Для повышения производительности в системах с большим объемом входящего документопотока рекомендуется распределить сервисы на несколько узлов. В качестве узлов могут выступать физические серверы или виртуальные машины.

Чтобы ускорить и упростить процесс установки, используется инструмент управления конфигурациями Ansible, который входит в состав компонента Directum Launcher.

Для установки с помощью Ansible разворачивается:

•управляющий узел (control node) с операционной системой Linux;

•управляемые узлы (managed node) либо операционной системой Linux, либо с Microsoft Windows. На них разворачиваются сервисы Ario. Среди управляющих узлов определяются:

•главный сервер (main_host), на который нужно установить основные сервисы: Directum Smart Service, Rabbit MQ и Directum Storage Service;

•второстепенные сервера, на которые распределяются сервисы, которые не развернуты на главном сервере:

Чтобы установить сервисы в распределенной системе:

1.Разверните управляющий и управляемые узлы. Убедитесь, управляемые узлы они соответствуют требованиям. Подробнее см. в документе «Directum RX. Типовые требования к аппаратному и программному обеспечению».

2.Выполните подготовительные действия. Подробнее см. раздел «Подготовка к установке» для Windows и Linux.

Примечание. Для работы по защищенному протоколу HTTPS нужно установить SSL-сертификат на все управляемые узлы.

3.Настройте защищенное подключение к управляемым узлам по сетевому протоколу SSH.

4.Определите состав сервисов для каждого узла согласно рекомендациям:

•на главный сервер (main host) устанавливаются сервисы Directum Smart Service, Directum Storage Service и Rabbit MQ. Также на этот сервер можно установить другие сервисы Ario;

• на второстепенные сервера устанавливается либо одинаковый набор сервисов Ario, либо на второстепенные серверы устанавливается по одному сервису Ario.

В таблице приведены примеры распределения сервисов на серверах с Linux:

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

5.Архив с Directum Launcher распакуйте в локальную папку на управляющем узле с помощью команды:

tar -xvf <Путь до архива> -С <Путь до папки>

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

tar -xf /home/user/DirectumLauncher.tar.gz -C /home/user/DirectumLauncher

ВАЖНО. Для корректной установки общий путь к файлам должен быть не более 256 символов. Также он не должен содержать пробелы, символы кириллицы, запятые и спецсимволы. Поэтому используйте, например, папку /srv/DirectumLauncher. В зависимости от настроек операционной системы для дальнейших действий могут потребоваться права суперпользователя.

6.В папку с Directum Launcher скопируйте ключ активации и архивы:

•Ario.tar.gz – компонент с сервисами Ario;

•DirectumLauncher.tar.gz – компонент Directum Launcher;

• ArioBaseImages.tar.gz – базовые docker-образы для сервисов, если на серверах отсутствует доступ к сети Интернет;

• Ario.zip и DirectumLauncher.zip – с компонентами Directum Ario и Directum Launcher соответственно.

7.Добавьте компонент с сервисами Ario с помощью команды:

./do.sh components add ario

8.Создайте конфигурационный файл config.yml на основе файла DirectumLauncher/etc/config.yml.example. Сгенерируйте настройки установки сервисов с помощью команды:

./do.sh ario generate_config_yaml --distributed

В результате:

•в папке DirectumLauncher/etc генерируется конфигурационный файл config.yml. В него добавляются параметры с настройками сервисов Ario;

•в папке DirectumLauncher/etc/ansible создаются:

ansible.cfg – конфигурационный файл, в котором задается путь до inventory-файла;

hosts.yml – inventory-файл, содержащий список узлов, на которых выполняются задачи с помощью Ansible;

ario_playbook.yml – плейбук со списком задач, которые нужно выполнять на узлах;

•в папке DirectumLauncher/plugin/ansible/roles создается папка с ролью компонента сервисов ario_component_role, которая используется в плейбуке.

9. Если планируете устанавливать сервисы Ario на управляемый узел с Microsoft Windows, создайте для него конфигурационный файл windows_config.yml.

10.В inventory-файле hosts.yml в секции ario_group укажите список управляемых узлов. Подробное описание inventory-файла см. в документации Ansible статью How to build your inventory.

Важно. Менять название секции main_host нельзя.

В секции узла заполните параметры:

•ansible_host – IP-адрес сервера;

