Первоначальная установка и настройка on Alertix

Порядок настройки хостов перед установкой кластеров и ресиверов, использующих Java

Mon, 01 Jan 0001 00:00:00 +0000

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

Используйте команду:

jlink --verbose --add-modules ALL-MODULE-PATH --compress 2 --strip-debug --no-header-files --no-man-pages --output /usr/lib/jvm/java-jlink

В результате по пути /usr/lib/jvm/java-jlink будет сформирован набор компонентов для работы Java.

Для корректного монтирования Java в контейнеры необходимо создать ссылку:

Установка Java на хост

Mon, 01 Jan 0001 00:00:00 +0000

Для установки Java используются два типа пакетов: DEB и RPM.

Проверка версии Java

Перед установкой необходимо проверить, наличие Java версии 21. Для этого выполните следующую команду:

which java
echo $?

Если команда echo $? возвращает 0, значит Java уже установлена. Узнать текущую версию можно с помощью команды:

java --version

Пример вывода:

openjdk 11.0.24 2024-07-16
OpenJDK Runtime Environment (build 11.0.24+8-post-Ubuntu-1ubuntu322.04)
OpenJDK 64-Bit Server VM (build 11.0.24+8-post-Ubuntu-1ubuntu322.04, mixed mode, sharing)

Если версия Java не соответствует требуемой (например, установлена Java 11 вместо Java 21), необходимо удалить существующую версию и установить нужную.

Первоначальная установка

Mon, 01 Jan 0001 00:00:00 +0000

Перед установкой Платформы необходимо проверить, чтобы на настраиваемой машине был отключен swap, для этого используется команда free.

Рисунок 1.

Если у swap в столбце Total не 0, то swap включен, и его необходимо отключить следующей командой:

sudo swapoff -a

Затем в /etc/fstab нужно закомментировать строки, где есть swap:

sudo vi /etc/fstab

Например:

Рисунок 2.

Командой lsblk нужно проверить, чтобы на сервере присутствовал раздел с raid и раздел(ы) для данных. А также удостовериться, что на сервере установлено необходимое количество ОЗУ, CPU и HDD в каждом разделе (согласно "Руководству по планированию установки и масштабированию").

Порядок действий при сбое установки стартовых компонентов платформы

Mon, 01 Jan 0001 00:00:00 +0000

При первичной установке Платформы после запуска консоли управления в процессе установки нескольких компонентов могут возникнуть сбои.

После исправления причин сбоя, необходимо установить отсутствующие компоненты.

В случае, когда сбой произошел на этапе установки кластера координатора, перезагрузите контейнер backend командой:

sudo docker restart backend

Установка начнется заново, модуль сбора журналов и сервис мониторинга установятся автоматически.

В случае, когда сбой произошел на этапе установки filebeat, выполните повторную настройку хоста консоли управления в Обслуживание > Управление хостами. После настройки хоста переустановите сервис Watchdog.

Порядок установки Платформы Alertix на Astra Linux

Mon, 01 Jan 0001 00:00:00 +0000

Для подготовки сервера, на базе ОС Astra Linux 1.8 SE необходимо подготовить конфигурационный файл config.json для Docker, который должен располагаться в директории /root/.docker/.

Данный конфигурационный файл выглядит следующим образом:

{
 "auths": {
 "registry.ngrsoftlab.ru": {
 "auth": "cXdlcXdlOjEyMzEyMw=="
 }
 }
}

Где в секции auth содержатся логин и пароль (в формате login:password), закодированные в Base64.

Необходимо создать данный файл и закодировать в Base64 логин и пароль, которые будут предоставлены для установки Alertix.

Порядок установки Платформы Alertix на RedOS

Mon, 01 Jan 0001 00:00:00 +0000

Подготовка сервера к установке Alertix

echo "alertix ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/alertix
sudo usermod -a -G wheel alertix
# отключаем swap
sudo swapoff -a
sudo sed -i '/ swap / s/^/#/' /etc/fstab

Установка и настройка необходимых пакетов

