Мастер-Тур(15):Установка

Статья находится на стадии разработки.
Версия статьи от 9-06-2016.

Поддерживаемые версии ПК «Мастер-Тур»: Начиная с 15 версии

Введение

Процесс установки ПК «Мастер-Тур» 15 версии включает в себя установку всех компонентов, необходимых для работы приложения.

Системные требования

Минимальная поддерживаемая версия SQL Server 2008 R2 SP1 (10.50.2500.0)

Процессор
Оперативная память
Свободное место на жестком диске
Операционная система
Разрешение монитора

Взаимодействие модулей

Взаимодействие модулей «Мастер-Тур» 15 версии представлено на схеме.

Установка

Установка компонентов 15 версии ПК «Мастер-Тур» производится в несколько этапов, которые описаны ниже.

Установка службы поиска

Служба поиска нужна для кеширования данных для поиска (!!! расширить, для чего нужна служба поиска!!!).

• Скопировать папку TourSearchOwin из дистрибутива на сервер приложений.
• Перед установкой службы поиска необходимо настроить конфигурационный файл Megatec.TourSearchOwin.exe.config.

№	Название	Описание	Настройка
1	Строка подключения	Строка подключения к базе данных ПК «Мастер-Тур» указывается в секции appSettings. Внимание! Для корректной работы в настройке User Id необходимо указать пользователя, созданного в ПК «Мастер-Тур». Использование имени входа sa или других системных имен входа MS SQL сервера невозможно.	<add key="connectionString" value="Data Source=Server; Initial Catalog=Database; User Id=User; Password=Password; Application Name=TourSearchOwin" />
2	Логирование	Путь к лог-файлам задается в секции Loggers path.	<Loggers path="Logs\"> <Logger level="ALL" name="TourSearch" console="true" /> Логирование информации о поиске (доп. инфо 36421) <Logger level="ALL" name="TourSearchCache" console="true" /> Логирование информации об инициализации кеша (доп. инфо 36421) </Loggers>
3	Путь к службе поиска	По умолчанию служба поиска использует порт 9000. Рекомендуется использование порта по умолчанию. Внимание! При смене порта необходимо также изменить порт в установочном скрипте _Install.bat.	<add key="serviceAddress" value="http://localhost:9000/TourSearchOwin/" />
4	Отображение актуальных фильтров	Включает актуальные фильтры в поиске и подсветку дат. В этом случае инициализация увеличивается по времени (актуальную информацию дописать после реализации задачи 37078). По умолчанию настройка не включена (значение false).	<add key="enableActualFilters" value="true" />

• Установка осуществляется запуском скрипта _Install.bat от имени администратора.
• При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта службы поиска.
• В Службах Windows добавляется служба TourSearchWebApi!!! заменить на TourSearchOwin после 36426 и скрин!!!.
  

• Для удаления службы кэширования необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.

Установка службы MasterTourService

Служба MasterTourService нужна для кеширования данных для работы ПК «Мастер-Тур». Без запущенной службы MasterTourService в ПК «Мастер-Тур» войти нельзя. (!!! расширить, для чего нужна служба MTS!!!).

• Скопировать папку MasterTourService из дистрибутива на сервер (!!! на каком сервере должна быть размещена служба MTS? !!!).
• Перед установкой службы поиска необходимо настроить конфигурационный файл Megatec.MasterTourService.exe.config.

№	Название	Описание	Настройка
1	Строка подключения	Строка подключения к базе данных ПК «Мастер-Тур» указывается в секции appSettings. Внимание! Для корректной работы в поле User Id необходимо указать пользователя sa.	<!--Имя приложения--> <add key="applicationName" value="MasterTourService"/> <!--Сервер--> <add key="serviceServer" value="Server"/> <!--База данных--> <add key="serviceDatabase" value="Database"/> <!--Логин --> <add key="defaultUserName" value="User"/> <!--Пароль--> <add key="defaultPassword" value="Password"/>
2	Логирование	Путь к лог-файлам задается в секции Loggers path.	<Loggers path="Logs\"> (доп. инфо по логам: список и что каждый лог логирует в задаче 36421) <Logger level="ALL" name="ExceptionLogger"/> <Logger level="ALL" name="AddCostLogic"/> <Logger level="ALL" name="CostLogic"/> <Logger level="ALL" name="TourMarginLogic"/> <Logger level="ALL" name="QuotaLogic"/> <Logger level="ALL" name="FlightSelectionLogic"/> </Loggers>
3	Имя текущей установленной службы (отображается в таблице MasterTourServiceHosts)	После установки службы MasterTourService также добавляется информация в таблицу MasterTourServiceHosts. В поле MTS_Name записывается значение настройки acceptableServices. Данная настройка отображает наименования сервисов, к которым можно будет обращаться: из ПК «Мастер-Тур», указав их в конфигурационном файле master32.exe.config из ПК «Мастер-Web», указав их в конфигурационном файле web.config из Программы туров, указав их в конфигурационном файле web.config. По умолчанию настройка не заполнена. Внимание! Данную настройку необходимо заполнять, если планируется использование нескольких служб MasterTourService. Если используется только одна служба MasterTourService, то настройку можно оставить не заполненной.	<add key="acceptableServices" value=""/>
4	Приоритет текущего установленного сервиса	Приоритет текущей установленной службы MasterTourService. Целое положительное число. Чем число выше, тем приоритет больше.	<add key="servicePriority" value="1"/>

