Мастер-Тур(15):Установка — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Открытие портов для работы системы)
(не показана 1 промежуточная версия этого же участника)
(нет различий)

Версия 08:26, 9 октября 2019

Версия статьи от 9-10-2019.

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


Содержание

Введение

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

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

Минимальная поддерживаемая версия SQL Server 2008 R2 SP1 (10.50.2500.0). При использовании Microsoft SQL Server 2017 необходимо проставить у базы данных уровень совместимости 140, иначе будут возникать ошибки, связанные с производительностью системы.

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

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

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

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

Установка

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

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


Пароль пользователей системы, от которых работают службы и приложения, 
не должен содержать ни одного из следующих символов: < > " ' & 

Открытие портов для работы системы

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


Служба TourSearchOwin по умолчанию сконфигурирована на работу по порту tcp: 9000. 
Все клиенты, работающие с веб интерфейсом поиска туров (как из сети internet, 
так и локальные пользователи и службы) должны иметь доступ к этой службе. 
Для этого необходимо открытие соответствующего порта на firewall и DNAT 
проброс порта к серверу,  на котором установлена служба TourSearchOwin.

Пример:

  • В конфигурационном файле службы TourSearchOwin настройка serviceAddress будет иметь значение http://online.yourdomainname.ru:9000/TourSearchOwin, а в конфигурационных файлах приложений TourSeachClient, TourPrograms, MasterWeb настройка SearchApiServiceUrl должна иметь значение http://online.yourdomainname.ru:9000/TourSearchOwin.
  • Для работы с сервисом в сети интернет у вас должен быть настроен DNS для вашего ресурса, к примеру с названием online.yourdomainname.ru. Вы должны иметь запись типа А в зоне домена. Как правило, эту запись можно настроить самостоятельно у вашего провайдера услуг или же по обращению в службу поддержки размещения ресурса.
  • Приложение TourSearchClient устанавливается на IIS и по умолчанию сконфигурировано на работу по порту tcp: 80.
  • Все службы и приложения размещаются на одном сервере в локальной сети или на площадке ДЦ (если используется конфигурация, где несколько серверов – см. ниже в разделе Советы).

Для работы такой конфигурации необходима возможность доступа из сети интернет всем пользователям к Public IP и трансляция портов 80, 9000 на данный сервер.

Важное замечание:

  • Для уменьшения трафика через внешнее соединение или при невозможности обеспечить взаимодействие служб сервера путем обращения к самому себе через внешнее соединение, рекомендуется настроить службу внутреннего DNS для трансляции адреса online.yourdomainname.ru в адрес локальной сети (192.168.1.1), на котором установлена службы TourSearchOwin. Таким образом можно добиться работы внешних пользователей с внешнем адресом, а работу пользователей локальной сети и всех служб комплекса через локальную сеть.

Советы:

  • При наличии в сети прокси-сервера необходимо исключить на всех клиентах и всех серверах работу с компонентами и службами через прокси-сервер.
  • Внутренний DNS можно заменить редактированием файла hosts в операционной системе, но это повлечет необходимость держать его актуальным на всех компьютерах и серверах локальной сети и своевременное его резервирование с возможностью восстановить из backup.
  • При необходимости изменить работу TourSearchOwin на работу с портом 80 необходимо:
    • изменить соответствующие строки в конфигурационных файлах. Привести к виду: http://online.yourdomainname.ru/TourSearchOwin настройку serviceAddress и соответствующим образом поправить настройки приложений TourSeachClient, TourPrograms, MasterWeb.
    • предусмотреть дополнительный Public IP и DNS записи, если служба TourSearchOwin размещается не на сервере, где размещен TourSearchClient, т.к. невозможно сделать DNAT с одного порта Public IP на два разных компьютера локальной сети.


Тестирование компонентов комплекса:

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

Установка и настройка SQL Server

База данных для серверной части ПК «Мастер-Тур» разворачивается на MS SQL Server. Минимально возможная версия сервера MS SQL Server 2008R2 SP1. Рекомендуется использование версии не ниже Microsoft SQL Server 2017 с последним сервис паком (гайд по установке).

