Master-Interlook:Interlook-Web. Настройка Web-сервиса Master-Interlook — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Введение)
(Настройки в секции Appsettings файла конфигурации web.config)
 
(не показано 17 промежуточных версий 2 участников)
Строка 1: Строка 1:
 
==Введение==
 
==Введение==
В данной статье рассказывается о правильной установке и настройке Web-сервиса ПК "Master-Interlook", а также действиях при его обновлении.
+
В данной статье рассказывается о правильной установке и настройке Web-сервиса ПК "Master-Interlook Web", а также действиях при его обновлении.
 
Бронирование в ПК «Мастер-Interlook Web» из базы данных ПК «Мастер-Interlook» осуществляется через веб-сервис ПК «Мастер-Interlook». В том случае, если данный веб-сервис не был установлен ранее (например для обмена данными с ПК «Мастер-Тур») для осуществления возможности бронирования необходимо установить и настроить данный веб-сервис.
 
Бронирование в ПК «Мастер-Interlook Web» из базы данных ПК «Мастер-Interlook» осуществляется через веб-сервис ПК «Мастер-Interlook». В том случае, если данный веб-сервис не был установлен ранее (например для обмена данными с ПК «Мастер-Тур») для осуществления возможности бронирования необходимо установить и настроить данный веб-сервис.
 
+
Также Web-сервис используется для автоматизации обмена данными между ПК "Мастер-Тур" и ПК "Master-Interlook".
 
==Порядок установки Web-сервиса==
 
==Порядок установки Web-сервиса==
Web-сервис устанавливается на стороне ПК "Master-Interlook" и предназначен для автоматизации обмена данными между ПК "Мастер-Тур" и ПК "Master-Interlook".
+
Web-сервис устанавливается на стороне ПК "Master-Interlook".
 
[[Файл: am_063.png|left|Предупреждение]]<br />
 
[[Файл: am_063.png|left|Предупреждение]]<br />
 
  Строго обязательно, чтобы Web-сервис и БД ПК "Master-Interlook" находились в одном часовом поясе.
 
  Строго обязательно, чтобы Web-сервис и БД ПК "Master-Interlook" находились в одном часовом поясе.
Строка 15: Строка 15:
 
  Если файл web.config есть и он настроен, то его копировать не надо.
 
  Если файл web.config есть и он настроен, то его копировать не надо.
 
<br />
 
<br />
* Используя модуль AdminMS на стороне ПК “Master-Interlook” создать пользователя и выдать ему максимальные права на работу с таблицами ПК “Master-Interlook”
+
При этом необходимо в файле <code>'''WEB.CONFIG'''</code> веб-сервиса настроить строку подключения к базе данных ПК «Мастер-Interlook»:
[[Файл: Ds208.png|x500px]]
+
<code>
* В файле web.config поменять строку подключения к базе данных ПК "Master-Interlook"
+
<add key="connectionString" value="Data Source=<span style="color:red">SERVERNAME</span>;Initial Catalog=<span style="color:red">DATABASENAME</span>;User Id=<span style="color:red">USERNAME</span>;Password=<span style="color:red">USERPASSWORD</span>;Application Name=<span style="color:red">ILWEB</span>"/>
<br /><syntaxhighlight lang="xml">
+
</code>
<add key="connectionString" value="Data Source=Some_Server;Initial Catalog=Some_Database;User ID=Some_Login;Password=Some_Password"/>
+
где:
</syntaxhighlight><br />
+
* '''SERVERNAME''' - сервер, на котором находится база данных ПК «Мастер-Interlook»;<BR>
где<br />
+
* '''DATABASENAME''' - название базы данных ПК «Мастер-Interlook»;<BR>
 +
* '''USERNAME''' - имя пользователя базы данных ПК «Мастер-Interlook», обладающего необходимыми правами;<BR>
 +
* '''USERPASSWORD''' - пароль пользователя базы данных ПК «Мастер-Interlook»;<BR>
 +
* '''APPLICATION''' - название веб-приложения Interlook-Web. (Приложение должно соответствовать приложению указанному в файле SETTINGS.CONFIG ПК «Мастер-Interlook Web»). </BR>
  
