Перенос сервиса Метрики на другой хост

Установка сервиса Метрики выполняется с помощью установщика expand.sh и файла инвентаря expand.inventory.yml.

Начиная с версии KUMA 4.2 при первичной установке решения сервис Метрики устанавливается на хосте, указанном в файле инвентаря в секции kuma_metrics. Вы можете указать другой хост для установки сервиса Метрики. В любой конфигурации KUMA сервис Метрики должен быть только один. При обновлении с версии KUMA 4.0 до версии 4.2 в файле инвентаря в секции kuma_metrics необходимо указать хост, на котором запущен активный сервис Метрики. При запуске обновления выполняется проверка и, если сервис Метрики на этом хосте не найден, возвращается ошибка и обновление прерывается.

В отказоустойчивой конфигурации KUMA сервис Метрики обращается к доступному Ядру KUMA напрямую, без участия балансировщика.

Если ранее работал один сервис Метрики и после его удаления был установлен новый сервис, исторические данные не удаляются. Данные сервиса Метрики остаются в директории /opt/kaspersky/kuma/metrics/<идентификатор прежнего сервиса Метрики>/data. Вы можете остановить сервис и перенести данные на другой хост, а также заменить существующую директорию data на перенесенную.

Чтобы установить сервис Метрики на другом хосте:

1. Убедитесь, что на целевых машинах соблюдены аппаратные и программные требования.
2. На контрольной машине перейдите в директорию с распакованным установщиком KUMA, выполнив следующую команду:

   cd kuma-ansible-installer

3. Скопируйте шаблон expand.inventory.yml.template и создайте файл инвентаря с именем expand.inventory.yml:

   cp expand.inventory.yml.template expand.inventory.yml

4. Измените параметры файла инвентаря expand.inventory.yml, указав в секции kuma_metrics хост, на котором вы хотите установить сервис Метрики.
5. На контрольной машине с доступом root из папки с распакованным установщиком выполните следующую команду:

   ./expand.sh expand.inventory.yml

   На хосте, указанном в секции kuma_metrics, появятся файлы для создания и установки сервиса Метрики.

6. В веб-интерфейсе откройте раздел Ресурсы и сервисы → Активные сервисы и в раскрывающемся списке Добавить выберите Добавить сервис Метрики.
7. В открывшемся окне в поле Имя сервиса Метрики укажите название сервиса.
8. Нажмите Добавить.

   Окно закроется, и вы перейдете в раздел Активные сервисы. Сервис Метрики добавлен в таблицу и находится в красном статусе.

9. Скопируйте идентификатор сервиса Метрики. Для этого в раздел Активные сервисы установите флажок рядом с сервисом Метрики и в панели инструментов или в меню () нажмите Копировать идентификатор.
10. Установите сервис Метрики на хосте, указанном в файле инвентаря expand.inventory.yml. Для этого в консоли командной строки выполните следующую команду:

    sudo /opt/kaspersky/kuma/kuma metrics --core https://<FQDN>:<port> --pair.fingerprint <CA_cert_ID> --id <service_ID> --api.port <API_port> --install

    где:

    • <FQDN> — полное доменное имя сервера Ядра KUMA.
    • <port> — номер порта Ядра KUMA для внутренних коммуникаций (по умолчанию используется порт 7210).
    • <CA_cert_ID> — идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.
      
      Параметр --pair.fingerprint является необязательным. При создании сервиса KUMA автоматически добавляет этот параметр в команду установки и указывает идентификатор отпечатка.
      Вы можете выполнить установку сервиса без указания параметра --pair.fingerprint. В этом случае KUMA использует значение insecure по умолчанию, что не обеспечивает проверку подлинности CA-сертификата Ядра KUMA при установлении соединения. Если используется значение insecure, обновление отпечатка после перевыпуска CA-сертификата не требуется.
      
      Для обеспечения проверки подлинности CA-сертификата Ядра KUMA рекомендуется не удалять параметр --pair.fingerprint с идентификатором отпечатка при установке сервиса. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.
    • <service_ID> — идентификатор сервиса, скопированный из веб-интерфейса KUMA.
    • <API_port> — порт, используемый для связи с устанавливаемым компонентом.

    Пример

    sudo /opt/kaspersky/kuma/kuma metrics --core https://kuma.example.com:7210 --pair.fingerprint d183f1208ca739e247997991403676a037dd64e34a5eb5ed59f83e54dc6e5145 --id XXXX --api.port YYYY --install

11. Если вы хотите перенести исторические данные прежнего сервиса Метрики, скопируйте директорию data со старого хоста на новый, сохранив все атрибуты файлов (владельца, группу, права доступа, временные метки):

    sudo mv /opt/kaspersky/kuma/metrics/<former_metrics_ID>/data /opt/kaspersky/kuma/metrics/<new_metrics_ID>/data

    где:

    • <former_metrics_ID> — идентификатор прежнего сервиса Метрики.
    • <new_metrics_ID> — идентификатор нового сервиса Метрики.

    После копирования убедитесь, что директория data и содержащиеся в ней файлы принадлежат пользователю и группе, под которыми работает сервис Метрики (по умолчанию kuma:kuma):

    sudo chown -R kuma:kuma /opt/kaspersky/kuma/metrics/<new_metrics_ID>/data

    sudo chmod -R 750 /opt/kaspersky/kuma/metrics/<new_metrics_ID>/data

12. Запустите сервис Метрики с помощью следующей команды:

    sudo systemctl start metrics.service

Сервис Метрики установлен и запущен.