.. _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» будет сообщено дополнительно.


.. _instrupdate-etrnstatus:

Особенности при переходе на версию 4.4 SP3 для работы с ЭТрН
-------------------------------------------------------------

При переходе на версию 4.4 SP3, при работе с ЭТрН, обработка которых не была завершена до обновления версии, для исключения дублирования документов в архиве 
для сценариев, когда одна организация выступает в нескольких ролях, необходимо вручную поменять в базе данных идентификатор оператора.

Для этого в таблице ``docflow.Documents`` в поле ``OperatorDocumentId`` нужно заменить идентификатор вида ``[role][guid]`` на ``guid``.

Например, 

для оператора «Логистика»:

* ``[Consignor][6368d0ee-0355-310c-f3d1-2aeec8646221]``
* ``[Consignee][6368d0ee-0355-310c-f3d1-2aeec8646221]``
* ``[Carrier][6368d0ee-0355-310c-f3d1-2aeec8646221]``

 нужно заменить на ``6368d0ee-0355-310c-f3d1-2aeec8646221``;

для оператора «Сфера Перевозки»:

* ``[GO][12e0275e-57c9-49d8-9885-2366b6857f51]``
* ``[GP][12e0275e-57c9-49d8-9885-2366b6857f51]``
* ``[TK][12e0275e-57c9-49d8-9885-2366b6857f51]``

 нужно заменить на ``12e0275e-57c9-49d8-9885-2366b6857f51``;

для оператора «Такском-Файлер»»:

* ``[Sender][fd6ec8c2-ab9d-284a-f896-8dba20b915ba]``
* ``[Receiver][fd6ec8c2-ab9d-284a-f896-8dba20b915ba]``
* ``[Transporter][fd6ec8c2-ab9d-284a-f896-8dba20b915ba]``

 нужно заменить на ``fd6ec8c2-ab9d-284a-f896-8dba20b915ba``.