Установка базовых модулей и расширений на сервер под управлением Linux

Данный раздел описывает установку базовых модулей для ОС Linux. Все описанные ниже команды необходимо выполнять после завершения действий, описанных в разделе "Установка Консоли управления Docsvision и Сервиса настроек".

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

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

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

    • РЕД ОС

    sudo apt-get update
    sudo apt-get install docsvision-workerservice
    sudo dnf makecache
    sudo dnf install docsvision-workerservice
  2. Приоритетным способом настройки системы является Консоль управления Docsvision, настройки в конфигурационном файле могут быть упразднены в будущих версиях. Рекомендуется обновить систему до версии с Консолью управления 6.2 и выше.

Установка модуля Платформа на Linux

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

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

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

    • РЕД ОС

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

    Вместе с модулем Платформа команда установит серверные компоненты базовых модулей.

  2. Выполните конфигурацию модуля по инструкции в разделе "Конфигурация Сервера приложений".

Установка файлового сервиса

  1. Установите пакеты модуля:

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

    • РЕД ОС

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

Установка Web-клиента

  1. Установите пакеты модуля:

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

    • РЕД ОС

    $ sudo apt-get install docsvision-webclient
    $ sudo dnf install docsvision-webclient

Установка СУБП

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

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

    • РЕД ОС

    $ sudo apt-get install docsvision-workflow
    $ sudo dnf install docsvision-workflow

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

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

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

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

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

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

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

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

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

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

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

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

    • РЕД ОС

    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-клиент, Управление процессами, Служба фоновых операций.

Заполнение конфигурационных файлов и регистрация сервисов

  1. Настройте конфигурацию Службы фоновых операций по адресу /usr/lib/docsvision/workerservice/, укажите необходимые параметры:

    В конфигурационном файле /usr/lib/docsvision/workerservice/appsettings.json для Linux располагаются настройки защищённого соединения.

    Фрагмент конфигурационного файла "appsettings.json":
    {
    "DocsVision": {
      "SettingsService": {
        "ConnectionString": "http://settings.domain.com:5200/api", (1)
        "ApiKey": "anything" (2)
      }
    },
      "RestApiAddress": "http://worker.domain.com:5900/api", (3)
      "LogTraceLevel": "1", (4)
      "Kestrel": { (5)
        "Endpoints": {
          "Http": {
            "Url": "http://*:5900"
          }
        }
      }
    }
    1 Адрес подключения к Сервису настроек.
    2 Ключ доступа к Сервису настроек — "пароль", который также должен быть указан в конфигурационном файле сервиса.
    3 Адрес подключения к Службе фоновых операций.
    4 Уровень журналирования Службы фоновых операций, см. подробнее "Журнал работы".
    5 Настройка защищённого (HTTPS) соединения для Службы фоновых операций для защиты конфиденциальных данных, см. подробнее "Подключение к Docsvision по HTTPS". Настройка также позволяет задать порт и адрес подключения к Службе фоновых операций.
  2. Перезапустите Службу фоновых операций командой:

    $ sudo systemctl restart dvworkerservice

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

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

DocsVision  ServiceId

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

DocsVision  SettingsService  ConnectionString

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

DocsVision  SettingsService  ApiKey

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

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

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

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

    $ sudo systemctl restart dvappserver dvwebclient dvworkflow dvfileservice

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

Обратите внимание, начиная с определённых версий[1], перечисленные далее системные службы запускаются от имени УЗ Docsvision и не требуют root-привилегий: Web-клиент, Управление процессами, Службы фоновых операций, Сервиса настроек, Консоли управления Docsvision Файлового сервиса, Сервиса полнотекстового индексирования.


1. Точные версии следующие: Web-клиент 6.1 сборки 1110 и выше, Управление процессами версии 6.1, сборка 284 и выше, Службы фоновых операций версии 6.1, сборка 147 и выше, Сервис настроек версии 6.1, сборка 187 и выше, Консоль управления Docsvision версии 6.2, сборка 1057 и выше, Файловый сервис устанавливается вместе с модулем Платформа версии 6.1, сборка 853 и выше, Сервис полнотекстового индексирования устанавливается вместе с модулем Платформа версии 6.1, сборка 853 и выше