Развертывание на одном узле с помощью стандартной виртуальной машины Ubuntu Server 24.04 LTS

В этом разделе содержатся инструкции по развертыванию экземпляра Kaspersky EDR Expert на одном узле на стандартной виртуальной машине Ubuntu Server 24.04 LTS.

Аппаратные требования к узлу кластера

• 16 vCPU
• 32 ГБ оперативной памяти
• 1 ТБ SSD или любое устройство с 8000 IOPS (операций ввода-вывода в секунду) при произвольном доступе

Требования к оборудованию должны быть рассчитаны в соответствии с руководством по масштабированию.

Проверка свободного места в каталогах /var, /opt и /tmp

Выполните следующие команды:

df -h /var

Требуется не менее 200 ГБ свободного места.

df -h /opt

Требуется не менее 500 ГБ свободного места.

df -h /tmp

Требуется не менее 50 ГБ свободного места.

Настройка учетной записи пользователя для развертывания Kaspersky EDR Expert

1. Откройте /etc/sudoers:

   sudo visudo

2. Добавьте в конец файла следующую строку:

   {user} ALL=(ALL) NOPASSWD: ALL

   где {user} – учетная запись, используемая для развертывания.

   В случае ошибки "user is not in sudoers file" переключитесь на пользователя с правами root и выполните следующую команду:

   echo "$USER ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/$USER

3. Сохраните (Ctrl+S) и закройте файл (Ctrl+X).
4. Создайте SSH-ключ:

   ssh-keygen -t rsa -b 4096 -N ""

5. Скопируйте открытый ключ на целевой хост (в случае развертывания на одном узле это тот же хост, с которого вы запускаете команду):

   ssh-copy-id <IP-адрес_виртуальной_машины>

Установка и настройка Docker

4.1 Установка Docker

Поддерживаются версии Docker 25 и выше.

4.1.1 Установка в Ubuntu 24:

sudo apt update && sudo apt install docker.io

4.1.2 ИЛИ Установка с использованием официальной инструкции:

1. Установите необходимые пакеты:

   sudo apt update && sudo apt install ca-certificates curl

2. Загрузите keyring Docker:

   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc && sudo chmod 0755 /etc/apt/keyrings/docker.asc

3. Добавьте apt-репозиторий Docker:

   sudo tee /etc/apt/sources.list.d/docker.sources <<EOF

   Types: deb

   URIs: https://download.docker.com/linux/ubuntu

   Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")

   Components: stable

   Architectures: $(dpkg --print-architecture)

   Signed-By: /etc/apt/keyrings/docker.asc

   EOF

4. Обновите кеш репозитория и установите пакеты Docker:

   sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4.2 Настройка Docker

1. Добавьте текущего пользователя в группу docker:

   sudo usermod -aG docker $USER

2. Активируйте членство пользователя в группе docker в текущем сеансе:

   newgrp docker

Установка и настройка PostgreSQL

Поддерживаются следующие версии PostgreSQL:

• PostgreSQL 15.
• PostgreSQL 16.
• PostgreSQL 17.
• PostgreSQL 18.

1. Установите PostgreSQL:

   sudo apt install -y postgresql-<версия>

   где <версия> – поддерживаемые версии PostgreSQL. Например, для PostgreSQL 16:

   sudo apt install -y postgresql-16

   Если требуемая версия PostgreSQL отсутствует в подключенном репозитории, необходимо добавить репозиторий PostgreSQL Apt. Подробнее см. на сайте PostgreSQL.

2. Создайте отдельного суперпользователя PostgreSQL:

   sudo -u postgres createuser --superuser xdr

3. Укажите пароль пользователя:

   sudo -u postgres psql -c "ALTER USER xdr WITH PASSWORD 'ваш пароль';"

4. Создайте для пользователя базу данных с таким же именем:

   sudo -u postgres psql -c "CREATE DATABASE xdr OWNER xdr;"

5. Разрешите доступ к PostgreSQL с любого IP-адреса:

   echo "host all all 0.0.0.0/0 scram-sha-256" | sudo tee -a /etc/postgresql/<версия>/main/pg_hba.conf

   где <версия> – поддерживаемые версии PostgreSQL. Например, для PostgreSQL 16:

   echo "host all all 0.0.0.0/0 scram-sha-256" | sudo tee -a /etc/postgresql/16/main/pg_hba.conf

