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

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

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

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

Чтобы установить модуль Управление процессами на сервер под управлением Linux:

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

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

    • РЕД ОС / SberLinux

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

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

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

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

Чтобы установить модуль Управление процессами на сервер под управлением Windows:

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

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

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

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

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

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

    Выбирайте необходимые компоненты в зависимостми от настраиваемого сервера. На основном сервере Docsvision обязательно должны быть установлены "Серверные компоненты" модуля. Для работы модулей, устанавливаемых отдельно (например, Консоль управления Docsvision, Служба фоновых операций, Web-клиент и т.д.), достаточно устанавливать только расширения (при наличии) и общие компоненты. См. "Требования к системе Docsvision" в разделе "Необходимые ресурсы", чтобы определить связь с другими модулями.

    Выбранные компоненты сохраняются при обновлении модуля, т.е. выбирать компоненты повторно при обновлении не потребуется. Если все модули установлены вместе, достаточно выбрать компоненты только при первой установке.
    Общие компоненты

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

    Серверные компоненты

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

    Служба Windows

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

    Расширение Консоли управления Docsvision

    Расширение Консоли управления Docsvision необходимо для настройки служб в Консоли и просмотра сообщений.

    Кнопка Сброс

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

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

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

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

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

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

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

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

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

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

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

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

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

    • РЕД ОС / SberLinux

    sudo apt-get update
sudo apt-get install docsvision-ext-workflow-mc
    sudo dnf makecache
sudo dnf install docsvision-ext-workflow-mc

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

  2. Перезапустите службу dvworkflow.

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

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

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

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

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

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

  1. Убедитесь, что в конфигурационном файле модуля Управление процессами по адресу /usr/lib/docsvision/workflow/appsettings.json для Linux и C:\Program Files\Docsvision\Workflow\appsettings.json для Windows указаны описанные ниже настройки. Файл может быть изменён в любом текстовом редакторе, например nano или блокноте (потребуются права суперпользователя/администратора). Настройки в конфигурационном файле:

    Фрагмент конфигурационного файла Управление процессами:
    {
  "Docsvision": {
    "ServiceId": "00000000-0000-0000-0000-000000000000", (1)
    "SettingsService": {
      "ConnectionString": "http://localhost:5200/api", (2)
      "ApiKey": "anything" (3)
    }
  },
  "AllowedHosts": "*",
  "Kestrel": { (4)
    "Endpoints": {
      "Http": {
        "Url": "http://*:5000"
      }
    }
  }
}
    1 ServiceId — уникальный идентификатор данного экземпляра модуля, генерируется и записывается автоматически.
    2 ConnectionString — полный адрес Сервиса настроек.
    3 ApiKey — API-ключ для подключения к Сервису настроек, можно оставить значение по умолчанию или изменить, главное условие, чтобы значения в конфигурации модулей Сервис настроек и Управление процессами были одинаковые.
    4 Опционально. Настройка доступа к Storage Server по HTTPS, см. подробнее Доступ к Storage Server по HTTPS в документации модуля Платформа.

  2. Дальнейшие настройки Расширения модуля Управление процессами для Консоли управления Docsvision выполняются в Консоли управления Docsvision. Откройте Консоль управления Docsvision на странице Серверы  Имя сервера  Управление процессами  "Группа настроек "Подключения" и настройте следующие параметры:

    • Сервер приложений — имя сервера из списка.

    • Почта по умолчанию — почтовым соединением по умолчанию для данного экземпляра модуля Управление процессами.

    • Имя пользователя — имя системной учётной записи Docsvision.

    • Пароль — пароль системной учётной записи.

      Пароль может быть зашифрован, "Штамп сертификата шифрования паролей" указывается в разделе "Общие настройки сервера приложений".

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

    • Обрабатываемые базы данных — настройка для выбора БД доли обрабатываемых процессов и почтового соединения, с которыми будет работать данный сервер СУБП.

    • API-ключ для подключения к Workflow — ключ для подключения серверного расширения Управление процессами, должен быть одинаковым в конфигурации модулей Платформа и Управление процессами.

  3. Запустите службу модуля Управление процессами.