Особенности настройки SQL сервера, задаваемые при установке:

  • Для работы ПК «Мастер-Тур» необходим компонент «Компонент Database Engine» и Компоненты соединения. Остальные компоненты (Службы Analysis Services, Службы Reporting Services, Службы Integration Services, Службы Master Data Services, Data Quality Services) не используются. Можно исключить их из установки для экономии ресурсов компьютера.
  • Установить значение «Cyrillic_General_CI_AS» в параметре сортировки свойств базы данных (Properties → Options → Collation).
  • Во избежание возникновения ошибок необходимо убедиться, что у имен входа (пользователей) Microsoft SQL Server, используемых для работы в ПК «Мастер-Тур», в качестве языка по умолчанию установлен английский язык. Для осуществления проверки нужно запустить SQL Server Management Studio, подключиться к используемому экземпляру SQL Server, зайти в свойства и выбрать значение «English» (Properties → General → Default language).
Предупреждение


Настройка Default language особо критична для имен входа, под которыми
работают ПК «Мастер-Web» и веб-сервисы «MasterTourService». Имена входа указываются
в конфигурационных файлах соответствующих приложений и используются для обращений
к базе данных ПК «Мастер-Тур».

Присоединение базы данных вручную

  • Подключиться к соответствующему экземпляру компонента SQL Server Database Engine, в обозревателе объектов выбрать имя сервера.
  • Кликом правой кнопкой мыши по узлу Databases открыть контекстное меню и выбрать команду Attach.
  • В открывшемся диалоговом окне нажать кнопку Add.
  • В открывшемся диалоговом окне выбрать диск, на котором находится база данных. В дереве каталогов выбрать необходимый mdf-файл, нажать OK.
  • При необходимости изменить данные:
    • Attach As - имя, под которым будет присоединена база данных;
    • Owner - владелец базы данных.
  • Нажать OK.
  • Новая база данных будет отображаться в списке.
  • После присоединения базы данных, необходимо убедиться, что выбран максимально возможный для этой версии SQL Server уровень совместимости, иначе будут возникать ошибки, связанные с производительностью системы. Для SQL Server 2017 уровень совместимости равен 140, это значение устанавливается в свойствах базы данных (Properties → Options → Compatibility level).
Предупреждение


Файлы базы данных и файлы резервной копии физически должны находиться на отдельных дисках 
(для восстановления базы данных в случае проблем с диском)

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

Если при установке 15 версии используется эталонная база, необходимо выполнить два скрипта:

  • Выполнить скрипт (из дистрибутива обновления) CurrentScript.sql – для обновления базы данных ПК Мастер-Тур
  • Выполнить скрипт (из дистрибутива обновления) CreateUserMT15.sql – для создания пользователя, который будет использоваться в конфигурационном файле службы поиска TourSearchOwin, а также для входа в программу туров для установки лицензии

После окончания настройки программы, для дальнейшего создания логинов и паролей пользователей необходимо использовать приложение Мастер-Администратор.


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

  • Обновить базу данных до релиза 2009.2.20.31 (скрипт обновления можно скачать из личного кабинета)
  • Выполнить скрипт (из дистрибутива обновления) 15.0.0_2015.09.01.sql
  • Выполнить скрипт (из дистрибутива обновления) CurrentScript.sql

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

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

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

  • Скопировать папку MasterTour из дистрибутива на клиентскую машину.
  • Распаковать дистрибутивы MasterTour_Rus_15.1.0.ххххх.zip и Plugins/AllPlugins.zip в папку MasterTour
  • Настроить конфигурационный файл sql.ini. Если установка с нуля, то шаблон файла можно взять ниже.
Название Описание Настройка
1 Строка подключения Строка подключения к базе данных ПК «Мастер-Тур»

Внимание!
В случае, если осуществляется вход в ПК "Мастер-Тур" не из локальной сети, то необходимо прописать внешний ip-адрес (как в файле sql.ini приложения ПК Мастер-Тур, так и в настройке hostname приложения MasterTourService).
Внимание!
Пароль пользователей системы, от которых работают службы и приложения, не должен содержать ни одного из следующих символов: < > " ' &

remotedbname=AVALON,DRIVER=SQL Server; SERVER=Server; DATABASE=Database; Trusted_Connection=NO; APP=Master-Tour client;


Шаблон файла sql.ini
[win32client]
clientname=MT

[win32client.dll]
comdll=sqlodb32

[odbcrtr]
remotedbname=AVALON,DRIVER=SQL Server; SERVER=Server; DATABASE=Database; Trusted_Connection=NO; APP=Master-Tour client;

[settings]


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

Установка отчетов

После установки ПК «Мастер-Тур» 15 необходимо переустановить следующие отчеты:

  • 4001
  • 4003
  • 4006
  • 4010
  • 4020
  • 4030

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

