Обновление модуля

Список изменений в текущей версии см. здесь: Изменения в релизной версии.

Установка новой версии должна выполняться в нерабочее время.
Создайте резервную копию БД Docsvision.
База данных Docsvision должна быть переведена на работу с расширенными метаданными.
При обновлении версия клиентского дистрибутива должна быть равной версии серверного дистрибутива.
Если к новой версии модуля приложена инструкция по обновлению, следуйте ей.
Если комплект обновления включает обновление для модуля "Платформа", перейдите к инструкции, приведенной в документации модуля Платформа.

Если к новой версии модуля прилагается отдельная инструкция по обновлению, следуйте ей.

Чтобы установить новую версию модуля:

Создайте резервную копию БД.
Устанавливать обновление рекомендуется на отдельную машину во избежание случаев, когда остаются старые файлы и папки системы.
Обновите серверные компоненты на сервере Linux командой:
```
sudo apt-get update
sudo apt-get install --only-upgrade docsvision-workerservice-*
```
На сервере Linux при обновлении сервиса будет предложено перезаписать текущий конфигурационный файл appsettings.json. Доступные варианты:
- Перезаписать текущий конфигурационный файл appsettings.json.
  - Текущий файл будет перезаписан стандартным, все выполненные настройки будут сохранены в файле appsettings.json.dpkg-old. Существующие настройки, включая псевдонимы и строки подключения к БД, потребуется перенести в новый файл appsettings.json.
- Сохранить текущий appsettings.json.
  - Все выполненные настройки останутся без изменений, стандартный файл конфигурации будет сохранён как appsettings.json.dpkg-dist.
- Показать различия между версиями.
  - В окне командной строки будут отображены отличия между старой и новой версией. Знаком + обозначаются добавленные строки, знаком - обозначаются удалённые строки.
- Запустить оболочку командной строки для проверки ситуации.
  - Возвращает в окно командной строки, дальнейшие действия зависят от администратора.
Затем установите серверные компоненты на машину с Windows, запустив инсталлятор .msi серверной части модуля.
Перезапустите dvappserver и все сервисы Docsvision на Linux.
Запустите программу Консоль настройки Docsvision и перейдите в раздел Базы данных. Если при открытии консоли появится диалог с предложением продолжить настройку, нажмите Нет.
Пользователь, от имени которого запускается Консоль настройки Docsvision:
- Должен являться администратором Docsvision — быть добавленным в группу DocsVision Administrators в конфигурационном файле модуля Платформа, см. раздел "Конфигурация модуля Платформа".
- Входить в группы Docsvision в Справочнике сотрудников:
  
  Администраторы УД.
  
  Администраторы КС.
  
  Системная для WF.
  
  _Системные группы.

Обновите существующую БД по инструкции, приведённой в документации модуля Платформа, раздел "Обновить базу данных".

Установка флагов в диалогах выбора обновляемых библиотек карточек и настроек модулей может оказаться недоступной, если изменений в библиотеке карточек между обновлениями не было.

Дойдите до выбора обновляемых библиотек карточек. Выберите библиотеки и нажмите Далее.

Рисунок 1. Обновление библиотек карточек
Перезапустите dvappserver и все сервисы Docsvision на Linux ещё раз.
Выберите модули Docsvision, настройки которых должны быть загружены в БД и нажмите Завершить.

Рисунок 2. Шаг загрузки настроек модулей
Клиентские компоненты модуля необходимо устанавливать на компьютерах пользователей, если был установлен Windows-клиент. Компоненты будут обновлены автоматически при запуске Windows-клиента.

Самостоятельно обновить клиентские компоненты можно из пакета установки Docsvision Worker service client.msi.
Обновите версию модуля на всех узлах кластера Docsvision, СУБП и Web-клиента.
Клиентские компоненты модуля на компьютерах пользователей будут обновлены автоматически при запуске Windows-клиента.

Самостоятельно обновить клиентские компоненты можно из пакета установки Docsvision Worker service client.msi.