• Установка осуществляется запуском скрипта _Install.bat от имени администратора.
• При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта MasterTourService.
• В Службах Windows добавляется служба MegatecMasterTourService.
  

• Для удаления службы кэширования необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.

Установка службы кеша для акций

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

• Скопировать папку SpecialsCacheService из дистрибутива на сервер.
• Перед установкой службы кеша для акций необходимо настроить конфигурационный файл Megatec.MasterTour.SpecialsCacheService.exe.config.

№	Название	Описание	Настройка
1	Строка подключения	Строка подключения к базе данных ПК «Мастер-Тур» указывается в секции appSettings. Внимание! Для корректной работы в поле User Id необходимо указать пользователя sa.	<add key="connectionString" value="Data Source=Server; Initial Catalog=Database; User Id=User; Password=Password; Application Name=Specials" />
2	Название службы	Задается название службы. По умолчанию служба будет создана с названием MegatecSpecialsCacheService.	<add key="serviceName" value="MegatecSpecialsCacheService"/>
3	Логирование	Путь к лог-файлам задается в секции Loggers path.	<Loggers path="Logs\"> <Logger level="ALL" name="ExceptionLogger" console="true" /> Логирование ошибок <Logger level="ALL" name="SpecialsCache" console="true" /> Логирование информации по заполнению кеша акций </Loggers>
4	Порт	По умолчанию служба кэширования использует порт 52529. Рекомендуется использование порта по умолчанию. Внимание! При смене порта необходимо также изменить порт в установочном скрипте _Install.bat.	<add baseAddress="http://localhost:52529/SpecialsCache/SpecialsHotelDataCacheService"/> <add baseAddress="http://localhost:52529/SpecialsCache/SpecialsAccommodationsCacheService"/>

• Установка осуществляется запуском скрипта _Install.bat от имени администратора.
• При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта кэширования.
• В Службах Windows добавляется служба SpecialsCacheService.
  

• Для удаления службы кэширования необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.

Установка службы платежей

Описание установки службы подписи путевок и платежей будет позже (после ее реализации).

Установка серверной части ПК «Мастер-Тур»

Установка серверной части ПК «Мастер-Тур»

Обновление базы данных ПК «Мастер-Тур»

Если при установке 15 версии используется эталонная база, то этот шаг можно пропустить.

Ниже описан порядок обновления базы данных ПК «Мастер-Тур» при переходе на 15 версию программы:

• Обновить базу данных до релиза 2009.2.20.11 (скрипт обновления можно скачать из личного кабинета)
• Выполнить скрипт (из дистрибутива обновления) 1. from 9.2.20.11.sql: происходит обновление с 2009.2.20.11 до последнего сервис пака
• Выполнить скрипт (из дистрибутива обновления) 2. CurrentScript.sql: происходит обновление с последнего сервис пака до 15 версии

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

• Выполнить скрипт (из дистрибутива обновления) convertCostOffers.sql: происходит конвертация цен в ценовые блоки

Установка клиентской части ПК «Мастер-Тур»

Установка клиентской части ПК «Мастер-Тур»

• После установки клиентской части необходимо настроить конфигурационный файл Master32.exe.config.

№	Название	Описание	Настройка
1	Имя текущей установленной службы	Наименования служб, к которым может обращаться текущий клиент (по значению настройки acceptableServices в MasterTourService). Можно указать несколько служб через точку с запятой. В случае, когда настройка не заполнена, используется произвольная служба из списка в таблице MasterTourServiceHosts. По умолчанию настройка не заполнена.	<add key="acceptableServices" value=""/>

Установка программы туров

Для установки приложения Программы туров нужно создать отдельную директорию, например, TourPrograms (далее в примерах будет использоваться данное название каталога) в корневом каталоге IIS (по умолчанию c:/inetpub/wwwroot) и выложить туда распакованные файлы из архива TourPrograms.zip. В управлении IIS необходимо создать виртуальный каталог для папки TourPrograms.

Создание виртуального каталога

По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:

1. Зайти в Пуск (Start) – Панель управления (Control Panel) – Администрирование (Administrative Tools).

2. Запустить Internet Information Services (IIS) Manager.

3. В открывшемся дереве каталогов выбрать сайты (Web Sites) – Default Web Site (либо другой сайт, на который планируется установить приложение). В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать пункт «Преобразовать в приложение».

Настройка конфигурационного файла

