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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Установка языка у имен входа)
(Установка и удаление серверной части ПК «Мастер-Тур»)
Строка 66: Строка 66:
 
* Тестирование '''TourSearchClient''': правильность настройки сети и работу службы можно проверить открытием ссылки ''http://online.yourdomainname.ru/TourSearchClient''.
 
* Тестирование '''TourSearchClient''': правильность настройки сети и работу службы можно проверить открытием ссылки ''http://online.yourdomainname.ru/TourSearchClient''.
  
===Установка и удаление серверной части ПК «Мастер-Тур»===
+
===Установка серверной части ПК «Мастер-Тур»===
 
 
====Установка серверной части ПК «Мастер-Тур»====
 
  
 
На данный момент актуальным приложением для установки серверной части является '''Microsoft SQL Server 2017''' ([https://docs.microsoft.com/ru-ru/sql/database-engine/install-windows/install-sql-server-from-the-installation-wizard-setup?view=sql-server-2017&viewFallbackFrom=sql-server-previousversions гайд по установке]). При его использовании необходимо проставить у базы данных уровень совместимости 140, иначе будут возникать ошибки, связанные с производительностью системы. Серверная часть ПК «Мастер-Тур» совместима и с более ранними версиями Microsoft SQL Server, начиная с '''SQL Server 2008 R2 SP1''' и выше.
 
На данный момент актуальным приложением для установки серверной части является '''Microsoft SQL Server 2017''' ([https://docs.microsoft.com/ru-ru/sql/database-engine/install-windows/install-sql-server-from-the-installation-wizard-setup?view=sql-server-2017&viewFallbackFrom=sql-server-previousversions гайд по установке]). При его использовании необходимо проставить у базы данных уровень совместимости 140, иначе будут возникать ошибки, связанные с производительностью системы. Серверная часть ПК «Мастер-Тур» совместима и с более ранними версиями Microsoft SQL Server, начиная с '''SQL Server 2008 R2 SP1''' и выше.
 
Процесс установки серверной части ПК «Мастер-тур» аналогичен процессу установки клиентской части ПК «Мастер-Тур». Обычная установка подразумевает установку на экземпляр «по умолчанию» '''Microsoft SQL Server''', имеющий смешанный режим аутентификации и пароль для логина '''sa''' - '''123456789'''. Выберите тип '''Обычная установка''' в том случае, если экземпляр «по умолчанию» '''Microsoft SQL Server''' был установлен в процессе инсталляции обязательных компонентов - в этом случае экземпляр имеет все необходимые для данного режима настройки. В том случае, если экземпляр «по умолчанию» '''Microsoft SQL Server''' был установлен Вами самостоятельно для успешной установки в данном режиме необходимо установить  смешанный режим аутентификации и пароль для логина '''sa''' - '''123456789'''.
 
 
В процессе инсталляции будет создан  каталог <code>C:\Program Files\Master-Tour_DB</code> и в него скопированы файлы базы данных. На экземпляре «по умолчанию» '''SQL Server''' будет установлена и сконфигурирована база данных '''avalon''' - для входа в данную базу данных будет создан логин '''MEGA''' с паролем '''123456789'''. Данный пароль Вы сможете изменить в процессе использования программы.
 
  
 
====Присоединение базы данных вручную====
 
====Присоединение базы данных вручную====
Строка 101: Строка 95:
 
  в конфигурационных файлах соответствующих приложений и используются для обращений
 
  в конфигурационных файлах соответствующих приложений и используются для обращений
 
  к базе данных ПК «Мастер-Тур».</span>
 
  к базе данных ПК «Мастер-Тур».</span>
 
====Удаление серверной части ПК «Мастер-Тур»====
 
Для удаления серверной части ПК «Мастер-Тур» просто удалите соответствующую базу данных  c сервера баз данных (базу данных с названием ''avalon'' - в случае если в процессе инсталляции имя базы данных не было изменено) используя стандартные средства '''MS SQL Server'''.
 
  
 
===Обновление базы данных ПК «Мастер-Тур»===
 
===Обновление базы данных ПК «Мастер-Тур»===

Версия 15:41, 17 июля 2019

Версия статьи от 17-07-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 на два разных компьютера локальной сети.


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

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

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

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

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


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

Установка языка у имен входа

Во избежание возникновения ошибок необходимо убедиться, что у имен входа (пользователей) Microsoft SQL Server, используемых для работы в ПК «Мастер-Тур», в качестве языка по умолчанию установлен английский язык. Для осуществления проверки нужно запустить SQL Server Management Studio, подключиться к используемому экземпляру SQL Server и зайти в свойства имени входа (пользователя). В поле «Default language» в качестве языка по умолчанию должен быть выбран «English».
Secutity → Logins → User → Properties

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


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

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

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


Ниже описан порядок обновления базы данных ПК «Мастер-Тур» уже не при установке эталонной базы, а при переходе на 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" />
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