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