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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Astra Linux

    • РЕД ОС

    • Альт Сервер

    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

    • РЕД ОС

    • Альт Сервер

    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. На сервере Консоли управления Docsvision запустите инсталлятор Docsvision EDI Integration server.msi.

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

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

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

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

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

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

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

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

Конфиденциальные настройки операторов ЭДО — Password, ApiKey и ProxyPassword — шифруются с использованием PFX-сертификата с закрытым ключом.

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

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

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

Шифрование в Linux

Если службы модулей Управление процессами и Web-клиент запущены на Linux, шифрование настраивается следующим образом.

  1. Используйте существующий сертификат с поддержкой функции шифрования или создайте сертификат по инструкции, указанной в разделе "Создание самоподписанного сертификата".

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

  2. Разместите PFX-сертификат с закрытым ключом в хранилище сертификатов учётной записи, от имени которой запущены службы модулей Управление процессами и Web-клиент.

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

    Если службы модулей Управление процессами и/или Web-клиент запускаются от другой учётной записи, разместите тот же PFX-файл в каталоге ~/.dotnet/corefx/cryptography/x509stores/my этой учётной записи.

    На машине с Windows-клиентом, с которой открывают и редактируют справочник ЮЗДО, установите тот же PFX-сертификат в хранилище пользователя, выполняющего настройку, по адресу Сертификаты  Текущий пользователь  Личное.

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

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

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

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

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

Шифрование в Windows

Если службы модулей Управление процессами и Web-клиент запущены на Windows, шифрование настраивается следующим образом.

  1. Используйте существующий сертификат с поддержкой функции шифрования или создайте сертификат по инструкции, указанной в разделе "Создание самоподписанного сертификата".

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

  2. Импортируйте PFX-сертификат с закрытым ключом в хранилище Сертификаты  Локальный компьютер  Личное.

    Предоставьте учётной записи, от имени которой запущены службы модулей Управление процессами и Web-клиент, доступ к закрытому ключу сертификата.

    Если сервисы запущены от имени УЗ Network Service, предоставьте ей доступ к закрытому ключу при помощи команды Управление закрытыми ключами в оснастке Сертификаты.

    Если Windows-клиент, с которого редактируют справочник ЮЗДО, установлен на другой машине, импортируйте тот же PFX-сертификат в хранилище пользователя, выполняющего настройку по адресу Сертификаты  Текущий пользователь  Личное.

    Если Windows-клиент установлен на той же машине, что и службы модулей Управление процессами и Web-клиент, повторно импортировать сертификат не требуется.

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

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

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

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

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