* Some_Server имя (IP-адрес) сервера, на котором находится база данных ПК "Master-Interlook"
+
====Настройки в секции Appsettings файла конфигурации web.config====
* Some_Database - имя базы данных ПК "Master-Interlook"
+
<BR> В 11.17 релизе переработана процедура перезапуска кэша. Эта настройка обязательно задается в web.config. <BR>
* Some_Login - идентификатор (логин) ранее созданного пользователя
+
Рассмотрим несколько вариантов:<BR>
* Some_Password – пароль для логина Some_Login
+
<add key="cachingTime" value=<span style="color:red">"-1"</span>/>
 +
где инициализация кэша максимально производительная: каждый отель загружается в своем потоке (возможны сбои).<BR>
 +
<add key="cachingTime" value=<span style="color:red">"-2"</span>/>
 +
– где загрузка кэша происходит перед запуском WebService.  Весь кэш загружается в 2 потока. Данные в кэше хранятся постоянно.
 +
<add key="cachingTime" value=<span style="color:red">"10"</span>/> 
 +
– где загрузка кэша при старте не происходит. Данные в нем хранятся 10 секунд.<BR>
 +
Подробнее описано в пункте [[Master-Interlook:Interlook-Web. Настройка Web-сервиса Master-Interlook#Настройка параметров "cachingTime"|''Настройка параметров "cachingTime"'']].<BR>
  
 +
'''<add key="LogCacheMemory" value=<span style="color:red">"0"</span>/>'''
 +
- включение логирования о использовании памяти сервера LogCacheMemory. Настройка служит для включения или отключения логирования в таблицу базы данных о использовании кешем сервиса памяти сервера.
 +
0 - выключена, 1 - включена</BR>
 +
'''<add key="IsAddHotsWithCosts" value="false"/>'''
 +
- настройка регулирует отображение стоимости Addhot типа WithCosts в стоимости проживания в поиске. Отсутсвие настройки обрабатывается как '''false'''. При включении настройки в '''true'''сумма проживания в поиске и в корзине одинаково, при выключении настройки цена в поиске не учитывает услуги типа WithCosts.</BR>
 +
<BR></BR>
 
В файле web.config для оптимальной работы сервиса нужно убедиться, что в секции <code><system.web></code> значение настройки '''compilation debug''' установлено в положении '''false'''   
 
В файле web.config для оптимальной работы сервиса нужно убедиться, что в секции <code><system.web></code> значение настройки '''compilation debug''' установлено в положении '''false'''   
 
<br /><syntaxhighlight lang="xml">
 
<br /><syntaxhighlight lang="xml">
Строка 34: Строка 49:
 
Данная настройка  обеспечивает большую производительность сервиса.<br />
 
Данная настройка  обеспечивает большую производительность сервиса.<br />
 
Далее необходимо создать в IIS новое приложение (например ILWevService) и указать физический путь к папке, созданной ранее.
 
Далее необходимо создать в IIS новое приложение (например ILWevService) и указать физический путь к папке, созданной ранее.
 +
 
===Создание приложения на IIS===
 
===Создание приложения на IIS===
 
Для создания приложения на IIS необходимо выполнить следующие шаги:
 
Для создания приложения на IIS необходимо выполнить следующие шаги:
Строка 45: Строка 61:
  
 
===Проверка работоспособности Web-сервиса===
 
===Проверка работоспособности Web-сервиса===
Для проверки работоспособности Web-сервиса необходимо в настройках IIS найти  файл Service.asmx и в контекстном меню выбрать пункт '''Обзор'''.
+
<BR>После установки веб-сервиса рекомендуется проверить его работу. Для этого можно в IIS выбрать приложение, созданное для веб-сервиса и в контекстном меню (вызывается нажатием левой кнопки мыши на приложении) выбрать пункт '''Обзор''' ('''Управление приложением''' &rarr; '''Обзор'''):<BR>
<br />[[Файл:65.PNG]]<br />
+
 
В случае успешной установки в браузере должна открыться страница Web-сервиса со списком доступных методов.
+
[[Файл: am_449.png|x500px|Управление приложением -> Обзор]]<BR>
<br />[[Файл:66.PNG]]<br />
+
<BR>
 +
 
 +
Когда откроется страница, необходимо в адресной строке в конце дописать <code>'''Service.asmx'''</code>. После этого должна открыться такая страница:<BR>
 +
 
 +
[[Файл: am_450.png|x500px|Веб-Сервис]]<BR>
 +
<BR>
  
 
===Настройка===
 
===Настройка===
 
В диспетчере служб IIS в разделе '''Пулы приложений (Application Pool)''' открыть '''Дополнительные параметры (Advanced Settings)''' приложения '''.Net v4.5'''.
 
В диспетчере служб IIS в разделе '''Пулы приложений (Application Pool)''' открыть '''Дополнительные параметры (Advanced Settings)''' приложения '''.Net v4.5'''.
В параметре '''Режим запуска (Start Mode)''' установить значение '''AlwaysRunning'''.
+
В параметре '''Режим запуска (Start Mode)''' установить значение '''AlwaysRunning'''. <br />
 
[[Файл:Ea_24.png|1000px|Пул приложений 1]] <br /> <br />
 
[[Файл:Ea_24.png|1000px|Пул приложений 1]] <br /> <br />
Настройка перезапуска службы рекомендована раз в сутки, желательно настраивать в ночное время. Таймаут простоя = 0. <br />
+
Рекомендуется настроить перезапуск пула приложения раз в сутки, в ночное время. Для настройки перезапуска открыть '''Дополнительные параметры (Advanced Settings)''' пула приложения и в поле '''Моменты точного времени для перезапуска  (Specific Time)''', меню '''TimeSpanArray''' установить время перезапуска.  Значение поля Постоянный временной интервал (в минутах) (Regular Time Interval) установить в значение 0. <br />
[[Файл:Ea_26.png|500px|Пул приложений 3]] <br /> <br />
+
[[Файл:Ea_236.png|500px|Пул приложений 3]] <br /> <br />
  
 
В IIS на уровне сайта открыть '''Дополнительные параметры (Advanced Settings)'''.
 
В IIS на уровне сайта открыть '''Дополнительные параметры (Advanced Settings)'''.
Строка 64: Строка 85:
 
==Порядок обновления Web-сервиса==
 
==Порядок обновления Web-сервиса==
 
При обновлении web-сервиса ПК "Мастер-Interlook" необходимо:
 
При обновлении web-сервиса ПК "Мастер-Interlook" необходимо:
* Получить архив файлов новой версии в [http://private.megatec.ru/login.php личном кабинете]
+
* Получить файлы новой версии
 
* Открыть папку, содержащие файлы текущего Web-сервиса (например, открыв Диспетчер служб Internet Information Services (IIS) и выбрав в контекстном меню необходимого web-сервиса пункт '''Проводник''')
 
* Открыть папку, содержащие файлы текущего Web-сервиса (например, открыв Диспетчер служб Internet Information Services (IIS) и выбрав в контекстном меню необходимого web-сервиса пункт '''Проводник''')
 
* Скопировать файлы новой версии в папку текущего Web-сервиса (заменяя все файлы)
 
* Скопировать файлы новой версии в папку текущего Web-сервиса (заменяя все файлы)
 
* Открыв Диспетчер служб Internet Information Services (IIS)
 
* Открыв Диспетчер служб Internet Information Services (IIS)
 
* На уровне сайта выбрать в меню действия выбрать пункт '''Перезагрузить''' (или '''Остановить''' и сразу после этого '''Начало''')
 
* На уровне сайта выбрать в меню действия выбрать пункт '''Перезагрузить''' (или '''Остановить''' и сразу после этого '''Начало''')
* Проверить работоспособность сервиса способом, описанным в  пункте [[Master-Interlook:Обмен. Настройка Web-сервиса Master-Interlook#Проверка работоспособности Web-сервиса|''Проверка работоспособности Web-сервиса'']]
+
* Проверить работоспособность сервиса способом, описанным в  пункте [[Master-Interlook:Interlook-Web. Настройка Web-сервиса Master-Interlook#Проверка работоспособности Web-сервиса|''Проверка работоспособности Web-сервиса'']].
  
 
==Настройка параметров "cachingTime"==
 
==Настройка параметров "cachingTime"==
Строка 84: Строка 105:
 
[[Category:Master-Interlook_Настройка]]
 
[[Category:Master-Interlook_Настройка]]
 
[[Category:Master-Interlook_Администрирование]]
 
[[Category:Master-Interlook_Администрирование]]
 
==Настройка параметров конфига web.config Integration Service Interlook==
 
Настройки конфигурационного файла
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
|- style="background-color:#F2F2F2"
 
 
! width="2%" | №
 
! width="10%" | Название
 
! width="38%" | Описание
 
! width="50%" | Настройка
 
 
|- style="vertical-align:text-top"
 
 
| 1
 
| Настройка вывода Adhot типа With Cost
 
| Настройка, позволяющая выводить доплаты Adhot типа With Cost в методах SearchHotelServices и SearchHotelServicesMinHotel.
 
По умолчанию настройка установлена в значении '''false'''.<br />
 
*  '''true''' – в ответе методов выдается значение размера доплаты Adhot типа With Cost в параметре "AddHotsWithCosts".
 
*  '''false''' или '''отсутствие настройки''' или любое значение отличное от '''true''' – в ответе методов выдается значение "-1" в параметре "AddHotsWithCosts".<br />
 
| <syntaxhighlight lang="xml" enclose="div">
 
<add key="IsAddHotsWithCosts" value="false"/>
 
</syntaxhighlight>
 
|}
 

Текущая версия на 11:33, 27 ноября 2023

Введение

В данной статье рассказывается о правильной установке и настройке Web-сервиса ПК "Master-Interlook Web", а также действиях при его обновлении. Бронирование в ПК «Мастер-Interlook Web» из базы данных ПК «Мастер-Interlook» осуществляется через веб-сервис ПК «Мастер-Interlook». В том случае, если данный веб-сервис не был установлен ранее (например для обмена данными с ПК «Мастер-Тур») для осуществления возможности бронирования необходимо установить и настроить данный веб-сервис. Также Web-сервис используется для автоматизации обмена данными между ПК "Мастер-Тур" и ПК "Master-Interlook".

Порядок установки Web-сервиса

Web-сервис устанавливается на стороне ПК "Master-Interlook".

Предупреждение


Строго обязательно, чтобы Web-сервис и БД ПК "Master-Interlook" находились в одном часовом поясе.


Подготовка к установке

Для установки Web-сервиса необходимо:

  • Создать новую директорию (например С:\Inetpub\wwwroot\Interlook_WebService)
  • Скопировать в созданную папку все файлы пакета установки
Предупреждение


Если файл web.config есть и он настроен, то его копировать не надо.


При этом необходимо в файле WEB.CONFIG веб-сервиса настроить строку подключения к базе данных ПК «Мастер-Interlook»:


<add key="connectionString" value="Data Source=SERVERNAME;Initial Catalog=DATABASENAME;User Id=USERNAME;Password=USERPASSWORD;Application Name=ILWEB"/>

где:

  • SERVERNAME - сервер, на котором находится база данных ПК «Мастер-Interlook»;
  • DATABASENAME - название базы данных ПК «Мастер-Interlook»;
  • USERNAME - имя пользователя базы данных ПК «Мастер-Interlook», обладающего необходимыми правами;
  • USERPASSWORD - пароль пользователя базы данных ПК «Мастер-Interlook»;
  • APPLICATION - название веб-приложения Interlook-Web. (Приложение должно соответствовать приложению указанному в файле SETTINGS.CONFIG ПК «Мастер-Interlook Web»).

Настройки в секции Appsettings файла конфигурации web.config


В 11.17 релизе переработана процедура перезапуска кэша. Эта настройка обязательно задается в web.config.
Рассмотрим несколько вариантов:

<add key="cachingTime" value="-1"/> 

– где инициализация кэша максимально производительная: каждый отель загружается в своем потоке (возможны сбои).

<add key="cachingTime" value="-2"/>

– где загрузка кэша происходит перед запуском WebService. Весь кэш загружается в 2 потока. Данные в кэше хранятся постоянно.

<add key="cachingTime" value="10"/>  

– где загрузка кэша при старте не происходит. Данные в нем хранятся 10 секунд.
Подробнее описано в пункте Настройка параметров "cachingTime".

<add key="LogCacheMemory" value="0"/> - включение логирования о использовании памяти сервера LogCacheMemory. Настройка служит для включения или отключения логирования в таблицу базы данных о использовании кешем сервиса памяти сервера. 0 - выключена, 1 - включена
<add key="IsAddHotsWithCosts" value="false"/> - настройка регулирует отображение стоимости Addhot типа WithCosts в стоимости проживания в поиске. Отсутсвие настройки обрабатывается как false. При включении настройки в trueсумма проживания в поиске и в корзине одинаково, при выключении настройки цена в поиске не учитывает услуги типа WithCosts.


В файле web.config для оптимальной работы сервиса нужно убедиться, что в секции <system.web> значение настройки compilation debug установлено в положении false


<compilation debug="false" targetFramework="4.0">


Данная настройка обеспечивает большую производительность сервиса.
Далее необходимо создать в IIS новое приложение (например ILWevService) и указать физический путь к папке, созданной ранее.

Создание приложения на IIS

Для создания приложения на IIS необходимо выполнить следующие шаги:

  • Запустить Диспетчер служб Internet Information Services (IIS)


62.PNG

  • Добавить классический пул приложения для ASP.NET 4.0


63.PNG

  • В IIS на уровне сайта выбрать из контекстного меню пункт Добавить приложение и связать данное приложение с ранее созданным пулом
  • В графе "Физический путь" выбрать ранее созданный каталог (например С:\Inetpub\wwwroot\Interlook_WebService).


64.PNG

Проверка работоспособности Web-сервиса


После установки веб-сервиса рекомендуется проверить его работу. Для этого можно в IIS выбрать приложение, созданное для веб-сервиса и в контекстном меню (вызывается нажатием левой кнопки мыши на приложении) выбрать пункт Обзор (Управление приложениемОбзор):

Управление приложением -> Обзор

Когда откроется страница, необходимо в адресной строке в конце дописать Service.asmx. После этого должна открыться такая страница:

Веб-Сервис

Настройка

В диспетчере служб IIS в разделе Пулы приложений (Application Pool) открыть Дополнительные параметры (Advanced Settings) приложения .Net v4.5. В параметре Режим запуска (Start Mode) установить значение AlwaysRunning.
Пул приложений 1

Рекомендуется настроить перезапуск пула приложения раз в сутки, в ночное время. Для настройки перезапуска открыть Дополнительные параметры (Advanced Settings) пула приложения и в поле Моменты точного времени для перезапуска (Specific Time), меню TimeSpanArray установить время перезапуска. Значение поля Постоянный временной интервал (в минутах) (Regular Time Interval) установить в значение 0.
Пул приложений 3

В IIS на уровне сайта открыть Дополнительные параметры (Advanced Settings). В параметре Предварительная установка разрешена (Preload Enabled) установить значение true.

Пул приложений 2

Порядок обновления Web-сервиса

При обновлении web-сервиса ПК "Мастер-Interlook" необходимо:

  • Получить файлы новой версии
  • Открыть папку, содержащие файлы текущего Web-сервиса (например, открыв Диспетчер служб Internet Information Services (IIS) и выбрав в контекстном меню необходимого web-сервиса пункт Проводник)
  • Скопировать файлы новой версии в папку текущего Web-сервиса (заменяя все файлы)
  • Открыв Диспетчер служб Internet Information Services (IIS)
  • На уровне сайта выбрать в меню действия выбрать пункт Перезагрузить (или Остановить и сразу после этого Начало)
  • Проверить работоспособность сервиса способом, описанным в пункте Проверка работоспособности Web-сервиса.

Настройка параметров "cachingTime"

<add key="cachingTime" value="-1"/> - инициализация кэша максимально производительная: каждый отель загружается в своем потоке(возможны сбои). Данные в кэше хранятся постоянно.
<add key="cachingTime" value="-2"/> - весь кэш загружается в 2 потока. Данные в кэше хранятся постоянно.
<add key="cachingTime" value="-5"/> - весь кэш загружается в 5 потоков. Данные в кэше хранятся постоянно.
<add key="cachingTime" value="-10"/> - весь кэш загружается в 10 потока. Данные в кэше хранятся постоянно.
<add key="cachingTime" value="10"/> - кэш не загружается при старте приложения, данные в нем хранятся 10 секунд.
<add key="cachingTime" value="300"/> - кэш не загружается при старте приложения, данные в нем хранятся 300 секунд.
<add key="cachingTime" value="600"/> - кэш не загружается при старте приложения, данные в нем хранятся 600 секунд.