Installing the program in a distributed configuration

KUMA is installed using the Ansible tool and a YML inventory file. The installation is performed from the control machine, and all of the KUMA components are installed on target machines.

To install KUMA:

1. On the control machine, go to the directory containing the extracted installer.

   cd kuma-ansible-installer

2. Depending on the type of application activation that you plan to use, do one of the following:
   • To activate the application using a key file, place the key file in the <installer directory>/roles/kuma/files/ directory.

     The key file must be named license.key.

     sudo cp <key file>.key <installer directory>/roles/kuma/files/license.key

   • To activate the application using an activation code, proceed to the next step of the instructions.
3. From the directory with the unpacked installer, start the installation of components using the prepared distributed.inventory.yml inventory file:

   sudo ./install.sh distributed.inventory.yml

   If privilege elevation on the target machine requires specifying a password, run the following command and specify the password when prompted:

   sudo ./install.sh distributed.inventory.yml --ask-become-pass

4. Accept the terms of the End User License Agreement.

   If you do not accept the terms of the End User License Agreement, the program will not be installed.

   Depending on the type of application activation, the installer produces one of the following results:

   • If you are activating the application using a key file and have placed the key file in <installer directory>/roles/kuma/files/, running the installer with the distributed.inventory.yml inventory file installs KUMA Core, all services specified in the inventory file, and OOTB resources.
   • If you are activating the application with an activation code or plan to upload a key file later, running the installer with the "distributed.inventory.yml" inventory file installs only KUMA Core.

     To install services, enter the activation code on the command line. Then run the postinstall.sh installer with the distributed.inventory.yml inventory file.

     sudo ./postinstall.sh distributed.inventory.yml

     This creates the specified services. You can select the resources that you want to import from the repository.

5. After the installation is complete, log in to the KUMA web interface and enter the address of the KUMA web interface in the address bar of your browser, then enter your credentials on the login page.

   The address of the KUMA web interface is https://<FQDN of the host where KUMA is installed>:7220.

   Default login credentials:

   • user name: admin
   • password: mustB3Ch@ng3d!

   After logging in for the first time, change the password of the admin account

All KUMA components are installed and you are logged in to the web interface.

We recommend saving a backup copy of the inventory file that you used to install the application. You can use this inventory file to add components to the system or remove KUMA.

Page top