Preparing the distributed.inventory.yml file for installing KUMA with multiple KUMA Core services on a Raft cluster

KUMA components can be installed, updated, and removed in the directory containing the extracted installer by using the Ansible® tool and the user-created YML inventory file containing a list of the hosts of KUMA components and other settings.

To create a distributed.inventory.yml file for installing KUMA with multiple KUMA Core services on a Raft cluster:

  1. Go to the KUMA installer directory by executing the following command:

    cd kuma-ansible-installer

  2. Create an inventory file named distributed.inventory.yml by copying distributed.inventory.yml.template:

    cp distributed.inventory.yml.template distributed.inventory.yml

  3. Edit the settings in the distributed.inventory.yml.

    Manually add the kuma-core-peers group to the inventory file and specify the servers for installing additional KUMA Core services. Together, the kuma-core and kuma-core-peers groups must list an odd number of servers.

    The kuma-core-00000000-0000-0000-0000-000000000000 service is installed on a server from the kuma_core group (displayed as core-1 in the web interface). On all servers from the kuma_core_peers group, the kuma-core-UID services are sequentially installed and started (displayed as core-<FQDN> in the web interface). These services are connected to the core-1 service. Only one KUMA Core service can be installed on each server.

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

Example distributed.inventory.yml file for installing KUMA with multiple KUMA Core services on a Raft cluster

Page top