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

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

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

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

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

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

  • Перед обновлением создайте резервную копию БД 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-settingsservice*
    sudo dnf makecache
sudo dnf update docsvision-settingsservice*
    sudo apt-get update
sudo apt-get install --only-upgrade=true 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, раздел "Обновление БД".

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

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

  8. Перезапустите службу Сервера Docsvision на Linux ещё раз.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  8. Перезапустите службу Сервера Docsvision на Windows ещё раз.

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

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