Установка и настройка СУБП

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

Установка на Linux

Установите службу модуля следующей командой, предварительно обновив индекс пакетов:
```
sudo apt-get update
sudo apt-get install docsvision-workflow
```

Все настройки модуля хранятся в конфигурационном файле appsettings.json. Конфигурационный файл может быть изменён в любом текстовом редакторе, например nano.

sudo nano /usr/lib/docsvision/workflow/appsettings.json

Основные настройки, которые нужно сделать:

{
  "Docsvision": {
    "Workflow": {
      "ServiceUrl": "http://dvserver.domain.com:5000/api/v1", (1)
      "BaseName": "alias", (2)
      "WorkflowServer": {
        (3)
      }
    }
  },
  "DataProtectCertificateThumbprint": "thumbprint", (4)
  "SystemUserAccount": "account@domain.com", (5)
  "SystemUserPassword": "password", (6)
  "APIKEY": "api-key" (7)
}

1 Адрес сервера Docsvision. Обратите внимание на api/v1 в адресе.

2 Псевдоним БД Docsvision.

3 Настройки почты, подробнее см. раздел "Настройки почты в конфигурационном файле модуля".

4 Отпечаток закрытого ключа шифрования SHA1.
Указывается без двоеточия, например, D8602179888DC8402B393F11DCA16A3376DDF879, см. подробнее в документации по установке системы, раздел "Защита системной учётной записи".
Если шифровать пароль системной учётной записи не планируется, параметр можно удалить.

5 Имя системной учётной записи Docsvision.

Пароль системной УЗ, рекомендуется хранить в зашифрованном виде, см. подробнее в документации по установке системы, раздел "Защита системной учётной записи".

Не рекомендуется авторизоваться на клиентских рабочих местах под системными учётными записями, т.к. это может привести к ошибкам в работе системы.

7 Используется для аутентификации в API Управление процессами. Можно оставить значение по умолчанию или изменить, главное условие, чтобы значения в конфигурации модулей Платформа и Управление процессами были одинаковые.

Установка на Windows

Пакет установки серверной части модуля: Docsvision Workflow server.msi.
Пакет установки клиентской части модуля: Docsvision Workflow client.msi.

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

Создание учетной записи для сервиса Workflow

Администратор должен создать учетную запись для СУБП, службы dvworkflow.

Создайте доменную учетную запись, и настройте её права:

На сервере Linux включите учетную запись в локальные группы DocsVision Power Users. Группы настраиваются в конфигурационном файле модуля Платформа, подробнее см. в документации модуля Платформа, раздел "Конфигурация модуля Платформа".
На компьютере с серверной частью модуля:
- Включите учетную запись в локальную группу Users.

После настройки системы Docsvision:

Предоставьте созданной учетной записи полные права по дискреционной модели безопасности на все папки и справочники системы Docsvision.
Для работы с карточками приложения Управление документами, включите учётную запись в группу Системная для WF в Справочнике сотрудников.
Назначьте учетной записи персональную лицензию в Docsvision (см. документацию модуля "Платформа".

Установка серверной части модуля

Серверная часть модуля Управление процессами должна быть установлена на компьютер с сервером Docsvision.

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

Запустите пакет установки Docsvision Workflow server.msi.

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

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

Рисунок 3. Начало установки серверной части модуля Управление процессами
На следующем экране нажмите кнопку Готово, чтобы закрыть мастер установки.
Если данный модуль устанавливается последним, запустите Консоль настройки Docsvision и выполните обновление базы данных, следуя инструкции в документации по администрированию модуля "Платформа":
- "Подключить существующую базу данных"
- "Создать новую базу данных"
На сервере Linux, укажите псевдоним и строку подключения к существующей или новой БД в конфигурационном файле модуля Платформа и перезапустите службу dvappserver командой:
```
sudo systemctl restart dvappserver
```

Установка клиентской части модуля

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

Клиентская часть модуля может быть установлена двумя способами:

Автоматически — требуемые компоненты будут загружены с сервера Docsvision и установлены автоматически.
Вручную — администратор должен самостоятельно установить клиентскую часть модуля Управление процессами.

Модуль будет установлен в каталог установки и с областью установки модуля Платформа — у пользователя должны быть права на установку с данными условиями.

Автоматическая установка клиентской части модуля Управление процессами

Запустите Windows-клиент. При подключении к серверу Docsvision, на котором установлена серверная часть модуля Управление процессами, клиентская часть модуля будет установлена автоматически.

Если клиентская часть модуля Платформа установлена с областью установки "для всех пользователей", Windows-клиент нужно запустить с правами локального администратора.

Установка клиентской части модуля Управление процессами из установочного пакета

Запустите пакет установки Docsvision Workflow client.msi.

Рисунок 4. Мастер установки клиентской части модуля Управление процессами

Для установки клиентской части модуля используются область и каталог установки, указанные в конфигурационном файле модуля Платформа, см. документацию модуля Платформа Раздел "Настройка клиентской части".
Примите условия лицензионного соглашения для продолжения установки.

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

Рисунок 6. Начало установки клиентской части модуля Управление процессами

Для установки с областью установки "для всех пользователей" требуются права локального администратора.
Нажмите на кнопку Готово, чтобы закрыть мастер установки.

Удаление модуля

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

Удалите:

Управление процессами. Сервер.
Управление процессами. Клиент.