# обновляем и устанавливаем необходимые пакеты
sudo dnf update -y && sudo dnf upgrade -y

# перезапуск после обновлений
sudo reboot

# установка
sudo dnf install docker-ce \
 docker-ce-cli \
 containerd \
 openssh-server \
 curl \
 python3 \
 python3-docker \
 python3-pip \
 pass \
 postgresql \
 net-tools \
 jq \
 java-21-openjdk-headless \
 java-21-openjdk-devel \
 java-21-openjdk-jmods \
 -y

# настройка docker
sudo systemctl enable --now docker
sudo systemctl enable --now docker.socket
pip3 install pexpect

# настройка java
sudo jlink --verbose --add-modules ALL-MODULE-PATH --compress 2 --strip-debug --no-header-files --no-man-pages --output /usr/lib/jvm/java-jlink
sudo ln -nfs /usr/lib/jvm/java-jlink /usr/lib/jvm/jdk

Порядок установки Платформы Alertix на SberLinux

Mon, 01 Jan 0001 00:00:00 +0000

Подготовка сервера к установке Alertix

echo "alertix ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/alertix
sudo usermod -a -G wheel alertix

# отключаем swap
sudo swapoff -a
sudo sed -i '/ swap / s/^/#/' /etc/fstab

Установка и настройка необходимых пакетов

# добавляем репозиторий epel
sudo dnf install -y https://dl.fedoraproject.org/pub/epel/9/Everything/x86_64/Packages/e/epel-release-9-10.el9.noarch.rpm
sudo dnf update

# добавляем и настраиваем репозиторий для docker
sudo dnf install dnf-plugins-core -y
sudo dnf-3 config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
sudo sed -i 's/$releasever/9/g' /etc/yum.repos.d/docker-ce.repo && sudo sed -i 's/$basearch/x86_64/g' /etc/yum.repos.d/docker-ce.repo
sudo dnf clean all && sudo dnf update

# устанавливаем необходимые пакеты
sudo dnf install docker-ce \
 docker-ce-cli \
 containerd.io \
 openssh-server \
 curl \
 python3 \
 python3-docker \
 pass \
 postgresql \
 net-tools \
 jq \
 java-21-openjdk-headless \
 java-21-openjdk-devel \
 java-21-openjdk-jmods \
 -y

# настройка docker
sudo systemctl enable --now docker
sudo systemctl enable --now docker.socket

# настройка java
sudo jlink --verbose --add-modules ALL-MODULE-PATH --compress 2 --strip-debug --no-header-files --no-man-pages --output /usr/lib/jvm/java-jlink
sudo ln -nfs /usr/lib/jvm/java-jlink /usr/lib/jvm/jdk

Установка корпоративного сертификата

Mon, 01 Jan 0001 00:00:00 +0000

Как было указано ранее при установке консоли Alertix создается самоподписанный сертификат, который используется при установлении HTTPS соединений с интерфейсами консоли и OpenSearch Dashboards. Расположение файлов с закрытыми ключами и сертификатами приведено в таблице ниже.

Таблица 1. Расположение файлов с закрытыми ключами и сертификатами
Компонент	Путь	Права доступа	Владелец	Описание
Backend	/opt/alertix/platform/ssl/certs/server_own_ca_signed.crt	-rw-r—r--	root:root	Сертификат компонента Backend в формате PEM
Backend	/opt/alertix/platform/ssl/keys/server.key	-rw-r-----	root:systemd-coredump	Закрытый ключ компонента Backend в формате PEM
OpenSearch Dashboards	/opt/alertix/dashboards /dashboards.crt	-rw-r—r--	alertix:alertix	Сертификат компонента OpenSearch Dashboards в формате PEM
OpenSearch Dashboards	/opt/alertix/dashboards /dashboards.key	-rw-------	alertix:alertix	Закрытый ключ компонента OpenSearch Dashboards в формате PEM

Для установки корпоративных (доверенных) сертификатов требуется скопировать на место указанных файлов сертификаты, подписанные Корпоративным Центром Сертификации. Закрытые ключи можно как сгенерировать самостоятельно, так и воспользоваться имеющимися. Сертификаты должны содержать все расширения, присутствующие в уже выписанных сертификатах, установленных в инсталляции. Пример вывода информации о существующих расширениях для сертификата OpenSearch Dashboards приведен ниже:

