Обновление Web-клиента

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

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

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

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

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

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

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

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

При обновлении Web-клиента происходит проверка параметра <LoadLayouts></LoadLayouts> в конфигурационном файле панели управления Web-клиента (WebClientAdminConsole.config), расположенного по адресу %LocalAppData%\Docsvision\WebClientAdminConsole.config.

Если файл отсутствует или значение <LoadLayouts>true</LoadLayouts>, Web-клиент будет обновлён в стандартном режиме с импортом решений в базу данных.

Если значение <LoadLayouts>false</LoadLayouts>, при обновлении Web-клиента решения не будут автоматически загружено в базу данных, администратор должен будет сделать это самостоятельно позднее.

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

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

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

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

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

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

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

    sudo apt-get update
sudo apt-get install --only-upgrade docsvision-webclient*
    sudo dnf makecache
sudo dnf update docsvision-webclient*
    sudo apt-get update
sudo apt-get install --only-upgrade=true docsvision-webclient*

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

  10. Обновите версию DVWebTool/DVSupService на клиентских рабочих местах.

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

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

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

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

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

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

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

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

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

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