Служба поиска нужна для кеширования данных для поиска и является основой архитектуры динамического ценообразования, API для поиска и бронирования. Служба кеширует следующие данные: справочники (города вылета, страны, города, отели и т.д.); актуальные фильтры, туры и цены.

  • Скопировать папку 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://*:9000/TourSearchOwin/" />
4 Использование актуальных фильтров Включает актуальные фильтры в поиске и подсветку дат. В этом случае инициализация увеличивается по времени. По умолчанию настройка не включена (значение false).
<add key="enableActualFilters" value="true" />
5 Название службы Задается название службы. По умолчанию служба будет создана с названием MegatecTourSearchOwin.
<add key="serviceName" value="MegatecTourSearchOwin"/>
6 Расчет размещения 1+0 при заполнении актуальных фильтров По умолчанию актуальные фильтры заполняются только по тем ценам, размещение которых равно 2+0. При использовании этой настройки будет учитываться как размещение 2+0, так и 1+0.

Внимание!
Использование данной настройки увеличивает время актуализации фильтров и уменьшает производительность системы. Использовать только по согласованию со своим куратором.

<add key="calculateFiltersByOneManToo" value="true" />
7 Указание приложения поиска.

Обрабатывается только в API для отдачи цен в поисковые системы.

Путь, где установлено приложение поиска. Данное значение добавляется к результату в параметре tourUrl методов GetTours и ActualizeTour. Вместо localhost необходимо указать внешний ip-адрес или внешнее субдоменное имя.
<add key="sletatruCreateReservationApplicationUrl" value="http://localhost/TourSearchClient/"/>
8 Отображение цен на услуги (значение surcharge метода ActualizeTour в API для отдачи цен в поисковые системы)
  • Always – цена на услуги возвращается всегда и для всех услуг
  • No – цена на услуги не возвращается
  • SurchargeOnly или отсутствие настройки – возвращаются цены только для тех услуг, которые не включены в стоимость тура
<add key="showServicePriceInActualizeTour" value="SurchargeOnly" />
9 Группы классов перелетов.

Обрабатывается только в API для отдачи цен в поисковые системы.

Коды перелетов определенного класса. До разделителя через запятую указываются все перелеты, относящиеся к эконом классу, после разделителя через запятую указываются все перелеты, относящиеся к бизнес классу.
<add key="flightTariffGroups" value="81,87,89,93|67,68,74,92"/>
10 Процент используемых ядер процессора при поиске. Процент от общего количества ядер процессора, которые будут использоваться при поиске. К примеру, в 20-ти ядерном процессоре при значении настройки "0,8" будет использоваться 80 % мощности, то есть 16 ядер.
<add key="searchCoresKoeff" value="0,8" />
11 Процент используемых ядер процессора при перерасчете актуальных фильтров.
Процент от общего количества ядер процессора, которые будут использоваться при перерасчете актуальных фильтров. К примеру, в 20-ти ядерном процессоре при значении настройки "0,8" будет использоваться 80 % мощности, то есть 16 ядер.
<add key="actualFiltersRecalcCoresKoeff" value="0,8" />
12 Упрощение расчета для поисковых систем. Данную настройку необходимо включать только в том случае, если для поисковых систем выделена отдельная служба поиска

false или отсутствие настройки – система работает без изменений
true – при поиске из поисковых систем не считаются лишние комбинации

<add key="searchApiСalculateAlgorithm" value="false" />
13 Служба с данными для актуальных фильтров. Данную настройку необходимо включать в службе, выделенной отдельно для поисковых систем. Используется с настройкой enableActualFilters в значении false
<add key="actualFiltersServiceUrl" value="адрес службы с включенной настройкой enableActualFilters" />
к примеру,  
<add key="actualFiltersServiceUrl" value="http://domain:9001/TourSearchOwin/" />
14 Ограничение максимального количества результатов для поисковых систем. Данная настройка ограничивает параметр count в API для поисковых систем.

Рекомендуемое значение – 60.

<add key="searchApiMaxResults" value="60" />
15 Очистка устаревших данных (offerID в API для поисковых систем) Задается интервал для очистки дерева результатов в API для поисковых систем. Указывается в минутах. Рекомендуемое значение – 60.
<add key="cleanSearchApiTreeInterval" value="60" />

Для настройки отправки писем при работе с частными лицами в Megateс.TourSearchOwin.exe.config службы TourSearchOwin нужно указать следующие настройки:

