Настройка агента ProAlert

1. Скачать актуальный дистрибутив.
2. Распаковать архив в отдельную папку. Не нужно распаковывать на рабочем столе или в каталог с названием версии.

В дистрибутиве содержатся следующие файлы:

desktop.bat       - запуск сервера в экранном режиме
install.bat       - установка сервера службой (запускать с правами Администратора)
uninstall.bat     - удаление службы сервера (запускать с правами Администратора)
license.bat       - запуск модуля лицензирования

Первый запуск приложения рекомендуется провести через desktop.bat
В процессе запуска возможно появления сообщение от брандмауэра или антивируса с запросом на сетевой доступ для нового приложения. Необходимо «Разрешить» доступ.

Для работы с ProAlert при первичной установке необходимо прописать лицензию. Для этого:

Получить лицензию, написав письмо на info@carbis.ru.
Запустить license.bat
Пролицензировать модуль по инструкции
Закрыть окно.

После первого запуска ProAlert-агента в папке с исполняемыми файлами появится конфиг-файл proalert_settings.yaml. Его нужно открыть блокнотом и отредактировать.

Пример конфигурационного файла:

# Настройки подключения к кассовому серверу. 
rk7_mid_connection:
  # Адрес подключения к  HTTP-XML интерфейсу кассового сервера. (str)
  host: 127.0.0.1
  # Порт подключения к  HTTP-XML интерфейсу кассового сервера. (int)
  port: 8080
  # Имя пользователя для работы с HTTP-XML интерфейсом кассового сервера. (str)
  user: ''
  #  Пароль пользователя для работы с HTTP-XML интерфейсом кассового сервера. (str)
  password: ''
# Настройки локального HTTP сервера. На этот порт будут приходить события, которые отправляет HTTP Order Notify. 
http_server:
  # Порт сервера 1..65535 (int)
  port: 11130
  # Кол-во потоков для обработки запросов. 1..20 (int)
  threads: 4
#  Настройки локального TCP сервера ProAgent-а. С этим портом в r_keeper настраивается виртуальный принтер. 
tcp_server:
  # Порт сервера 1..65535 (int)
  port: 11131
# Настройки подключения к головному серверу ProAlert находящемуся “в облаке”.  На этот сервер будут отправляться сообщения о кассовых операциях. 
proalert_connection:
  # Порт подключения к серверу ботов ProAlert (int)
  port: 443
  # Протокол подключения к головному серверу ProAlert. (str)
  protocol: wss
  # IP адрес подключения к головному серверу ProAlert. (str)
  host: proalert.carbis.ru
# Уникальный идентификатор ProAlert Agentа Через этот идентификатор головной сервер будет понимать, какой агент к нему обратился (str)
token: 430ce8e3-e32c-40f0-87b3-802f6a283809
# Настройки логирования 
log:
  # Уровень логирования 0..10 (int)
  level: 3
  # Срок хранения старых логов в днях  (1+) (int)
  retention_days: 7

Каждый параметр описан в комментарии внутри конфиг-файла.
Особенности:
- имя пользователя и пароль можно вводить без кавычек и апострофов;
- уникальный идентификатор не нужно вписывать вручную. Он генерируется при создании файла;

После настройки конфига, ProAlert-агента нужно перезапустить.
При запуске в desktop-режиме (desktop.bat) он инициирует открытие браузера и показывает страницу с данными, которые потребуются для связки с чатом в telegram.
Вручную эту страницу можно открыть на ПК с ProAlert-агентом по ссылке: http://127.0.0.1:11130/qrcode
В данном примере порт 11130 это:

# Настройки локального HTTP сервера. На этот порт будут приходить события, которые отправляет HTTP Order Notify. 
http_server:
  # Порт сервера 1..65535 (int)
  port: 11130

Окно выглядит следующим образом:

Скриншот QR-кода или текстовый идентификатор - потребуется при связывании ProAlert-агента с группой (чатом) в telegram (тут про это написано).

Нормальный режим работы ProAlert-агента - службой.
Чтобы установить службу, нужно запустить install.bat от имени администратора.
Запускать ProAlert-агента приложением и добавлять в автозагрузку - не рекомендуется. Причина - при каждом таком запуске он будет инициировать открытие браузера и показывать свой конфиг, который используется для связки с чатом в telegram.