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

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

Условия обновления

  • Установка новой версии должна выполняться в нерабочее время.

  • Создайте резервную копию БД Docsvision.

  • База данных Docsvision должна быть переведена на работу с расширенными метаданными.

  • При обновлении версия клиентского дистрибутива должна быть равной версии серверного дистрибутива.

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

  • Если комплект обновления включает обновление для модуля "Платформа", перейдите к инструкции, приведенной в документации модуля Платформа.

Порядок обновления

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

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

  1. Создайте резервную копию БД.

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

  3. Обновите серверные компоненты на сервере Linux командой:

    • Astra Linux

    • РЕД ОС

    sudo apt-get update
sudo apt-get install --only-upgrade docsvision-managementconsole* && sudo apt-get install --only-upgrade docsvision-settingsservice* && sudo apt-get install --only-upgrade docsvision-externalapi**
    sudo dnf update docsvision-managementconsole* && sudo dnf update docsvision-settingsservice* && sudo dnf update docsvision-externalapi*

  4. На сервере Linux при обновлении сервиса будет предложено перезаписать текущий конфигурационный файл appsettings.json. Доступные варианты:

    • Перезаписать текущий конфигурационный файл appsettings.json.

      • Текущий файл будет перезаписан стандартным, все выполненные настройки будут сохранены в файле appsettings.json.dpkg-old. Существующие настройки, включая псевдонимы и строки подключения к БД, потребуется перенести в новый файл appsettings.json.

    • Сохранить текущий appsettings.json.

      • Все выполненные настройки останутся без изменений, стандартный файл конфигурации будет сохранён как appsettings.json.dpkg-dist.

    • Показать различия между версиями.

      • В окне командной строки будут отображены отличия между старой и новой версией. Знаком + обозначаются добавленные строки, знаком - обозначаются удалённые строки.

    • Запустить оболочку командной строки для проверки ситуации.

      • Возвращает в окно командной строки, дальнейшие действия зависят от администратора.

  5. Перезапустите dvappserver и все сервисы Docsvision на Linux.

  6. Запустите программу Консоль настройки Docsvision и перейдите в раздел Базы данных.

    Пользователь, от имени которого запускается Консоль настройки Docsvision:

    • Должен являться администратором Docsvision — быть добавленным в группу DocsVision Administrators в конфигурационном файле модуля Платформа, см. раздел "Конфигурация модуля Платформа".

    • Входить в группы Docsvision в Справочнике сотрудников:

      • Администраторы УД.

      • Администраторы КС.

      • Системная для WF.

      • _Системные группы.

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

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

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

    Обновление библиотек карточек
    Рисунок 1. Обновление библиотек карточек

  9. Перезапустите dvappserver и все сервисы Docsvision на Linux ещё раз.

  10. Выберите модули Docsvision, настройки которых должны быть загружены в БД и нажмите Завершить.

    Шаг загрузки настроек модулей
    Рисунок 2. Шаг загрузки настроек модулей