Configuring the kuma-kont utility

Configuring the kuma-kont utility involves the following steps:

1. Creating the kuma-kont-config.yaml configuration file.
2. Creating the kuma-kont service.

Creating the kuma-kont-config.yaml configuration file

To create the kuma-kont-config.yaml configuration file:

1. Go to the Open Single Management Platform installer directory by executing the following command:

   cd kuma-ansible-installer/roles/kuma/files

2. Extract the kuma-kont.tar archive:

   tar -xvf kuma-kont.tar

3. Go to the directory of the utility:

   cd kuma-kont

4. Copy the kuma-kont-config-template.yaml template to create a configuration file named kuma-kont-config.yaml:

   cp kuma-kont-config-template.yaml kuma-kont-config.yaml

5. Change read permissions for the configuration file:

   sudo chown <user name>:<group> kuma-kont-config.yaml

   sudo chmod 600 kuma-kont-config.yaml

   Replace <user name> with the operating system user name that the service will use.

6. Edit the settings in the kuma-kont-config.yaml configuration file.

   Specify the values of the following settings:

   • General settings: state_file, log_file_path.
   • Kontinent Database: name, user, password, host, port.
   • Open Single Management Platform Collector: address, port, protocol.

     An example of configuration is given in the kuma-kont-config-template.yaml file.

7. Save the changes to the file.

The configuration file is created.

Creating the service

To create the kuma-kont service:

1. Change the execution permissions for the executable file:

   sudo chown <user name>:<group> <path to executable file>

   sudo chmod 700 <path to executable file>

2. Create the /etc/systemd/system/kuma-kont.service file with the following contents:

   [Unit]

   Description=Connector Kontinent 3.9

   After=network.target

   [Service]

   User=<user name>

   ExecStart=<path to executable file> --config <path to configuration file>

   Restart=always

   RestartSec=10

   [Install]

   WantedBy=multi-user.target

   Replace <user name> with the user name of the operating system user that the service will use.

3. Specify the path to the executable file.

   Specify the path to the kuma-kont executable file in the ExecStart field.

   For example, if the kuma-kont file is located in the /usr/bin/ directory, leave the default value.

4. Specify the path to the configuration file.

   Specify the path to the kuma-kont-config.yaml configuration file in the ExecStart field. For example, if the kuma-kont-config.yaml file is located in the /path/to/ directory, specify that path.

   Example kuma-kont.service file

   [Unit]

   Description=Continent Service

   After=network.target

   [Service]

   User=user-example

   ExecStart=./usr/bin/kuma-kont --config /path/to/kuma-kont-config.yaml

   Restart=always

   RestartSec=10

   [Install]

   WantedBy=multi-user.target

5. Load the systemd configuration:

   sudo systemctl daemon-reload

6. Make the service run at startup:

   sudo systemctl enable kuma-kont

The kuma-kont utility will be started as a service at system startup.

Page top