Установка Artix:ConsultantApp

Установка на кассовый сервер (Artix Control Center)

Установить пакет artixcs-consultant-app.

sudo apt update
sudo apt install artixcs-consultant-app

Установка на отдельный сервер

  1. Необходимо добавить репозиторий:

    wget -O - http://update.artix.su/artix.gpg.key | sudo apt-key add -
echo 'deb [arch=amd64] http://update.artix.su/cs/ cashserver4_stable cashserver4' | sudo tee /etc/apt/sources.list.d/cashserver4.list

  2. Установить пакет artixcs-consultant-app.

    sudo apt update
sudo apt install artixcs-consultant-app

Пакет будет установлен в директорию /opt/artixcs-consultant-app. Логирование работы сервиса ведется в файле /var/log/artix/artixcs-consultant-app/artixcs-consultant-app.log.

Обновление

Для обновления необходимо выполнить команды:

sudo apt update
sudo apt install artixcs-consultant-app

Настройки

На кассе самообслуживания (КСО)

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

Наименование

Возможные значения

Описание

Файл /opt/sst-sco/conf/assistant.ini, секция [Assistant], настройки модуля сервиса оповещения
enable
  • true
  • false (по умолчанию)
Включение модуля
listen<хост>:<порт>
по умолчанию 0.0.0.0:3203		Прослушиваемый адрес. Устанавливается в 0.0.0.0:3203 для включения сервера
Пример настройки
[Assistant]
enable = true

На кассе самообслуживания можно задать дополнительные параметры подключения к Artix:ConsultantApp:

Наименование

Возможные значения

Описание

Файл /opt/sst-sco/conf/assistant.ini, секция [Assistant.gRPC], настройки модуля сервиса оповещения
keepaliveTime

целое положительное число
по умолчанию 3600 (1 час)

Время жизни соединения. В секундах
keepaliveTimeout

целое положительное число
по умолчанию 1

Время ожидания ответа на запрос состояния соединения. В секундах
maxPingsWithoutData

целое положительное число
по умолчанию 2

Количество ping-запросов, которые могут быть отправлены, когда нет данных

Для уменьшения вероятности разрыва связи по истечении времени жизни соединения можно использовать значения:

Пример настройки
[Assistant.gRPC]
keepaliveTime = 1
keepaliveTimeout = 3600
maxPingsWithoutData = 0

Логирование модуля Assistant для КСО по умолчанию осуществляется в /linuxcash/logs/current/sst-sco/root.log.

На гибридной кассе

Настройка выполняется отдельно для режима КСО и режима РМК.

Для отображения гибридной кассы в интерфейсе Artix:ConsultantApp при переключении в режим РМК необходимо включить плагин assistant. Данные настройки используются для всех гибридных касс. После настройки плагина необходимо выполнить перезапуск кассы.

НаименованиеВозможные значенияОписание
Файл /linuxcash/cash/conf/ncash.ini.d/assistant.ini, секция [plugins], плагин для работы гибридной кассы с сервисом оповещения
assistant
  • on
  • off (по умолчанию)

Включение плагина

Файл /linuxcash/cash/conf/ncash.ini.d/assistant.ini, секция [Assistant], настройки сервиса оповещения
listen

<хост>:<порт>
по умолчанию 0.0.0.0:3203

Прослушиваемый адрес. Устанавливается в 0.0.0.0:3203 для включения сервера
Пример настройки
[plugins] 
assistant = on

Логирование плагина assistant для гибридной кассы в режиме РМК осуществляется в /linuxcash/logs/current/terminal.log.

В Artix:ConsultantApp

Настройки Artix:ConsultantApp задаются на кассовом сервере (Artix Control Center) или на другом сервере с установленным пакетом artixcs-consultant-app.

Наименование

Возможные значения

Описание

Файл /opt/artixcs-consultant-app/application.properties
server.port

<порт>
по умолчанию 18095

Порт сервера Artix:ConsultantApp
cs.host

<хост>
по умолчанию 127.0.0.1

IP-адрес кассового сервера
cs.port<порт>
по умолчанию 38051		Порт кассового сервера
keystore.filenameпо умолчанию sco_cash_key_store.pkcs12

Наименование файла хранилища SSL-сертификатов

keystore.password

Пароль от файла хранилища.

Рекомендуется установить уникальный пароль для хранилища сертификатов после установки Artix:ConsultantApp

keystore.certificate.life.period.in.daysпо умолчанию 36500Срок жизни сертификата в днях
serviceNameпо умолчанию artixcs-consultant-appНазвание сервиса
Пример настройки
server.port=18095
cs.host=<IP-адрес Artix Control Center>
cs.port=38051

keystore.filename=sco_cash_key_store.pkcs12
keystore.password=12345
keystore.certificate.life.period.in.days=36500

serviceName=artixcs-consultant-app
Если Artix:ConsultantApp установлен на отдельную машину, то необходимо указать:
  • IP-адрес Artix Control Center,
  • порт Artix Control Center.
    Если указать порт 8080, то будет произведено перенаправление на рабочий порт Artix Control Center.

После настройки приложение будет доступно по адресу http://<IP-адрес Artix Control Center>:<server.port>.

  • No labels