Описание Настройка
1 Адрес, с которого отправляются письма из системы бронирования
<add key="mailFrom"value="MasterWeb@EmailServiceProvider.com" />
2 Адрес администратора системы, на который приходит уведомление о новой регистрации (можно добавить несколько адресов через « ; »)
<add key="rcptTo"value="MasterWebAdmin@EmailServiceProvider.com"/>
3 Дополнительные e-mail адреса, на которые приходят сообщения о новой регистрации и заявке на бронирование (можно добавить несколько e-mail адресов через « ; »)
<add key="addRcptTo"value="Email1@EmailServiceProvider.com; Email2@EmailServiceProvider.com" />
4 Почтовый сервер SMTP
<add key="smtpServer"value="Smtp.EmailServiceProvider.com" />
5 SMTP порт почтового сервера (по умолчанию — 25)
<add key="smtpPort" value="25" />
6 Тип авторизации на сервере: None, Base64 или TLS/SSL
<add key="smtpAuthentication" value="Base64" />
7 Активация протокола SSL (Нужно включить при использовании TLS/SSL авторизации.)
<add key="EnableSsl" value="false" />
8 Имя пользователя для подключения к почтовому серверу
<add key="smtpUser" value="Domain\Username" />
9 Пароль пользователя для подключения к почтовому серверу
<add key="smtpPassword" value="Pa$$w0rd" />


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

TourSearchWebApi

  • Для удаления службы кэширования необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.
Рекомендуется ежедневно перезапускать службу поиска. Это можно сделать с помощью планировщика заданий Windows. 
Пример bat-файла размещен ниже.
Пример bat-файла для перезагрузки службы поиска
@Echo Off
SetLocal EnableDelayedExpansion

Set ServiceName=MegatecTourSearchOwin
Net Stop %ServiceName%||(
	For /F "tokens=3" %%A In ('SC queryex %ServiceName%^|Find "PID"') Do (
	            TaskKill /F /PID %%A>nul
	            Ping -n 5 127.0.0.1>nul
	)
)
Net start %ServiceName%
echo service restart @ %date% %time% >> REM C:\checklog.txt 
Exit


Варианты конфигураций служб поиска

Ниже описаны варианты конфигураций служб поиска в зависимости от нагрузки и потребностей туроператоров.

Описание Служба Настройка
1 По умолчанию для небольших и средних ТО служба поиска и служба API размещаются на одном сервере. Сервер: TourSearchClient + API
<add key="enableActualFilters" value="true" />
<add key="searchApiСalculateAlgorithm" value="false" />
<add key="searchApiMaxResults" value="60" />
<add key="actualFiltersServiceUrl" value="" />
2 В том случае, если идут большие запросы от поисковых систем и конфигурация №1 не справляется – службу поиска и службу API разносят по разным серверам. Сервер 1: TourSearchClient
<add key="enableActualFilters" value="true" />
<add key="searchApiСalculateAlgorithm" value="false" />
<add key="searchApiMaxResults" value="60" />
<add key="actualFiltersServiceUrl" value="" />
Сервер 2: API
<add key="enableActualFilters" value="true" />
<add key="searchApiСalculateAlgorithm" value="true" />
<add key="searchApiMaxResults" value="60" />
<add key="actualFiltersServiceUrl" value="" />
3 Существует возможность разделить API для поисковых систем на 2 части: API для актуальных фильтров и API для поисковых систем. В API для актуальных фильтров будут только считаться актуальные фильтры при изменениях в системе, а API для поисковых систем будет служить только для осуществления поиска из поисковых систем.

В этом случае конфигурация поисковых служб будет следующая: на отдельном сервере располагается служба поиска (для TourSearchClient), на отдельном сервере API для актуальных фильтров и на отдельном сервере API для поисковых систем.

Сервер 1: TourSearchClient
<add key="enableActualFilters" value="true" />
<add key="searchApiСalculateAlgorithm" value="false" />
<add key="searchApiMaxResults" value="60" />
<add key="actualFiltersServiceUrl" value="" />
Сервер 2: API (актуальные фильтры)
<add key="enableActualFilters" value="true" />
<add key="searchApiСalculateAlgorithm" value="true" />
<add key="searchApiMaxResults" value="60" />
<add key="actualFiltersServiceUrl" value="" />
Сервер 3: API (поисковые системы)
<add key="enableActualFilters" value="false" />
<add key="searchApiСalculateAlgorithm" value="true" />
<add key="searchApiMaxResults" value="60" />
<add key="actualFiltersServiceUrl" value="значение настройки serviceAddress службы API (актуальные фильтры)" />


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

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

  • Скопировать папку MasterTourService из дистрибутива на сервер. Служба MasterTourService должна устанавливаться на компьютере, имеющем доступ к серверу баз данных, или на компьютере, который сам является сервером баз данных (установлен MS SQL Server).
  • Перед установкой службы поиска необходимо настроить конфигурационный файл Megatec.MasterTourService.exe.config.
