Изменение имени хоста при распределенном развертывании
Скопировано

13 октября 2026

ID 314906

Изменение имени хоста при распределенном развертывании

Чтобы изменить имя хоста на узле, на котором установлены сервисы KUMA:

  1. Остановите все сервисы KUMA, кроме Ядра KUMA, выполнив следующую команду:

    sudo systemctl stop kuma-<collector/correlator/storage/eventRouter/metrics>-<service_ID>.service

    где:

    <service_ID> — идентификатор сервиса, скопированный из веб-интерфейса KUMA.

  2. Создайте файл восстановления с помощью следующей команды:

    sudo touch /opt/kaspersky/kuma/core/<core_ID>/raft/.reset

    где:

    <core_ID> — идентификатор Ядра KUMA, скопированный в веб-интерфейсе.

  3. Перейдите в директорию systemd с конфигурацией сервиса Ядра KUMA и измените параметры запуска:
    • В параметре --raft.node.addr укажите новый FQDN хоста.
    • Удалите параметр --raft.join, если он указан.
  4. На каждом хосте, где установлены сервисы KUMA (коллектор, коррелятор, хранилище, маршрутизатор событий), найдите unit-файл systemd соответствующего сервиса:

    systemctl cat kuma-<service_ID>.service

    где:

    <service_ID> — идентификатор сервиса, скопированный в веб-интерфейсе.

    Команда вернет директорию, в которой расположен unit-файл systemd сервиса KUMA. Перейдите в эту директорию и откройте unit-файл с помощью редактора.

  5. В каждом unit-файле systemd сервисов измените значения следующих параметров:
    • В параметре --core укажите новое имя для хоста, на котором установлено Ядро KUMA.
    • В параметре --advertise.fqdn укажите новое полное доменное имя машины.
  6. Примените новые параметры, выполнив следующую команду:

    sudo systemctl daemon-reload

  7. Измените FQDN хоста в файле /etc/hosts. Новый FQDN должен разрешаться в IP-адрес этого хоста.
  8. Измените имя хоста в операционной системе:

    sudo hostnamectl set-hostname <hostname>

    где:

    <hostname> — новое имя хоста.

  9. Перезагрузите каждый хост, на котором установлены сервисы KUMA, кроме хоста с Ядром KUMA, выполнив следующую команду:

    sudo reboot

  10. Перезагрузите хост с Ядром KUMA.

    sudo reboot

  11. В веб-интерфейсе KUMA перейдите в раздел Ресурсы и сервисы → Активные сервисы, в списке сервисов установите флажок для необходимых сервисов и в панели инструментов или в меню () нажмите Сбросить сертификат.

    KUMA автоматически сгенерирует новый сертификат для каждого сервиса, для которого был сброшен сертификат. Для работающих сервисов перезапуск не требуется, новый сертификат будет применен автоматически. Если сервис был остановлен, необходимо перезапустить его, чтобы применить новый сертификат.

  12. Удалите директории с сертификатами сервисов, выполнив следующие команды:

    sudo rm -rf /opt/kaspersky/kuma/collector/correlator/storage/eventRouter/<service_ID>/certificates

    sudo rm -rf /opt/kaspersky/kuma/clickhouse/certificates

    где:

    <service_ID> — идентификатор сервиса, скопированный из веб-интерфейса KUMA.

  13. В веб-интерфейсе KUMA перейдите в раздел Ресурсы и сервисы → Активные сервисы, откройте каждый активный сервис для изменения параметров и на шаге Маршрутизация замените прежний FQDN на новый для точки назначения.
  14. Перезапустите все сервисы KUMA:

    sudo systemctl restart kuma-<collector/correlator/storage/eventRouter/metrics>-<service_ID>.service

    где:

    <service_ID> — идентификатор сервиса, скопированный из веб-интерфейса KUMA.

Хост с Ядром KUMA будет работать под новым именем, а сервисы отобразятся в разделе Ресурсы и сервисы → Активные сервисы в зеленом статусе.

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!