Установка и настройка

Состав установочного комплекта

Пакет установки Менеджера решений: Docsvision 5 SolutionManager.msi.
Пакет установки расширения Службы фоновых операций для Менеджера решений: Docsvision 5 Worker service extension for Solution manager.msi.

Краткая справка по установке

Чтобы установить Менеджер решений, выполните следующие шаги инструкции:

Установите модуль "Служба фоновых операций" при помощи инсталлятора заранее.
Установите модули Менеджер решений и Расширение Службы фоновых операций для Менеджера решений из отдельных пакетов установки.

Данный вариант установки подходит для совместной и раздельной установки Менеджера решений и Службы фоновых операций.

Установка модуля "Менеджера решений"

Для установки Менеджера решений нужны права локального администратора.

Запустите пакет установки Docsvision 5 SolutionManager.msi от имени администратора. Будет открыто приветственное окно мастера установки.

Рисунок 1. Мастер установки Менеджера решений
Примите условия лицензионного соглашения для продолжения установки и нажмите кнопку Далее.

Рисунок 2. Условия лицензионного соглашения
Будет показан каталог установки программы. При необходимости измените путь. Нажмите кнопку Установить для установки программы.

Рисунок 3. Каталог установки

Укажите настройки подключения к базе данных Менеджера решений и адрес Сервиса настроек и нажмите кнопку Установить.

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

Рисунок 4. Подключение к базе данных Менеджера решений

Формат строки подключения:

Для Microsoft SQL Server: Data Source=Адрес-сервера-баз-данных;Initial Catalog=Название-БД-Службы-фоновых-операций;Integrated Security=False;User ID=Имя-пользователя-БД;Password=Пароль-пользователя-БД;TrustServerCertificate=True.

Data Source — адрес сервера SQL для подключения к БД. В качестве Data Source может быть указан экземпляр SQL-сервера, например так: Data Source=DVDatabse\Server1.
Название-БД-Службы-фоновых-операций — псевдоним базы данных.
Integrated Security — задает логическое значение, определяющее способ проверки подлинности:
- False — при подключении в строке должны быть указаны идентификатор пользователя и пароль.
- True — при подключении будут использованы учетные данные текущей учетной записи Windows.
Имя-пользователя-БД — учётная запись пользователя для подключения к БД.
Пароль-пользователя-БД — пароль учётной записи для подключения к БД.
TrustServerCertificate=True — подробнее про настройку см. особенности настройки сертификата.

При использовании строки подключения к хранилищу с Windows-аутентификацией для Microsoft SQL Server учетной записи службы Сервиса настроек необходимо предоставить права на создание новых БД, а также полные права на БД, которая будет использована для Сервиса настроек.

Если строке подключения введены корректные данные, при запуске Сервиса настроек будет создана новая или обновлена существующая БД.

Для PostgreSQL: host=Адрес-сервера-баз данных;Port=SQL-порт;database=Название-БД-Менеджера решений;Username=Имя-пользователя-БД;Password=Пароль-пользователя-БД.

Адрес-сервера-баз данных — адрес сервера SQL для подключения к БД.
SQL-порт — порт SQL-сервера.
Название-БД-Менеджера решений — псевдоним базы данных.
Имя-пользователя-БД — учётная запись пользователя для подключения к БД.
Пароль-пользователя-БД — пароль учётной записи для подключения к БД.

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

Если используется Windows-аутентификация для Microsoft SQL Server, указанные права должны быть выданы учетной записи службы Менеджера решений. Учетная запись должна быть включена в группу безопасности Администраторы на сервере Docsvision.

Адрес Сервиса настроек указывается в формате http://полное-имя-сервера.домен:порт, например http://example.domain.com:5200.

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

Перезагрузка требуется для корректного завершения инициализации новой локальной группы безопасности Docsvision SolutionManager Administrators.

Установка модуля "Расширение Службы фоновых операций для Менеджера решений"

Данный компонент должен быть установлен на компьютере с модулем "Docsvision 5. Служба фоновых операций".

Задачи Менеджера решений должны обрабатываться только одним экземпляром Службы фоновых операций — параллельная обработка заданий несколькими службами приведет к ошибке.

Если в организации установлено несколько модулей "Docsvision 5. Служба фоновых операций", расширение для Службы фоновых операций следует устанавливать только на один из них.

Для установки расширения нужны права локального администратора.

Запустите пакет установки Docsvision 5 Docsvision 5 Worker service extension for Solution manager.msi. Будет открыто приветственное окно мастера установки.

Рисунок 5. Мастер установки расширения для Службы фоновых операций
Примите условия лицензионного соглашения для продолжения установки и нажмите кнопку Установить для установки программы.

Рисунок 6. Условия лицензионного соглашения

Расширение будет установлено в каталог установки модуля "Docsvision 5. Служба фоновых операций".
Если до установки расширения для Службы фоновых операций не был установлен Менеджер решений, мастер установки потребует указать строку подключения к Менеджеру решений. Введите строку подключения к базе данных настроек Менеджера решений, подключение к которой было настроено при установке Менеджера решений.

Рисунок 7. Подключение к базе данных Менеджера решений

Формат строки подключения приведен выше.

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

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

Если используется Windows-аутентификация для Microsoft SQL Server, указанные права должны быть выданы учетной записи службы Менеджера решений. Учетная запись должна быть включена в группу безопасности Администраторы на сервере Docsvision.

При установке расширения на компьютер с модулем Менеджер решений строка подключения будет получена из его конфигурации, страница настройки подключения — пропущена. Требования к учетной записи, от имени которой подключается БД, сохраняются.
Нажмите кнопку Готово, чтобы закрыть мастер установки.
Ознакомьтесь с разделом "Функции администратора модуля", чтобы предоставить пользователям доступ к модулю, настроить путь к временной папке, изменить подключение к базе данных Менеджера решений и выполнить другие задачи.
Ознакомьтесь с разделом "Настройки в Консоли управления Docsvision", чтобы выполнить необходимые для работы модуля настройки системы.

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

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

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

Если есть потребность защитить соединение, настройте Microsoft SQL сервер в соответствии с инструкцией.

Создание процесса для обработки задач Менеджера решений

После установки модуля Менеджер решений в Консоли управления Docsvision автоматически появляется специальный тип конфигурации.
В Консоли управления Docsvision откройте вкладку "Служба фоновых операций" и подключите новый процесс. Подробнее см. "Настройка Службы фоновых операций".
Нажмите на кнопку Подключить процесс.
В появившемся окне введите Имя процесса и выберите Тип конфигурации Менеджер решений.

В настройках созданного процесса заполните обязательные поля:

Таймаут — поле необязательно для заполнения, подробнее см. в разделе "Добавить процесс" документации модуля Консоль управления Docsvision.

Использовать x86 — установите флаг, чтобы переключить обработку заданий на версию фоновой операции с указанной разрядностью. Когда флаг снят, используется разрядность x64.

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