Развертывание сервиса печати через терминал

Установка сервиса печати доступна с версии WEB-Сервер-КС 6.0.9.060.

Данная инструкция описывает процесс установки сервиса печати на сервере, где уже развернут RMQ-КС.

Шаги по установке Docker/Podman не будут включены, поскольку предполагается, что ПО котнейнеризации уже установлено данном сервере.

Перед началом развертывания

⚠️ Заведите пользователя в рабочей базе с именем rsdbmgr и паролем (в примере установки пароль 1).
Этот пользователь должен иметь роль администратора комплекса. От его имени будут запускаться процессы, связанные с сервисом печати. Логин и пароль понадобятся при развертывании.

1. Получите root-права

Наберите команду и введите пароль от пользователя root.

sudo su

2. Скачайте и распакуйте образ dks-wsks-6.0.9

wget -O /opt/dks-wsks-6.0.9_d12.tar.gz https://keysystems.ru/files/web/Linux/wsks/6.0.9/dks-wsks-6.0.9_d12.tar.gz
tar -C /opt/ -xvf /opt/dks-wsks-6.0.9_d12.tar.gz

3. Установите контейнер «WEB-Сервер-КС»

Установите контейнер «WEB-Сервер-КС» с http-сервером или без http-сервера.

Узнайте сначала установленные локали:

locale -a | grep ru

Пример вывода ru_RU.utf8:

ru_RU
ru_RU.koi8r
ru_RU.utf8
ru_UA
ru_UA.utf8

3.1. Установка контейнера с http-сервером

Выберите вариант установки:

• Docker+Nginx Рекомендуется к установке
• Docker+Angie В РРПО
• Docker+Apache
• Podman+Apache
• Podman+Nginx
• Podman+Angie

В данном примере:

• 443 - это виртуальный порт (этот порт не публикуется).
• порт 9093 - это порт prometheus (сбор метрик сервисов),
• локаль - ru_RU.utf8

Важно!

В случае, если порт web-сервиса использовался отличный от 443, то наименование установленного контейнера будет иметь вид wsks-6.0.9_54хх, поэтому нужно быть внимательнее, так как дальнейшая инструкция установки описана для контейнера с портом 443 (wsks-6.0.9_443).

Не устанавливайте вариант с Apache в ОС ROSA Enterprise Linux Server 7.3!

Docker:

Nginx Рекомендуется к установке

/opt/dks-wsks-6.0.9/install.sh -ws "nginx" -p "443" -cs "docker" -pp "9093" -l ru_RU.utf8

Angie В РРПО

/opt/dks-wsks-6.0.9/install.sh -ws "angie" -p "443" -cs "docker" -pp "9093" -l ru_RU.utf8

Apache

/opt/dks-wsks-6.0.9/install.sh -ws "apache2" -p "443" -cs "docker" -pp "9093" -l ru_RU.utf8

Podman:

Nginx

/opt/dks-wsks-6.0.9/install.sh -ws "nginx" -p "443" -cs "podman" -pp "9093" -l ru_RU.utf8

Angie

/opt/dks-wsks-6.0.9/install.sh -ws "angie" -p "443" -cs "podman" -pp "9093" -l ru_RU.utf8

Apache

/opt/dks-wsks-6.0.9/install.sh -ws "apache2" -p "443" -cs "podman" -pp "9093" -l ru_RU.utf8

Вывод терминала

           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
           ~     Установка контейнера WEB-Сервер-КС
           ~        http сервер: nginx
           ~           порт\id : 443
           ~   контейнеризация : docker
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[   OK   ] Проверка доступности порта 443  ПО "WEB-Сервер-КС".
[   OK   ] Проверка доступности порта 9093  ПО "prometheus".
[   OK   ] Проверка работы сервиса ПО "Docker" (docker.service).
[   OK   ] Загрузка эталонного локального образа wsks-6.0.9 из архива ksdeb12_wsks-6.0.9_image.tar.
[   OK   ] Построение конечного образа wsks-6.0.9_443 на базе эталонного.
           Структура каталогов /opt/wsks-6.0.9_443 для запуска контейнера wsks-6.0.9_443 не существует, создаем...
[   OK   ] Создание структуры каталогов для запуска контейнера wsks-6.0.9_443.
[   OK   ] Создание контейнера wsks-6.0.9_443 и запуск в docker (порт\id 443).
[   OK   ] Создание пользователя ks-www-data.
           Группа ks-www-data существует.
           Пользователь ks-www-data существует.
