Установка Консоли управления Docsvision

Перед установкой ознакомьтесь с разделом "Необходимые ресурсы".

Пользователь, выполняющий установку, должен обладать правами локального администратора и являться администратором Docsvision (быть членом группы Администраторы в Справочнике сотрудников).

Начиная с НО 26.1, Консоль управления Docsvision является основным инструментом конфигурации системы, необходимым для первоначальной настройки всех модулей системы, также без Консоли управления Docsvision не будет функционировать модуль "Служба фоновых операций", необходимый для создания групп заданий и отправки почтовых уведомлений.

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

Установка сервиса внешнего API

Установка Сервиса внешнего API не требуется в версиях Консоли управления Docsvision 6.2 и выше и выше.

Установка Консоли управления Docsvision на сервер под управлением Linux

Чтобы установить Консоль управления Docsvision:

  1. Установите серверные компоненты Консоли управления Docsvision следующей командой, предварительно обновив индекс пакетов:

    • Astra Linux / Альт Сервер

    • РЕД ОС / SberLinux

    sudo apt-get update
sudo apt-get install docsvision-managementconsole
    sudo dnf makecache
sudo dnf install docsvision-managementconsole

  2. Запустите службу Консоли:

    sudo systemctl start dvconsole

  3. Если данный модуль устанавливается последним, запустите Консоль управления Docsvision и выполните обновление базы данных, следуя инструкции в документации по администрированию модуля "Консоль управления Docsvision":

  4. Перезапустите службу Сервера Docsvision.

Установка Консоли управления Docsvision на сервер под управлением Windows

Чтобы установить Консоль управления Docsvision:

  1. Откройте пакет установки Docsvision Management Console.msi.

    Установка Консоли управления Docsvision
    Рисунок 1. Установка Консоли управления Docsvision

  2. Нажмите Далее, ознакомьтесь с условиями лицензионного соглашения. Подтвердите, что вы согласны с лицензионным соглашением и нажмите Далее.

    Лицензионное соглашение
    Рисунок 2. Лицензионное соглашение

  3. Выберите компоненты, которые требуется установить, и нажмите Далее.

    Выбор устанавливаемых компонентов
    Рисунок 3. Выбор устанавливаемых компонентов
    Служба Windows

    Основные компоненты Консоли управления Docsvision, предоставляющие базовую функциональность, обязательна для установки на сервер Консоль управления Docsvision.

    Кнопка Сброс

    Сбрасывает выбор компонентов на стандартные.

    Кнопка Использование диска

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

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

    Мастер установки серверной части модуля Базовые объекты
    Рисунок 4. Мастер установки серверной части модуля Базовые объекты

  5. На следующем шаге нажмите кнопку Готово, чтобы закрыть мастер установки.

  6. Если данный модуль устанавливается последним, запустите Консоль управления Docsvision и выполните обновление базы данных, следуя инструкции в документации по администрированию модуля "Консоль управления Docsvision":

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

Установка Сервиса настроек на сервер Консоли управления Docsvision

Установите Сервиса настроек на сервер Консоли управления Docsvision. Инструкция по установке Сервиса настроек приведена в разделе "Установка Сервиса настроек" документации Сервиса настроек.

Установка расширений модулей для Консоли управления Docsvision

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

Расширения обязательны для установки в версии Консоли управления Docsvision 6.2 и выше и выше. Для возможности настройки модулей через Консоль управления Docsvision необходимо установить их расширения, добавляющие в систему:

  • Настройки служб в Консоли, просмотр сообщений — расширение Службы фоновых операций для Консоли управления Docsvision.

  • Получение списка локализаций и видов карточек, возможность загрузки новых значений в базу данных, импорт решений — расширение Web-клиента для Консоли управления Docsvision.

  • Связанные с модулем ресурсы локализации, обработчики, специализированные редакторы для настройки сервера приложений и БД из Консоли управления Docsvision — расширение сервера приложений для Консоли управления Docsvision.

  • Связанные с модулем ресурсы локализации, обработчики и специализированные редакторы для настройки из Консоли управления Docsvision (при наличии) — расширение модуля Управление процессами для Консоли управления Docsvision.

  • Связанные с модулем ресурсы локализации, обработчики и специализированные редакторы для настройки из Консоли управления Docsvision (при наличии) — расширение Файлового сервиса для Консоли управления Docsvision.

Установка расширений модулей для Консоли управления Docsvision на сервер под управлением Linux

В некоторых дистрибутивах и в случаях, когда Консоль управления Docsvision установлена на одной машине с Сервером приложений Docsvision, расширения добавляются в систему при первичной установке или обновлении Консоли.

В Альт Сервер и при установке Консоли на олтдельный сервер расширения всегда требуется устанавливать вручную.
Чтобы установить расширения модулей для Консоли управления Docsvision на сервер под управлением Linux:

  1. Выполните следующие команды:

    • Astra Linux / Альт Сервер

    • РЕД ОС / SberLinux

    sudo apt-get update