Установка лицензии

Mon, 01 Jan 0001 00:00:00 +0000

Платформа является лицензируемым ПО с бессрочно выдаваемой лицензией. Информация о выданной Заказчику лицензии в Платформе представлена в виде лицензионного файла, содержащего соответствующую информацию. Лицензионный файл передается Заказчику вместе с экземпляром ПО для загрузки в управляющий интерфейс.

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

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

Изменение паролей по умолчанию

Mon, 01 Jan 0001 00:00:00 +0000

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

Рисунок 1.

Пароль должен соответствовать следующим требованиям:

длина не менее 12 символов;
наличие в пароле не менее одного буквенного и одного цифрового символа;
один и тот же символ не должен встречаться в пароле более трех раз.

Установка Data-cluster

Mon, 01 Jan 0001 00:00:00 +0000

На данном этапе выполняется установка подсистемы хранения (Opensearch) платформы и проверяется выполнение соответствующих требований к аппаратной конфигурации и корректности выполненных подготовительных мероприятий согласно разделам, описанным в "Руководстве по планированию установки и масштабированию" (требования к аппаратной конфигурации, подготовка к установке).

Для выполнения установки Data-cluster выберите в меню "Обслуживание" блок "Кластеры".

Рисунок 1.

На открывшейся странице выберите операцию "Data-кластер".

Рисунок 2.

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

Один хост, один докер-узел – неотказоустойчивая облегченная схема. Требует минимальных аппаратных ресурсов. Выход из строя или сбой одного из томов дисковой подсистемы может привести к потере данных.
Один хост, три докер-узла - схема с репликацией, обеспечивает непрерывную работу кластера Opensearch без потери данных, в случае выхода из строя или сбоя одного из томов дисковой системы. Позволяет выполнять операции перезапуска узлов кластера, без прерывания работы.
Один хост, hot-warm - схема из двух быстрых узлов и двух обычных узлов кластера Opensearch. Применяется при высокой нагрузке и необходимости длительного хранения данных. Схема с репликацией обеспечивает непрерывную работу кластера без потери данных, в случае выхода из строя или сбоя одного из томов дисковой системы и позволяет выполнять операции перезапуска узлов кластера, без прерывания работы.
Три хоста - отказоустойчивая схема. Узлы кластера Opensearch располагаются на разных серверах. Обеспечивается непрерывная работа при сбое или выходе из строя одного сервера целиком или одного из томов дисковой системы.
Три хоста, hot-warm - отказоустойчивая схема. Применяется при высокой нагрузке и необходимости длительного хранения данных. Узлы кластера Opensearch располагаются на разных серверах. На каждом сервере располагается 2 узла: один быстрый и один обычный. Обеспечивается непрерывная работа при выходе из строя одного сервера.

Установка в изолированных средах

Mon, 01 Jan 0001 00:00:00 +0000

При необходимости установки и обновления в изолированных от Интернет сегментах сети необходимо развернуть локальную копию репозитория обновлений. Для этого необходимо добавление в локальный DNS записи для registry.ngrsoftlab.ru и выпуск сертификата для возможности установления https соединений. Содержимое локального репозитория, в т.ч. обновления, передаются производителем как tar-архивы <имякомпонента>.tar по запросу на адрес support@ngrsoftlab.ru.

Начиная с версии 3.9.1, установка и обновление Alertix возможны и без докер-репозитория. Для этого при запуске инсталлера для обновления/установки укажите переменную окружения REMOTE_REGISTRY=0. Для проверки доступных версий без докер-репозитория нужный образ должен быть на хосте консоли управления, даже если компонент устанавливается на другой хост инсталляции. При сохранении образа на хост, его имя должно быть таким, как если бы образ был скачан из репозитория, с хостом консоли в адресе (например, alertixdemo.ngrsoftlab.ru/platform-back:3.9.1)