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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 Worker 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. Шаг загрузки настроек модулей

Обновление клиентских компонентов

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

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

  2. Обновите версию модуля на всех узлах кластера Docsvision, СУБП и Web-клиента.

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

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

Обновление расширения Службы фоновых операций для Консоли управления Docsvision на сервере под управлением Linux

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

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

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

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

Обновление расширения Службы фоновых операций для Консоли управления Docsvision на сервере под управлением Windows

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

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

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

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