•ansible_hostname – DNS-имя сервера;

•ansible_shell_type – тип оболочки для выполнения команд. В параметре укажите значение cmd. Настройка задается только для серверов с Microsoft Windows;

•ansible_connection – тип подключения к удаленному серверу. В параметре укажите значение ssh. Настройка задается только для серверов с Microsoft Windows;

•ansible_ssh_private_key_file – путь до закрытого SSH-ключа;

•ansible_user – пользователь, от имени которого происходит подключение к серверу;

•included_services – список сервисов Directum Ario, которые нужно установить на узле. В качестве значения указываются сокращенные названия сервисов в нижнем регистре без спецсимволов. Например, Directum Smart Service – dss, Directum Fact Extractor Service R – dfesr. Нужное название можно найти в разделе «Архитектура сервисов Ario»;

•excluded_services – список сервисов Directum Ario, которые не нужно устанавливать на узле. В качестве значения указываются сокращенные названия сервисов в нижнем регистре без спецсимволов. Например, Directum Smart Service – dss, Directum Fact Extractor Service R – dfesr.

Подробнее о настройках см. в документации Ansible статью Ansible Configuration Settings.

Пример настройки hosts.yml для Linux

all:

  children:
    ario_group:
      hosts:
        main_host: #reserved section name
          ansible_host: '192.168.0.3'
          ansible_hostname: server
          ansible_ssh_private_key_file: /home/administrator/.ssh/id_rsa
          ansible_user: administrator
          excluded_services: "dtes;ddas;ddds"
        linux_host_ario_1:
          ansible_host: '192.168.0.1'
          ansible_hostname: server1
          ansible_ssh_private_key_file: /home/administrator/.ssh/id_rsa
          ansible_user: administrator
          included_services: "ddas;ddds;dtes"
        linux_host_ario_2:
          ansible_host: '192.168.0.2'
          ansible_hostname: server2
          ansible_ssh_private_key_file: /home/administrator/.ssh/id_rsa
          ansible_user: administrator
          included_services: "ddas;ddds;dtes"
      vars:
        config_path: "<Путь до конфигурационного файла config.yml>"
        home_dl: "{{ ansible_user_dir }}/home_dl"

Пример настройки hosts.yml для Windows

all:

  children:
    ario_group:
      hosts:
        main_host: #reserved section name
          ansible_host: '192.168.0.3'
          ansible_hostname: server
          ansible_shell_type: "cmd"
          ansible_connection: ssh
          ansible_ssh_private_key_file: /home/administrator/.ssh/id_rsa
          ansible_user: administrator
          excluded_services: "dtes;ddas;ddds"
        windows_host_ario_1:
          ansible_host: '192.168.0.1'
          ansible_hostname: server1
          ansible_shell_type: "cmd"
          ansible_connection: ssh
          ansible_ssh_private_key_file: /home/administrator/.ssh/id_rsa
          ansible_user: administrator
          included_services: "ddas;ddds"
        windows_host_ario_2:
          ansible_host: '192.168.0.2'
          ansible_hostname: server2
          ansible_shell_type: "cmd"
          ansible_connection: ssh
          ansible_ssh_private_key_file: /home/administrator/.ssh/id_rsa
          ansible_user: administrator
          included_services: "dtes"
      vars:
        config_path: "<Путь до конфигурационного файла windows_config.yml>"
        home_dl: "C:/home_dl"

11.В секции vars задайте общие настройки для всех узлов:

•config_path – путь до конфигурационного файла windows_config.yml на управляющем узле. Если для каждого узла создан свой конфигурационный файл config.yml, добавьте этот параметр в секциях соответствующих узлов;

•home_dl – путь до папки, в которую нужно распаковать Directum Launcher на управляемых узлах.

12.Сохраните настройки.

13.На узлах с операционной системой Linux настройте управление контейнерами с помощью инструмента Docker Swarm.

14.Проверьте подключение к управляемым узлам. Для этого выполните команду:

./do.sh ansible-ping --remote=ario_group

15.Установите сервисы Directum Ario на все узлы с помощью команды:

./do.sh ansible-playbook <Путь до файла ario_playbook.yml>

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

./do.sh ansible-playbook /home/administrator/DirectumLauncher/etc/ansible/ario_playbook.yml

СМ. ТАКЖЕ