Интеллектуальные возможности > Сервисы Directum Ario > Администрирование сервисов Ario (Windows) > Установка сервисов Ario > Порядок установки

1.Из полученного дистрибутива скопируйте архив с сервисами Directum Ario – ario<номер версии сервисов>.zip – в корень папки Directum Launcher.

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

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

do components add ario

3.Создайте конфигурационный файл config.yml на основе файла DirectumLauncher/etc/config.yml.example. Если он был создан ранее, пропустите шаг.

4.Сгенерируйте настройки установки сервисов с помощью команды:

do ario generate_config_yaml

3.Откройте конфигурационный файл config.yml и в секции variables задайте параметры подключения к базам данных и RabbitMQ, а также другие параметры.

Структура сеции variables:

variables:

ARIO_DATABASE_ENGINE: '{используемая СУБД}'

ARIO_PG_CONNECTION_STRING: '{строка подключения к базе данных Smart Service};'

ARIO_PG_CONNECTION_STRING_DIS: '{строка подключения к базе данных Smart Service};'

ARIO_QUEUE_CONNECTION_STRING: '{строка подключения к очереди сообщений RabbitMQ}'

ARIO_STORAGE_SERVICE_URL: '{хост для хранения оперативных данных}'

ARIO_STORAGE_SERVICE_PORT: {порт подключения к сервису Storage Service}

ARIO_STORAGE_SERVICE_LOGIN: '{логин для подключения к сервису Storage Service}'

ARIO_STORAGE_SERVICE_PASSWORD: '{пароль для подключения к сервису Storage Service}'

ARIO_IDENTITY_SERVICE_PORT: {порт подключения к сервису Identity Service}

ARIO_RABBIT_INSTALL_PATH: '{путь до RabbitMQ}'

ARIO_INSTALL_PATH: '{путь до папки установки}'

ARIO_LOG_PATH: '{путь до лог-файлов}'

ARIO_ACTIVATION_KEY_PATH: '{путь до ключа активации}'

ARIO_DSS_PORT: {порт для подключения к сервису Smart Service}

ARIO_APM_SERVER_HOST: {адрес контейнера с сервисом Elastic APM Service}

ARIO_APM_SERVER_PORT: {внутренний порт для подключения к сервису Elastic APM Service}

Где:

•параметры подключения к базам данных Smart Service или Identity Service. Для этого в строках подключения к базам данных ARIO_PG_CONNECTION_STRING и ARIO_PG_CONNECTION_STRING_DIS соответственно задайте параметры:

User ID – логин для подключения к базе данных. Значение по умолчанию postgres;

Password – пароль для подключения к базе данных. Не допускается использование пустого пароля. Для корректной работы сервисов в пароле не рекомендуется использовать спецсимволы: ‘ # @ \ \ : * ? “ < > |;

Host – имя компьютера, на котором установлена СУБД. Если при установке PostgreSQL имя компьютера по умолчанию было изменено, укажите имя сервера в формате <Имя компьютера>\<Имя экземпляра>;

Port – порт для подключения к базе данных. Если СУБД установлена локально, то значение по умолчанию берется из ветки реестра HKEY_LOCAL_MACHINE\SOFTWARE\PostgreSQL\Services\postgresql-x64-9.6\Port. Иначе подставляется значение 5432;

Datadase – имя базы данных. Укажите имя ранее созданной базы данных или задайте имя новой. Если указать имя новой базы данных, то она создается при первом запуске сервисов. Значения по умолчанию: Ario_Smart_Service – для базы данных Smart Service; Ario_Identity_Service – для базы данных Identity Service.

•параметры подключения к RabbitMQ. На каждом сервере в строке подключения ARIO_QUEUE_CONNECTION_STRING необходимо задать одинаковые параметры:

Port – порт для подключения к RabbitMQ. Значение по умолчанию 5672;

virtualHost – виртуальный хост RabbitMQ для работы с сервисами Ario, например ario_host;

username – логин для подключения к RabbitMQ. Для установки на один сервер значение по умолчанию – guest. Для установки на нескольких серверах укажите логин вручную, так как использование учетной записи guest запрещено;

password – пароль для подключения к RabbitMQ.

ВАЖНО. Для корректной работы сервисов не рекомендуется в логине и пароле для подключения к RabbitMQ использовать спецсимволы: ‘ # @ \ \ : * ? “ < > |.

hostname – сервер, на котором установлен брокер сообщений RabbitMQ. Значение по умолчанию localhost;

Exchange – точка обмена, к которой привязываются очереди сообщений веб-сервера. Также используется для наименования очередей сообщений. Имя каждой точки должно быть уникальным и не повторять имена точек, которые добавлены в RabbitMQ по умолчанию. Задайте новую точку обмена, например Ario_Exchange. Она создается во время установки системы;