Установка и конфигурация без Консоли управления Docsvision

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

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

    • РЕД ОС / SberLinux

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

  2. Приоритетным способом настройки системы является Консоль управления Docsvision, но настройки в конфигурационном файле `/usr/lib/docsvision/workflow/appsettings.json` для Linux и `C:\Program Files\Docsvision\Workflow\appsettings.json` для Windows.json имеют приоритет перед Консолью управления, см. подробнее "Страница "Серверы"" в документации Консоли управления Docsvision. Это сделано с целью оставить возможность постепенного перехода от настройки модулей через конфигурационные файлы к конфигурации через Консоль управления Docsvision.

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

    {
  "Docsvision": {
    "Workflow": {
      "ServiceUrl": "http://dvserver.domain.com:5000/api/v1", (1)
      "BaseName": "alias", (2)
      "WorkflowServer": {
        (3)
      }
    },
  "ServiceId": "203ed2fd-f9ea-4886-9708-b8192334dd28", (4)
  "SettingsService": {
    "ConnectionString": "http://storage-server.com:5200/api", (5)
    "ApiKey": "dvworkflowapikey" (6)
  },
  "DataProtectCertificateThumbprint": "thumbprint", (7)
  "SystemUserAccount": "account@domain.com", (8)
  "SystemUserPassword": "password", (9)
  "APIKEY": "api-key" (10)
}
    1 ServiceUrl — Адрес сервера Docsvision. Обратите внимание на api/v1 в адресе.
    2 BaseName — Псевдоним БД Docsvision.
    3 WorkflowServer — Настройки почты, подробнее см. раздел "Настройки почты в конфигурационном файле модуля".
    4 ServiceId — Уникальный идентификатор данного экземпляра модуля, генерируется и записывается автоматически.
    5 ConnectionString — Адрес подключения к сервису настроек.
    6 ApiKey — Ключ приложения для подключения к сервису настроек.
    7 DataProtectCertificateThumbprint — Отпечаток закрытого ключа шифрования SHA1.
    Указывается без двоеточия, например, D8602179888DC8402B393F11DCA16A3376DDF879, см. подробнее в документации по установке системы, раздел "Защита системной учётной записи".
    Если шифровать пароль системной учётной записи не планируется, параметр можно удалить.
    8 SystemUserAccount — Имя системной учётной записи Docsvision.
    9 SystemUserPassword — Пароль системной УЗ, рекомендуется хранить в зашифрованном виде, см. подробнее в документации по установке системы, раздел "Защита системной учётной записи".
    Не рекомендуется авторизоваться на клиентских рабочих местах под системными учётными записями, т.к. это может привести к ошибкам в работе системы.
    10 APIKEY — Используется для аутентификации в API Управление процессами. Можно оставить значение по умолчанию или изменить, главное условие, чтобы значения в конфигурации модулей Платформа и Управление процессами были одинаковые.

  3. Запустите службу dvworkflow.

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

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

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

  • Автоматически — требуемые компоненты будут загружены с сервера Docsvision и установлены автоматически.

  • Вручную — администратор должен самостоятельно установить клиентскую часть модуля Управление процессами.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. На сервере Linux включите учётную запись в локальные группы DocsVision Power Users.

    Группы настраиваются:

    • В конфигурационном файле модуля Платформа, подробнее см. в документации модуля Платформа, раздел "Конфигурация Сервера приложений".

    • В Консоли управления Docsvision, разделе "Управление доступом", подробнее см. в документации модуля Консоль управления Docsvision, раздел "Управление доступом".

  2. На компьютере с серверной частью модуля:

    • Включите учётную запись в локальную группу Users.

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

  1. Предоставьте созданной учётной записи полные права по дискреционной модели безопасности на все папки и справочники системы Docsvision.

  2. Для работы с карточками приложения Управление документами, включите учётную запись в группу Системная для WF в Справочнике сотрудников.

  3. Назначьте учётной записи персональную лицензию в Docsvision (см. документацию модуля "Платформа".

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

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

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

    • Astra Linux

    • РЕД ОС / SberLinux

    • Альт Сервер

    $ sudo apt-get purge docsvision-workflow
    $ sudo dnf remove docsvision-workflow
    $ sudo apt-get remove docsvision-workflow

    • Чтобы удалить раширение для Консоли управления Docsvision в ОС Linux, выполните:

      • Astra Linux

      • РЕД ОС / SberLinux

      • Альт Сервер

      $ sudo apt-get purge docsvision-ext-workflow-mc
      $ sudo dnf remove docsvision-ext-workflow-mc
      $ sudo apt-get remove docsvision-ext-workflow-mc

      Компоненты модуля и расширение следует удалять до удаления компонентов модуля Платформа.