Введение

В r_k Loyalty реализована возможность настроить программу лояльность одного заведения на два кассовых сервера.

Требования

Перед началом подключения r_k Loyalty убедитесь, что у вас:

  • Установлен сервер справочников — REF
  • Установлен кассовый сервер — MID
  • Приобретены и активированы лицензии:
    • R-Keeper модуль Касса RK7 ПО — 2 шт., приобретается по количеству касс
    • R-Keeper модуль Менеджер RK7 ПО — 1 шт.
    • R-Keeper модуль XML сохранение заказов 12 мес. ПО — 1шт.
    • R-Keeper модуль Loyalty Standart — 1 шт.
    • Интерфейс White Server — 1 шт., лицензия бесплатная.

Ограничения

На данный момент есть два ограничения для настройки интеграции:

  • Поддерживается работа двух кассовых серверов только с одной организацией, зарегистрированной на r_k Loyalty
  • Кассовые серверы должны быть установлены в одной директории, в ином случае интеграция не заработает

Настройка нескольких кассовых серверов

Предварительные действия

Для запуска нескольких кассовых серверов необходимо заранее подготовить отдельные для каждого сервера ini-файлы. Для этого:

  1. Перейдите в папку с установленным экземпляром r_keeper
  2. Найдите файл rkeeper7.ini
    • Если вы устанавливали r_keeper через инсталлятор, этот файл находится в папке \Rk7MidServer
    • Если вы устанавливали r_keeper через архив, этот файл находится в папке \bin\win
  3. Создайте копию файла и назовите ее rkeeper2.ini.

Настройки в менеджерской станции r_keeper

Далее необходимо создать второй сервер и кассу. Для этого:

  1. Авторизуйтесь в менеджерской станции r_keeper
  2. Создайте кассовый сервер и кассу. Название и сетевой ID сервера и кассы должны совпадать и быть уникальными. 
  3. Пролицензируйте кассовый сервер
  4. Перейдите в Свойства кассового сервера и раскройте раздел HTTP Ограничения
  5. Во всех полях раздела поставьте значение HTTP Access
    Эти значения должны стоять у обоих серверов. 
  6. Сохраните изменения.

Настройки в конфигурационных файлах

После создания второго кассового сервера и кассы, необходимо сделать изменения в файлах созданном файле .ini. Для этого:

  1. Отройте раннее созданный файл rkeeper2.ini
  2. Введите новые значения у следующих полей:
    1. ErrorLog — укажите директорию для хранения логов
    2. Client — укажите названия кассового сервера, в r_keeper это сетевой ID
    3. BasePath — укажите директорию для базы данных
    4. PORT — укажите уникальный порт
      Если вы вносили изменения в название первого кассового сервера, его название необходимо исправить в файле rkeeper7.ini
  3. Сохраните изменения и закройте файл
  4. Создайте копию папки кассовой станции:
  5. В созданной папке создайте ярлык для второй кассы — wincah.bat
  6. Найдите и откройте файл wincash.ini в созданной папке
  7. Введите новые значения в оба файла у следующих полей:
    1. STATION — укажите уникальное имя для второй кассовой станций: в r_keeper это поле — сетевой ID
    2. Server — укажите имя кассового сервера из пункта 2
    3. ErrorLog — укажите уникальное имя для файла логов
    4. [TCPDNS\] — укажите название, адрес и порт кассового сервера из пункта 2
  8. Сохраните изменения и закройте файл.

Настройки в файлах ini завершены. 

Запуск нескольких серверов

Запустить несколько серверов можно как приложения и как службы.

  • Для корректного запуска нескольких приложений необходимо создать ярлыки и развести их по собственным ini-файлам.
  • Для корректного запуска нескольких служб необходимо установить службу для каждого сервера отдельно.

Только в этом случае сервера можно будет запустить без ошибок. 

Настройка запуска нескольких приложений

Для начала необходимо создать ярлыки для запуска серверов. Для этого:

  1. Создайте ярлыки исполнительного файла midserv.exe кассового сервера и назовите их, например, midserv1.exe и midserv2.exe
    • Если вы устанавливали r_keeper через инсталлятор, этот файл находится в папке Rk7MidServer
    • Если вы устанавливали r_keeper через архив, этот файл находится в папке \bin\win.
  2. Нажмите правой кнопкой мыши по одному из созданных ярлыков и выберите Свойства

  3. В открывшемся окне в поле Объект после адреса расположения ярлыка впишите: /ininame:rkeeper1.ini /desktop
    Повторите действия для второго ярлыка, только в поле Объект впишите /ininame:rkeeper2.ini /desktop

    Каждый из ярлыков должен ссылаться на собственный ini-файл.

  4. Нажмите кнопку ОК.

Теперь каждый кассовый сервер можно запустить как приложение через свой ярлык.

