Инструкция по установке PMS агента

Интеграция между TravelLine и вашей АСУ осуществляется при помощи программного компонента «TravelLine Pms Integration Agent» (далее «агент»), который представляет собой Windows компонент работающий на сервере гостиницы. Процесс настройки интеграции состоит из нескольких шагов, первым из которых является установка и настройка «агента». Ниже указаны требуемые действия, которые выполняются системным администратором гостиницы. После выполнения указанных действий вам необходимо сообщить своему менеджеру поддержки корректный IP адрес, по которому можно установить соединение с «агентом». Для установки и запуски «агента» требуется:

• получить от менеджера поддержки ZIP архив с «агентом»;

• установить «агента»;

• прописать параметры подключения к базе данных АСУ;

• запустить «агента»;

• проверить, что «агент» запустился и работает;

• выслать адрес доступа к агенту менеджеру поддержки.

В пунктах ниже будут приведены скриншоты с английской версии Windows 7. В случае установки «агента» под другую версию операционной системы скриншоты могут незначительно отличаться.

Требования

Для работы «агента» требуется:

• наличие на .NET 3.5 (SP1);

• открытый для внешних соединений TCP-порт на компьютере с установленным «агентом»;

• если доступ в интернет осуществляется через отдельный интернет-шлюз, то на шлюзе должен быть настроен проброс портов до компьютера с «агентом».

• при наличии защитного программного обеспечения (Windows firewall, антивирус и др.) на компьютере с «агентом», необходимо разрешить входящие/исходящие соединения на порт агента по протоколу https.

По умолчанию «агент» работает на порту 8055. В случае необходимости изменения порта обратитесь к своему менеджеру по сопровождению с соответствующим запросом. Изменение порта выполняется специалистами TravelLine.

Установка агента

Все действия нужно производить под учетной записью Администратора:

• распакуйте архив;

• скопируйте версию «агента» нужной архитектуры (x86, x64) в новый каталог. Архитектура определяется тем, в какой из версий Data Sources (ODBC) настроен доступ для базу данных АСУ. Соответствующую информацию можно получить от представителей компании вашей АСУ, которые выполняли работы по установке АСУ.

• в консоли выполните две команды:после установки агента в списке служб должна появиться новая служба в статусе «Started»

  • AgentService.exe install

  • AgentService.exe start

Проверка запущен ли агент

1. На машине с агентом в браузере открыть url https://127.0.0.1:8055/ должно появится предупреждение о https сертификате. Подобная страница означает, что «агент» запущен и позволяет подключаться с локального компьютера.

2. В случае если страница не открывается, нужно проверить:

Также нужно проверить, что агент открывается через внешний IP адрес. Для этого в браузере нужно открыть страницу с внешним ip https://<;внешний ip>:8055. После открытия страницы должно появится предупреждение о https сертификате, аналогичное указанному в пункте 1.

• Запущен ли windows компонент «TravelLine PMS Integration Agent»

• Разрешён ли порт в фаерволе

3. В случае если урл не открывается, нужно проверить, что ваше защитное программное обеспечение не блокирует доступ к «агенту». При выходе в сеть через интернет-шлюз нужно проверить корректность настройки проброса портов.

Удаление агента

В консоли выполните две команды:

• AgentService.exe stop

• AgentService.exe uninstall

Установка нового агента поверх существующего

Внимание! Перед выполнением действий прочитайте инструкцию до конца

• сохраните файл config.xml;

• в консоли выполните две команды: удалите содержимое каталога с агентом;

  • AgentService.exe stop;

  • AgentService.exe uninstall;

• распакуйте архив в каталог для агента;

• скопируйте в каталог агентом файл config.xml;

• в консоли выполните две команды:

  • AgentService.exe install;

  • AgentService.exe start.

FAQ

Ошибка: служба агента не запускается или останавливается сразу после запуска
Решение:

• проверьте, что компьютер, на котором агент соответствует «Требованиям», установите необходимые программные компоненты.

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

• проверьте содержимое файла «[папка с установленным агентом]/Logs/startup.log», в случае возникновения системной ошибки там будет детальная информация. Перешлите ее вашему менеджеру поддержки.

Ошибка: в браузере не открывается страница https://127.0.0.1:8055
Решения:

• проверьте наличие элемента <agentKey>[уникальный ключ агента]</agentKey> в файле config.xml. В случае отсутствия данного элемента обратитесь к менеджеру поддержки для получения ключа.

• пропишите в файле config.xml элемент <ignoreCertErrors>true</ignoreCertErrors> внутри элемента <config>.

Ошибка: в браузере открывается страница https://127.0.0.1:8055, но не открывается страница по внешнему адресу
Решения:

• проблема связана с настройками вашего защитного программного обеспечения - файрвола, антивируса. Нужно, что оно не блокировало входящий и исходящий траффик в «агенту» по протоколу https. Внесите соответствующие коррективы в настройки.

• в случае использование интернет шлюза проверьте настройки проброса портов с шлюза на сервер с установленным агентом.

Ошибка: менеджер поддержки сообщает вам, что архитектура установленного агента не соответствует настроенному источнику данных DSN
Решение:

• установите агента с другой архитектурой, 32 или 64 бита в зависимости от текущей установки.