Администрирование (Linux) > Локальная установка системы > Подготовка к установке

RabbitMQ необходимо установить и настроить до развертывания системы Directum RX. При этом необходимо учитывать, что не поддерживается вариант установки RabbitMQ в контейнере, если Docker настроен в режиме Rootless.

Возможные варианты установки RabbitMQ:

•в docker-контейнере вместе с веб-сервером, если не используется режим Rootless;

•в docker-контейнере на отдельном сервере, если на компьютере с веб-сервером настроен Docker в режиме Rootless;

•вне docker-контейнера вместе с веб-сервером или на отдельном сервере.

Установка RabbitMQ

1.Распакуйте архив с Directum Launcher в локальную папку на сервере, если это не было сделано ранее. Для этого выполните команду:

tar -xvf <Имя архива> -С <Имя папки>

Пример команды:

tar -xvf DirectumLauncher.tar.gz -С /srv/DirectumLauncher

2.В папку с Directum Launcher скопируйте архив DockerImages.tar.gz с базовыми docker-образами, если на сервере отсутствует доступ к сети Интернет.

3.Установите Docker Engine, если это не сделано ранее.

4.Если конфигурационный файл config.yml ранее не был создан, создайте его на основе файла DirectumLauncher/etc/config.yml.example, который входит в комплект поставки. Для этого выполните команду:

cp /srv/DirectumLauncher/etc/config.yml.example /srv/DirectumLauncher/etc/config.yml

5.В конфигурационном файле config.yml в секции variables в переменной home_path укажите путь до папки с данными, например /srv/rxdata.

6.В секции services_config добавьте секцию SungeroRabbitMQ и заполните в ней параметры:

rabbitmq_data_path – папка для хранения данных RabbitMQ;

docker_tag – версия docker-образа RabbitMQ в формате <Имя образа>:<Версия образа>. Если при установке Directum RX для RabbitMQ нужно использовать версию docker-образа, которая отличается от поставляемой, измените значение параметра. В этом случае компонент загружается из библиотеки базовых образов Docker Hub. Если нужно загружать образ из другого репозитория, то в имени дополнительно укажите адрес для скачивания, например registry.directum.ru/public/rabbitmq:3.11.17-management.

Пример настройки:

SungeroRabbitMQ:

    rabbitmq_data_path: '{{ home_path }}/rabbitmq_data'
    docker_tag: 'registry.directum.ru/public/rabbitmq:3.11.17-management'

Примечание. При переходе на новую версию системы Directum RX ранее установленные базовые docker-образы RabbitMQ автоматически не обновляются.

7.Разверните контейнер RabbitMQ. Для этого в командной строке перейдите в папку с Directum Launcher и выполните команду:

./do.sh rabbitmq up

8.Настройте RabbitMQ.

Настройка RabbitMQ

ВАЖНО. Для значений параметров RabbitMQ учитывается регистр символов.

Чтобы настроить RabbitMQ:

1.Откройте страницу администрирования RabbitMQ. Для этого перейдите по ссылке http://<IP-адрес или имя компьютера с RabbitMQ>:15672. В открывшемся окне заполните поля: login – guest, password – guest.

2.На открывшейся странице создайте пользователя с правами администратора. Для этого перейдите на вкладку «Admin» и в разделе «Add a user» заполните поля Username, Password – логин и пароль администратора RabbitMQ. Права администратора в дальнейшем нужны для создания пользователя, от имени которого система Directum RX будет подключаться к RabbitMQ.

3.В поле Tags выберите значение Admin и нажмите на кнопку Add user.

4.Завершите сеанс пользователя guest. Затем повторно откройте страницу администрирования RabbitMQ и в открывшемся окне укажите логин и пароль созданного пользователя.

5.Удалите пользователя guest. Для этого на вкладке «Admin» выберите в списке пользователя guest и в разделе «Delete this user» нажмите на кнопку Delete.

6.Создайте виртуальный хост RabbitMQ для работы с Directum RX. Для этого на вкладке «Admin» на панели справа перейдите в группу Virtual Hosts и в разделе «Add a new virtual host» в поле Name заполните название хоста, например, rxhost. Затем нажмите на кнопку Add virtual host.

7.На панели справа перейдите в группу Users.

8.Создайте пользователя, от имени которого система Directum RX сможет подключаться к RabbitMQ. Для этого на вкладке «Admin» в разделе «Add a user» заполните поля Username, Password – логин и пароль пользователя. Затем в поле Tags выберите значение None и нажмите на кнопку Add user.

9.Выберите созданного пользователя в списке, затем в разделе «Permissions» в поле Virtual Host выберите созданный виртуальный хост и нажмите на кнопку Set permission.

10.В разделе «Topic permissions» в поле Virtual Host выберите созданный виртуальный хост и нажмите на кнопку Set topic permission.

Подробнее об установке RabbitMQ см. в документации на сайте продукта, статья Documentation: Table of Contents.

Когда настройка завершена, из соображений безопасности рекомендуется отключить страницу администрирования RabbitMQ. Для этого в Directum Launcher перейдите в режим Настройка. Затем в конфигураторе в секции RabbitMQ добавьте параметр management_panel_disabled и установите для него флажок.