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

Установка

Перед установкой сервера лояльности на отдельную машину необходимо: 

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. Обновить список доступных пакетов командой:

   sudo apt-get update

3. Установить пакет для конфигурирования зависимостей MySQL сервера командой:

   sudo apt-get -y install artixcs-apt-config

4. Установить пакет с MySQL-сервером командой:

   sudo apt-get install artixcs-config

Установка серверов лояльности осуществляется с указанием названия необходимого пакета:

Для установки сервера лояльности выполните следующую команду:

sudo apt-get install <пакет_для_установки>

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

service <пакет_для_установки> status

Настройка

Настройка работы серверов лояльности осуществляется в конфигурационном файле application.properties, расположенном в своей директории для каждого сервера:

• для бонусного сервера в /opt/artixcs-accounting-bonuses/,
• для сервера сертификатов в /opt/artixcs-accounting-certificates/,
• для сервера купонов в /opt/artixcs-accounting-coupons/,
• для бонусного сервера и сервера сертификатов одновременно в /opt/artixcs-accounting-bonuses-certificates/.
  
  

server.port=38058
#Контекстный путь, url для запроса к серверу. По умолчанию /ACC
server.contextPath=/ACC
#Указать директорию, в которой находяться конфигурационные файлы (все, за исключением application.properties - это файл должен лежать рядом с jar).
#По умолчанию конфигурационные файлы берутся изнутри jar. Для того чтоб указать файлы конфигурации с диска, нужно перед ними поставить префикс file:
accounting.properties.directory=classpath:config
#Запустить КС в light-режиме (можно делать начисления без явного создания карты и счета на сервере). Используется в COUPONS-режиме
accounting.logic.lightMode=true
#Использовать реляционное хранилище для храненения данных, по-умолчанию true (не может быть задано, если accounting.mongodb.storage=true)
#accounting.sql.storage=true
#Если хранилище реляционное, можно указать тип БД (mysql или mssql). Будут применяться настройки из файлов
# cashserver-routing-connection-mysql.properties или cashserver-routing-connection-mssql.properties соответственно
accounting.sql.type=mysql
#Использовать mongodb для хранения данных. Параметры подключения к mongodb указаны в файле accounting-mongo-connection-properties.properties (не может быть задано, если accounting.sql.storage=true)
#accounting.mongodb.storage=false
#При запуске сервера слушать thrift-интерфейс
accounting.with.thrift=true
#Порт для административного сервиса thrift
accounting.thrift.admin.port=7790
#Порт для основного сервиса thrift
accounting.thrift.logic.port=7791
##DO NOT CHANGE PARAMETERS BELOW WITHOUT EMERGENCY
spring.jackson.default-property-inclusion=non_null
spring.jackson.date-format=yyyy-MM-dd'T'HH:mm:ss.SSSX

serviceName=artixcs-accounting-coupons

accounting.logic.serverType=COUPONS
cashserver.artix.sql.dbsuffix=db_coupons
urls.mongo.database=db_accounting_coupons

Стыковка с кассовым сервером

Стыковка серверов лояльности с кассовым сервером осуществляется в настройках Artix Control Center в подразделе "Сервера Artix Loyality".

Для добавления сервера нажмите кнопку "Добавить БС". В появившемся окне заполните предложенные поля и сохраните изменения:

Пример стыковки купонного сервера с кассовым сервером

Заполненные поля соответствуют описанию полей в документации "Настройки сервера", подраздел "Сервера Artix Loyalty".

Настройка сервера в Artix Loyality Managment

При необходимости настроить сервер лояльности можно в Artix Loyality Managment. Подробнее можно прочитать в документации "Настройки".

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

Настройка работы бонусного сервера на кассе осуществляется в файле с расширением .xml, созданном в директории /linuxcash/cash/conf/plugins/ (например, artix_bonus.xml). 

Настройка работы сервера сертификатов на кассе осуществляется в файле с расширением .xml, созданном в директории /linuxcash/cash/conf/plugins/ (например, artix_certificate.xml).

Настройка работы купонного сервера на кассе осуществляется в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/onlinecoupon.ini.

...
[OnlineCoupon]
; Настройка плагина онлайн купонов

; Префикс онлайн купона
; для штрих-кода в формате EAN13 не более 3 цифр
;prefix = 888

; Адрес сервера онлайн купонов
host = 192.169.10.118

; Порт
port = 38058

; Таймаут запроса к серверу онлайн купонов
; значение по умолчанию 5
;timeout = 5

; Имя пользователя для авторизации на сервере
;user =

; Пароль для авторизации на сервере
;password =
...