Различия

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

--- external:pro_bonus:02_rkeeper_setup:02_farcard [2023/05/29 15:51] – Алексей Коробов
+++ external:pro_bonus:02_rkeeper_setup:02_farcard [2024/09/16 08:11] (текущий) – Евгений Горносталь
@@ Строка 1: / Строка 1: @@
 ====== Настройка FarCards ======
-Для связи кассы r_keeper с сервером ProBonuys используется технология **FarCard**.
+Для связи кассы r_keeper с сервером ProBonus используется технология **FarCard**.
-Данный модуль устанавливается в каждом ресторане (как правило на одной машине с кассовым сервером).
-  - [[https://disk.yandex.ru/d/sZVbCilocRx-0Q|Скачать]] и распаковать готовую сборку FarCard (probonus_farcards_х-х-х-х.rar).
+  - [[https://disk.yandex.ru/d/sZVbCilocRx-0Q|Скачать]] и распаковать готовую сборку FarCard. Она включена в общую сборку модулей ProBonus отдельной папкой.
-  - В **farcards.ini** в секции [pds_netk], в параметре NetServerName, указать имя PDS интерфейса [[https://wiki.carbis.ru/external/pro_bonus/02_rkeeper_setup/01_rkeeper#pds_интерфейс|который настраивали тут]].
+  - В **farcards.ini** в секции [pds_netk], в параметре NetServerName, указать уникальное имя PDS интерфейса [[https://wiki.carbis.ru/external/pro_bonus/02_rkeeper_setup/01_rkeeper#pds_интерфейс|который настраивали тут]].
+  - Скопировать три конфигурационных файла - probonus.ini, FARCARDS.ini, netk.ini из подкаталога "ini_for_first_install" в каталог с farcards.exe
   - В **probonus.ini** в секции [PARAMS] указать адрес и порт сервера ProBonus.
   - В **probonus.ini** в секции [LOG] можно изменить уровень логирования (1-10, чем выше тем подробнее логи).
@@ Строка 12: / Строка 12: @@
 Результатом успешного запуска будет свернутое в трей приложение:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-115936.png}}
+{{:external:pro_bonus:02_rkeeper_setup:2024-09-16_11-11-47.png}}
+Нужно убедиться, что на вкладке DLL в колонке "Status" указано **Ok**. Если имя PDS интерфейса не является уникальным и имеет дубли, то в колонке "Status" будет указана ошибка:
-Для постоянной работы рекомендуется установить FarCard в виде службы при помощи команды **"Farcards.exe /install"**
+{{:external:pro_bonus:02_rkeeper_setup:2024-09-16_11-58-21.png}}
+Если все настройки выполнены правильно, для постоянной работы рекомендуется установить FarCard в виде службы при помощи команды **"Farcards.exe /install"**. Чтобы запустить программу в режиме службы, сначала необходимо отключить ранее запущенный экземпляр в режиме desktop. Это можно сделать через Диспетчер задач или щелкнуть ПКМ по строке на вкладке DLL и выбрать Shutdown. После этого можно перейти к запуску в виде службы.
+{{:external:pro_bonus:02_rkeeper_setup:2024-09-16_11-13-13.png}}
 ===== Варианты размещения FarCard =====
-В зависимости от конфигурации r_keeper в конкретном ресторане или ресторанной сети, модуль FarCard и кассовый сервер (сервера) могут размещаться как на одной машине, так и на разных.
-Важно помнить о том, что модуль FarCard взаимодействует именно с кассовым сервером (mid-ом) и все дополнительные настройки связи (если они требуются) делаются на кассовом сервере.
-Рассмотрим различные варианты конфигурации
+====Стандартный базовый вариант - сервер ProBonus и Farcard вместе====
-==== Небольшой ресторан (кафе) с единственной кассой ====
+Простейший случай для настройки - размещение всех модулей ProBonus, включая FarCard, на одном ПК в одном общем каталоге (как в сборке-дистрибутиве).
-Как правило, в этом случае, все модули ПО размещаются на одной машине (на кассовом моноблоке) и никаких дополнительных настроек FarCard не требуется: mid находит FarCard по сетевому имени (Файл "FARCARDS.INI" -> Секция "pds_netk" -> Параметр "NetServerName")
+В этом случае в ini-файле кассовых серверов нужно вписать дополнительную строку, чтобы кассовые серверы знали где "искать" farcards ProBonus.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-113128.png}}
+Этот способ настройки можно использовать как для одиночных объектов, так и для сетей ресторанов - при этом Farcard будет один общий на все объекты. Это упрощает поддержку системы и упрощает её обновлений.
-==== Классический ресторан с кассой и станциями официанта ====
+Пример настроек для случая, когда сервер ProBonus и кассовый сервер - в общей локальной сети:
-В этой конфигурации кассовый сервер может находиться на выделенной машине (в серверной, а не на кассовом моноблоке). Для такого случая рекомендуется размещать модуль FarCard на машине с mid-ом, что облегчает конфигурацию системы.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-113804.png}}
-==== Линейка касс FastFood или сеть ресторанов ====
+**Сервер с FarCards (IP адрес 192.168.1.100)**
-Возможны конфигурации при который используется несколько кассовых серверов:
-  * Кассовая линейка на FastFood из 3х касс. На каждой кассе свой mid server.
-  * Сетевые рестораны. В каждом ресторане свой mid server.
-При такой конфигурации возможны следующие варианты размещения FarCard
-  * Отдельный экземпляр FarCard для каждого кассового сервера. При этом mid и FC могут размещаться как на одной машине, так и на разных.
-  * Один экземпляр FarCard который взаимодействует со всеми mid серверами. В этом случае очевидно что FC и mid сервера размещаются на разных машинах и могут находиться в разных сетях.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114355.png}}
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114401.png}}
-==== Дополнительные настройки для особых случаев ====
-В тех случаях когда FarCard и кассовый сервер (кассовые сервера) разнесены на разные машины, вариант с настройкой связи через сетевое имя является не надежным (больше времени требуется на поиск нужного имени в сетевом окружении, в зависимости от настроек сети это может быть не возможно), а если модули находятся в разных физических сетях, то поиск по имени не будет работать совсем.
-Для такого случая нужно сделать дополнительные настройки на стороне кассовых серверов для обеспечения стабильной связи с FarCard.
-В файле rkeeper.ini всех кассовых серверов, в секции [TCPDNS] прописать сетевое имя FarCard (Файл "FARCARDS.INI" -> Секция "pds_netk" -> Параметр "NetServerName") и указать IP адрес (или доменное имя) машины на которой установлен модуль FarCard с этим сетевым именем и порт FC (Файл "netk.ini" -> Секция "TCPSOC" -> Параметр "port") .
-**Сервер с FarCart (IP адрес 192.168.1.100)**
 Файл FARCARDS.INI
   ...
