.. _smev3_adapter_install.rst:

Установка модуля
^^^^^^^^^^^^^^^^^^^^

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

Установка КриптоПро
#########################

Установка СМЭВ3-адаптера возможна, только если были добавлены ключи (контейнер закрытого ключа) для сервиса **КриптоПро**.

В случае использования для электронной подписи сервиса **КриптоПро**, необходимо предварительно выполнить шаги:

- скачать **КриптоПро JCP** (https://www.cryptopro.ru/download?pid=129) для Java JDK на сервер, где будет установлен СМЭВ3–адаптер; 
- установить загруженное ПО, следуя инструкции и документации на официальном сайте;
- получить сертификат для установки от уполномоченных лиц и установить его в **КриптоПро**.


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

Модуль СМЭВ3-адаптер поставляется в виде JAR-файла. В поставку также входят следующие файлы:

- файл настроек конфигурации модуля СМЭВ3-адаптер ``application.yml``;
- файлы для подключения к ProStore: JDBC–драйвер (``dtm-jdbc-driver-*.*.*.jar``) и ``commons-lang3-3.12.0.jar``;
- сконфигурированные pebble-шаблоны.

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

1. Настроить конфигурацию модуля.
2. Создать на сервере директорию для загрузки файлов модуля.
3. Загрузить файлы модуля в созданную директорию.
4. Запустить JAR-файл модуля.
5. Проверить установку модуля.

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

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

Пример файла ``application.yml`` и возможные настройки конфигурации модуля см. в разделе :ref:`smev-option` Руководства администратора.


Добавление папки для загрузки файлов модуля
################################################

Создайте на сервере папку, в которую будут загружены файлы модуля, например, ``/opt/smev3-adapter``.

В случае, если ранее была установлена старая версия **СМЭВ3-адаптера**, сделайте его резервную копию.

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

Загрузите в созданную на предыдущем шаге папку:

-	JAR-файл модуля;
-	файл настроек конфигурации модуля СМЭВ3-адаптер (``application.yml``);
-	файлы JDBC-драйвер (``dtm-jdbc-driver-*.*.*.jar``) и ``commons-lang3-3.12.0.jar`` для подключения к ProStore;
-	сконфигурированные pebble-шаблоны.

Кластеризация модуля
#########################

Кластеризация модуля достигается путем запуска копии экземпляра данного модуля. Оптимальным вариантом является использование 
оркестраторов, например:

- **Kubernetes**;
- **Openshift**;
- **Docker-swarm**;
- **Nomad**.