.. _smev3_adapter_install.rst:

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

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

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


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

Установка СМЭВ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.