Установка базовых модулей и расширений на сервер под управлением Linux
Данный раздел описывает установку базовых модулей для ОС Linux. Все описанные ниже команды необходимо выполнять после завершения действий, описанных в разделе "Установка Консоли управления Docsvision и Сервиса настроек".
Установка Службы фоновых операций на сервер под управлением Linux
-
Установите серверные компоненты Службы фоновых операций следующей командой, предварительно обновив индекс пакетов:
-
Astra Linux / Альт Сервер / Ubuntu
-
РЕД ОС
sudo apt-get update sudo apt-get install docsvision-workerservicesudo dnf makecache sudo dnf install docsvision-workerservice -
-
Приоритетным способом настройки системы является Консоль управления Docsvision, настройки в конфигурационном файле могут быть упразднены в будущих версиях. Рекомендуется обновить систему до версии с Консолью управления 6.2 и выше.
Установка модуля Платформа на Linux
После завершения предварительной настройки сервера установите серверные компоненты модуля, используя команды ниже.
-
Установите пакеты модуля Платформа следующей командой, предварительно обновив индекс пакетов:
-
Astra Linux / Альт Сервер / Ubuntu
-
РЕД ОС
sudo apt-get update sudo apt-get install docsvision-platformsudo dnf makecache sudo dnf install docsvision-platformВместе с модулем Платформа команда установит серверные компоненты базовых модулей.
-
-
Выполните конфигурацию модуля по инструкции в разделе "Конфигурация Сервера приложений".
Установка файлового сервиса
-
Установите пакеты модуля:
-
Astra Linux / Альт Сервер / Ubuntu
-
РЕД ОС
sudo apt-get update sudo apt-get install docsvision-fileservicesudo dnf makecache sudo dnf install docsvision-fileservice -
Установка Web-клиента
-
Установите пакеты модуля:
-
Astra Linux / Альт Сервер / Ubuntu
-
РЕД ОС
$ sudo apt-get install docsvision-webclient
$ sudo dnf install docsvision-webclient
-
Установка СУБП
-
Установите модуль Управление процессами следующей командой:
-
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, расширения добавляются в систему при первичной установке или обновлении Консоли. В Альт Сервер и при установке Консоли на отдельный сервер расширения всегда требуется устанавливать вручную. |
-
Выполните следующие команды:
-
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-mcsudo 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 -
-
Перезапустите службы Docsvision для следующих модулей: Файловый сервис, Платформа, Web-клиент, Управление процессами, Служба фоновых операций.
Заполнение конфигурационных файлов и регистрация сервисов
-
Настройте конфигурацию Службы фоновых операций по адресу
/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". Настройка также позволяет задать порт и адрес подключения к Службе фоновых операций. -
Перезапустите Службу фоновых операций командой:
$ sudo systemctl restart dvworkerservice
Регистрация модулей системы
Чтобы настраивать модули системы через интерфейс Консоли управления Docsvision, необходимо в конфигурационных файлах настраиваемых модулей были указаны параметры, перечисленные ниже.
-
Уникальный идентификатор данного экземпляра модуля. Параметр задаётся автоматически при установке модуля.
-
Адрес подключения к хранилищу настроек. Параметр необходимо указать вручную.
-
Ключ приложения для подключения к хранилищу настроек. Параметр необходимо указать вручную.
-
Откройте поочерёдно конфигурационные файлы в каталогах модулей Платформа, Файловый сервис, Web-клиент, Управление процессами и укажите недостающие параметры в требуемых секциях. Конфигурационные файлы располагаются в каталогах по адресу
/usr/lib/docsvision/имя-модуля/appsettings.json.Внесение иных изменений в конфигурационные файлы допустимо только после полного завершения всех действий по обновлению системы, чтобы существующие настройки автоматически перенеслись в интерфейс Консоли управления.
-
После редактирования конфигурационных файлов обязательно перезапустите соответствующие системные службы:
$ sudo systemctl restart dvappserver dvwebclient dvworkflow dvfileservice
Убедиться в успешной регистрации сервисов можно следующим образом: запустить Консоль управления Docsvision и открыть страницу Серверы, выбрать сервер из списка слева. Если для выбранного сервера в правой колонке доступны разделы настроек "Сервер приложений", "Веб-клиент", "Управление процессами" и "Файловый сервис", регистрация выполнена успешно. В противном случае проверьте конфигурацию модулей и перезапустите службы ещё раз.
|
Обратите внимание, начиная с определённых версий[1], перечисленные далее системные службы запускаются от имени УЗ Docsvision и не требуют root-привилегий: Web-клиент, Управление процессами, Службы фоновых операций, Сервиса настроек, Консоли управления Docsvision Файлового сервиса, Сервиса полнотекстового индексирования. |