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

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

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

1. Убедитесь, что на целевых машинах соблюдены аппаратные и программные требования, а также требования к устройствам с операционными системами Oracle Linux, Astra Linux, Ubuntu, РЕД ОС, М ОС.
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 и укажите в нем серверы, которые вы хотите добавить, в секции storage. В приведенном примере в секции storage указаны серверы для установки 3 выделенных киперов и 2 шардов, каждый из которых будет содержать по 2 реплики. В файле инвентаря expand.inventory.yml следует указать только FQDN. Роли киперов, шардов и реплик вы будете назначать позднее в веб-интерфейсе KUMA, последовательно выполняя шаги инструкции. Вы можете адаптировать этот пример под свои потребности.

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

   kuma:

   vars:

   ansible_connection: ssh

   ansible_user: root

   children:

   kuma_collector:

   kuma_correlator:

   kuma_storage:

   hosts:

   kuma-storage-cluster2-server1.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster2-server2.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster2-server3.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster2-server4.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster2-server5.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster2-server6.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster2-server7.example.com:

   ip: 0.0.0.0

5. На контрольной машине с доступом root из директории с распакованным установщиком выполните следующую команду:

   ./expand.sh expand.inventory.yml

   В результате выполнения команды на каждой целевой машине, указанной в файле инвентаря expand.inventory.yml, появятся файлы для создания и установки хранилища.

6. Создайте и установите хранилище. Для каждого кластера хранения следует создавать отдельное хранилище, то есть 3 кластера хранения – 3 хранилища. Поскольку хранилище состоит из клиентской и серверной частей, выполните следующие два шага:
   1. Создайте клиентскую часть хранилища, которая включает в себя набор ресурсов и сервис хранилища:
      1. Чтобы создать набор ресурсов для хранилища, в веб-интерфейсе KUMA в разделе Ресурсы → Хранилища нажмите Добавить хранилище и настройте параметры. В разделе Узлы кластера ClickHouse укажите роли для каждого добавляемого сервера: кипер, шард, реплика. Подробнее см. Создание набора ресурсов для хранилища.

         Созданный набор ресурсов для хранилища отображается в разделе Ресурсы → Хранилища. Теперь можно создать сервисы хранилища для каждого узла кластера ClickHouse.

      2. Чтобы создать сервис хранилища, в веб-интерфейсе KUMA в разделе Ресурсы → Активные сервисы нажмите Добавить сервис.

         В открывшемся окне Выберите сервис выберите созданный на шаге a. набор ресурсов для хранилища и нажмите Создать сервис. Повторите для каждого узла хранилища ClickHouse.

         Количество созданных сервисов должно равняться количеству узлов в кластере ClickHouse, то есть 50 узлов – 50 сервисов. Созданные сервисы хранилища отображаются в веб-интерфейсе KUMA в разделе Ресурсы → Активные сервисы. Теперь сервисы хранилища необходимо установить на каждом узле кластера ClickHouse, используя идентификатор сервиса.

   2. На целевой машине создайте серверную часть хранилища:
      1. В веб-интерфейсе KUMA в разделе Ресурсы → Активные сервисы выберите нужный сервис хранилища и нажмите Копировать идентификатор.

         Идентификатор сервиса будет скопирован в буфер обмена, он понадобится для выполнения команды установки сервиса.

      2. Сформируйте и выполните на целевой машине следующую команду:

         sudo /opt/kaspersky/kuma/kuma <storage> --core https://<FQDN>:<port> --pair.fingerprint <CA_cert_ID> --id <service_ID> --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.

         Сервис хранилища будет установлен на целевой машине. Вы можете проверить статус сервиса в веб-интерфейсе в разделе Ресурсы → Активные сервисы.

      3. Последовательно выполните команду установки сервиса хранилища на каждой целевой машине, указанной в секции storage в файле инвентаря expand.inventory.yml. На каждой машине в команде установки требуется указывать уникальный идентификатор сервиса в рамках кластера.

      Выделенные киперы запускаются автоматически сразу после установки и отображаются в разделе Ресурсы → Активные сервисы в зеленом статусе. Сервисы на остальных узлах хранилища могут не запускаться до тех пор, пока не будут установлены сервисы для всех узлов данного кластера. До этого момента сервисы могут отображаться в красном статусе. Это нормальное поведение для создания нового кластера хранения или добавления узлов в существующий кластер хранения. Как только будет выполнена команда установки сервисов на всех узлах кластера, все сервисы переходят в зеленый статус.

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

Добавление дополнительного кластера хранения завершено.