Установка в распределенной конфигурации

Эта инструкция является частью сценария развертывания и первоначальной настройки.

Установка производится с контрольной машины, при этом все компоненты решения устанавливаются на целевых машинах.

Для наглядного ознакомления с установкой Kaspersky SIEM в распределенной конфигурации вы можете просмотреть видео ниже, а затем воспользоваться пошаговой инструкцией.

Перед началом установки убедитесь, что вы выполнили действия по подготовке к установке. Также убедитесь, что у вас есть действующий лицензионный ключ для активации решения.

Чтобы установить Kaspersky SIEM в распределенной конфигурации, перейдите на контрольную машину и выполните следующие действия:

Поместите архив с установщиком на контрольную машину

В личном кабинете на портале Kaspersky CompanyAccount скачайте архив с установщиком, а затем скопируйте архив с установщиком kuma-ansible-installer-<номер версии KUMA>.tar.gz на контрольную машину и распакуйте его с помощью следующей команды (потребуется около 2 ГБ дискового пространства):

tar -xpf kuma-ansible-installer-<номер версии KUMA>.tar.gz

Войдите в директорию с установщиком и предоставьте пользователю ОС, от имени которого запускается установщик KUMA, доступ к файлам в директории

Для этого последовательно выполните следующие команды:

cd kuma-ansible-installer

chown -R <user_name>:<group> kuma-ansible-installer

где:

• <user_name> — пользователь ОС, от имени которого запускается установщик KUMA и которому следует выдать права на директорию с установщиком. Также у пользователя должны быть права на запись в директорию, в которую этот архив будет распаковываться.
• <group> — основная группа пользователя.

Активируйте решение

В зависимости от способа активации, выполните следующие действия:

• Файл ключа.

  Поместите файл ключа license.key в директорию <директория установщика>/roles/kuma/files/:

  cp <файл ключа>.key <директория установщика>/roles/kuma/files/license.key

• Код активации.

  Действия не требуются, переходите к следующему пункту инструкции.

  Активация приложения с помощью кода активации доступна только для KUMA 3.4 и более поздних версий. Для более ранних версий KUMA используется активация приложения файлом ключа.

Подготовьте файл инвентаря

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

   cp distributed.inventory.yml.template distributed.inventory.yml

   Шаблон содержит базовый набор параметров, но его недопустимо использовать при установке без изменений.

2. Заполните значения параметров в файле инвентаря distributed.inventory.yml в соответствии с выполняемым сценарием. Доступные значения параметров приведены в таблице параметров в файле инвентаря.
   1. В шаблоне файла инвентаря distributed.inventory.yml приведены примеры имен хостов для разных групп сервисов KUMA. Перед установкой замените эти примеры на действительные FQDN в формате <имя хоста>.<домен> и при необходимости укажите IPv4-адрес или IPv6-адрес серверов вашей инфраструктуры, на которые будут устанавливаться соответствующие сервисы.
   2. Если вы используете нестандартную директорию для хранения SSH-ключей, укажите полный путь к SSH-ключу в параметре ansible_ssh_private_key_file в файле инвентаря в секции kuma: vars:, чтобы обеспечить доступ установщика к целевым машинам.
   3. Если вы хотите использовать нестандартный порт для подключения по протоколу SSH в ходе установки, выберите один из следующих вариантов:
      • Если порт одинаковый для группы хостов, укажите порт в параметре ansible_port в файле инвентаря в секции vars.
      • Если для подключения к каждому хосту используется отдельный нестандартный порт, укажите порт в параметре ansible_port для каждого хоста в файле инвентаря.
   4. Если вы хотите, чтобы при установке были созданы предустановленные сервисы (коллектор, коррелятор и хранилище), присвойте параметру deploy_example_services значение true.

      Предустановленные сервисы будут созданы и автоматически запущены на указанных в файле инвентаря хостах. Созданные сервисы будут доступны в веб-интерфейсе Kaspersky SIEM. Дополнительно устанавливать или запускать их не требуется. При необходимости вы можете удалить предустановленные сервисы.

   Ниже приведен пример заполнения файла инвентаря distributed.inventory.yml с указанием полного пути к SSH-ключу, без развертывания предустановленных сервисов, с указанием отдельного нестандартного порта для подключения по протоколу SSH для коллектора и коррелятора и общего нестандартного порта для группы хостов хранилища.

   Пример файла инвентаря distributed.inventory.yml

   all:

   vars:

   deploy_to_k8s: false

   need_transfer: false

   generate_etc_hosts: false

   deploy_example_services: false

   no_firewall_actions: false

   kuma:

   vars:

   ansible_connection: ssh

   ansible_ssh_private_key_file: <полный путь к файлу с ключом SSH>

   ansible_user: <пользователь из группы sudo>

   ansible_become: true

   children:

   kuma_core:

   hosts:

   kuma-core-1.example.com:

   raft_node_addr: ""

   ip: 0.0.0.0

   kuma_metrics:

   hosts:

   kuma-metrics.example.com

   ip: 0.0.0.0

   kuma_collector:

   hosts:

   kuma-collector-1.example.com:

   ansible_port: 2222

   ip: 0.0.0.0

   kuma_correlator:

   hosts:

   kuma-correlator-1.example.com:

   ansible_port: 2223

   ip: 0.0.0.0

   kuma_storage:

   vars:

   ansible_port: 2224

   hosts:

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

   ip: 0.0.0.0

   shard: 1

   replica: 1

   keeper: 0

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

   ip: 0.0.0.0

   shard: 1

   replica: 2

   keeper: 0

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

   ip: 0.0.0.0

   shard: 2

   replica: 1

   keeper: 0

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

   ip: 0.0.0.0

   shard: 2

   replica: 2

   keeper: 0

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

   ip: 0.0.0.0

   shard: 0

   replica: 0

   keeper: 1

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

   ip: 0.0.0.0

   shard: 0

   replica: 0

   keeper: 2

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

   ip: 0.0.0.0

   shard: 0

   replica: 0

   keeper: 3

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

Запустите установщик

Запустите установщик install.sh с подготовленным файлом инвентаря distributed.inventory.yml:

Для пользователя с root-правами

./install.sh distributed.inventory.yml

Для пользователя без root-прав требуется ввести пароль для повышения привилегий

./install.sh distributed.inventory.yml --ask-become-pass

Ознакомьтесь с условиями Лицензионного соглашения

Если вы не примете условия Лицензионного соглашения, решение не будет установлено.

Если вы хотите принять условия Лицензионного соглашения, при отображении запроса в командной строке введите:

yes

Завершение установки

Для завершения установки выполните действия в зависимости от способа активации решения:

Файл ключа

Код активации

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