Добавление устройств для установки дополнительных сервисов KUMA

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

Вам нужно указать параметры дополнительных устройств в файле expand.inventory.yml. Этот файл находится в дистрибутиве с транспортным архивом, KDT, конфигурационным файлом и другими файлами. В файле expand.inventory.yml можно указать сразу несколько дополнительных устройств для коллекторов, корреляторов и хранилищ. Убедитесь, что соблюдены аппаратные и программные требования, а также требования к установке на выбранных устройствах.

Чтобы подготовить требуемую инфраструктуру на устройствах, указанных в файле expand.inventory.yml, вам нужно создать служебные директории, в которые будут добавлены файлы, необходимые для установки службы. Чтобы подготовить инфраструктуру, выполните следующую команду и укажите файл expand.inventory.yml:

./kdt invoke kuma --action addHosts --param host_inventory='<путь_к_файлу_инвентаря>'

На устройствах, указанных в файле expand.inventory.yml, служебные каталоги, в которые добавляются файлы, необходимые для установки службы.

Пример дополнительного файла инвентаря KUMA для установки сервисов KUMA (файл expand.inventory.yml)

Добавление дополнительного хранилища, коллектора или коррелятора

Вы можете добавить к существующей инфраструктуре дополнительное хранилище кластера, коллектор или коррелятор. Если вы хотите добавить несколько сервисов, рекомендуется устанавливать их в следующем порядке: хранилища, коллекторы и корреляторы.

Чтобы добавить дополнительное хранилище кластера, коллектор или коррелятор:

1. В главном меню Консоли OSMP перейдите в Параметры → KUMA.
2. В разделе KUMA Консоли OSMP создайте набор ресурсов для каждого сервиса KUMA (хранилищ, коллекторов и корреляторов), который вы хотите установить на подготовленных устройствах.
3. Создайте сервисы для хранилищ, коллекторов и корреляторов.
4. Получите идентификаторы сервисов для привязки созданных наборов ресурсов и сервисов KUMA:
   1. В главном окне решения OSMP перейдите в раздел Ресурсы → Активные сервисы.
   2. Выберите требуемый сервис KUMA и нажмите на кнопку Копировать идентификатор.
5. Установите сервисы KUMA на каждое подготовленное устройство, указанное в разделах kuma_storage, kuma_collector и kuma_correlator файла инвентаря expand.inventory.yml. На каждом устройстве в команде установки укажите идентификатор сервиса, соответствующий устройству. Выполните соответствующие команды, чтобы установить сервисы KUMA:
   • Команда установки хранилища:

     sudo /opt/kaspersky/kuma/kuma storage --core https://<FQDN>:7210 --pair.fingerprint <fingerprint ID of the KUMA Core CA certificate> --id <service ID> --install

   • Команда установки коллектора:

     sudo /opt/kaspersky/kuma/kuma collector --core https://<FQDN>:7210 --pair.fingerprint <fingerprint ID of the KUMA Core CA certificate> --id <service ID> --api.port <API port>

   • Команда установки коррелятора:

     sudo /opt/kaspersky/kuma/kuma correlator --core https://<FQDN>:7210 --pair.fingerprint <fingerprint ID of the KUMA Core CA certificate> --id <service ID> --api.port <API port> --install

     Команды установки коллектора и коррелятора автоматически создаются на вкладке Проверка в мастере установки. Порт, используемый для связи, автоматически добавляется в команду. Используйте сгенерированные команды для установки коллектора и коррелятора на устройства. Это позволит убедиться, что порты для связи с сервисами, которые указаны в команде, доступны.

   где:

   • <FQDN> – полное доменное имя сервера Ядра KUMA. FQDN Ядра KUMA – это <kuma_host>.<smp_domain>. Порт, который используется для подключения к Ядру KUMA, невозможно изменить. По умолчанию номер порта – 7210.
   • <fingerprint ID of the KUMA Core CA certificate> – идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.

     Аргумент --pair.fingerprint является необязательным. При создании сервиса OSMP автоматически добавляет этот параметр в команду установщика и указывает идентификатор отпечатка.

     Вы можете установить сервис без указания параметра --pair.fingerprint. В этом случае OSMP использует значение insecure по умолчанию, которое пропускает проверку сертификата центра сертификации (CA) Ядра KUMA при установлении подключения. Если значение insecure, отпечаток не нужно обновлять после перевыпуска сертификата центром сертификации (CA).

     Чтобы убедиться, что сертификат центра сертификации (CA) Ядра KUMA прошел проверку, рекомендуется сохранить параметр --pair.fingerprint с идентификатором отпечатка при установке сервиса. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.

   • <service ID> – это идентификатор сервиса KUMA, скопированный из веб-интерфейса.
   • <API port> – это порт, используемый для связи с установленным компонентом.