•значения остальных параметров:

ARIO_STORAGE_SERVICE_URL – хост, на котором необходимо развернуть Directum Storage Service. Значение по умолчанию localhost;

ARIO_STORAGE_SERVICE_PORT – порт для подключения к сервису Directum Storage Service. Значение по умолчанию 9021;

ARIO_IDENTITY_SERVICE_PORT – порт для подключения к сервису Directum Identity Service. Значение по умолчанию 9030;

ARIO_LOG_PATH – относительный или полный путь до папки с лог-файлами и файлами трассировки. Значение по умолчанию C:\SMART\logs;

ARIO_INSTALL_PATH – относительный или полный путь до папки установки сервисов Directum Ario. Значение по умолчанию C:\interpub\Ario.

Примечание. Убедитесь, что у встроенных учетной записи «IUSR» и группы «IIS_IUSRS» есть права на полный доступ к указанной папке. При необходимости выдайте им права.

ARIO_ACTIVATION_KEY_PATH – относительный или полный путь до ключа активации.

Пример секции variables:

variables:
  ARIO_PG_CONNECTION_STRING: {строка подключения к базе данных Smart Service};
  ARIO_PG_CONNECTION_STRING_DIS: {строка подключения к базе данных Smart Service};
  ARIO_QUEUE_CONNECTION_STRING: {строка подключения к очереди сообщений RabbitMQ}
  ARIO_STORAGE_SERVICE_URL: {хост для хранения оперативных данных}
  ARIO_STORAGE_SERVICE_PORT: {порт подключения к сервису Storage Service}
  ARIO_IDENTITY_SERVICE_PORT: {порт подключения к сервису Identity Service}
  ARIO_LOG_PATH: {путь до лог-файлов}
  ARIO_INSTALL_PATH: {путь до папки установки}
  ARIO_ACTIVATION_KEY_PATH: {путь до ключа активации}

6.В конфигурационном файле config.yml в секции services_config проверьте значения параметров установки сервисов.

Структура секции services_config:

services_config:
  ArioRabbitMQ:
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
  ArioStorageService:
    PORT: '{{ ARIO_STORAGE_SERVICE_PORT }}'
    LOGIN: '{{ ARIO_STORAGE_SERVICE_LOGIN }}'
    PASSWORD: '{{ ARIO_STORAGE_SERVICE_PASSWORD }}'
  ArioElasticApm:
    PORT: '{{ ARIO_APM_SERVER_PORT }}'
    TRACES_PATH: '{{ ARIO_LOG_PATH }}/traces'
  ArioIdentityService:
    PORT: '{{ ARIO_IDENTITY_SERVICE_PORT }}'
    DATABASE_ENGINE: '{{ ARIO_DATABASE_ENGINE }}'
    CONNECTION_STRING: '{{ ARIO_PG_CONNECTION_STRING_DIS }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/IdentityService'
  ArioSmartService:
    PORT: '{{ ARIO_DSS_PORT }}'
    DATABASE_ENGINE: '{{ ARIO_DATABASE_ENGINE }}'
    CONNECTION_STRING: '{{ ARIO_PG_CONNECTION_STRING }}'
    STORAGE_ENDPOINT: '{{ ARIO_STORAGE_SERVICE_URL }}:{{ ARIO_STORAGE_SERVICE_PORT }}'
    STORAGE_LOGIN: '{{ ARIO_STORAGE_SERVICE_LOGIN }}'
    STORAGE_PASSWORD: '{{ ARIO_STORAGE_SERVICE_PASSWORD }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    IDENTITY_SERVICE: 'http://localhost:{{ ARIO_IDENTITY_SERVICE_PORT }}'
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/SmartService'
  ArioPublishingService:
    PORT: {Порт для подключения к сервису Publishing Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/PublishingService'
  ArioTextExtractorService:
    PORT: {Порт для подключения к сервису Text Extractor Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/TextExtractorService'
    QUEUE_POLICIES:
      - QUEUE_POLICY_NAME: 'ARIO_EXTRACT_TEXT_POLICY'
        QUEUE_POLICY_FILTER: '(?!.*reply)ario-extract-text'
        QUEUE_POLICY_VALUE: '{"consumer-timeout":86400000}'
  ArioDocumentDisassemblerService:
    PORT: {Порт для подключения к сервису Document Disassembler Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/DocumentDisassemblerService'
  ArioDocumentAssemblerService:
    PORT: {Порт для подключения к сервису Document Assembler Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/DocumentAssemblerService'
  ArioFactExtractorService:
    PORT: {Порт для подключения к сервису Fact Extractor Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/FactExtractorService'
  ArioFactExtractorRulesService:
    PORT: {Порт для подключения к сервису Fact Extractor Rules Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}?heartbeat=300'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/FactExtractorRulesService'
  ArioFactExtractorLearnService:
    PORT: {Порт для подключения к сервису Fact Extractor Learn Service}
    DATABASE_ENGINE: '{{ ARIO_DATABASE_ENGINE }}'
    CONNECTION_STRING: '{{ ARIO_PG_CONNECTION_STRING }}'
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}?heartbeat=36000'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/FactExtractorLearnService'
    QUEUE_POLICIES:
      - QUEUE_POLICY_NAME: 'ARIO_FACT_TRAIN_POLICY'
        QUEUE_POLICY_FILTER: '(?!.*reply)ario-facts-(train|retrain)'
        QUEUE_POLICY_VALUE: '{"consumer-timeout":250000000}'
  ArioObjectDetectionService:
    PORT: {Порт для подключения к сервису Object Detection Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/ObjectDetectionService'
  ArioImageClassifierService:
    PORT: {Порт для подключения к сервису Image Classifier Service}
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/ImageClassifierService'
  ArioTextClassifierService:
    PORT: {Порт для подключения к сервису Text Classifier Service}
    DATABASE_ENGINE: '{{ ARIO_DATABASE_ENGINE }}'
    CONNECTION_STRING: '{{ ARIO_PG_CONNECTION_STRING }}'
    QUEUE_CONNECTION_STRING: '{{ ARIO_QUEUE_CONNECTION_STRING }}'
    APM_ENDPOINT: 'http://{{ ARIO_APM_SERVER_HOST }}:{{ ARIO_APM_SERVER_PORT }}'
    LOG_PATH: '{{ ARIO_LOG_PATH }}/TextClassifierService'
    QUEUE_POLICIES:
      - QUEUE_POLICY_NAME: 'ARIO_CLASSIFIER_TRAIN_POLICY'
        QUEUE_POLICY_FILTER: '(?!.*reply)ario-classifier-(train|retrain)'
        QUEUE_POLICY_VALUE: '{"consumer-timeout":250000000}'

Где:

ArioRabbitMQ – секция с параметрами установки брокера сообщений RabbitMQ:

•QUEUE_CONNECTION_STRING – строка подключения к RabbitMQ. По умолчанию используется значение, указанное в параметре ARIO_QUEUE_CONNECTION_STRING.

ArioStorageService – секция с параметрами установки сервиса Directum Storage Service:

•PORT – порт для подключения к сервису Directum Storage Service. По умолчанию используется значение, указанное в параметре ARIO_STORAGE_SERVICE_PORT;

•LOGIN – логин для подключения к сервису Directum Storage Service. По умолчанию используется значение, указанное в параметре ARIO_STORAGE_SERVICE_LOGIN;

•PASSWORD – пароль для подключения к сервису Directum Storage Service. По умолчанию используется значение, указанное в параметре ARIO_STORAGE_SERVICE_PASSWORD.

ArioElasticApm – секция с параметрами установки сервиса Directum Elastic APM Service:

•PORT – порт для подключения к сервису Directum Elastic APM Service. По умолчанию используется значение, указанное в параметре ARIO_APM_SERVER_PORT;

•TRACES_PATH – папка, в которую записываются файлы трассировки запросов к сервисам Ario. По умолчанию используется значение <Путь до лог-файлов>/Traces, где в качестве пути до лог-файлов используется значение параметра ARIO_LOG_PATH.

ArioIdentityService – секция с параметрами установки сервиса Directum Identity Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9030;

•DATABASE_ENGINE – используемая СУБД. По умолчанию используется значение, указанное в параметре ARIO_DATABASE_ENGINE;

•CONNECTION_STRING – строка подключения к базе данных Smart Service. По умолчанию используется значение, указанное в параметре ARIO_PG_CONNECTION_STRING;

•APM_ENDPOINT – URL-адрес для подключения к сервису Elastic APM Service. По умолчанию используется значение <адрес контейнера с сервисом>:<внутренний порт>, где в качестве адреса и порта используются значения, указанные в параметрах ARIO_APM_SERVER_HOST и ARIO_APM_SERVER_PORT соответственно;

•LOG_PATH – путь до лог-файлов сервиса. По умолчанию используется значение <Путь до лог-файлов>/IdentityService, где в качестве пути до лог-файлов используется значение параметра ARIO_LOG_PATH.

ArioSmartService – секция с параметрами установки сервиса Directum Smart Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 61100;

•DATABASE_ENGINE – используемая СУБД. По умолчанию используется значение, указанное в параметре ARIO_DATABASE_ENGINE;

•STORAGE_ENDPOINT – URL-адрес для подключения к сервису хранения объектов Storage Service. По умолчанию используется значение <адрес контейнера с сервисом>:<внутренний порт>, где в качестве адреса и порта используются значения, указанные в параметрах ARIO_APM_SERVER_HOST и ARIO_APM_SERVER_PORT соответственно;

•STORAGE_LOGIN – логин для подключения к сервису Directum Storage Service. По умолчанию используется значение, указанное в параметре ARIO_STORAGE_SERVICE_LOGIN;

•STORAGE_PASSWORD – пароль для подключения к сервису Directum Storage Service. По умолчанию используется значение, указанное в параметре ARIO_STORAGE_SERVICE_ PASSWORD;

•IDENTITY_SERVICE – адрес сервиса Identity Service. Рекомендуется не менять значение по умолчанию localhost;

•QUEUE_CONNECTION_STRING – строка подключения к RabbitMQ. По умолчанию используется значение, указанное в параметре ARIO_QUEUE_CONNECTION_STRING;

•LOG_PATH – путь до лог-файлов сервиса. По умолчанию используется значение <Путь до лог-файлов>/SmartService, где в качестве пути до лог-файлов используется значение параметра ARIO_LOG_PATH.

ArioPublishingService – секция с параметрами установки сервиса Directum Publishing Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9057;

ArioTextExtractorService – секция с параметрами установки сервиса Directum Text Extractor Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9027;

•QUEUE_POLICIES – секция с настройкой политик RabbitMQ. Значения по умолчанию:

QUEUE_POLICIES:
    QUEUE_POLICY_NAME: 'ARIO_EXTRACT_TEXT_POLICY'
    QUEUE_POLICY_FILTER: '(?!.*reply)ario-extract-text'
    QUEUE_POLICY_VALUE: '{"consumer-timeout":86400000}'

ArioDocumentDisassemblerService – секция с параметрами установки сервиса Directum Document Disassembler Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9028;

ArioDocumentAssemblerService – секция с параметрами установки сервиса Directum Document Assembler Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9029;

ArioFactExtractorService – секция с параметрами установки сервиса Directum Fact Extractor Base Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9017;

ArioFactExtractorRulesService – секция с параметрами установки сервиса Directum Fact Extractor Rules Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9018;

ArioFactExtractorLearnService – секция с параметрами установки сервиса Directum Fact Extractor Learn Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9019;

•DATABASE_ENGINE – Тип СУБД. По умолчанию используется тип, указанный в параметре ARIO_DATABASE_ENGINE;

•QUEUE_POLICIES – секция с настройкой политик RabbitMQ. Значения по умолчанию:

QUEUE_POLICIES:
    QUEUE_POLICY_NAME: 'ARIO_FACT_TRAIN_POLICY'
    QUEUE_POLICY_FILTER: '(?!.*reply)ario-facts-(train|retrain)'
    QUEUE_POLICY_VALUE: '{"consumer-timeout":250000000}'

ArioObjectDetectionService – секция с параметрами установки сервиса Directum Object Detection Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9047;

ArioImageClassifierService – секция с параметрами установки сервиса Directum Image Classifier Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9008;

ArioTextClassifierService – секция с параметрами установки сервиса Directum Text Classifier Service:

•PORT – порт для подключения к сервису. Значение по умолчанию 9007;

•DATABASE_ENGINE – Тип СУБД. По умолчанию используется тип, указанный в параметре ARIO_DATABASE_ENGINE;

•QUEUE_POLICIES – секция с настройкой политик RabbitMQ. Значения по умолчанию:

QUEUE_POLICIES:
    QUEUE_POLICY_NAME: 'ARIO_CLASSIFIER_TRAIN_POLICY'
    QUEUE_POLICY_FILTER: '(?!.*reply)ario-classifier-(train|retrain)'
    QUEUE_POLICY_VALUE: '{"consumer-timeout":250000000}'

При необходимости скорректируйте значения.

7.По умолчанию при установке сервисов настраиваются политики брокера сообщений RabbitMQ. Если он используется на отдельном сервере, политики настраиваются на стороне брокера сообщений, а из настроек сервисов Directum Ario их нужно удалить. Для этого в секциях ArioTextExtractorService, ArioFactExtractorLearnService и ArioTextClassifierService удалите секцию с настройкой политики RabbitMQ QUEUE_POLICIES.

8.Установите сервисы Directum Ario. Для этого выполните команду:

do ario install

9.Дождитесь окончания установки.

Совет. В зависимости от конфигурации оборудования меняется время запуска сервисов Directum Ario. Иногда Directum Launcher может прекратить установку, потому что не дожидается запуска сервисов. В результате модели классификации и извлечения фактов не импортируются. В этом случае с помощью инструмента checker.html проверьте состояние сервисов Directum Ario. Если сервисы запустились, импортируйте модели классификации и извлечения фактов вручную.

Установка с помощью командной строки

Установка с помощью командной строки