Установка и обновление Artix:ConsultantApp

Системные требования

Для работы с Artix:ConsultantApp рекомендуется использовать операционную систему семейства Ubuntu, начиная с версии 22.04.

При работе с большим количеством касс (>1000) рекомендуется использовать 4-х ядерный CPU с поддержкой технологии Hyper-Threading, а также:

• для приложения Artix:ConsultantApp, установленного на отдельный сервер, необходимо выделить не менее 8 Gb ОЗУ,
• для приложения Artix:ConsultantApp, установленного на кассовый сервер, необходимо выделить 8 Gb ОЗУ дополнительно к тому объему оперативной памяти, который уже занимают другие приложения и сервисы.

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

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

   sudo apt update
   sudo apt install artixcs-consultant-app

2. Если в работе будет использована БД Mysql 5.7, то в конфигурационном файле /etc/mysql/mysql.conf в секции [mysqld] необходимо указать дополнительные настройки:
   

   character-set-server=utf8mb4
   collation-server=utf8mb4_unicode_ci

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

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

Настройки

На Artix Control Center

Для добавления кассы в Artix:ConsultantApp кассу необходимо создать в Artix:Control Center. Подробнее об этом можно прочитать в разделе "Архитектура торговой сети".

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

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

[Assistant]
enable = true

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

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

[Assistant.gRPC]
keepaliveTime = 1
keepaliveTimeout = 3600
maxPingsWithoutData = 0

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

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

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

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

[plugins] 
assistant = on

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

Повторное добавление кассы

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

При повторном добавлении кассы необходимо:

1. На кассе удалить директорию /etc/ssl/certs/assistant.
2. Перезапустить кассовую программу.
3. В веб-интерфейсе Artix:ConsultantApp обновить список касс:
   1. Перейти на страницу "Управление".
   2. Заново выбрать магазин из списка доступных магазинов.

В Artix:ConsultantApp 

Настройки Artix:ConsultantApp задаются на кассовом сервере (Artix Control Center) или на другом сервере с установленным пакетом 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

db.type=mysql
db.username=netroot
db.password=netroot  

markedgoods.storno.allowed=false
serviceName=artixcs-consultant-app

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

Авторизация из браузера РМК

В настройках Artix:ConsultantApp может быть задана возможность быстрой авторизации на Artix:ConsultantApp из браузера РМК без ввода логина и пароля. Для включения данной возможности необходимо в /opt/artixcs-consultant-app/application.properties вручную добавить и включить параметр trust.node.authorization для авторизации с доверенных узлов:

# Авторизация с доверенных узлов
trust.node.authorization=true

 В настройках Artix:ConsultantApp может быть задана возможность изменения время жизни кэша приложения. Для этого необходимо в /opt/artixcs-consultant-app/application.properties вручную добавить и задать параметр expire.cache.seconds.

# Время жизни кэша приложения (в секундах)
# По умолчанию 300 секунд
expire.cache.seconds=10

Запуск Artix:ConsultantApp в режиме kiosk

Данный режим работы обеспечивает запуск Artix:ConsultantApp на устройстве с Ubuntu (планшете или отдельной машине), где с выделенного места консультант КСО может совершать интервенции и следить за работой всего острова самообслуживания сразу.

Реализована возможность запуска Artix:ConsultantApp в режиме kiosk. При включенном режиме kiosk пользователю предоставляется доступ к операционной системе с ограниченными правами. 

Для запуска режима kiosk необходимо:

1. Создать скрипт kiosk.sh.
   

   kiosk.sh

   #!/bin/bash
   
   snap install ubuntu-frame chromium
   snap connect chromium:wayland ubuntu-frame:wayland
   
   snap set ubuntu-frame daemon=true
   snap set chromium url=<адрес доступа к Artix:ConsultantApp>

2.  Запустить скрипт командой:

   sudo sh kiosk.sh

При запуске kiosk пользователь получит доступ к веб-приложению Artix:ConsultantApp в браузере Google Chrome с url = <адрес доступа к Artix:ConsultantApp>.