1.1. Установка сервера интеграции с ILMS [HSU Wiki]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
===== 1.1. Установка сервера интеграции с ILMS =====

==== 1.1.1. Установка SQL Server 2014 ====

<note>**[color=red]Внимание![/color]** При использовании сервера интеграции с программным обеспечением [[https://hsu.systems/products/software-and-equipment/htlock/|HTLock]] установка SQL сервера и создание базы данных не требуется.</note>

{{:start:pms:pms_1.1.1.1.png?|}}

Поставить галочку «I accept the license terms» для принятия лицензионного соглашения Microsoft. Продолжите нажатием **Next**.

{{:start:pms:pms_1.1.1.2.png?|}}

Для работы ПО достаточно одного компонента, выбранного по умолчанию (Database Engine Services), все остальные выделять не нужно. Вы можете при необходимости изменить место установки сервера SQL. Продолжите нажатием **Next**.

{{:start:pms:pms_1.1.1.3.png?|}}

Производится именованная установка экземпляра SQL. Имя экземпляра HSUILMS. Не меняйте это имя, если в этом нет необходимости, вся дальнейшая документация ссылается на него. Продолжите нажатием **Next**.

{{:start:pms:pms_1.1.1.4.png?|}}

Конфигурация служб. Вносите изменения только в случае необходимости. Продолжите нажатием **Next**.

{{:start:pms:pms_1.1.1.5.png?|}}

По умолчанию оставьте «Windows authentication mode» - режим проверки подлинности Windows. 

Если вам необходим доступ в [[https://hsu.systems/products/software-and-equipment/intelligent-lock-management-system/|ILMS]] из нескольких рабочих мест, установите переключатель в Смешанный режим проверки подлинности (Mixed mode) и задайте пароль пользователя **sa**, запомните это пароль. Пользователь sa и его пароль могут быть использованы для удаленного подключения к базе. 

Также на этом шаге могут быть изменены места хранения баз данных. Внести изменения при необходимости.

Продолжите нажатием **Next**. 

Начнется установка сервера баз данных.

{{:start:pms:pms_1.1.1.6.png?|}}

Завершите установку - **Close**.

Если предполагается обращаться к SQL серверу через локальную сеть, после установки необходимо **включить протокол TCP/IP** для выбранного экземпляра SQL. Для этого в меню "**Пуск**" откройте папку "**MS SQL Server 2014**" и выберите программу "**SQL Server 2014 Configuration Manager**"

{{:start:pms:confman.png?600|}}

В открывшимся окне слева выберите **SQL Server Configuration Manager (Local)** -> **SQL Server Network Configuration** -> **Protocols for HSUILMS**. Справа откроется окно доступных протоколов. Нажмите правой клавишей мыши на протоколе **TCP/IP** и выберите **Enabled**

{{:start:pms:confman1.png?600|}}

После этого откроется окно, которое предупреждает, что прежде чем изменения вступят в силу необходимо перезагрузить сервис, к которому были применены изменения. Нажмите "**OK**" и в левой части окна выберите **SQL Server Configuration Manager (Local)** -> **SQL Server Services**. Справа откроется окно запущенных сервисов SQL. Нажмите правой клавишей мыши на "**SQL Server (HSUILMS)**" и выберите **Restart**

{{:start:pms:confman2.png?600|}}

Закройте программу "**SQL Server 2014 Configuration Manager**" и продолжайте установку.

==== 1.1.2. Создание базы данных ====

Создание базы данных происходит как часть установки [[https://hsu.systems/products/software-and-equipment/intelligent-lock-management-system/|ILMS]]. В процессе установки будет открыто окно выбора машины для создания базы данных. Если производилась автоматическая установка сервера баз данных на предыдущем шаге, то в списке серверов будет доступен сервер с именем имя_компьютера\**HSUILMS**, где имя_компьютера – сетевое DNS имя вашего компьютера. В случае простой установки, необходимо выбрать этот сервер.

{{:start:pms:pms_1.1.2.1.png?|}}

Необходимо выбрать соответствующий сервер из списка и нажать кнопку «**Подключить**» (возможная ошибка описана в [[start:pms:05_sql-setup-and-config|разделе 5 Установка и настройка SQL сервера]]). 

При первичном внедрении по умолчанию используется **Аутентификация Windows**. 

Для предварительно настроенных серверов SQL – возможна Аутентификация **SQL Server**. 

Нажимаем кнопку «**Подключить**», отобразятся все существующие базы данных на сервере:

{{:start:pms:pms_1.1.2.2.png?|}}

**Не допускается** создание базы данных с именем, отличным от [99V].

Нажимаем кнопку «**ОК**» для создания базы данных.

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

При выборе //**Перезаписать**// база будет заменена пустой из пакета установщика. Будьте осторожны, отменить эту операцию уже будет нельзя. В случае согласия, база данных будет перезаписана новой окончательно.

При выборе //**Использовать существующую**//, система будет использовать существующую базу.

При выборе //**Обновить**//, база будет сохранена и ее структура будет обновлена до текущей версии. Пунт становится доступным, если указанная база создана пакетом установщика v3.2 ниже. 

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



==== 1.1.3. Установка Intelligent Lock Management System ====

<note> **[color=red]Внимание![/color]** При использовании сервера интеграции с программным обеспечением «**[[https://hsu.systems/products/software-and-equipment/htlock/|HTLock]]**» установка Intelligent Lock Management System **не требуется**.</note>

Начнётся установка базового программного обеспечения «**[[https://hsu.systems/products/software-and-equipment/intelligent-lock-management-system/|HSU Intelligent Lock Management]]**», отобразится окно установки:

{{:start:pms:pms_1.1.3.1.png?|}}

Нажмите кнопку «Next», выберите необходимый путь установки и снова нажмите кнопку «Next», после чего «Install». После чего программное обеспечение будет установлено. В конце установки появится окно выбора типа базы данных, которое будет использовать программное обеспечение «**Intelligent Lock Management System**»:

{{:start:pms:pms_1.1.3.2.png?|}}

Необходимо выбрать:
  * DB Type List – **MS SQL Server**
  * Database Version – **SQL Server 2012 Express 64**
После нажать кнопку «**ОK**»

На этом установка базового программного обеспечения «**Intelligent Lock Management System**» завершена. На рабочем столе будет создан ярлык «HSU Intelligent Lock Management System».



==== 1.1.4. Установка Сервера интеграции HSU ====

Далее автоматически начнётся установка «Службы интеграции гостиничных замков HSU (Сервер)». Появится соответствующее окно установки

{{:start:pms:pms_1.1.4.1.png?|}}

<note> **[color=red]Внимание![/color] Если вы не используете интеграцию с системой управления гостиницей PMS, этот шаг можно пропустить**, нажав Отмена в окне мастера установки Службы интеграции гостиничных замков HSU.</note>

Нажимаем кнопку «**Далее**», после чего необходимо принять лицензионное соглашение, нажать кнопку «**Далее**», выбрать место установки службы и снова нажать кнопку «**Далее**» для начала установки службы. 

==== 1.1.5. Настройка сервера интеграции ====

После установки появится окно «**Настройки сервера интеграции HSU**»:

К данным настройкам можно вернуться позже через //«Пуск» => «Служба интеграции HSU» => «Настройки сервера интеграции»//

{{:start:pms:изображение_2023-12-07_113413278.png?400|}}

Здесь настраиваются параметры коммуникации между PMS и СКУД, а также выбрать с какой системой необходимо провести интеграцию. Для обеспечения работы службы потребуется **Серверная** лицензия, которая приобретается и выпускается поставщиком СКУД HSU и данного программного обеспечения.

<note>**[color=red]Внимание![/color]** Если у вас нет приобретенной лицензии на службу интеграции с PMS – нажмите кнопку «Файл» вверху слева, после чего «Выход» или просто закройте окно, и пропустите шаг настройки. \\ Перейдите к пункту – [[start:pms:03_check-the-system#3.1. Завершение настройки и проверка работы в ILMS|3.1 Завершение настройки и проверка работы]] </note>

*//если следующий шаг будет пропущен в процессе установки, к нему можно вернуться в дальнейшем через меню Пуск Windows («Пуск» => «Служба интеграции HSU» => «Настройки сервера интеграции»)//

Если лицензия есть – выполняем следующее:

  * Нажмите кнопку «**Файл**» вверху слева, далее «**Запрос лицензии**».
  * Отобразится соответствующее окно. В строке «**Номер лицензии**» введите номер лицензии, полученный вами от поставщика. Если «**Номер лицензии**» вы не получали – запросите его у поставщика СКУД системы и данного программного обеспечения.
  * В поле «**Пользователь**» данные организации, на которую производилась закупка интерфейса. \\ **Пример:** номер лицензии – //1234// пользователь – //ООО «Зайчик»// 
  * Нажмите кнопку «**Запросить**». 

{{:start:pms:pms_1.1.5.2.png?|}}

После нажатия на кнопку «**Запросить**» в окне «**Данные запроса**» появится текст запроса активации. Его необходимо **скопировать полностью**. Выделите текст полностью, кликните правой кнопкой мыши и нажмите «**Копировать**». 

**Данный текст необходимо предоставить поставщику СКУД системы и данного программного обеспечения для получения обратного кода активации.** 

После получения кода активации, скопируйте его в буфер обмена. Выберете «**Файл**» => «**Установка Лицензии**». В появившемся окне, в поле «**Ответ центра лицензирования**» вставьте текст кода активации и нажмите кнопку «**Установить**» для активации лицензии.

Если всё сделано правильно – отобразится соответствующее окно:

{{:start:pms:pms_1.1.5.3.png?|}}

Отобразится техническая информация в окне настройки:

{{:start:pms:pms_1.1.5.4v2.png?|}}

В **графе 1** отображается номер лицензии модуля интеграции с PMS, установленной на данной машине.

В **графе 2** отображается пользователь, под которым была зарегистрирована лицензия.

В **графе 3** отображается период действия лицензии модуля интеграции с PMS.

В **графе 4** отображается TCP порт, который используется для обращения PMS системы к модулю интеграции. По умолчанию графа принимает значение 3015. При необходимости, данное значение можно изменить.

Теперь необходимо выбрать программный продукт, с которым будет проводиться интеграция. Для этого в графе «Системная интеграция» необходимо выставить флажок «**Интеграция ILMS**», после чего откроется возможность производить настройку сервера интеграции с программным продуктом «**[[https://hsu.systems/products/software-and-equipment/intelligent-lock-management-system/|HSU Intelligent Lock Management]]**» 

{{:start:pms:pms_1.1.5.5v2.png?|}}

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

{{:start:pms:pms_1.1.5.6.png?|}}

В случае необходимости можно выбрать БД ILMS. Нажмите кнопку «**Файл**», далее «**Выбор БД замков**». Выберите необходимый сервер из списка, выберите требуемый способ аутентификации и базу данных. Если вы производите автоматизированную установку включая установку сервера баз данных SQL, вам необходимо выбрать сервер имя_компьютера\**HSUILMS**, где имя_компьютера – сетевое DNS имя вашего компьютера, аутентификация Windows, база данных [99V]

Нажмите кнопку «**Подключить**», после чего нажмите кнопку «Ок» (Возможная ошибка описана в [[start:pms:05_sql-setup-and-config|разделе 5 Установка и настройка SQL сервера]]).

{{:start:pms:pms_1.1.5.7.png?|}}

Вернитесь к окну «**Интеграция ILMS**». Поле «**Подключение к БД замков**» будет заполнено. Нажмите кнопку «**Тест**» для проверки соединения с БД:

{{:start:pms:pms_1.1.5.8.png?|}}

В случае успешного соединения с БД появится соответствующее окно:

{{:start:pms:pms_1.1.5.9.png?|}}

Если вам необходимо записывать данные дорожек №2 и №3 непосредственно на карту, в меню «Интеграция ILMS» перейдите на закладку «//Данные карты//» и установите флаг «//Использовать карту для хранения дорожек//». В таблице «//Назначенные дорожкам сектора карты//» определите сектора карты, через которые планируется осуществлять обмен со сторонними NFC устройствами.

В процессе выпуска карты PMS может записать на карту произвольную информацию, которая потом может быть считана любым NFC-совместимым устройством, включая Android устройства с NFC чипом. Эти устройства могут изменять данные на карте, а PMS может считывать их. Такой информацией может быть баланс гостя, коды начислений, баллы программы лояльности, любая другая информация, которую необходимо передать в (из) стороннюю систему, POS систему.

Пароль защищает данные на карте от изменяя внешними системами. Если у вас есть необходимость предоставить внешним системам право изменять данные в указанных секторах, установленный пароль необходимо передать в эти системы.

Новые карты поставляются с предустановленным паролем FFFFFFFFFFFF (12 символов). Кнопка Сброс восстанавливает этот пароль.

Подробная информация о функции приведена в документации по интегрированию с PMS.
**Не следует включать эту функцию, если не используете механизм обмена данными со сторонними системами NFC через память карты.**

{{:start:pms:pms_1.1.5.10.png?|}}

В меню «**Интерфейс**» можно настроить программный интерфейс, через который будет организовываться связь между сервером интеграции и PMS системой. Тип интерфейса «**HSU**» используется для связи с **большинством PMS систем**, кроме исключений, описанных далее для **FIAS** и **Rest**.

{{:start:pms:pms.1.1.hsu.png?600|}}

Тип интерфейса «**FIAS**» используется для связи сервера интеграции с PMS системами **Oracle Fidelio** и **Oracle Opera**. 

{{:start:pms:pms.1.2.fias.png?600|}}

Тип интерфейса «**REST API**» используется для того, чтобы принимать внешние **HTTP API** команды. Так же данный интерфейс используется для связи сервера с PMS системой **TravelLine** и новыми версиями 1С:Отель.

{{:start:pms:pms.1.2.rest.v2.png?600|}}

В поле **Энкодер по умолчанию** вписывается номер энкодера, который будет основным в вашей системе. Поле **HSU API key** используется для аутентификации сервером HSU команд, приходящих от PMS. Каждая команда PMS должна содержать это значение. Для автоматического заполнения данного поля случайным значением можно нажать на кнопку **Генерация** Поле **External API key** используется для аутентификации ответов, полученных от сервера HSU.


Для отображения информации в меню «**Лог**» необходимо нажать на кнопку «**Файл**» и поставить флажок «**Подробные логи**».

{{:start:pms:pms_1.1.5.12.png?|}}

На этом «**Настройка сервера интеграции HSU**» завершена. Нажмите кнопку «**Файл**», далее кнопку «**Выход**». 

В окне установки «**Служба интеграции гостиничных замков HSU (сервер)**» нажмите кнопку «**Закрыть**», тем самым завершив установку:

{{:start:pms:pms_1.1.5.13.png?|}}

Установка серверной части программного обеспечения завершена.

<note important> **[color=red]Важно![/color]**
  * Номер энкодера присваивается автоматически после первого соединения клиента с сервером и может быть изменен в настройках серверной службы
  * Если изменить имя компьютера, на котором запущен сервер интеграции, необходимо выполнить перезапрос лицензии. Предыдущая лицензия работать не будет.
  * Если на ПК\сервере установлены Антивирусные программные комплексы различных производителей – стабильная работа интерфейса не гарантируется. Рекомендуется отключить Антивирусные ПО до начала работ по установке. 
  * Вы всегда можете вернуться к настройкам параметров служб интеграции с PMS через «//Пуск//» => «//Служба интеграции HSU//» => «//Настройки сервера интеграции//» </note>
</note>

**Далее**

->**[[start:pms:02_imls-encoder-client|2 Установка клиентской части программного обеспечения]]** - если вы **используете интеграцию** системы на базе [[https://hsu.systems/products/software-and-equipment/intelligent-lock-management-system/|ILMS]] с PMS гостиницы

->**[[start:pms:03_check-the-system|3 Проверка работоспособности программного комплекса]]** - если вы **не используете интеграцию** с PMS и производится установка только самой [[https://hsu.systems/products/software-and-equipment/intelligent-lock-management-system/|ILMS]]