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

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

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

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

  • Версии всех серверных и клиентских компонентов должны быть одинаковыми.

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

  • Перед обновлением создайте резервную копию БД Docsvision.

  • Если в БД PostgreSQL используется pgAgent, остановите планировщик дол начала обновления.

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

Обновление модуля на сервере под управлением Linux

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

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

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

  2. Если в БД PostgreSQL используется pgAgent, остановите планировщик.

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

    • Astra Linux

    • РЕД ОС / SberLinux

    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 makecache
sudo dnf update docsvision-managementconsole* docsvision-settingsservice*

  4. При обновлении сервера Docsvision предыдущих версий под управлением Astra Linux будет предложено перезаписать текущий конфигурационный файл appsettings.json.

    Доступные варианты:

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

      • Текущий файл будет перезаписан стандартным, все выполненные настройки будут сохранены в файле appsettings.json.dpkg-old (appsettings.json.rpmsave для Альт Сервер), их необходимо будет перенести в Консоль управления Docsvision.

        Начиная с НО 26.1, основным инструментом настройки системы является Консоль управления Docsvision. Принимая решение заменить конфигурационый файл модулей Платформа (dvappserver для Linux и Docsvision Platform для Windows), Файловый сервис (dvfileservice для Linux и Docsvision File Service для Windows), Web-клиент (dvwebclient для Linux и Docsvision Web-client для Windows), Управление процессами (dvworkflow для Linux и Docsvision Workflow Server для Windows), Консоль управления Docsvision (dvsettings для Linux и Docsvision Settings Service для Windows), учитывайте, что все существующие настройки будут заменены базовым набором параметров:

        ServiceId

        Уникальный идентификатор данного экземпляра модуля. Параметр задаётся автоматически при установке модуля.

        SettingsService  ConnectionString

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

        SettingsService  ApiKey

        Ключ приложения для подключения к хранилищу настроек. Параметр необходимо указать вручную.

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

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

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

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

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

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

  5. Запустите Консоль управления Docsvision и перейдите в раздел Серверы  Имя-сервера  Сервер приложений  Базы данных.

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

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

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

Обновление модуля на сервере под управлением Windows

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

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

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

  2. Если в БД PostgreSQL используется pgAgent, остановите планировщик.

  3. Обновите необходимые компоненты модуля на сервере Windows из инсталлятора Docsvision Management Console.msi.

  4. На сервере Docsvision под управлением Windows при обновлении сервисов текущий конфигурационный файл appsettings.json не перезаписывается. При обновлении системы с предыдущих версий можно сравнить существующий конфигурационный файл со стандартной версией из комплекта поставки — appsettings.json.dist, расположенный в том же каталоге.

  5. Запустите Консоль управления Docsvision и перейдите в раздел Серверы  Имя-сервера  Сервер приложений  Базы данных.

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

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

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

Обновление расширений для Консоли управления Docsvision на сервере под управлением Linux

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

  1. Обновите компоненты расширений для Консоли управления Docsvision на сервере Linux командой:

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

    sudo apt-get update
sudo apt-get install --only-upgrade docsvision-ext-fileservice-mc docsvision-ext-platform-mc docsvision-ext-webc-mc docsvision-ext-workflow-mc docsvision-ext-ws-mc*
    sudo dnf makecache
sudo dnf update docsvision-ext-fileservice-mc docsvision-ext-platform-mc docsvision-ext-webc-mc docsvision-ext-workflow-mc docsvision-ext-ws-mc*
    sudo apt-get update
sudo apt-get install --only-upgrade=true docsvision-ext-fileservice-mc docsvision-ext-platform-mc docsvision-ext-webc-mc docsvision-ext-workflow-mc docsvision-ext-ws-mc*

Обновление расширений для Консоли управления Docsvision на сервере под управлением Windows

  1. Обновите необходимые компоненты модуля на сервере Windows из инсталлятора Docsvision Management Console.msi.

  2. На шаге выбора компонентов расширения выберите необходимые компоненты и нажмите Далее.

  3. Нажмите на кнопку Установить и дождитесь завершения установки модуля.

  4. Нажмите на кнопку Готово, чтобы закрыть мастер установки.