Название Описание Настройка
1 Название службы Задается название службы. По умолчанию служба будет создана с названием MegatecMasterTourService.
<add key="serviceName" value="MegatecMasterTourService"/>
2 Строка подключения Строка подключения к базе данных ПК «Мастер-Тур» указывается в секции 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"/>
3 Имя компьютера, на котором будет размещено приложение MegatecMasterTourService Необязательная настройка. Если настройка не указана (или не указано значение настройки), то используется DNS-имя компьютера.

Внимание!
В случае, если осуществляется вход в ПК "Мастер-Тур" не из локальной сети, то необходимо прописать внешний ip-адрес (как в настройке hostname приложения MasterTourService, так и в файле sql.ini приложения ПК Мастер-Тур).

<!--Имя хоста-->
<add key="hostName" value=""/>
4 Логирование Путь к лог-файлам задается в секции 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>
5 Имя текущей установленной службы (отображается в таблице MasterTourServiceHosts) После установки службы MasterTourService также добавляется информация в таблицу MasterTourServiceHosts. В поле MTS_Name записывается значение настройки acceptableServices. Данная настройка отображает наименования сервисов, к которым можно будет обращаться:
  • из ПК «Мастер-Тур», указав их в конфигурационном файле master32.exe.config
  • из ПК «Мастер-Web», указав их в конфигурационном файле web.config
  • из Программы туров, указав их в конфигурационном файле web.config.
  • из любого сервиса интеграции с платежными системами, указав их в конфигурационном файле web.config.

По умолчанию настройка не заполнена.
Внимание!
Значение настройки должно быть явно задано.

<add key="acceptableServices" value=""/>
6 Приоритет текущего установленного сервиса Приоритет текущей установленной службы MasterTourService. Целое положительное число. Чем число выше, тем приоритет больше.
<add key="servicePriority" value="1"/>
  • Установка осуществляется запуском скрипта _Install.bat от имени администратора. Запуск от имени администратора
  • При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта MasterTourService. Правила для входящих подключений MasterTourService
  • В Службах Windows добавляется служба MegatecMasterTourService.

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.

SpecialsCacheService

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

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

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

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

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

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

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

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

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

Название Описание Настройка
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 Путь к службе поиска Необходимо указать путь, по которому была настроена служба поиска. Если был изменен порт по умолчанию – его также необходимо сменить в настройке. Вместо localhost необходимо указать внешний ip-адрес или внешнее субдоменное имя.
<add key="SearchApiServiceUrl" value="http://localhost:9000/TourSearchOwin/" />
4 Путь к службе кеша для акций Необходимо указать путь, по которому была настроена служба кеша для акций. Если был изменен порт по умолчанию – его также необходимо сменить в настройке. Вместо localhost необходимо указать внешний ip-адрес или внешнее субдоменное имя (если планируется использование акций извне), либо указать внутренний ip-адрес или внутреннее субдоменное имя (если планируется использование акций внутри локальной сети).
<add key="CacheServiceUrl" value="http://localhost:52529/SpecialsCache/"/>
5 Имя текущей установленной службы Наименование службы, к которой может обращаться текущий клиент (по значению настройки acceptableServices в MasterTourService). По умолчанию настройка не заполнена. Значение настройки должно быть явно задано.
<add key="acceptableServices" value=""/>

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

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

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

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

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

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

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

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