Дополнительные сервисы KUMA установлены.

Добавление устройств в существующее хранилище

Вы можете расширить существующее хранилище (хранилище кластера), добавив устройства в качестве новых узлов хранилища кластера.

Чтобы добавить устройства в существующее хранилище:

1. В главном меню Консоли OSMP перейдите в Параметры → KUMA.
2. Добавьте узлы в хранилище кластера. Для этого измените параметры существующего хранилища кластера:
   1. В разделе Ресурсы → Хранилища выберите существующее хранилище и откройте хранилище для изменения.
   2. В разделе Узлы кластера ClickHouse нажмите на Добавить узлы и в полях для нового узла укажите роли. Укажите соответствующие доменные имена устройств из раздела kuma_storage файла expand.inventory.yml, а затем укажите роли для новых узлов.
   3. Сохраните изменения.

   Поскольку вы добавляете серверы в существующий кластер хранилища, создавать отдельное хранилище уже не нужно.

3. Создайте сервисы хранилища для каждого добавленного узла хранилища кластера в разделе KUMA Консоли OSMP и привяжите сервисы к хранилищу кластера.
4. Получите идентификаторы сервиса хранилища для каждого подготовленного устройства для установки сервисов KUMA:
   1. В разделе KUMA Консоли OSMP перейдите в раздел Ресурсы → Активные сервисы.
   2. Выберите требуемый сервис KUMA и нажмите на кнопку Копировать идентификатор.
5. Установите сервис хранилища на каждое подготовленное устройство, указанное в разделе kuma_storage файла инвентаря expand.inventory.yml. На каждом устройстве в команде установки укажите идентификатор сервиса, соответствующий устройству. Выполните следующую команду, чтобы установить сервис хранилища:

   sudo /opt/kaspersky/kuma/kuma storage --core https://<FQDN>:7210 --pair.fingerprint <fingerprint ID of the KUMA Core CA certificate> --id <service ID> --install

   где:

   • <FQDN> – полное доменное имя сервера Ядра KUMA. FQDN Ядра KUMA – это <kuma_host>.<smp_domain>. Порт, который используется для подключения к Ядру KUMA, невозможно изменить. По умолчанию номер порта – 7210.
   • <fingerprint ID of the KUMA Core CA certificate> – идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.

     Аргумент --pair.fingerprint является необязательным. При создании сервиса OSMP автоматически добавляет этот параметр в команду установщика и указывает идентификатор отпечатка.

     Вы можете установить сервис без указания параметра --pair.fingerprint. В этом случае OSMP использует значение insecure по умолчанию, которое пропускает проверку сертификата центра сертификации (CA) Ядра KUMA при установлении подключения. Если значение insecure, отпечаток не нужно обновлять после перевыпуска сертификата центром сертификации (CA).

     Чтобы убедиться, что сертификат центра сертификации (CA) Ядра KUMA прошел проверку, рекомендуется сохранить параметр --pair.fingerprint с идентификатором отпечатка при установке сервиса. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.

   • <service ID> – это идентификатор сервиса KUMA, скопированный из веб-интерфейса.

Дополнительные устройства добавлены в хранилище кластера.

Укажите добавленные устройства в файле инвентаря distributed.inventory.yml, чтобы в нем были актуальные сведения на случай обновления компонентов KUMA.