Kaspersky Unified Monitoring and Analysis Platform

Backing up KUMA

KUMA allows you to back up the KUMA Core database and certificates. Backups may be created using the executable file /opt/kaspersky/kuma/kuma.

Data may only be restored from a backup if it is restored to the KUMA of the same version as the backup one.

To perform a backup:

  1. Log in to the OS of the server where the KUMA Core is installed as the root user.
  2. Execute the following command:

    /opt/kaspersky/kuma/kuma tools backup --dst <path to the backup folder> --certificates

    The flag --certificates is optional and is used to back up certificates.

The backup copy has been created.

To restore data from a backup:

  1. Log in to the OS of the server where the KUMA Core is installed as the root user.
  2. On the KUMA Core server, run the following command:

    sudo systemctl stop kuma-core

  3. Execute the following command:

    /opt/kaspersky/kuma/kuma tools restore --src <path to the backup folder> --certificates

    The --certificates flag is optional and is used to restore certificates.

  4. Start KUMA by running the following command:

    sudo systemctl start kuma-core

  5. Rebuild the services using the recovered service resource sets.

Data is restored from the backup.

What to do if KUMA malfunctions after restoring data from a backup copy

If the KUMA Core fails to start after data recovery, the recovery must be performed again but this time the KUMA database in MongoDB must be reset.

To restore KUMA data and reset the MongoDB database:

  1. Log in to the OS of the server where the KUMA Core is installed.
  2. On the KUMA Core server, run the following command:

    sudo systemctl stop kuma-core

  3. Log in to MongoDB by running the following commands:
    1. cd /opt/kaspersky/kuma/mongodb/bin/
    2. ./mongo
  4. Reset the MongoDB database by running the following commands:
    1. use kuma
    2. db.dropDatabase()
  5. Log out of the MongoDB database by pressing Ctrl+C.
  6. Restore data from a backup copy by running the following command:

    sudo /opt/kaspersky/kuma/kuma tools restore --src <path to folder containing backup copy> --certificates

    The --certificates flag is optional and is used to restore certificates.

  7. Start KUMA by running the following command:

    sudo systemctl start kuma-core

  8. Rebuild the services using the recovered service resource sets.

Data is restored from the backup.

Collectors are not required to be backed up, except for SQL-connected collectors. When restoring such collectors, you should revert to the original initial value of the ID.

Page top
[Topic 222208]