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

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

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

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 указаны серверы для установки двух шардов, каждый из которых будет содержать по две реплики. В файле инвентаря 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-cluster1-server8.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster1-server9.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster1-server10.example.com:

   ip: 0.0.0.0

   kuma-storage-cluster1-server11.example.com:

   ip: 0.0.0.0

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

   ./expand.sh expand.inventory.yml

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

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

      Пример добавления узлов

      Узлы кластера ClickHouse

      <существующие узлы>

      Полное доменное имя: kuma-storage-cluster1server8.example.com

      Идентификатор шарда: 1

      Идентификатор реплики: 1

      Идентификатор кипера: 0

      Полное доменное имя: kuma-storage-cluster1server9.example.com

      Идентификатор шарда: 1

      Идентификатор реплики: 2

      Идентификатор кипера: 0

      Полное доменное имя: kuma-storage-cluster1server9.example.com

      Идентификатор шарда: 2

      Идентификатор реплики: 1

      Идентификатор кипера: 0

      Полное доменное имя: kuma-storage-cluster1server10.example.com

      Идентификатор шарда: 2

      Идентификатор реплики: 2

      Идентификатор кипера: 0

   3. Сохраните параметры хранилища.

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

7. Создайте сервис хранилища:
   1. В веб-интерфейсе KUMA в разделе Ресурсы → Активные сервисы нажмите Добавить сервис.
   2. В открывшемся окне Выберите сервис выберите измененное на предыдущем шаге хранилище и нажмите Создать сервис. Повторите для каждого добавляемого узла хранилища ClickHouse.

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

8. Установите сервисы хранилища на каждом сервере:
   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.

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

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

9. Примените изменения в работающем кластере. Для этого в веб-интерфейсе KUMA в разделе Ресурсы → Активные сервисы установите флажок рядом со всеми сервисами хранилища в кластере, который вы расширяете, и нажмите Обновить параметры. Изменения будут применены без остановки сервисов.
10. Укажите добавленные серверы в файле инвентаря distributed.inventory.yml, чтобы в нем были актуальные сведения на случай обновления KUMA.

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