.. _instrupdate:

Инструкция по обновлению
===========================

В данном разделе представлена последовательность действий Администратора для обновления Продукта до текущей версии.

.. important::
  * В версии 4.1 изменился формат лицензии. Перед обновлением нужно запросить новую лицензию и применить ее после обновления.
  * | В версии 4.1 удалены таблицы  AuditSettings, ProxySettings, DbContextLoggingSettings, ValidationAndSignaturesSettings с настройками, а также изменен формат настроек 
      в таблицах SettingsStore и ClientMessagesSenderSettings. 
    | **Миграция этих настроек в автоматическом режиме не выполняется**. 
    | После обновления БД нужно удалить вручную настройки из SettingsStore и ClientMessagesSenderSettings и при необходимости повторно задать настройки аудита, прокси-сервера, 
      логирования запросов к БД, валидации, уведомлений и публикации задач.

#. В IIS остановить пулы веб-сервисов и Dashboard, подлежащие обновлению.
#. Остановить сервис ИМ.
#. Сохранить резервную копию файлов подлежащих обновлению сервисов: ИМ, веб-сервисов и Dashboard, работающих на соответствующей зоне.
#. Удалить содержимое из корневых папок всех сервисов, сделав предварительно бэкап конфигурационных файлов. 
#. Скопировать файлы из соответствующих папок поставки релиза.
#. Конфигурационные файлы из новой поставки изменить в соответствии с файлами настройки из бэкапа.
#. Сделать резервную копию БД.
#. Обновить БД с помощью Database Migrator.
#. Запустить пулы в IIS для веб-сервисов и Dashboard.
#. Запустить сервис ИМ.
#. Убедиться, что в логах ИМ, веб-сервисов, Dashboard отсутствуют сообщения об ошибках.

| См. также:
| :ref:`Astra Linux. Обновление БД <Install_AstraLinux_Common_SettingUpDatabases>`
| :ref:`Windows. Обновление БД <Install_Windows_Common_SettingUpDatabases>`
| :ref:`Docker. Обновление БД <Install_Docker_Common_SettingUpDatabases>`


.. _instrupdate-US:

Настройки для работы с универсальными сообщениями
-------------------------------------------------

В ``appsettings.json`` интеграционного модуля добавлено свойство «UniversalMessages», содержимое которого представляет собой словарь, где ключом является код оператора, 
а значением – режим работы с универсальными сообщениями (УС).

Допустимые режимы работы:

* 0 – только УС;
* 1 – только старый вариант квитанций;
* 2 – старый вариант квитанций совместно с УС.

| По умолчанию, для операторов, которые уже поддерживают работу с УС, выбран режим «2». Для остальных – режим «1».
| О необходимости и сроках перехода от режима «2» на режим «0» будет сообщено дополнительно.