Master-Interlook:Interlook-Web. Настройка Web-сервиса Master-Interlook — различия между версиями
| [досмотренная версия] | [досмотренная версия] |
Aefremov (обсуждение | вклад) (→Введение) |
Biryukov (обсуждение | вклад) (→Настройка) |
||
| (не показано 19 промежуточных версий 3 участников) | |||
| Строка 1: | Строка 1: | ||
==Введение== | ==Введение== | ||
| − | В данной статье рассказывается о правильной установке и настройке Web-сервиса ПК "Master-Interlook", а также действиях при его обновлении. | + | В данной статье рассказывается о правильной установке и настройке Web-сервиса ПК "Master-Interlook Web", а также действиях при его обновлении. |
Бронирование в ПК «Мастер-Interlook Web» из базы данных ПК «Мастер-Interlook» осуществляется через веб-сервис ПК «Мастер-Interlook». В том случае, если данный веб-сервис не был установлен ранее (например для обмена данными с ПК «Мастер-Тур») для осуществления возможности бронирования необходимо установить и настроить данный веб-сервис. | Бронирование в ПК «Мастер-Interlook Web» из базы данных ПК «Мастер-Interlook» осуществляется через веб-сервис ПК «Мастер-Interlook». В том случае, если данный веб-сервис не был установлен ранее (например для обмена данными с ПК «Мастер-Тур») для осуществления возможности бронирования необходимо установить и настроить данный веб-сервис. | ||
| − | + | Также Web-сервис используется для автоматизации обмена данными между ПК "Мастер-Тур" и ПК "Master-Interlook". | |
==Порядок установки Web-сервиса== | ==Порядок установки Web-сервиса== | ||
| − | Web-сервис устанавливается на стороне | + | 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 /> | ||
| − | + | При этом необходимо в файле <code>'''WEB.CONFIG'''</code> веб-сервиса настроить строку подключения к базе данных ПК «Мастер-Interlook»: | |
| − | + | <code> | |
| − | + | <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>"/> | |
| − | < | + | </code> |
| − | <add key="connectionString" value="Data Source= | + | где: |
| − | </ | + | * '''SERVERNAME''' - сервер, на котором находится база данных ПК «Мастер-Interlook»;<BR> |
| − | где< | + | * '''DATABASENAME''' - название базы данных ПК «Мастер-Interlook»;<BR> |
| + | * '''USERNAME''' - имя пользователя базы данных ПК «Мастер-Interlook», обладающего необходимыми правами;<BR> | ||
| + | * '''USERPASSWORD''' - пароль пользователя базы данных ПК «Мастер-Interlook»;<BR> | ||
| + | * '''APPLICATION''' - название веб-приложения Interlook-Web. (Приложение должно соответствовать приложению указанному в файле SETTINGS.CONFIG ПК «Мастер-Interlook Web»). </BR> | ||
| − | + | ====Настройки в секции Appsettings файла конфигурации web.config==== | |
| − | + | <BR> В 11.17 релизе переработана процедура перезапуска кэша. Эта настройка обязательно задается в web.config. <BR> | |
| − | + | Рассмотрим несколько вариантов:<BR> | |
| − | + | <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-сервиса=== | ||
| − | + | <BR>После установки веб-сервиса рекомендуется проверить его работу. Для этого можно в IIS выбрать приложение, созданное для веб-сервиса и в контекстном меню (вызывается нажатием левой кнопки мыши на приложении) выбрать пункт '''Обзор''' ('''Управление приложением''' → '''Обзор'''):<BR> | |
| − | < | + | |
| − | + | [[Файл: am_449.png|x500px|Управление приложением -> Обзор]]<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 /> | ||
| − | + | Рекомендуется настроить перезапуск пула приложения раз в сутки, в ночное время. Для настройки перезапуска открыть '''Дополнительные параметры (Advanced Settings)''' пула приложения и в поле '''Моменты точного времени для перезапуска (Specific Time)''', меню '''TimeSpanArray''' установить время перезапуска. Значение поля Постоянный временной интервал (в минутах) (Regular Time Interval) установить в значение 0. <br /> | |
| − | [[Файл: | + | [[Файл:Ea_236.png|500px|Пул приложений 3]] <br /> <br /> |
| − | + | Дополнительные настройки условий перезапуска, такие как '''Через регулярные интервалы времени (в минутах)''' и '''После выполнения фиксированного числа запросов''' рекомендуется устанавливать на значение 0.<br /> | |
| + | [[Файл:Ag 065.png|500px|Пул приложений 4]]<br /><br /> | ||
| + | В случае если сталкиваетесь с проблемой постоянного перезапуска пула приложений, можно отключить настройку '''Защита от частых сбоев''' в дополнительных параметрах перезапуска пула приложений.<br /> | ||
| + | [[Файл:Ag 067.png|500px|Пул приложений 5]]<br /><br /> | ||
В IIS на уровне сайта открыть '''Дополнительные параметры (Advanced Settings)'''. | В IIS на уровне сайта открыть '''Дополнительные параметры (Advanced Settings)'''. | ||
В параметре '''Предварительная установка разрешена (Preload Enabled)''' установить значение '''true'''. | В параметре '''Предварительная установка разрешена (Preload Enabled)''' установить значение '''true'''. | ||
| Строка 64: | Строка 88: | ||
==Порядок обновления Web-сервиса== | ==Порядок обновления Web-сервиса== | ||
При обновлении web-сервиса ПК "Мастер-Interlook" необходимо: | При обновлении web-сервиса ПК "Мастер-Interlook" необходимо: | ||
| − | * Получить | + | * Получить файлы новой версии |
* Открыть папку, содержащие файлы текущего Web-сервиса (например, открыв Диспетчер служб Internet Information Services (IIS) и выбрав в контекстном меню необходимого web-сервиса пункт '''Проводник''') | * Открыть папку, содержащие файлы текущего Web-сервиса (например, открыв Диспетчер служб Internet Information Services (IIS) и выбрав в контекстном меню необходимого web-сервиса пункт '''Проводник''') | ||
* Скопировать файлы новой версии в папку текущего Web-сервиса (заменяя все файлы) | * Скопировать файлы новой версии в папку текущего Web-сервиса (заменяя все файлы) | ||
* Открыв Диспетчер служб Internet Information Services (IIS) | * Открыв Диспетчер служб Internet Information Services (IIS) | ||
* На уровне сайта выбрать в меню действия выбрать пункт '''Перезагрузить''' (или '''Остановить''' и сразу после этого '''Начало''') | * На уровне сайта выбрать в меню действия выбрать пункт '''Перезагрузить''' (или '''Остановить''' и сразу после этого '''Начало''') | ||
| − | * Проверить работоспособность сервиса способом, описанным в пункте [[Master-Interlook: | + | * Проверить работоспособность сервиса способом, описанным в пункте [[Master-Interlook:Interlook-Web. Настройка Web-сервиса Master-Interlook#Проверка работоспособности Web-сервиса|''Проверка работоспособности Web-сервиса'']]. |
==Настройка параметров "cachingTime"== | ==Настройка параметров "cachingTime"== | ||
| Строка 84: | Строка 108: | ||
[[Category:Master-Interlook_Настройка]] | [[Category:Master-Interlook_Настройка]] | ||
[[Category:Master-Interlook_Администрирование]] | [[Category:Master-Interlook_Администрирование]] | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Текущая версия на 17:06, 21 мая 2024
Содержание
Введение
В данной статье рассказывается о правильной установке и настройке 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)
- Добавить классический пул приложения для ASP.NET 4.0
- В IIS на уровне сайта выбрать из контекстного меню пункт Добавить приложение и связать данное приложение с ранее созданным пулом
- В графе "Физический путь" выбрать ранее созданный каталог (например С:\Inetpub\wwwroot\Interlook_WebService).
Проверка работоспособности Web-сервиса
После установки веб-сервиса рекомендуется проверить его работу. Для этого можно в IIS выбрать приложение, созданное для веб-сервиса и в контекстном меню (вызывается нажатием левой кнопки мыши на приложении) выбрать пункт Обзор (Управление приложением → Обзор):
Когда откроется страница, необходимо в адресной строке в конце дописать Service.asmx. После этого должна открыться такая страница:
Настройка
В диспетчере служб IIS в разделе Пулы приложений (Application Pool) открыть Дополнительные параметры (Advanced Settings) приложения .Net v4.5.
В параметре Режим запуска (Start Mode) установить значение AlwaysRunning.
Рекомендуется настроить перезапуск пула приложения раз в сутки, в ночное время. Для настройки перезапуска открыть Дополнительные параметры (Advanced Settings) пула приложения и в поле Моменты точного времени для перезапуска (Specific Time), меню TimeSpanArray установить время перезапуска. Значение поля Постоянный временной интервал (в минутах) (Regular Time Interval) установить в значение 0.
Дополнительные настройки условий перезапуска, такие как Через регулярные интервалы времени (в минутах) и После выполнения фиксированного числа запросов рекомендуется устанавливать на значение 0.
В случае если сталкиваетесь с проблемой постоянного перезапуска пула приложений, можно отключить настройку Защита от частых сбоев в дополнительных параметрах перезапуска пула приложений.
В IIS на уровне сайта открыть Дополнительные параметры (Advanced Settings).
В параметре Предварительная установка разрешена (Preload Enabled) установить значение true.
Порядок обновления 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 секунд.
