Установка White Server Agent v2

В статье описана отдельная установка White Server Agent v2.

В r_keeper, начиная с версий 7.6.5.459 он включен в установщик и ставится автоматически. Процесс установки r_keeper + WSA v2 описан в статье тихая установка r_keeper 7 и WSA v2.

Процесс перехода с WSA v1 на WSA v2 описан в отдельной статье.

Для работы WSA необходимо приобрести лицензии.

Установка

Установить WSA можно с помощью инсталлятора, доступного на ftp://ftp.ucs.ru/WS/WSAgent/versions/.

1. Откройте ссылку  ftp://ftp.ucs.ru/WS/WSAgent/versions/  в проводнике или FTP-клиенте
2. Авторизуйтесь с помощью Dealer ID
3. Выберите последнюю версию установщика и скачайте ее на компьютер. Проще всего это сделать, отсортировав файлы по дате изменения
4. Запустите установщик и выполняйте шаги указанные в мастере установки
   

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

   

   Обратите внимание!

   Для настройки r_k Cloud в этом окне снимите флаг "Сервер справочников установлен локально" и вместо поля "Путь к установленному R-Keeper" заполните поле "IP сервера справочников". Укажите нужный порт XML-интерфейса.
6. Нажмите Далее. Установщик укажет, какие настройки следует выполнить в менеджерской станции:
   
   1. Откройте менеджерскую станцию и перейдите в меню  Настройки > OLAP отчеты > Серверы отчетов 
   2. Выберите желаемый сервер отчетов или справочников
   3. В разделе XML-интерфейс укажите Порт привязки. Порт должен быть свободен и доступен по сети
   4. В разделе HTTP Server укажите свободный порт в поле  HTTP Data Port, при этом настройка  Use Free Listen Port должна быть отключена
   5. Сохраните изменения и согласитесь с предупреждениями о том, что сервер должен быть перезагружен
      
   6. В разделе HTTP Ограничения укажите во всех полях право  HTTP Access
      

   7. Если привилегия  HTTP Access  отсутствует, то создайте новую привилегию с таким именем.

   8. Перезапустите сервер справочников или отчетов. После перезагрузки сервера настройки в json-файле WSA v2 обновятся.
   9. Перезапустите кассовый сервер
   10. В установщике поставьте флаг  Готово
7. Укажите путь к папке кассового сервера. Поле Порт PDS-интерфейса   заполнится автоматически после указания правильного пути. Затем нажмите кнопку  Проверить доступность
   
8. На шаге настройки StoreHouse 5 укажите:
   1. IP — адрес расположения StoreHouse 5
   2. Port — укажите порт Web API 
   3. Пользователь — укажите логин пользователя в Store House 5
   4. Пароль — укажите пароль этого пользователя.
      Нажмите кнопку Далее. 
9. На шаге перезапуска RK:
   1. Выключите кассовый сервер и поставьте галочку  R-keeper остановлен
   2. Поставьте галочку Файл скопирован, копировать ничего не нужно
   3. Запустите кассовый сервер и поставьте галочку  R-keeper запущен
   4. Нажмите кнопку Далее
      
10. Нажмите  Установить
11. Дождитесь, пока WSA установится на ваш компьютер.
    При установке WSA проверит, пролицензирован ли r_keeper. О необходимых лицензиях читайте в статье Лицензирование. 
    Если все хорошо, то после установки агент будет запущен.
    

Установка WSA v2 успешно завершена.

WSA подключится к серверу в течение 15 минут и отобразится в административной панели. Вы можете проверить подключение.

Настройка WSA для доставки описана в статье Настройка агента для Delivery.

После успешного запуска WSA на кассовом сервере появятся два интерфейса. Чтобы проверить интерфейсы, выполните следующие действия:

1. В менеджерской станции r_keeper перейдите в меню Сервис > Станции и устройства
2. В окне Кассовые станции и устройства выберите нужное заведение, а затем выберите Кассовый сервер
3. В окне Устройства будут отображаться PDS и XML интерфейсы.
   

Если интерфейсы не появились, перезапустите кассовый сервер. Без этих интерфейсов WSA не будет работать. 

Для полноценной работы WSA, необходимо проверить следующие параметры:

1. HTTP Ограничения:
   1. Перейдите в меню Сервис > Станции и устройства
   2. В нужном ресторане выберите кассовый сервер, для которого будет настраиваться интеграция, и перейдите на вкладку Свойства
   3. В блоке HTTP Ограничения выставьте значение HTTP Access в полях:
      • HTTP API
      • Web интерфейс
      • XML интерфейс.
        
2. Права:
   1. Перейдите в меню Персонал > Работники
   2. Раскройте Центральный офис, выберите WSA и перейдите на вкладку Свойства
   3. В блоке Кассовые ограничения:
      1. В поле Операции разрешите все операции
      2. В поле Права > Права WSA установите флаг.
   4. В блоке Менеджерские ограничения:
      1. В поле Привилегии на объекты разрешите все объекты
      2. В поле Привилегии разрешите все привилегии.

Новый транспорт r_k Reports

WSA используется для передачи данных из r_keeper 7 в r_k Reports. Для работы нового транспорта данных необходимо настроить для WSA роль SQL. Роль SQL присваивается WSA автоматически, если версия RK не ниже 7.7.0.169. В других случаях роль SQL настраивается вручную по инструкции.

Как подключить новый транспорт данных описано в инструкции к подключению к r_k Reports.