Различия

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

--- external:pro_bonus:02_rkeeper_setup:02_farcard [2024/02/22 10:03] – Алексей Коробов
+++ 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.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.
@@ Строка 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 =====
+====Стандартный базовый вариант - сервер ProBonus и Farcard вместе====
 Простейший случай для настройки - размещение всех модулей ProBonus, включая FarCard, на одном ПК в одном общем каталоге (как в сборке-дистрибутиве).
-В этом случае в ини-файле кассовых серверов нужно вписать дополнительную строку, чтобы кассовые серверы знали где "искать" farcards ProBonus.
+В этом случае в ini-файле кассовых серверов нужно вписать дополнительную строку, чтобы кассовые серверы знали где "искать" farcards ProBonus.
+Этот способ настройки можно использовать как для одиночных объектов, так и для сетей ресторанов - при этом Farcard будет один общий на все объекты. Это упрощает поддержку системы и упрощает её обновлений.
 Пример настроек для случая, когда сервер ProBonus и кассовый сервер - в общей локальной сети:
@@ Строка 56: / Строка 61: @@
-В зависимости от конфигурации r_keeper в конкретном ресторане или ресторанной сети, модуль FarCard и кассовый сервер (сервера) могут размещаться как на одной машине, так и на разных.
-Важно помнить о том, что модуль FarCard взаимодействует именно с кассовым сервером (mid-ом) и все дополнительные настройки связи (если они требуются) делаются на кассовом сервере.
-Рассмотрим различные варианты конфигурации
+Также существуют альтернативные варианты настройки, когда farcards размещается локально в ресторанах.
+Эти варианты менее предпочтительны, т. к. при обновлении версии ПО нужно найти все установленные локально в ресторанах FarCard и обновить их.
-==== Небольшой ресторан (кафе) с единственной кассой ====
+==== Альтернативная конфигурация ====
-Как правило, в этом случае, все модули ПО размещаются на одной машине (на кассовом моноблоке) и никаких дополнительных настроек FarCard не требуется: mid находит FarCard по сетевому имени (Файл "FARCARDS.INI" -> Секция "pds_netk" -> Параметр "NetServerName")
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-113128.png}}
-==== Классический ресторан с кассой и станциями официанта ====
-В этой конфигурации кассовый сервер может находиться на выделенной машине (в серверной, а не на кассовом моноблоке). Для такого случая рекомендуется размещать модуль FarCard на машине с mid-ом, что облегчает конфигурацию системы.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-113804.png}}
-==== Линейка касс FastFood или сеть ресторанов ====
 Возможны конфигурации при который используется несколько кассовых серверов:
   * Кассовая линейка на FastFood из 3х касс. На каждой кассе свой mid server.
@@ Строка 78: / Строка 74: @@
 {{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114355.png}}
 {{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114401.png}}
-==== Дополнительные настройки для особых случаев ====
-В тех случаях когда FarCards и кассовый сервер (кассовые сервера) разнесены на разные машины, вариант с настройкой связи через сетевое имя является не надежным (больше времени требуется на поиск нужного имени в сетевом окружении, в зависимости от настроек сети это может быть не возможно), а если модули находятся в разных физических сетях, то поиск по имени не будет работать совсем.
-Для такого случая нужно сделать дополнительные настройки на стороне кассовых серверов для обеспечения стабильной связи с FarCard.
-В файле rkeeper.ini всех кассовых серверов, в секции [TCPDNS] прописать сетевое имя FarCard (Файл "FARCARDS.INI" -> Секция "pds_netk" -> Параметр "NetServerName") и указать IP адрес (или доменное имя) машины на которой установлен модуль FarCard с этим сетевым именем и порт FC (Файл "netk.ini" -> Секция "TCPSOC" -> Параметр "port") .
-**Сервер с FarCards (IP адрес 192.168.1.100)**
-Файл FARCARDS.INI
-  ...
-  [pds_netk]
-  NetServerName=ProBonus
-  ...
-Файл netk.ini
-  ...
-  [TCPSOC]
-  port=22349
-  ...
-**Кассовый сервер midserv (IP адрес 192.168.1.200)**
-Файл rkeeper.ini
-  ...
-  [TCPDNS]
-  TEST_RK7SRV=192.168.1.100:3639
-  ProBonus=192.168.1.100:22349
-  ...
-Ту же самую методику настройки можно использовать если farcards размещён на сервере "в интернете" с белым IP и проброшенным портом.