.. _data_uploader_install:

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

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

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

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

.. _data_uploader__migration:

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

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

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

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

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

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

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

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

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

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

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


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

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

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

где, 

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