sudo apt-get install docsvision-ext-fileservice-mc docsvision-ext-platform-mc docsvision-ext-webc-mc docsvision-ext-workflow-mc docsvision-ext-ws-mc
    sudo dnf makecache
sudo dnf install docsvision-ext-fileservice-mc docsvision-ext-platform-mc docsvision-ext-webc-mc docsvision-ext-workflow-mc docsvision-ext-ws-mc

  2. Перезапустите службы Docsvision для следующих модулей: Файловый сервис, Платформа, Web-клиент, Управление процессами, Служба фоновых операций.

Установка расширений модулей для Консоли управления Docsvision на сервер под управлением Windows

Чтобы установить расширения модулей для Консоли управления Docsvision на сервер под управлением Windows:

  1. На сервере Консоли управления Docsvision запустите инсталлятор Службы фоновых операций Docsvision Worker service.msi, на шаге выбора компонентов выберите компонент "Расширение консоли управления" для Службы фоновых операций:

    Выбор компонентов Службы фоновых операций для установки
    Рисунок 5. Выбор компонентов Службы фоновых операций для установки

  2. Запустите инсталлятор модуля Платформа Docsvision Platform server.msi, на шаге выбора компонентов выберите компонент "Расширение консоли управления" для модулей Платформа и Файловый сервис:

    Выбор компонентов модуля Платформа для установки
    Рисунок 6. Выбор компонентов модуля Платформа для установки

  3. На сервере Консоли управления Docsvision запустите инсталлятор Web-клиента Docsvision web-client.msi, на шаге выбора компонентов выберите компонент "Расширение консоли управления" для Web-клиента:

    Выбор компонентов Web-клиент для установки
    Рисунок 7. Выбор компонентов Web-клиент для установки

  4. На сервере Консоли управления Docsvision запустите инсталлятор Управление процессами Docsvision Workflow server.msi, на шаге выбора компонентов выберите компонент "Расширение консоли управления" для модуля Управление процессами:

    Выбор компонентов модуля Управление процессами для установки
    Рисунок 8. Выбор компонентов модуля Управление процессами для установки

Регистрация модулей системы

Для возможности настройки модулей системы через интерфейс Консоли управления Docsvision необходимо, чтобы параметры, перечисленные ниже, были в конфигурационном файле настраиваемого модуля: Платформа, Файловый сервис, Web-клиент, Управление процессами.

  • DocsVision  ServiceId — уникальный идентификатор данного экземпляра модуля. Параметр задаётся автоматически при установке модуля.

  • DocsVision  SettingsService  ConnectionString — адрес подключения к хранилищу настроек. Параметр необходимо указать вручную.

  • DocsVision  SettingsService  ApiKey — ключ приложения для подключения к хранилищу настроек. Параметр необходимо указать вручную.

Откройте поочерёдно конфигурационные файлы в каталогах модулей Платформа, Файловый сервис, Web-клиент, Управление процессами и укажите недостающие параметры в требуемых секциях. Конфигурационные файлы располагаются в каталогах по адресу /usr/lib/docsvision/имя-модуля/appsettings.json в Linux и C:\Program Files\Docsvision\имя-модуля\appsettings.json для Windows.

После редактирования конфигурационных файлов обязательно перезапустите соответствующие системные службы!

Убедиться в успешной регистрации сервисов можно следующим образом: запустить Консоль управления Docsvision и открыть страницу Серверы, выбрать сервер из списка слева. Если для выбранного сервера в правой колонке доступны разделы настроек "Сервер приложений", "Веб-клиент", "Управление процессами" и "Файловый сервис", регистрация выполнена успешно. В противном случае проверьте конфигурацию модулей и перезапустите службы ещё раз.

Особенности настройки сертификата

Настройка актуальна только для Microsoft SQL Server, для PostgreSQL дополнительных настроек не требуется. По умолчанию провайдер считает соединение с БД защищённым.

Если соединение не защищено (т.е. не настроен сертификат на уровне БД, используется самозаверенный или недействительный сертификат), необходимо в строке соединения указывать TrustServerCertificate = true, это сообщит провайдеру, что серверу можно доверять.

Настоятельно рекомендуется использовать защищённое соединение, настроив Microsoft SQL сервер в соответствии с инструкцией в руководстве по настройке системы, см. подробнее "Создание доверенного сертификата для подключения к БД".

Удаление Консоли управления Docsvision

  • Чтобы удалить модуль в ОС Windows, воспользуйтесь стандартными средствами системы (Установка и удаление программ).

  • Чтобы удалить модуль в ОС Linux, выполните команду:

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

    $ sudo apt-get purge docsvision-managementconsole
    $ sudo dnf remove package docsvision-managementconsole
    $ sudo apt-get remove --purge docsvision-managementconsole

Созданные группы и службы будут удалены, Сервис настроек станет недоступен.