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

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

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

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

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

Обратите внимание!

Данное обновление включает изменение способа хранения расширенных метаданных в БД, после обновления может потребоваться изменение собственных хранимых процедур. Подробности в пункте Обновление кода скриптов, работающих с БД Docsvision.

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

Перед установкой убедитесь в наличии .NET Desktop Runtime (x86/x64) версии 6.0.3.

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

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

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

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

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

    sudo apt-get update
sudo apt-get install --only-upgrade docsvision-platform-*

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

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

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

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

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

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

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

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

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

  5. Затем установите серверные компоненты на машину с Windows, запустив инсталлятор .msi серверной части модуля.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  12. Согласитесь с предложением продолжить настройку системы Docsvision.

  13. Пройдите все шаги мастера настройки до страницы настройки баз данных.

    Настройка баз данных Docsvision
    Рисунок 3. Настройка баз данных Docsvision

  14. Выберите основную БД Docsvision в списке, установите переключатель в положение Использовать выбранную в списке базу данных и нажмите Далее.

  15. Согласитесь с предложением обновить БД.

    Запрос на обновление базы данных
    Рисунок 4. Запрос на обновление базы данных

  16. Обновите базу данных.

    На странице выбора обновляемых библиотек карточек не снимайте выбор с библиотек карточек.

  17. Завершите настройку с помощью мастера настройки.

  18. Установите новую версию модуля (модулей) без обновления БД:

    • На оставшихся узлах кластера Docsvision.

    • На сервере СУБП, Web-клиента и других модулей, использующих компоненты модуля Платформа.

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

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

    Если клиентская часть модуля Платформа установлена с областью установки для текущего пользователя, самостоятельно удалите ВСЕ клиентские компоненты старой версии до установки новой, в ином случае в ОС будут параллельно существовать старая и новая версии.

  20. При необходимости после установки модуля Платформа установите клиентские компоненты других модулей.

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