Различия

Показаны различия между двумя версиями страницы.

--- external:pro_alert:01_install_and_settings:02_proalert_settings [2023/02/15 16:11] – Алексей Коробов
+++ external:pro_alert:01_install_and_settings:02_proalert_settings [2023/09/26 15:48] (текущий) – Алексей Коробов
@@ Строка 1: / Строка 1: @@
 ====== Настройка агента ProAlert ======
+===== Установка и первый запуск =====
+  - Скачать [[https://disk.yandex.ru/d/Ob0agHtUYG7y2A|актуальный дистрибутив]].
+  - Распаковать архив в отдельную папку. Не нужно распаковывать на рабочем столе или в каталог с названием версии.
+В дистрибутиве содержатся следующие файлы:
+<code>
+desktop.bat       - запуск сервера в экранном режиме
+install.bat       - установка сервера службой (запускать с правами Администратора)
+uninstall.bat     - удаление службы сервера (запускать с правами Администратора)
+license.bat       - запуск модуля лицензирования
+</code>
+Первый запуск приложения рекомендуется провести через desktop.bat
+В процессе запуска возможно появления сообщение от брандмауэра или антивируса с запросом на сетевой доступ для нового приложения. Необходимо «Разрешить» доступ.
 ===== Лицензирование =====
@@ Строка 11: / Строка 27: @@
 Закрыть окно.
-====== Настройка ProAlert-агента ======
+===== Настройка ProAlert-агента =====
+После первого запуска ProAlert-агента в папке с исполняемыми файлами появится конфиг-файл **proalert_settings.yaml**. Его нужно открыть блокнотом и отредактировать.
+Пример конфигурационного файла:
+<code ini>
+# Настройки подключения к кассовому серверу.
+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
+</code>
+Каждый параметр описан в комментарии внутри конфиг-файла.
+Особенности:
+- имя пользователя и пароль можно вводить без кавычек и апострофов;
+- уникальный идентификатор не нужно вписывать вручную. Он генерируется при создании файла;
+После настройки конфига, ProAlert-агента нужно перезапустить.
+При запуске в desktop-режиме (desktop.bat) он инициирует открытие браузера и показывает страницу с данными, которые потребуются для связки с чатом в telegram.
+Вручную эту страницу можно открыть на ПК с ProAlert-агентом по ссылке: http://127.0.0.1:11130/qrcode
+В данном примере порт 11130 это:
+<code>
+# Настройки локального HTTP сервера. На этот порт будут приходить события, которые отправляет HTTP Order Notify.
+http_server:
+  # Порт сервера 1..65535 (int)
+  port: 11130
+</code>
+Окно выглядит следующим образом:
+{{:external:pro_alert:01_install_and_settings:pasted:20230215-163755.png}}
+Скриншот QR-кода или текстовый идентификатор - потребуется при связывании ProAlert-агента с группой (чатом) в telegram ([[external:pro_alert:01_install_and_settings:10_proalert_chat_connect|тут про это написано]]).
+===== Установка службой =====
+Нормальный режим работы ProAlert-агента - службой.
+Чтобы установить службу, нужно запустить install.bat от имени администратора.
+Запускать ProAlert-агента приложением и добавлять в автозагрузку - не рекомендуется. Причина - при каждом таком запуске он будет инициировать открытие браузера и показывать свой конфиг, который используется для связки с чатом в telegram.
-После первого запуска ProAlert-агента в папке с исполняемыми файлами появится конфиг-файл **proalert.yaml**. Его можно открыть блокнотом и отредактировать.