Настройка запуска нескольких служб

  1. Запустите командную строку:
    1. Нажмите на кнопку Пуск и начните вводить словосочетание Командная строка
    2. Нажмите комбинацию клавиш win+r, чтобы открыть консоль, введите cmd и нажмите выполнить
  2. В открывшемся окне введите cd [путь установки кассового сервера] midserv.exe /ininame:rkeeper.ini /install 
  3. Нажмите на кнопку Enter
    Будет произведена установка службы для первого сервера
  4. После завершения установки введите cd [путь установки кассового сервера] midserv.exe /ininame:rkeeper2.ini /srvname:midserver2 /install
  5. Нажмите на кнопку Enter
    Будет произведена установка службы для второго кассового сервера
  6. Закройте командную строку.

Теперь каждый кассовый сервер можно запустить как службу. 

Обновление White Server Agent

После установки приложений или служб, необходимо обновить White Server Agent, чтобы он подключился к новым серверам. 

Если у вас уже стоит WSA, остановите монитор и агент в службах и удалите его с помощью деинсталлятора.

  1. Перейдите на FTP в папку /WS/WSAgent/versions
  2. Скачайте установщик White Server Agent версии 2.5.3.18 или выше
  3. Запустите установщик и выполняйте шаги, указанные в мастере установки

  4. Укажите путь к папке сервера справочников. Поле Порт XML-интерфейса заполнится автоматически после указания правильного пути. Нажмите Далее.

  5. Установщик укажет, какие настройки следует выполнить в менеджерской станции. Если вы обновляете WSA, значит, эти параметры у вас уже настроены. Поставьте флаг около слова Готово и нажмите Далее.

  6. Укажите путь к папке кассового сервера, в которой развернуты оба кассовых сервера
    1. Отметьте настройку Активировать R-Keeper loyalty
    2. На вопрос Установленная система лояльности выберите ответ Не установлена 
    3. Поле Порт PDS-интерфейса заполнится автоматически после указания правильного пути. Затем нажмите кнопку Проверить доступность
      Если кассовые сервера находятся на разных машинах, под каждый из кассовых серверов необходимо установить отдельный агент, и в данном шаге указать соответствующие адреса папок.
  7. Нажмите на кнопку Далее
  8. Выключите кассовый сервер и сервер справочников поставьте галочку R-keeper остановлен
  9. Запустите сервер справочников и оба кассовых сервера — файлы midserv1.exe и midserv2.exe — и поставьте галочку R-keeper запущен
  10. Нажмите Далее
  11. Пролицензируйте агент
    • Если вы обновляете WSA, сделайте это с помощью файла WsConnectionConfigurator.exe
    • Если вы устанавливаете агент в первый раз, то перед окончанием установки появится окно для лицензирования системы.
      Убедитесь, что в поле Выберите адрес указан адрес http://ws.ucs.ru/wsagent. Нажмите кнопку Попробовать применить настройки и после успешного применения — Закрыть.

Установка WSA v2 успешно завершена. Теперь он подключился к обоим кассовым серверам.

Для завершения настроек рекомендуем перезагрузить компьютер, но это не обязательно.

Проверка подключения WSA

Чтобы убедиться, что все настроено правильно, проверьте файлы в директории Config:

  1. Перейдите в папку с установленным White Server Agent 
  2. Откройте папку Config
  3. Убедитесь, что после установки появилось два файла:
    • RkCashServer.PluggedSystemConnection
    • RkReferenceServer.PluggedSystemConnection

Также проверьте, что в административной панели WSA отображаются оба кассовых сервера. Для этого:

  1. Авторизуйтесь в административной панели WSA
  2. Перейдите в меню в Рестораны и в поле ObjectId введите номер вашего заведения
  3. Нажмите на шестеренку, чтобы перейти в настройки заведения
  4. Перейдите к разделу Агенты V2
  5. Убедитесь:
    1. В колонке Активность агента отображается актуальные дата и время
    2. В колонке Активность монитора отображаются актуальные дата и время
    3. В колонке Подключенные системы отображаются оба кассовых сервера.

Если в данном заведении до этого уже работали кассовые компоненты, то необходимо обновить справочники. Для этого:

  1. На странице ресторана перейдите на вкладку Параметры создания заказа
  2. Нажмите на кнопку Обновить справочники и дождитесь сообщения, что справочники обновлены
  3. Нажмите на кнопку Сохранить.

Справочники обновлены. 

Проверка лояльности

В системе лояльности необходимо произвести проверку, чтобы убедиться, что интеграция прошла успешно. Для этого:

  1. Авторизуйтесь в системе лояльности r_k Loyalty
  2. Перейдите в меню Администрирование > Рестораны, выберите свое заведение
  3. Перейдите на вкладку Кассовые настройки
  4. Укажите:
    1. Тип кассовой станции — RKeeper7
    2. Номер объекта из системы лицензирования
  5. Нажмите на кнопку Проверить.
    Если проверка не выявила никаких ошибок, значит, интеграция прошла успешно и кассовые серверы готовы к использованию с системой лояльности. 
  6. Нажмите на кнопку Сохранить.

Готово, теперь система лояльности работает на двух кассовых серверах.