Настройка FarCards

Для связи кассы r_keeper с сервером ProBonuys используется технология FarCard.
Данный модуль устанавливается в каждом ресторане (как правило на одной машине с кассовым сервером).

1. Скачать и распаковать готовую сборку FarCard..
2. В farcards.ini в секции [pds_netk], в параметре NetServerName, указать имя PDS интерфейса который настраивали тут.
3. Скопировать три конфигурационных файла - probonus.ini, FARCARDS.ini, netk.ini из подкаталога «ini_for_first_install» в каталог с farcards.exe
4. В probonus.ini в секции [PARAMS] указать адрес и порт сервера ProBonus.
5. В probonus.ini в секции [LOG] можно изменить уровень логирования (1-10, чем выше тем подробнее логи).

Первый запуск FarCard рекомендуется провести в режиме desktop, при помощи команды «Farcards.exe /desktop»

Результатом успешного запуска будет свернутое в трей приложение:

Для постоянной работы рекомендуется установить FarCard в виде службы при помощи команды «Farcards.exe /install»

В зависимости от конфигурации r_keeper в конкретном ресторане или ресторанной сети, модуль FarCard и кассовый сервер (сервера) могут размещаться как на одной машине, так и на разных.
Важно помнить о том, что модуль FarCard взаимодействует именно с кассовым сервером (mid-ом) и все дополнительные настройки связи (если они требуются) делаются на кассовом сервере.

Рассмотрим различные варианты конфигурации

Как правило, в этом случае, все модули ПО размещаются на одной машине (на кассовом моноблоке) и никаких дополнительных настроек FarCard не требуется: mid находит FarCard по сетевому имени (Файл «FARCARDS.INI» → Секция «pds_netk» → Параметр «NetServerName»)

В этой конфигурации кассовый сервер может находиться на выделенной машине (в серверной, а не на кассовом моноблоке). Для такого случая рекомендуется размещать модуль FarCard на машине с mid-ом, что облегчает конфигурацию системы.

Возможны конфигурации при который используется несколько кассовых серверов:

• Кассовая линейка на FastFood из 3х касс. На каждой кассе свой mid server.
• Сетевые рестораны. В каждом ресторане свой mid server.

При такой конфигурации возможны следующие варианты размещения FarCard

• Отдельный экземпляр FarCard для каждого кассового сервера. При этом mid и FC могут размещаться как на одной машине, так и на разных.
• Один экземпляр FarCard который взаимодействует со всеми mid серверами. В этом случае очевидно что FC и mid сервера размещаются на разных машинах и могут находиться в разных сетях.

В тех случаях когда 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 и проброшенным портом.