Как установить PMS-агента и восстановить интеграцию с АСУ

• Перед установкой
• Как установить агент
• Как проверить работу агента
  • Проверьте локальное подключение
  • Проверьте внешний доступ
  • Проверьте состояние интеграции
• Как восстановить интеграцию
• Если возникла ошибка

TravelLine PMS Integration Agent — служба Windows для обмена данными между TravelLine и АСУ «Эдельвейс» или Intellect Style. 

Обратите внимание. Установку и обслуживание агента выполняет системный администратор средства размещения. 

Перед установкой

Подготовьте компьютер для установки:

• Установите .NET Framework 3.5 SP1 на компьютере, где будет работать агент.
• Выделите TCP-порт для входящих подключений к агенту.
  
  Обратите внимание. По умолчанию используется порт 8055. Если нужен другой порт, обратитесь в техподдержку TravelLine по адресу support@travelline.ru: порт меняют специалисты TravelLine.
• Разрешите входящие и исходящие HTTPS-соединения на порт агента в брандмауэре Windows, антивирусе и на сетевом оборудовании.
• Если подключение проходит через отдельный интернет-шлюз, настройте перенаправление порта со шлюза на компьютер с агентом.
• Уточните у поставщика АСУ разрядность ODBC-драйвера и источника данных DSN — сохраненных настроек подключения к базе данных. Разрядность агента должна соответствовать разрядности драйвера: x86 для 32-разрядного, x64 для 64-разрядного.
• Отправьте в техподдержку TravelLine по адресу support@travelline.ru запрос на архив с агентом для вашей АСУ нужной разрядности.

Как установить агент

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

1. Распакуйте архив от TravelLine.

2. Выберите версию агента: x86 для 32-разрядного ODBC-драйвера или x64 для 64-разрядного. Разрядность агента должна соответствовать драйверу и настроенному источнику данных DSN.

3. Скопируйте файлы в отдельную постоянную папку, например C:\TravelLine\PmsAgent.

Обратите внимание. Для названия папки используйте только латиницу. 

4. Через поиск в меню «Пуск» найдите «Командная строка» и выберите «Запуск от имени администратора».

5. Перейдите в папку с файлом AgentService.exe:

cd /d "C:\TravelLine\PmsAgent"

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

6. Выполните команды по очереди:

AgentService.exe install
AgentService.exe start

Если команда завершилась с ошибкой или служба не запускается, перейдите к разделу «Если возникла ошибка».

7. Если команда успешно выполнилась, то в поиске в меню «Пуск» откройте приложение «Службы» или «Win + R».

8. Введите services.msc и нажмите «OK». 

9. Нажмите правой кнопкой мыши на TravelLine PMS Integration Agent → выберите «Свойства» → вкладка «Восстановление».

10. Для всех сбоев выберите «Перезапуск службы» и нажмите «ОК».

Как проверить работу агента

Проверьте локальное подключение

1. На компьютере с агентом откройте в браузере: https://127.0.0.1:8055/

Примечание. Если используется другой порт, замените 8055 на настроенное значение. При успешном подключении, вы увидите надпись «Authorization required».

2. Если подключиться не удалось, проверьте состояние службы и правильность порта. Если после проверки подключиться не удалось, обратитесь в техподдержку TravelLine по адресу: support@travelline.ru. 

Проверьте внешний доступ

• Передайте техподдержке TravelLine статический внешний IP-адрес и порт компьютера с установленным агентом для проверки доступа со стороны TravelLine.
• Если локальное подключение доступно, а внешнее — нет, проверьте правила брандмауэра, антивируса, сетевого оборудования и перенаправление порта на интернет-шлюзе.

Проверьте состояние интеграции в личном кабинете TravelLine

После завершения настройки:

1. В личном кабинете TravelLine откройте раздел «Интеграция с АСУ» → «Состояние интеграции».

2. Нажмите «Проверить состояние интеграции». Ожидаемый статус проверки — «Работает корректно».

Как восстановить интеграцию

Если интеграция работала и связь пропала:

1. В личном кабинете TravelLine в разделе «Интеграция с АСУ» → «Состояние интеграции» прочитайте сообщение об ошибке.

2. Убедитесь, что компьютер с агентом подключен к интернету.

3. На компьютере откройте «Службы» и найдите TravelLine PMS Integration Agent:

• Если служба остановлена, выберите «Запустить».
• Если выполняется, но обмен не работает, выберите «Перезапустить».

4. Проверьте подключение к агенту и состояние интеграции.

Если изменился статический внешний IP-адрес средства размещения, сообщите новый адрес в техподдержку TravelLine по адресу support@travelline.ru.

Если возникла ошибка

Ошибка	Что проверить
Служба не запускается или сразу останавливается	установлены ли необходимые программные компоненты; корректны ли настройки подключения к АСУ; есть ли у учетной записи пользователя, от имени которого запускается служба, права на запуск и запись файлов в папку агента. Установите необходимые права учетной записи. В случае возникновения системной ошибки детальная информация появится в папке агента в файле Logs\startup.log. Откройте файл и передайте сведения об ошибке в техподдержку TravelLine на support@travelline.ru
В браузере не открывается страница https://127.0.0.1:8055 (локальное подключение недоступно)	выполняется ли служба и правильно ли указан порт; есть ли элемент agentKey в файле config.xml. В файле config.xml добавьте ignoreCertErrors="true" внутри элемента config. Если ключ отсутствует, обратитесь в техподдержку TravelLine
В браузере открывается страница https://127.0.0.1:8055, но не открывается страница по внешнему адресу (локальное подключение доступно, внешнее — нет)	настройки брандмауэра и антивируса; перенаправление порта на шлюзе
Агент не подключается к источнику данных DSN	параметры подключения; разрядность агента; ODBC-драйвера; DSN