.. _standard_loader_install:

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

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

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

1. Выполнить предусловия для запуска новой версии компонентов модуля.
2. Настроить конфигурацию модуля.
3. Создать на сервере директорию для загрузки файлов модуля.
4. Загрузить файлы модуля в созданную директорию.
5. Запустить модуль (Описание процесса запуска приведено в разделе :ref:`standard_loader_start` Руководства администратора Компонента «Витрина данных»).
6. Проверить установку модуля.

.. _stloder_migration:

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

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

Миграции подлежат данные только таблиц, предназначенных для хранения статической информации:

- information_system;
- source;
- pull_task;
- schedule;
- deployer;
- reader;
- config;
- flk_conditions;
- session_status_dictionary;
- compare_task;
- compare_schedule.

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

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

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

3. Остановить формирование новых сеансов: закрыть доступ клиентов к ридерам типа push сетевыми средствами, перевести все расписания и для заданий типа pull, и для сверок в выключенное состояние.
4. Дождаться перехода всех сеансов в финальные статусы (проверка возможна с использованием REST-запроса на получение списка сеансов с фильтрацией по неконечным статусам).
5. Проверить наличие ошибочных статусов сеансов загрузки и ошибок ФЛК.
6. Обработать ошибочные статусы и ошибки ФЛК (в случае наличия ошибок загрузки данных, необходимо устранить причину и повторить загрузку до первого запуска загрузчика версии 2.6.0 и выше, т.к. 
   история будет утеряна).
7. Остановить загрузчик.
8. Запустить загрузчик новой версии (2.6.0 или выше) со всеми задействованными компонентами (Manager и Buffer - обязательно, FLK и Comparator - опционально) в одном экземпляре (допускается запуск как в одной, так и в 
   различных JVM). В случае запуска в нескольких экземпляров возможны ошибки при выполнении миграции.

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

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

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

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

Пример файла ``application.yml`` и возможные настройки конфигурации модуля приведены в разделе 
:ref:`standard_loader_config` Руководства администратора Компонент «Витрина данных».


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

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

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

где, 

- ``file.jar`` - название JAR-файла;
- ``user_name`` - имя пользователя, например, ``sudo`` или ``root``;
- ``IP`` - адрес сервера;
- ``/home/dir`` - директория на сервере, в которую будет загружен файл.