4. Процесс установки

Действия по установке выполняются через SSH консоль технологического пользователя.

Общий процесс установки состоит из следующих действий:

  1. Выполнить предусловия для запуска новой версии модуля.

  2. Настроить конфигурацию модуля.

  3. Создать на сервере директорию для загрузки файлов модуля.

  4. Загрузить файлы модуля в созданную директорию.

  5. Запустить модуль (Описание процесса запуска приведено в разделе Запуск модуля Руководства администратора Компонента «Витрина данных»).

  6. Проверить установку модуля.

4.1. Предусловия выполнения первого запуска новой версии модуля

Начиная с версии 2.6.0 хранение данных персистентности модуля осуществляется в снапшот-таблицах Prostore. Пересоздание таблиц и миграция данных выполняется автоматически при старте модуля.

Для исключения возникновения ошибок миграции, перед первым запуском новой версии модуля необходимо выполнить следующие действия:

  1. Проверить версию Prostore (для работы новой версии REST-Uploader требуется Prostore версии 7.6 и выше).

  2. Проверить тип подключенных датасорсов Prostore (В Prostore данные персистентности хранятся в snapshot-таблицах, которые поддерживаются только в датасорсах с типом ADP):

  • если все имеющиеся датасорсы с типом ADP, перейти к следующему шагу;

  • если нет ни одного ADP-датасорса, то необходимо развернуть СУБД PostgreSQL и настроить подключение к Prostore (при отсутствии ADP невозможно использование функционала сбора данных о компонентах в новой версии Витрин данных);

  • если имеются и ADP, и датасорсы других типов, необходимо в конфигурационном файле REST-Uploader задать перечень наименований используемых ADP-датасорсов;

  1. Синхронизировать настройки блока component-info (кроме secrets) в конфигурационных файлах всех модулей, отправляющих информацию о себе.

  2. Запустить один экземпляр одного из модулей ВД новой версии с включенным функционалом сбора данных (component-info.enabled: true) и с заданными настройками подключения к Prostore (в случае запуска нескольких экземпляров или нескольких компонентов возможны ошибки пересоздания таблицы component_info).

После успешного выполнения миграции необходимо убедиться в успешности создания таблицы component_info.

В случае наличия в логах ошибок создания таблицы component_info, необходимо устранить возможные причины и перезапустить один экземпляр одного модуля Витрины новой версии или дождаться выполнения повторной попытки создания таблицы (периодичность конфигурируется в параметре component-info.create-table-period).

4.2. Настройка конфигурации

Настройка конфигурации выполняется путем редактирования параметров файла конфигурации application.yml.

Пример файла application.yml и возможные настройки конфигурации модуля приведены в разделе Конфигурация модуля REST-Uploader (application.yml) Руководства администратора Компонента «Витрина данных».

4.3. Загрузка JAR-файла на сервер

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

scp file.jar user_name@IP:/home/dir

где,

  • file.jar - название JAR-файла;

  • user_name - имя пользователя, например, sudo или root;

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

  • /home/dir - директория на сервере, в которую будет загружен файл.