[   OK   ] Остановка контейнера wsks-6.0.9_443.
[   OK   ] Настройка ротации логов ПО "WEB-Сервер-КС".
[   OK   ] Запуск сервиса wsks-6.0.9_443.service.
[  Инфо  ] Остановка сервиса wsks-6.0.9_443.service.
           Отсутствуют установленные приложения.
           Для развертывания веб приложений используйте скрипт ws_addapp.sh.
           См. инструкцию по развертыванию /opt/wsks-6.0.9_443/ctl/readme.txt

3.2. Установка контейнера без http-сервера

В данном примере:

• 443 - это виртуальный порт (этот порт не публикуется).
• порт 9093 - это порт prometheus (сбор метрик сервисов),
• локаль - ru_RU.utf8

Docker

/opt/dks-wsks-6.0.9/install.sh -ws "no_http" -p "443" -cs "docker" -pp 9093 -l ru_RU.utf8

Podman

/opt/dks-wsks-6.0.9/install.sh -ws "no_http" -p "443" -cs "podman" -pp 9091 -l ru_RU.utf8

4. Установите сервис печати

1. Скачайте архив сервиса печати:

wget -O /opt/wsks-6.0.9_443/ctl/tar_files/reportservice.tar.gz "https://keysystems.ru/files/web/INSTALL/SMART2/updates/ReportsService/25.1.37.806/ReportsService_net60_25.1.37.806.tar.gz"

1. Установите сервис:

bash /opt/wsks-6.0.9_443/ctl/ws_addapp.sh -t wSPrt -a reportservice.tar.gz -p auto -vc report -du rsdbmgr -dpwd 1 -mq amqp://admin:1@127.0.0.1:5672

Параметр	По умолчанию	Описание
-t --app_type	wSPrt	Тип устанавливаемого приложения «Сервис печати».
-a --app_tar_archive	reportservice.tar.gz	Имя архива *.tar.gz для развертывания. Переименованно в reportservice.tar.gz в процессе загрузки архива на хост.
-vc --virt_catalog	report	Виртуальный каталог для приложения. Если не указан, то берется тип + кестрел порт.
-p --kestrel_port	auto	Порт кестрел. Со значением auto порт присваивается автоматически.
-du --dbuser	rsdbmgr	Имя пользователя для соединения с БД.
-dpwd --dbpwd	1	Пароль пользователя БД.
-mq --mqconn	amqp://admin:1@127.0.0.1:5672	Строка соединения с брокером очередей (см. ниже).

Строка соединения с брокером очередей должна быть указана в следующем формате: amqp://<имя пользователя>:<пароль>@<IP-адрес>:<порт>
Параметры строки соединения:

• <имя пользователя> : Имя пользователя, указанное при развертывании «RabbitMQ» (RMQ).
• <пароль> : Пароль, заданный при конфигурации RMQ.
• <IP-адрес> : Адрес сервера, на котором развернут брокер очередей.
  • Если RabbitMQ развернут на том же сервере, где будет использоваться сервис, можно использовать локальный IP-адрес 127.0.0.1.
• <порт> : Номер порта, на котором работает RabbitMQ. По умолчанию используется порт 5672.

Примечание:
Значения параметров (имя пользователя, пароль, IP-адрес, порт) определяются во время развертывания «RabbitMQ». Убедитесь, что все данные корректны и соответствуют текущей конфигурации системы.

Вывод терминала

           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
           ~    Установка прикладного приложения WEB-Сервер-КС
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[   OK   ] Проверка доступности порта 54457 ПО "Сервис печати".
[   OK   ] Проверка виртуального каталога "report".
[   OK   ] Распаковка архива обновления "ReportsService_net6_25.1.9.129.tar.gz" в рабочий каталог.
[   OK   ] Создание каталога приложения /opt/wsks-6.0.9_443/www/html/wsks_54457.
[   OK   ] Создание файла запуска приложения /opt/wsks-6.0.9_443/ctl/app/54457_app.sh.
           Приложение будет доступно по адресу - https://10.38.46.115:443/report.
[   OK   ] Создание файла конфигурации для приложения /opt/wsks-6.0.9_443/conf.ks/vhost.ks/54457_ks.conf.
[   OK   ] Создание файла настроек для приложения /opt/wsks-6.0.9_443/www/html/wsks_54457/appsettings.Production.json.
[   OK   ] Запуск .NET Core приложения.