В статье описана отдельная установка 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 v2:
Операционная система

64-разрядная версия Windows 7 SP1 или Windows 7 SP2+

Для Windows 7 SP1 необходимо установить следующие обновления:
KB976932, KB2999226 или Visual Studio С++ 2015 Redistributable
KB2533623

Процессор

Intel Core i3 1 ГГц

Оперативная память

4 Гб

Место на жестком диске

2 Гб

Интернет-соединение

1 Мбит/с, стабильный канал связи

r_keeper7.6.0

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

Так же для версий WSA новее 2.8.х.х на Windows 7 (и на Windows Server – при возникновении ошибки при попытке скачивания .net, вида: "Unable to download https://aka.ms/dotnet/3.1... ) требуется:

  1. Установить вручную четыре runtime'a по ссылкам ниже:
    https://download.visualstudio.microsoft.com/download/pr/63b482d2-04b2-4dd4-baaf-d1e78de80738/40321091c872f4e77337b68fc61a5a07/aspnetcore-runtime-3.1.32-win-x86.exe
    https://download.visualstudio.microsoft.com/download/pr/3f353d2c-0431-48c5-bdf6-fbbe8f901bb5/542a4af07c1df5136a98a1c2df6f3d62/windowsdesktop-runtime-3.1.32-win-x86.exe
    https://download.visualstudio.microsoft.com/download/pr/25974def-24fd-4155-af11-7bf477cc1c7f/21f5291090d9d4040ad8522bbdf00cc6/aspnetcore-runtime-6.0.25-win-x86.exe
    https://download.visualstudio.microsoft.com/download/pr/33eced41-f212-46df-bb2f-12d4b891e667/f55a4581dd72a971f21e9562816c7430/windowsdesktop-runtime-6.0.25-win-x86.exe
  2. Запустить инсталлятор
  3. Если возникнут ошибки и в журнале событий Windows, связанные с файлами:

Также подойдёт любая операционная система новее Windows 7 SP2.

Установка

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

  1. Откройте ссылку  ftp://ftp.ucs.ru/WS/WSAgent/versions/  в проводнике или FTP-клиенте
  2. Авторизуйтесь с помощью Dealer ID
  3. Выберите последнюю версию установщика и скачайте ее на компьютер. Проще всего это сделать, отсортировав файлы по дате изменения
  4. Запустите установщик и выполняйте шаги указанные в мастере установки
  5. Выберите язык установки
  6. Выберите регион сервера:
    Ru — для подключения к RU серверу
    Eu — для подключения к EU серверу
    Test — для подключения к тестовому серверу.
    Серверы изолированы и не синхронизированы друг с другом. При выборе сервера учитывайте, что интеграционные решения, в том числе Доставка r_k Delivery и сами объекты, должны работать в зоне размещения сервера.
  7. Выберите системы, к которым будет подключен агент
  8. Укажите путь к папке сервера справочников. Поле Порт XML-интерфейса   заполнится автоматически после указания правильного пути.

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

    Для настройки r_k Cloud в этом окне снимите флаг "Сервер справочников установлен локально" и вместо поля "Путь к установленному R-Keeper" заполните поле "IP сервера справочников". Укажите нужный порт XML-интерфейса.
  9. Нажмите Далее. Установщик укажет, какие настройки следует выполнить в менеджерской станции:
    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. В установщике поставьте флаг  Готово
  10. Укажите путь к папке кассового сервера. Поле Порт PDS-интерфейса   заполнится автоматически после указания правильного пути. Затем нажмите кнопку  Проверить доступность
  11. На шаге настройки StoreHouse 5 укажите:
    1. IP — адрес расположения StoreHouse 5
    2. Port — укажите порт Web API 
    3. Пользователь — укажите логин пользователя в Store House 5
    4. Пароль — укажите пароль этого пользователя.
      Нажмите кнопку Далее. 
  12. На шаге перезапуска RK:
    1. Выключите кассовый сервер и поставьте галочку  R-keeper остановлен
    2. Поставьте галочку Файл скопирован, копировать ничего не нужно
    3. Запустите кассовый сервер и поставьте галочку  R-keeper запущен
    4. Нажмите кнопку Далее
  13. Нажмите  Установить
  14. Дождитесь, пока 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. В поле Привилегии разрешите все привилегии.