Add Host

The process is the same for both Ubuntu and RHEL / CentOS Linux.

We will use Ubuntu as our example.

Create Installer Package

Once selected you will have to provide additional information required to Create Installer script, that installs the Kazuhm agent, and connects your new host to the Kazuhm portal.

Information includes:

Location (optional) - Physical location of the hosts. Note that this will be converted to all lower case and <space>'s replaced by "-"; in the example above "San Diego" becomes "san-diego'.

Sudo Username (optional) - sudo username to be used when running the Kazuhm installation on the host. If this is left blank then the installation is run as the actual user running the installation script.

Once entered click Create Installer to generate the script.

On successful completion (this will take less than a minute) you will be prompted to download the installer script (~9MB) kazagent.run

Installation

There are a number of host system prerequisites before the Installer script can be run:

• Minimum 4 GB RAM and 2 CPU per host.
• Confirm that your OS is supported here.
• The use of swap must be permanently disabled.
• Network Configuration allowing Internet access for all machines which must also have Port 22 and Port 443 open.
• Routing must be configured to allow bi-directional communication between Master and Workers.
• Passwordless sudo must be enabled for the sudo username (see above) that will be used to run
  the Installer. It is suggested that the visudo command be used:

sudo visudo
INSTALLING_SUDO_USER ALL=(ALL) NOPASSWD:ALL

Copy Installer Package to Host

As an example we are using a Windows desktop and a secure VPN connection.

Open Windows Terminal

cd to directory into which the kazinstall.run Installer Package was downloaded.

scp kazagent.run username@IPAddress:/home/kazadmin/

Copy Installer Package to Remaining Hosts

Note - this requires using SSH on the Host Group master to run commands on the other hosts in the group. In order to avoid the SSH "connect to a new host" prompt, it is required that the host group master have the rest of the host group's SSH public keys installed. This can be accomplished by logging in to the master, running the ssh command to each host in the group, then entering "yes" when prompted. Alternatively, SSH public keys can be added automatically for all hosts with a single bash command, for example:

for WORKER in 10.99.9.{901..919}; do ssh-keyscan -t ed25519 $WORKER>/dev/null >> ~/.ssh/known_hosts; done

where 10.99.9.901...919 is the IP Address range for all other hosts

Open Windows Terminal

ssh to host (master) onto which you copied the Installer Package

If required set up public keys on host group master as above.

for i in 10.99.9.{901..919}; do scp kazagent.run $i:~/.; done

where 10.99.9.901...919 is the IP Address range for all other hosts

Install Agent on First Host

Open Windows Terminal

ssh to host (master) onto which you copied the Installer Package

sudo sh ./kazagent.run

Install Agent on Remaining Hosts

Open Windows Terminal

ssh to host (master) onto which you copied the Installer Package

If required set up public keys on host group master as above.

for i in 10.99.9.{901..919}; do ssh $i "hostname; sudo sh ./kazagent.run; echo"; done

where 10.99.9.901...919 is the IP Address range for all other hosts

On successful completion all Hosts will be displayed in Host Management as Connected.

Troubleshooting

Please refer to FAQs - How do I troubleshoot Linux Hosts?