Название Описание Настройка
1 Ссылка на страницу забронированных путевок Путь к приложению ПК «Мастер-Web»
<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 Путь к службе поиска Необходимо указать путь, по которому была настроена служба поиска. Если был изменен порт по умолчанию – его также необходимо сменить в настройке. Вместо localhost необходимо указать внешний ip-адрес или внешнее субдоменное имя.
<add key="SearchApiServiceUrl" value="http://localhost:9000/TourSearchOwin/" />
3 Настройка языка Язык поиска по умолчанию. Код языка указывается исходя из файла с локализацией в \TourSearchClient\Content\localization
<add key="defaultLanguageCode" value="ru"/>
4 Время кеширования файлов локализации Указывается время в минутах, через которое должен очищаться кеш файлов локализации. Изменения, внесенные в файлы \TourSearchClient\Content\localization применяться через указанное время.
<add key="languageDictionaryCacheExpiration" value="5"/>
5 Логирование Путь к лог-файлам задается в секции Loggers path.
<Loggers path="Logs\">
 <Logger level="ALL" name="TourSearch" console="true" /> Логирование информации о поиске (доп. инфо 36421)
 <Logger level="ALL" name="TourSearchCache" console="true" /> Логирование информации об инициализации кеша (доп. инфо 36421)
 <Logger level="ALL" name="ExceptionLogger" console="true"/> Логирование ошибок возникающих в приложении
</Loggers>
6 Системные настройки Настройки внутреннего пользования. Не изменяемые
<add key="webpages:Version" value="3.0.0.0"/>
<add key="webpages:Enabled" value="false"/>
<add key="ClientValidationEnabled" value="true"/>
<add key="UnobtrusiveJavaScriptEnabled" value="true"/>

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

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

Название Описание Настройка
1 Строка подключения Строка подключения к базе данных ПК «Мастер-Тур» указывается в секции appSettings.

Внимание!
Для корректной работы в настройке User Id необходимо указать пользователя, созданного в ПК «Мастер-Тур». Использование имени входа sa или других системных имен входа MS SQL сервера невозможно.
Внимание!
Пароль пользователей системы, от которых работают службы и приложения, не должен содержать ни одного из следующих символов: < > " ' &

<add key="connectionString" value="Data Source=Server;Initial Catalog=Database;User Id=User;Password=Password;Application Name=MasterWeb" />
<add key="connectionStringShort" value="Data Source=Server; Initial Catalog=Database"/>
2 Путь к службе поиска Необходимо указать путь, по которому была настроена служба поиска. Если был изменен порт по умолчанию – его также необходимо сменить в настройке. Вместо localhost необходимо указать внешний ip-адрес или внешнее субдоменное имя.
<add key="SearchApiServiceUrl" value="http://localhost:9000/TourSearchOwin/" />
3 Имя текущей установленной службы Наименование службы, к которой может обращаться текущий клиент (по значению настройки acceptableServices в MasterTourService). По умолчанию настройка не заполнена. Значение настройки должно быть явно задано.
<add key="acceptableServices" value=""/>
4 Оплата от клиента

Используется в экране Информация о заказе (OrderInfo.aspx)

Настройка, позволяющая в экране OrderInfo.aspx вносить процент комиссии, оплаченный клиентом. По умолчанию настройка отсутствует.
  • true – появляется поле Оплата от клиента с возможностью вносить данные по оплате
  • false или отсутствие настройки – поле Оплата от клиента отсутствует
<add key="PaymentAmount" value="true"/>

Настройка отправки e-mail сообщений в системе бронирования

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

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

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

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

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

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


Если было изменено количество логических ядер процессора, версия SQL-сервера 
или название экземпляра SQL-сервера, то файл лицензии необходимо запросить заново.

Настройка логирования

Возможные ошибки и варианты их решения


TourSearchClient: Сервис поиска недоступен. Проверьте настройки.

Проверьте, заполнены ли настройки serviceAddress и SearchApiServiceUrl в конфигурационных файлах.
Если настройки заполнены, но все равно ошибка сохраняется, попробуйте сделать следующее:

  • Служба TourSearchOwin работает по порту 9000. Для нее требуется доступность из интернета. Необходимо сделать проброс портов на роутере до локального в сети компьютера.
  • В конфигурационном файле службы прописать название доменной машины, к примеру test.youdomainame.ru.
  • Данное имя должно быть доступно в интернете и иметь белый статический адрес, внутри сети данное имя должно иметь ip того компьютера, где установлена служба, к примеру 192.168.0.10.
  • На сервере, где будет использоваться данная служба нужно в свойствах обозревателя выключить использовать прокси-сервер.


TourSearchClient: Ошибка. Срок действия лицензии истек.

Проверьте, правильно ли указан срок действия в лицензии.
Проверьте, запускается ли Мастер-Тур. Если Мастер-Тур запускается и не выдает сообщения о сроке действия лицензии, то выполните скрипт ниже по базе денных, перезапустите службу поиска и заново запустите приложение.

use master grant view server state to public