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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Дождаться перехода выполняющихся загрузок в финальные статусы.

  2. Проверить наличие ошибочных статусов загрузки и ошибок ФЛК, обработать ошибки (в случае наличия ошибок загрузки данных, необходимо устранить причину и повторить загрузку до обновления CSV-Uploader, т.к. данные журналов загрузок не подлежат миграции).

  3. Отключить автоматическую загрузку данных в витрину по расписанию.

  4. Остановить CSV-Uploader.

  5. Запустить новую версию CSV-uploader в одном экземпляре (в случае запуска нескольких экземпляров возможны ошибки при выполнении миграции).

После успешного выполнения миграции (модуль запущен, в логах отсутствуют ошибки миграции) выполнить запуск других экземпляров при необходимости.

В случае наличия в логах ошибок миграции, необходимо устранить возможные причины и повторить запуск одного экземпляра CSV-uploader версии 2.6.0 и выше.

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

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

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

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

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

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

где,

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

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

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

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