Установка

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

Для установки необходимо:

1. Скачать и запустить скрипт установки:
   

   curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/add_rep.sh -o /tmp/add_rep.sh
   chmod +x /tmp/add_rep.sh
   /tmp/add_rep.sh

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

   sudo apt update
   sudo apt install artixcs-ads

Установка на кассе (Artix:SCO и Artix:POS)

Для работы необходимо установить пакет artix-ads:

apt update
apt install artix-ads

Настройки 

На Artix Control Center

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

На кассе (Artix:POS)

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

1.  Установить пакет artix-view командой:
   

   aptitude install artix-view

2. Активировать модуль viewconnector:


   Наименование	Возможные значения	Описание
   Файл /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini, секция [plugins], настройки приложения artix-view
   viewconnector	on off	Активация модуля viewconnector

   Пример настройки

   [plugins]
   viewconnector = on

3. Настроить параметры отображения информации для покупателя:
   

   Наименование	Возможные значения	Описание
   Файл /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini, секция [View.Style], настройки отображения приложения artix-view
   displayType	0 – только чек, 1 – только реклама, 2 – чек слева, реклама справа, 3 – реклама слева, чек справа, 4 – чек вверху, реклама внизу, 5 – реклама вверху, чек внизу, 6 – в режиме ожидания - только реклама, в режиме формирования - только чек.	Тип отображения информации

   Пример настройки отображения чека слева, рекламы справа

   [View.Style]
   ; Настройки отображения приложения artix-view
   
   ; Тип отображения информации
   ; 0 - только чек
   ; 1 - только реклама
   ; 2 - чек слева, реклама справа
   ; 3 - реклама слева, чек справа
   ; 4 - чек вверху, реклама внизу
   ; 5 - реклама вверху, чек внизу
   ; 6 - в режиме ожидания - только реклама, в режиме формирования - только чек
   ; по умолчанию 0
   displayType = 2

4. Указать путь к потоку на Ads сервисе:
   

   Наименование	Возможные значения	Описание
   Файл /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini, секция [ViewConnector.Ads], настройки модуля сервиса оповещения
   url	по умолчанию http://0.0.0.0:49152/v1/stream/connect	Путь к потоку на ads сервисе

   Пример настройки

   [ViewConnector.Ads]
   ; Путь к потоку на ads сервисе
   ; По умолчанию не указан
   ; Если не указан - не используется
   ;url = http://0.0.0.0:49152/v1/stream/connect

5. Сконфигурировать экраны:
   
    Для монитора, на который будет осуществляться вывод информации для покупателя, необходимо указать приложение /linuxcash/cash/view/artix-view:
   
   Подробнее о настройке экранов можно прочитать в статье "Настройка экрана".

Настройка сервиса

[Main]
; Основные настройки

; Адрес, который будет слушать сервис для соединения сервера
listen = 0.0.0.0:49152

; Период повторной попытки синхронизации после ошибки в секундах
; По умолчанию 60
;syncRepeat = 60

; Заполнитель, отображаемый, при отсутствии иных данных для отображения
; По умолчанию "/opt/artix-ads/placeholder"
;defaultPlaceholder = "/opt/artix-ads/placeholder"

На кассе самообслуживания (Artix:SCO)

Для работы необходимо настроить модуль Ads:

[Ads]
; Включение модуля, по умолчанию false
;enable = false

; Путь к потоку на ads сервисе
; По умолчанию http://0.0.0.0:49152/v1/stream/connect
;url = http://0.0.0.0:49152/v1/stream/connect

; Время простоя, после которого начинает отображаться реклама
; в секундах, не менее 1 секунды, по умолчанию 60
;showTimeout = 60

; Экран, на котором отображается реклама, по умолчанию primary
; Возможные значения:
; primary - основной экран программы
; second - первый попавшийся не основной экран
; системное название экрана - список можно посмотреть в root.log
;screen = primary

; Автоматический переход в режим формирования после закрытия рекламы, по умолчанию false
;startCheck = false

; Отключить виджет рекламы в продаже для Slim
; Реклама будет отображаться на весь экран
; По умолчанию false
;disableWidget = false

Настройка сервиса

[Main]
; Основные настройки

; Адрес, который будет слушать сервис для соединения сервера
listen = 0.0.0.0:49152
 
; Период повторной попытки синхронизации после ошибки в секундах
; По умолчанию 60
;syncRepeat = 60

; Заполнитель, отображаемый, при отсутствии иных данных для отображения
; По умолчанию "/opt/artix-ads/placeholder"
;defaultPlaceholder = "/opt/artix-ads/placeholder"

Настройка сервиса мониторинга статистики

В Artix Digital Signage 

max_connections = 200

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

server.port = 8024

spring.datasource.url=jdbc:postgresql://localhost:5432/ads
spring.datasource.username=netroot
spring.datasource.password=netroot

cs.url=http://127.0.0.1:38051/CSrest/rest/

# upload large files with rest
server.tomcat.max-swallow-size=-1
spring.servlet.multipart.max-file-size=2GB
spring.servlet.multipart.max-request-size=2GB

spring.rsocket.server.transport=websocket
spring.rsocket.server.mapping-path=/
spring.rsocket.server.port=7000
serviceName=artixcs-ads

После настройки приложение будет доступно по адресу http://<IP-адрес сервиса>:8824.

Настройка взаимодействия с сервисом мониторинга статистики

Для передачи запросов к сервису мониторинга статистики в конфигурацию nginx добавлен маршрут, перенаправляющий запросы на сервис мониторинга статистики. Адрес сервиса статистики задается с помощью алиаса ads.stats.host в /etc/hosts. По умолчанию после установки пакета sco-stats-service заполняется как 127.0.0.1.

Для изменения адреса сервиса мониторинга статистики используется скрипт setHostName.sh, расположенный в /opt/artixcs-ads/supportFile. Для изменения выполните команды:

chmod +x setHostName.sh
./setHostName.sh ads.stats.host <IP-адрес>

После изменения файла необходимо перезапустить nginx:

sudo systemctl restart nginx

Логирование

По умолчанию логи работы artix-ads записываются в файл /linuxcash/logs/current/artix-ads.log.

Настройка логов на кассе осуществляется в файле /opt/artix-ads/config.ini:

[Logger]
; Настройки логгера 
; Путь до файла
; По умолчанию "/linuxcash/logs/current/artix-ads.log" 
;path = "/linuxcash/logs/current/artix-ads.log" 

; Уровень логирования
; По умолчанию "error" 
;level = "error" 

; Максимальный размер файла для ротации (в кб)
; По умолчанию 5000
;maxFileSize = 5000

; Максимальное кол-во файлов
; По умолчанию 5
;maxFiles = 5