Первоначальная установка и настройка 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 версии 17. Для этого выполните следующую команду:

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 17), необходимо удалить существующую версию и установить нужную.

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

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.

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

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.

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

длина не менее 8 символов;
содержание не менее 3-х групп символов – символы верхнего регистра, символы нижнего регистра, цифры, спецсимволы (знаки пунктуации).

Установка 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.

Пример установки и настройки собственного локального репозитория - https://docs.docker.com/registry/deploying/

Допускается использование любого другого продукта, обеспечивающего docker api v2.

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