№	Название	Описание	Настройка
1	Строка подключения	Строка подключения к базе данных ПК «Мастер-Тур» указывается в секции appSettings.	<add key="connectionString" value="Data Source=Server; Initial Catalog=Database; User Id=User; Password=Password; Application Name=TourPrograms" />
2	Логирование	Путь к лог-файлам задается в секции Loggers path.	<Loggers path="Logs\"> (доп. инфо по логам: список и что каждый лог логирует в задаче 36421) <Logger level="ALL" name="ExceptionLogger"/> Логирование ошибок <Logger level="ALL" name="AddCostLogic"/> Логирование ... <Logger level="ALL" name="CostLogic"/> <Logger level="ALL" name="TourMarginLogic"/> <Logger level="ALL" name="QuotaLogic"/> <Logger level="ALL" name="FlightSelectionLogic"/> </Loggers>
3	Путь к службе поиска	Необходимо указать путь, по которому была настроена служба поиска. Если был изменен порт по умолчанию – его также необходимо сменить в настройке.	<add key="SearchApiServiceUrl" value="http://localhost:9000/TourSearchOwin/" />
4	Путь к службе кеша для акций	Необходимо указать путь, по которому была настроена служба кеша для акций. Если был изменен порт по умолчанию – его также необходимо сменить в настройке.	<add key="cacheServiceBaseAddress" value="http://localhost:52529/SpecialsCache/"/>
5	Имя текущей установленной службы	Наименования служб, к которым может обращаться текущий клиент (по значению настройки acceptableServices в MasterTourService). Можно указать несколько служб через точку с запятой. В случае, когда настройка не заполнена, используется произвольная служба из списка в таблице MasterTourServiceHosts. По умолчанию настройка не заполнена.	<add key="acceptableServices" value=""/>

Установка поиска вариантов программ туров

Для установки приложения Поиск вариантов программ туров нужно создать отдельную директорию, например, TourSearchClient (далее в примерах будет использоваться данное название каталога) в корневом каталоге IIS (по умолчанию c:/inetpub/wwwroot) и выложить туда распакованные файлы из архива TourSearchClient.zip. В управлении IIS необходимо создать виртуальный каталог для папки TourSearchClient.

Создание виртуального каталога

По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:

1. Зайти в Пуск (Start) – Панель управления (Control Panel) – Администрирование (Administrative Tools).

2. Запустить Internet Information Services (IIS) Manager.

3. В открывшемся дереве каталогов выбрать сайты (Web Sites) – Default Web Site (либо другой сайт, на который планируется установить приложение). В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать пункт «Преобразовать в приложение».

Настройка конфигурационного файла

!!!Актуализировать таблицу!!!

№	Название	Описание	Настройка
1	Ссылка на страницу забронированных путевок	Путь Внимание! Текст.	<add key="mwOrderInfo" value="MasterWeb/OrderInfo.aspx"/> <add key="mwOrderListUrl" value="MasterWeb/OrderList.aspx"/> <add key="mwPasswordRecoveryUrl" value="MasterWeb/PasswordRecovery.aspx"/> <add key="mwRegistrationUrl" value="MasterWeb/registration.aspx"/> <add key="mwSendReservationMails" value="MasterWeb/SendReservationMails.aspx"/>
2	Логирование	Путь к лог-файлам задается в секции Loggers path.	<Loggers path="Logs\"> <Logger level="ALL" name="TourSearch" console="true" /> Логирование информации о поиске (доп. инфо 36421) <Logger level="ALL" name="TourSearchCache" console="true" /> Логирование информации об инициализации кеша (доп. инфо 36421) </Loggers>
3	Путь к службе поиска	Необходимо указать путь, по которому была настроена служба поиска. Если был изменен порт по умолчанию – его также необходимо сменить в настройке.	<add key="SearchApiServiceUrl" value="http://localhost:9000/TourSearchOwin/" />

Установка ПК «Мастер-Web»

Настройка конфигурационного файла

!!!Актуализировать таблицу!!!

№	Название	Описание	Настройка
1	Путь к службе поиска	Необходимо указать путь, по которому была настроена служба поиска. Если был изменен порт по умолчанию – его также необходимо сменить в настройке.	<add key="SearchApiServiceUrl" value="http://localhost:9000/TourSearchOwin/" />
2	Имя текущей установленной службы	Наименования служб, к которым может обращаться текущий клиент (по значению настройки acceptableServices в MasterTourService). Можно указать несколько служб через точку с запятой. В случае, когда настройка не заполнена, используется произвольная служба из списка в таблице MasterTourServiceHosts. По умолчанию настройка не заполнена.	<add key="acceptableServices" value=""/>

Установка файла лицензии

Для установки файла лицензии необходимо зайти в приложение Программа туров на вкладку Панель администрирования под пользователем, который имеет административные права (выбрана роль sysadm на уровне сервера), а также является пользователем ПК «Мастер-Тур». При первом входе будет отображена информация о том, что файл лицензии отсутствует.

Необходимо скопировать поле GUID сервера и отправить его в компанию ООО «КОМПАНИЯ МЕГАТЕК» по адресу service@megatec.ru. После обработки Вам будет отправлено письмо с файлом лицензии. Его нужно будет выбрать с помощью кнопки Выбрать.

После этого нажать на кнопку Загрузить. Файл лицензии будет загружен, информация об этом будет отображена внизу страницы. Для клиента отображается информация о названии компании, сроке действия и количестве купленных лицензий. Изменения по новому файлу лицензии будут применены через 10 минут.