external:pro_bonus:02_rkeeper_setup:02_farcard

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
external:pro_bonus:02_rkeeper_setup:02_farcard [2024/01/10 09:44] – Алексей Коробовexternal:pro_bonus:02_rkeeper_setup:02_farcard [2026/10/22 07:54] (текущий) – Алексей Коробов
Строка 1: Строка 1:
 ====== Настройка FarCards ====== ====== Настройка FarCards ======
  
-Для связи кассы r_keeper с сервером ProBonuys используется технология **FarCard**.  +Для связи кассы r_keeper с сервером ProBonus используется технология **FarCard**.
-Данный модуль устанавливается в каждом ресторане (как правило на одной машине с кассовым сервером). +
  
-  - [[https://disk.yandex.ru/d/sZVbCilocRx-0Q|Скачать]] и распаковать готовую сборку FarCard (probonus_farcards_х-х-х-х.zip). +===== Установка и настройка =====
-  - В **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, чем выше тем подробнее логи).+
  
-Первый запуск FarCard рекомендуется провести в режиме desktop, при помощи команды **"Farcards.exe /desktop"** +  - [[https://disk.yandex.ru/d/sZVbCilocRx-0Q|Скачайте]] и распакуйте готовую сборку FarCard. Она включена в общую сборку модулей ProBonus отдельной папкой. 
-   +  - Скопируйте три конфигурационных файла — ''probonus.ini'', ''FARCARDS.ini'', ''netk.ini'' — из подкаталога ''ini_for_first_install'' в каталог с ''farcards.exe''. 
-Результатом успешного запуска будет свернутое в трей приложение: +  - В файле ''farcards.ini'' в секции ''[pds_netk]'' в параметре ''NetServerName'' укажите уникальное имя PDS-интерфейса, [[external:pro_bonus:02_rkeeper_setup:01_rkeeper#pds_интерфейс|который настраивали здесь]]. 
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-115936.png}}+  - В файле ''probonus.ini'' в секции ''[PARAMS]'' укажите: 
 +    * ''ServerAddress'' (обязательное поле) — адрес сервера ProBonus; 
 +    * ''ServerPort'' (обязательное поле) — порт сервера ProBonus; 
 +    * ''ServerConnectTimeout'' (необязательное поле) — таймаут на подключение (по умолчанию 10 секунд); 
 +    * ''ServerReadTimeout'' (необязательное поле) — таймаут на ответ (по умолчанию 10 секунд). 
 +  - В файле ''probonus.ini'' в секции ''[LOG]'' можно изменить уровень логирования (1–10: чем выше, тем подробнее логи).
  
-Для постоянной работы рекомендуется установить FarCard в виде службы при помощи команды **"Farcards.exe /install"**+===== Первый запуск ===== 
 + 
 +Первый запуск FarCard рекомендуется провести в режиме desktop с помощью команды ''Farcards.exe /desktop''. 
 + 
 +Результатом успешного запуска будет свёрнутое в трей приложение: 
 + 
 +{{:external:pro_bonus:02_rkeeper_setup:2024-09-16_11-11-47.png}} 
 + 
 +Убедитесь, что на вкладке **DLL** в колонке **Status** указано **Ok**. Если имя PDS-интерфейса не является уникальным и имеет дубли, в колонке **Status** будет указана ошибка: 
 + 
 +{{: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 ===== ===== Варианты размещения FarCard =====
-В зависимости от конфигурации r_keeper в конкретном ресторане или ресторанной сети, модуль FarCard и кассовый сервер (сервера) могут размещаться как на одной машине, так и на разных. 
-Важно помнить о том, что модуль FarCard взаимодействует именно с кассовым сервером (mid-ом) и все дополнительные настройки связи (если они требуются) делаются на кассовом сервере. 
  
-Рассмотрим различные варианты конфигурации+==== Стандартный базовый вариант — сервер ProBonus и FarCard вместе ====
  
-==== Небольшой ресторан (кафе) с единственной кассой ==== +Простейший случай для настройки — размещение всех модулей ProBonus, включая FarCard, на одном ПК в одном общем каталоге (как в сборке-дистрибутиве). В этом случае в ini-файл кассовых серверов нужно вписать дополнительную строку, чтобы кассовые серверы знали, где «искать» FarCard ProBonus.
-Как правило, в этом случае, все модули ПО размещаются на одной машине (на кассовом моноблоке) и никаких дополнительных настроек FarCard не требуется: mid находит FarCard по сетевому имени (Файл "FARCARDS.INI" -> Секция "pds_netk" -> Параметр "NetServerName") +
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-113128.png}}+
  
-==== Классический ресторан с кассой и станциями официанта ==== +Этот способ настройки можно использовать как для одиночных объектов, так и для сетей ресторанов — при этом FarCard будет один общий на все объекты. Это упрощает поддержку системы и её обновление.
-В этой конфигурации кассовый сервер может находиться на выделенной машине (в серверной, а не на кассовом моноблоке). Для такого случая рекомендуется размещать модуль FarCard на машине с mid-ом, что облегчает конфигурацию системы. +
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-113804.png}}+
  
-==== Линейка касс FastFood или сеть ресторанов ==== +Пример настроек для случая, когда сервер ProBonus и кассовый сервер находятся в общей локальной сети.
-Возможны конфигурации при который используется несколько кассовых серверов: +
-  * Кассовая линейка на 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 (IP-адрес 192.168.1.100)**
-В тех случаях когда FarCards и кассовый сервер (кассовые сервера) разнесены на разные машины, вариант с настройкой связи через сетевое имя является не надежным (больше времени требуется на поиск нужного имени в сетевом окружении, в зависимости от настроек сети это может быть не возможно), а если модули находятся в разных физических сетях, то поиск по имени не будет работать совсем. +
-Для такого случая нужно сделать дополнительные настройки на стороне кассовых серверов для обеспечения стабильной связи с FarCard.  +
-В файле rkeeper.ini всех кассовых серверов, в секции [TCPDNS] прописать сетевое имя FarCard (Файл "FARCARDS.INI" -> Секция "pds_netk" -> Параметр "NetServerName") и указать IP адрес (или доменное имя) машины на которой установлен модуль FarCard с этим сетевым именем и порт FC (Файл "netk.ini" -> Секция "TCPSOC" -> Параметр "port") .+
  
 +Файл ''FARCARDS.INI'':
  
-**Сервер с FarCards (IP адрес 192.168.1.100)** +<code ini> 
-Файл FARCARDS.INI  +... 
-  ... +[pds_netk] 
-  [pds_netk] +NetServerName=ProBonus 
-  NetServerName=ProBonus +... 
-  ... +</code>
-Файл netk.ini  +
-  ... +
-  [TCPSOC] +
-  port=22349 +
-  ...+
  
 +Файл ''netk.ini'':
  
-**Кассовый сервер midserv (IP адрес 192.168.1.200)** +<code ini> 
-Файл rkeeper.ini  +... 
-  ... +[TCPSOC] 
-  [TCPDNS] +port=22349 
-  TEST_RK7SRV=192.168.1.100:3639 +... 
-  ProBonus=192.168.1.100:22349 +</code>
-  ...+
  
-Ту же самую методику настройки можно использовать если farcards размещён на сервере "в интернете" с белым IP и проброшенным портом.+**Кассовый сервер midserv (IP-адрес 192.168.1.200)** 
 + 
 +Файл ''rkeeper.ini'': 
 + 
 +<code ini> 
 +... 
 +[TCPDNS] 
 +TEST_RK7SRV=192.168.1.100:3639 
 +ProBonus=192.168.1.100:22349 
 +... 
 +</code> 
 + 
 +Ту же самую методику настройки можно использовать, если FarCard размещён на сервере «в интернете» с белым IP и проброшенным портом, в том числе если сервер ProBonus находится «в облаке». В этом случае: 
 + 
 +Файл ''rkeeper.ini'': 
 + 
 +<code ini> 
 +... 
 +[TCPDNS] 
 +TEST_RK7SRV=192.168.1.100:3639 
 +ProBonus=123.123.123.124:22349 
 +... 
 +</code> 
 + 
 +Здесь ''123.123.123.124'' — внешний белый IP сервера, где установлен FarCard, а ''22349'' — порт из ''netk.ini'', который «проброшен». 
 + 
 +Также существуют альтернативные варианты настройки, когда FarCard размещается локально в ресторанах. Эти варианты менее предпочтительны, т. к. при обновлении версии ПО нужно найти все FarCard, установленные локально в ресторанах, и обновить их. 
 + 
 +==== Альтернативная конфигурация ==== 
 + 
 +Возможны конфигурации, при которых используется несколько кассовых серверов: 
 + 
 +  * **Кассовая линейка FastFood из трёх касс.** На каждой кассе свой mid server. 
 +  * **Сетевые рестораны.** В каждом ресторане свой mid server. 
 + 
 +При такой конфигурации возможны следующие варианты размещения FarCard: 
 + 
 +  * **Отдельный экземпляр FarCard для каждого кассового сервера.** При этом mid server и FarCard могут размещаться как на одной машине, так и на разных. 
 +  * **Один экземпляр FarCard, который взаимодействует со всеми mid server.** В этом случае, очевидно, FarCard и mid server размещаются на разных машинах и могут находиться в разных сетях. 
 + 
 +{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114355.png}} 
 + 
 +{{:external:pro_bonus:02_rkeeper_setup:pasted:20221023-114401.png}}
  
  • external/pro_bonus/02_rkeeper_setup/02_farcard.1704869099.txt.gz
  • Последнее изменение: 2024/01/10 09:44
  • — Алексей Коробов