Для работы сервиса Exchanger необходимо установить пакет artix-cs-exchangers (ранее использовалась версия пакета artix-cs2.0-exchangers), в результате чего на кассовом сервере появится каталог /opt/exchangers.
Правила считывания конфигурационных файлов
Конфигурационные файлы представляют собой файлы формата *.ini, в которых находятся настройки сервиса. Основным конфигурационным файлом является /opt/exchangers/config/cs/exchangers.ini, также настройки могут находиться в директории /opt/exchangers/config/cs/conf.d/.
Порядок считывания настроек:
Сначала считываются настройки из основного конфигурационного файла
/opt/exchangers/config/cs/exchangers.ini.Затем считываются настройки из конфигурационного файла директории
/opt/exchangers/config/cs/conf.d/.
Настройки из файла в директории /opt/exchangers/config/cs/conf.d/ являются самыми приоритетными. Если они заданы, то в первую очередь будут использоваться они.
Настройки обмена задаются в конфигурационном файле /opt/exchangers/config/cs/exchangers.ini. Файл разделен на секции, каждая из которых отвечает за конфигурирование определенной части функционала. Пути к директории журнала событий сервиса Exchanger и к рабочей директории для файлового обмена справочниками и продажами задаются в секции main:
Секция | Наименование | Тип данных | Описание | Примечания |
|---|---|---|---|---|
main | workDirectory | строковый | Рабочая директория, в которой будет выполняться обработка справочников и файлов продаж – их конвертация, загрузка и выгрузка. Если параметр не задан явно – берется значение по умолчанию | По умолчанию /opt/exchangers/work |
| logDirectory | строковый | Директория ведения журнала событий Exchanger. Если параметр не задан явно - берется значение по умолчанию | По умолчанию /opt/exchangers/logs | |
| IMAGES_SERVICE | sourceDirectory | строковый | Путь к директории, в которой будут храниться изображения на АСТУ | По умолчанию /path/to/images |
| maxImageSize | строковый | Максимальный размер файла в байтах | По умолчанию 1048576 (1МБ) |
[main] ; Рабочая директория workDirectory = /opt/exchangers/work ; директория для лога logDirectory = /opt/exchangers/logs ... [IMAGES_SERVICE] ; Путь к директории с изображениями на АСТУ ;sourceDirectory = /path/to/images ; Максимальный размер файла в байтах. По умолчанию - 1048576 (1Мб) maxImageSize = 1048576
Настройки сервиса для различных форматов производятся в web-интерфейсе кассового сервера и подробно описаны в разделе "Обмен АСТУ - Кассовый сервер".
Логирование
Файлы логов хранятся в директории /opt/exchangers/logs/.
Для работы с данными доступны следующие логи:
| Наименование | Описание |
|---|---|
| dictLoadmain.log | Лог запуска процесса загрузки справочников |
| dictLoad<номер_кассы>.log | Лог событий загрузки справочников на кассу |
| saleUnloadmain.log | Лог запуска процесса выгрузки продаж |
| saleUnload<номер_кассы>.log | Лог событий выгрузки продаж из кассы |
Помимо указанных логов могут быть использованы и другие файлы журналов, которые создаются при установке некоторых пакетов и запуске процессов.
Настройка логов на сервере осуществляется в файле /opt/exchangers/config/cs/logging.properties.
В настройках можно изменить уровень логирования на любой из следующих:
INFO,DEBUG,WARNING,ERROR,CRITICAL.
Самым детализированным уровнем логирования является DEBUG (вес лог-файла выше, чем у остальных).
Не рекомендуется вносить изменения в остальные настройки.