@@ Строка 66: / Строка 49: @@
   ...
+Ту же самую методику настройки можно использовать если farcards размещён на сервере "в интернете" с белым IP и проброшенным портом. В том числе, если сервер ProBonus - "в облаке". В этом случае:
+Файл rkeeper.ini
+  ...
+  [TCPDNS]
+  TEST_RK7SRV=192.168.1.100:3639
+  ProBonus=123.123.123.124:22349
+  ...
+здесь   123.123.123.124 - это внешний белый IP сервера где установлен FarCards, а 22349 - порт из netk.ini, который "проброшен".
+Также существуют альтернативные варианты настройки, когда farcards размещается локально в ресторанах.
+Эти варианты менее предпочтительны, т. к. при обновлении версии ПО нужно найти все установленные локально в ресторанах FarCard и обновить их.
+==== Альтернативная конфигурация ====
+Возможны конфигурации при который используется несколько кассовых серверов:
+  * Кассовая линейка на FastFood из 3х касс. На каждой кассе свой mid server.
+  * Сетевые рестораны. В каждом ресторане свой mid server.
+При такой конфигурации возможны следующие варианты размещения FarCard
+  * Отдельный экземпляр FarCard для каждого кассового сервера. При этом mid и FC могут размещаться как на одной машине, так и на разных.
+  * Один экземпляр FarCard который взаимодействует со всеми mid серверами. В этом случае очевидно что FC и mid сервера размещаются на разных машинах и могут находиться в разных сетях.
+{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114355.png}}
+{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114401.png}}