6. Укажите следующие параметры в конфигурационном файле PostgreSQL (/etc/postgresql/<версия>/main/postgresql.conf), где <версия> – версия PostgreSQL. Например, для PostgreSQL 16: /etc/postgresql/16/main/postgresql.conf.

   Прокомментированные (#) строки необходимо раскомментировать.

   listen_addresses = '*'

   shared_buffers = 8192MB

   max_stack_depth = 7MB

   temp_buffers = 24MB

   work_mem = 16MB

   max_connections = 512

   max_parallel_workers_per_gather = 0

   maintenance_work_mem = 128MB

   standard_conforming_strings = on

7. Перезапустите PostgreSQL:

   sudo systemctl restart postgresql

Настройка DNS

На вашем DNS-сервере зарегистрируйте FQDN сервисов для подключения к сервисам OSMP.

Чтобы быстро начать работу, добавьте на свой DNS-сервер запись подстановки A, указывающую на свободный IP-адрес (<ingress_ip>) в той же подсети, что и кластер. Шлюз кластера Kubernetes будет прослушивать этот IP-адрес и направлять трафик к соответствующим службам.

По умолчанию службы OSMP доступны по следующим адресам:

<ingress_ip> - admsrv.<ingress_domain>

<ingress_ip> - api.<ingress_domain>

<ingress_ip> - console.<ingress_domain>

<ingress_ip> - kuma.<ingress_domain>

<ingress_ip> - *.kuma.<ingress_domain>

<ingress_ip> - monitoring.<ingress_domain>

<ingress_ip> - agentserver.<ingress_domain>

<ingress_ip> - updater.<ingress_domain>

Распаковка утилиты KDT:

Выполните следующую команду, чтобы создать директорию и распаковать утилиту KDT:

mkdir ./kdt && tar -xvf bin.tar.gz -C ./kdt

Настройка системного времени для синхронизации с NTP-сервером:

1. Выполните следующие команды:

   sudo apt update

   sudo apt install -y systemd-timesyncd

   sudo timedatectl set-ntp true

   sudo timedatectl set-timezone Europe/Moscow

   sudo timedatectl set-local-rtc 0

   timedatectl status

   В выводе будет строка:

   System clock synchronized: yes

2. Чтобы проверить синхронизацию, выполните команду:

   date

   В выводе будет текущая дата и время.

Создание конфигурации для запуска установки

Легенда

• 10.0.0.100 – IP-адрес хоста, на котором выполняется развертывание (<host_ip>)
• 10.0.0.200 – IP-адрес, используемый для записи с подстановкой A на этапе настройки DNS (<ingress_ip>)
• user – учетная запись пользователя для развертывания (<user_name>)
• /home/user/.ssh/id_rsa – путь к закрытой части SSH-ключа, созданного на этапе настройки пользователя (<ssh_key_path>)
• xdr.mydomain.com – домен для входящего трафика (<ingress_domain>)

9.1 Указание параметров установки с помощью мастера настройки

1. Выполните следующую команду, чтобы запустить мастер настройки:

   ./bin/kdt wizard -k xdr-<версия_приложения>.tar -o params.yaml

2. Введите количество primary_nodes (не менее 1): 1
3. Введите IPv4-адрес первого управляющего узла: 10.0.0.100
4. Введите имя пользователя для подключения к первому управляющему узлу: user
5. Введите путь к SSH-ключу для подключения к первому управляющему узлу: /home/user/.ssh/id_rsa
6. Введите количество worker_nodes (0 – развертывание на одном узле, 3 и более – развертывание на нескольких узлах): 0
7. Введите 1, если требуется балансировщик нагрузки; в противном случае нажмите Enter: нажмите Enter
8. Введите строку подключения для доступа к СУБД: postgres://<dbms_username>:<password>@<fqdn>:<port>: postgres://xdr:<your_password>@10.0.0.100:5432
9. Требуется ввести IP-адрес шлюза кластера Kubernetes следующим образом: <ip_address>. Шлюз Kubernetes предназначен для подключения компонентов Kaspersky EDR Expert, установленных внутри кластера Kubernetes. Введите IP-адрес: 10.0.0.200
10. Требуется создать учетную запись пользователя Kaspersky EDR Expert. Введите пароль учетной записи пользователя Kaspersky EDR Expert, которая будет создана KDT во время установки. Пароль не может содержать менее 8 и более 256 символов. Пароль должен содержать прописные и строчные буквы, цифры и специальные символы. Введите пароль: ваш_пароль
11. Введите путь к файлу инвентаря KUMA: /dev/null
12. Введите путь к SSH-ключу, который используется для подключения к узлам со службами KUMA: /home/user/.ssh/id_rsa
13. Введите путь к файлу лицензионного ключа KUMA: /dev/null
14. Требуется доменное имя для публичных служб Kaspersky EDR Expert. Это доменное имя будет включено в доменные имена служб Kaspersky EDR Expert. Например, console.<domain name>. Введите доменное имя: xdr.mydomain.com
15. Введите путь к файлу пользовательского сертификата и закрытому ключу для публичных сервисов Kaspersky EDR Expert (если вы хотите использовать самоподписанный сертификат, нажмите Enter, чтобы пропустить этот шаг): нажмите Enter
16. Введите "Y", если в вашем регионе требуется расширенный жизненный цикл инцидентов: N
17. Введите имя учетной записи пользователя, используемой для просмотра метрик OSMP с помощью инструмента Grafana. Имя пользователя не может содержать менее 1 и более 30 символов. Имя пользователя должно начинаться с буквы и может содержать строчные буквы (от "a" до "z"), цифры (от "0" до "9") и специальные символы (_ -.): xdr
18. Введите пароль от учетной записи, используемой для просмотра метрик OSMP с помощью инструмента Grafana. Пароль не может содержать менее 8 и более 256 символов. Пароль должен содержать прописные и строчные буквы, цифры и специальные символы: ваш_пароль

9.2 Указание параметров установки с помощью конфигурационного файла

Шаблон конфигурационного файла (singlenode.smp_param.yaml.template) находится в дистрибутиве в архиве с утилитой KDT.

Значение параметра psql_dsn должно соответствовать URI-формату. Если URI-подключение включает специальные символы в любой из его частей, символы должны быть экранированы с помощью процентной кодировки.

Символы, которые требуется заменить в значении параметра psql_dsn:

• Пробел → %20
• ! → %21
• # → %23
• % → %25
• & → %26
• / → %2F
• : → %3A
• = → %3D
• ? → %3F
• @ → %40
• [ → %5B
• ] → %5D

Дополнительную информацию см. в статье Строка подключения PostgreSQL.

schemaType: ParameterSet

schemaVersion: 1.0.1

namespace: ""

name: bootstrap

project: xdr

nodes:

- desc: cdt-primary0

type: primary-worker

host: <host_ip>

access:

ssh:

user: <user_name>

key: <ssh_key_path>

parameters:

- name: psql_dsn

source:

value: postgres://xdr:<ваш_пароль>@<host_ip>:5432

- name: ingress_ip

source:

value: <ingress_ip>

- name: ssh_pk

source:

path: <ssh_key_path>

- name: admin_password

source:

value: "ваш_пароль"

- name: low_resources

source:

value: "true"

- name: openbao_ha_mode

source:

value: "false"

- name: default_class_replica_count

source:

value: "1"

- name: inventory

source:

value: /dev/null

- name: license

source:

value: /dev/null

- name: smp_domain

source:

value: "<ingress_domain>"

- name: pki_host_list

source:

value: "admsrv api console kuma monitoring updater"

- name: grafana_admin_user

source:

value: xdr

- name: grafana_admin_password

source:

value: "ваш_пароль"

Установка Kaspersky EDR Expert

Выполните следующую команду:

./bin/kdt apply --accept-eula -k xdr-<версия_приложения>.tar -i params.yaml

Если установка завершится успешно, в терминале будет отображена следующая информация:

INFO[0038] apply inventory ./conf.yaml

INFO[0039] preparing bootstrap_<версия>.tgz

INFO[0092] installing: bootstrap

INFO[0404] time: prepare 53.113895029s install 5m12.442326155s

INFO[0404] current installation is valid

INFO[0404] bundles will be published: 40

INFO[0536] bundles published 40

INFO[0536] bundles will be applied: 39

INFO[2450] apply done: 31m53.851140069s

INFO[2450] apply command completed successfully

INFO[2450] time: publish 2m11.679771805s install 31m53.930470045s

Чтобы проверить установку, требуется перейти на страницу авторизации. Для этого введите в строке поиска браузера:

console.<ingress_domain>

Где <ingress_domain> – FQDN, указанное на шаге 6 этой процедуры.