Установка на одном сервере

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

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

Для наглядного ознакомления с установкой 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 и более поздних версий. Для более ранних версий решения используется активация приложения файлом ключа.

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

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

   cp single.inventory.yml.template single.inventory.yml

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

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

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

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

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

   all:

   vars:

   deploy_to_k8s: false

   need_transfer: false

   generate_etc_hosts: false

   deploy_example_services: true

   no_firewall_actions: false

   kuma:

   vars:

   ansible_connection: ssh

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

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

   ansible_become: true

   ansible_port: 2222

   children:

   kuma_core:

   hosts:

   kuma1.example.com:

   kuma_collector:

   hosts:

   kuma1.example.com

   kuma_correlator:

   hosts:

   kuma1.example.com

   kuma_storage:

   hosts:

   kuma1.example.com:

   shard: 1

   replica: 1

   keeper: 1

   kuma_metrics:

   hosts:

   kuma1.example.com

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

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

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

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

./install.sh single.inventory.yml

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

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

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

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

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

yes

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

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

• Файл ключа

  Если вы активируете решение с помощью файла ключа и поместили файл ключа в директорию <директория установщика>/roles/kuma/files/, в результате запуска установщика с файлом инвентаря single.inventory.yml будут установлены Ядро KUMA и сервис Метрики. На указанных в файле инвентаря хостах будут размещены файлы, необходимые для дальнейшей установки и запуска сервисов KUMA, а также будут доступны преднастроенные ресурсы (нормализаторы, правила корреляции, активные листы и другие), отмеченные префиксом [OOTB].

  Сведения о ходе установки, успешно выполненных операциях и возникших ошибках выводятся только в журналы Ядра KUMA, которые хранятся в директории /opt/kaspersky/kuma/core/<идентификатор сервиса Ядра KUMA>/log/core.

  После завершения работы установщика войдите в веб-интерфейс.

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

  Если вы активируете решение с помощью кода активации, будут установлены только Ядро KUMA и сервис Метрики.

  Чтобы завершить установку:

  1. Войдите в веб-интерфейс и укажите код активации.
  2. Запустите установщик postinstall.sh с файлом инвентаря single.inventory.yml:

     ./postinstall.sh single.inventory.yml

  На хостах, указанных в файле инвентаря, будут размещены файлы, необходимые для дальнейшей установки и запуска сервисов KUMA. В репозитории будут доступны для импорта преднастроенные ресурсы (нормализаторы, правила корреляции, активные листы и другие), отмеченные префиксом [OOTB].

  Сведения о ходе установки, успешно выполненных операциях и возникших ошибках выводятся только в журналы Ядра KUMA, которые хранятся в директории /opt/kaspersky/kuma/core/<идентификатор сервиса Ядра KUMA>/log/core.

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