Работа сервиса Nes
обеспечивается пакетом artix-cs-nes
(ранее использовался пакет artix-cs2.0-nes
).
Настройки задаются в конфигурационном файле /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 | логический |
| Использовать для загрузки справочников новые объекты или старые.
| По умолчанию |
sendDictGenerateEventOnCS | логический |
| Посылать команду генерации справочников на КС при выгрузке справочников из АСТУ
| По умолчанию 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
(вес лог-файла выше, чем у остальных).
Не рекомендуется вносить изменения в остальные настройки.