===== 1.1. Установка сервера интеграции с ILMS =====
==== 1.1.1. Установка SQL Server 2014 ====
**[color=red]Внимание![/color]** При использовании сервера интеграции с программным обеспечением [[https://hsu.systems/products/software-and-equipment/htlock/|HTLock]] установка SQL сервера и создание базы данных не требуется.
{{: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 ====
**[color=red]Внимание![/color]** При использовании сервера интеграции с программным обеспечением «**[[https://hsu.systems/products/software-and-equipment/htlock/|HTLock]]**» установка Intelligent Lock Management System **не требуется**.
Начнётся установка базового программного обеспечения «**[[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?|}}
**[color=red]Внимание![/color] Если вы не используете интеграцию с системой управления гостиницей PMS, этот шаг можно пропустить**, нажав Отмена в окне мастера установки Службы интеграции гостиничных замков HSU.
Нажимаем кнопку «**Далее**», после чего необходимо принять лицензионное соглашение, нажать кнопку «**Далее**», выбрать место установки службы и снова нажать кнопку «**Далее**» для начала установки службы.
==== 1.1.5. Настройка сервера интеграции ====
После установки появится окно «**Настройки сервера интеграции HSU**»:
К данным настройкам можно вернуться позже через //«Пуск» => «Служба интеграции HSU» => «Настройки сервера интеграции»//
{{:start:pms:изображение_2023-12-07_113413278.png?400|}}
Здесь настраиваются параметры коммуникации между PMS и СКУД, а также выбрать с какой системой необходимо провести интеграцию. Для обеспечения работы службы потребуется **Серверная** лицензия, которая приобретается и выпускается поставщиком СКУД HSU и данного программного обеспечения.
**[color=red]Внимание![/color]** Если у вас нет приобретенной лицензии на службу интеграции с PMS – нажмите кнопку «Файл» вверху слева, после чего «Выход» или просто закройте окно, и пропустите шаг настройки. \\ Перейдите к пункту – [[start:pms:03_check-the-system#3.1. Завершение настройки и проверка работы в ILMS|3.1 Завершение настройки и проверка работы]]
*//если следующий шаг будет пропущен в процессе установки, к нему можно вернуться в дальнейшем через меню Пуск 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?|}}
Установка серверной части программного обеспечения завершена.
**[color=red]Важно![/color]**
* Номер энкодера присваивается автоматически после первого соединения клиента с сервером и может быть изменен в настройках серверной службы
* Если изменить имя компьютера, на котором запущен сервер интеграции, необходимо выполнить перезапрос лицензии. Предыдущая лицензия работать не будет.
* Если на ПК\сервере установлены Антивирусные программные комплексы различных производителей – стабильная работа интерфейса не гарантируется. Рекомендуется отключить Антивирусные ПО до начала работ по установке.
* Вы всегда можете вернуться к настройкам параметров служб интеграции с PMS через «//Пуск//» => «//Служба интеграции HSU//» => «//Настройки сервера интеграции//»
**Далее**
->**[[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]]