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

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

Начиная с версии 6.1 сборки 235 и выше, в Модуле интеграции с операторами ЭДО и коннекторах изменён механизм шифрования конфиденциальных настроек.

При обновлении или установке потребуется создать сертификат с приватной и публичной частью, указать параметр Thumbprint в настройках коннектора, заново указать пароли в настройках оператора в Справочнике настроек операторов ЮЗДО и перезагрузить список операторов ЮЗДО и контрагентов.

Подробнее о шифровании см. в разделе "Шифрование системных настроек".

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

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

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

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

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

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

При выполнении данной операции в БД Docsvision будут загружены стандартные настройки Модуля интеграции с операторами ЭДО. Рекомендуем перед обновлением БД экспортировать Справочник настроек операторов ЮЗДО для последующего его импорта после обновления БД.

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

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

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

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

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

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

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обновление расширения Модуля интеграции с операторами ЭДО для Web-клиента на сервере под управлением Linux

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

  1. Обновите компоненты расширения Модуля интеграции с операторами ЭДО для Web-клиента на сервере Linux командой:

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

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

Обновление расширения Модуля интеграции с операторами ЭДО для Web-клиента на сервере под управлением Windows

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

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

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

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

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

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

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

Шифрование настроек

Настройки шифрования необходимо выполнить только один раз, если этого не было выполнено ранее, при повторных обновлениях — не требуется.

  1. Создайте сертификат по инструкции "Создание сертификата шифрования в Linux".

    Пароль для сертификата указывать не требуется!

  2. Добавьте сертификаты с публичным и приватным ключом на клиентскую и серверную машины модуля Управление процессами по пути /root/.dotnet/corefx/cryptography/x509stores/my. Приватный ключ требуется и на клиенте, потому что при загрузке операторов нужны пароли к УЗ.
    Приватная часть требуется только на машине, где планируется настраивать/редактировать справочник ЮЗДО и под пользователем, который будет это делать. Устанавливать сертификат на все рабочие места с Windows-клиентом не требуется.

    Если Web-клиент запущен от имени пользователя иного, чем ROOT, например от имени учётной записи Docsvision, сертификат требуется размещать по пути /home/docsvision/.dotnet/corefx/cryptography/x509stores/my.

  3. Убедитесь, что в настройках оператора Диадок появился параметр для ввода отпечатка Thumbprint.

  4. В свойствах Контекстное меню  Свойства  Состав  Отпечаток созданного сертификата скопируйте отпечаток (например: 3f65b0bc7ca3f7291c5473e1cfb411f62bc0dfbe) и укажите его в настройках оператора. Повторно введите пароли (Password, ApiKey, ProxyPassword) в настройках оператора Диадок, чтобы они сохранились с учётом новой логики шифрования.
    Если этот шаг пропустить, документооборот с оператором будет невозможен.

  5. Перезапустите службу dvworkflow для Linux и Docsvision Workflow Server для Windows.

  6. Перезагрузите список операторов и котрагентов.

  7. Проверьте работу модуля ЭДО (достаточно убедиться, что работает получение и отправка документов, если всё работает стандартно, дешифровка работает).