Работа сервиса Nes обеспечивается пакетом artix-cs-nes (ранее использовался пакет artix-cs2.0-nes), в результате чего на кассовом сервере появится каталог /opt/nes.

Правила считывания конфигурационных файлов

Конфигурационные файлы представляют собой файлы формата *.ini, в которых находятся настройки сервиса. Основным конфигурационным файлом является /opt/nes/config/nes_load.ini, также настройки могут находиться в директории /opt/nes/config/conf.d/.

Порядок считывания настроек:

  1. Сначала считываются настройки из основного конфигурационного файла /opt/nes/config/nes_load.ini.

  2. Затем считываются настройки из конфигурационного файла директории /opt/nes/config/conf.d/.

Настройки из файла в директории /opt/nes/config/conf.d/ являются самыми приоритетными. Если они заданы, то в первую очередь будут использоваться они.

Настройки задаются в конфигурационном файле /opt/nes/config/nes_load.ini, который разделен на секции:

  • [MAIN] – обязательная секция, содержит настройки для работы Nes,
  • [mysql] – секция содержит настройки подключения к базе данных, а так же некоторые сервисные настройки,
  • [CS] – секция содержит настройки доступа к кассовому серверу,
  • [FILEQUEUE] – секция содержит настройки файл-очередей для передачи данных.

Базовая настройка

Базовая настройка предполагает конфигурирование основных процессов сервиса загрузки. Загрузчик обрабатывает данные с помощью процессов, для каждого из которых ведется журнал работы. Базовые настройки сервиса задаются в конфигурационном файле /opt/nes/config/nes_load.ini в секции [MAIN].

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

Тип данных

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

Описание

Примечания

logDirectoryстроковый

Директория ведения журнала событий Nes

По умолчанию директория /opt/nes/logs
poolProcessSize целочисленныйцелое положительное числоКоличество процессов, которые будут запущены для работы с даннымиПо умолчанию 3
modernObjectsлогический
  • true
  • false

Использовать для загрузки справочников новые объекты или старые.

  • true – новые,
  • false – старые.

По умолчанию true

sendDictGenerateEventOnCSлогический
  • true
  • false

Посылать команду генерации справочников на КС при выгрузке справочников из АСТУ

  • true – при выгрузке справочников из АСТУ отправляется команда генерации справочников на КС,
  • false – генерация справочников на КС после выгрузки справочников из АСТУ не производится.
По умолчанию true
notBlockDBForCommandsстроковый
Список команд, разделенных запятыми, для которых не требуется выполнять блокировку БДПо умолчанию addSoftCheck, clearSoftCheck, deleteSoftCheck

Настройка работы с базой данных

Сервис Nes работает непосредственно с базой данных кассового сервера. Настройка подключения загрузчика к БД и способ передачи данных осуществляется в конфигурационном файле /opt/nes/config/nes_load.ini в секции [mysql].

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

Тип данных

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

Описание

Примечания

hostстроковый
Хост системы управления базой данныхПо умолчанию localhost
portцелочисленныйцелое положительное числоПорт системы управления базой данныхПо умолчанию 3306

user

строковый
Логин системы управления базой данныхПо умолчанию netroot
passwordстроковый
Пароль системы управления базой данныхПо умолчанию netroot
commandCommitCountцелочисленныйцелое положительное числоКоличество команд, которые будут накоплены для выполнения подтверждения записи данных в БДПо умолчанию 600
migrateVersionцелочисленныйцелое положительное числоПоддерживаемая версия миграции БД на КСПо умолчанию 31

Настройка доступа к КС

Для отправки статусов загрузки справочников необходимо настроить доступ к кассовому серверу, на котором при каждой загрузке будет сохраняться соответствующая информация.

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

Тип данных

Описание

Примечания

defaultStatusServerстроковыйАдрес кассового сервера, на который по умолчанию должны отправляться статусы прогрузки справочниковПо умолчанию localhost:8080
serverUrlPrefixстроковыйПрефикс для URL сервераПо умолчанию /CSrest/rest
loginстроковыйЛогин для авторизации на КСПо умолчанию admin
passwdстроковыйПароль для авторизации на КСПо умолчанию admin

Настройка работы очереди сообщений 

Очередь сообщений необходима для обеспечения гарантированной доставки данных. Сервис Nes определяет, каким образом будет произведено подключение к очереди и по какому протоколу будет производиться передача сообщений.

НаименованиеТип данныхОписаниеПримечания
fileQueueRootстроковыйПуть до корневой директории файл-очередиПо умолчанию /opt/queues

Логирование

Файлы логов хранятся в директории /opt/nes/logs/.

Для работы с данными доступны следующие логи:

НаименованиеОписание
nesUploadService.logВ логе записываются события взаимодействия с очередью File-Queue и REST
nesUploadcash.logВ лог записываются события по загрузке данных из очереди в БД кассы

Помимо указанных логов могут быть использованы и другие файлы журналов, которые создаются при установке некоторых пакетов и запуске процессов.

Настройка логов на сервере осуществляется в файле /opt/nes/config/logging.properties.

В настройках можно изменить уровень логирования на любой из следующих:

  • INFO,

  • DEBUG,

  • WARNING,

  • ERROR,

  • CRITICAL.

Самым детализированным уровнем логирования является DEBUG (вес лог-файла выше, чем у остальных).

Не рекомендуется вносить изменения в остальные настройки.

  • No labels