Установка Mid Office Manager — различия между версиями
(→Настройка подключения сервера {{an}} к СУБД PostgreSQL) |
|||
(не показаны 43 промежуточные версии 2 участников) | |||
Строка 9: | Строка 9: | ||
Подробнее эти этапы описаны ниже. | Подробнее эти этапы описаны ниже. | ||
− | Для | + | Для полноценного начала работы программы после установки необходимо произвести [[Конфигурирование Mid Office Manager|конфигурирование Mid Office Manager]]. |
=== Установка и конфигурирование СУБД PostgreSQL === | === Установка и конфигурирование СУБД PostgreSQL === | ||
Строка 27: | Строка 27: | ||
#:Вы вправе выбрать другой язык, но так будет удобнее администрировать базу данных. | #:Вы вправе выбрать другой язык, но так будет удобнее администрировать базу данных. | ||
#На последней странице мастера установки снимите флажок запуска Stack Builder и завершите работу мастера установки. | #На последней странице мастера установки снимите флажок запуска Stack Builder и завершите работу мастера установки. | ||
+ | |||
+ | ==== Дополнительное конфигурирование СУБД PostgreSQL ==== | ||
+ | Для надежной и устойчивой работы PostgreSQL нужно сконфигурировать ряд параметров этой СУБД. | ||
+ | |||
+ | # На машине, где вы установили СУБД PostgreSQL перейдите в установочную папку PostgreSQL, например <tt>c:\Program Files\PostgreSQL\9.3\</tt>, и откройте подпапку '''data'''. | ||
+ | # В подпапке '''data''' откройте на редактирование файл '''postgresql.conf''' и найдите и измените в нем следующие параметры: | ||
+ | #* '''shared_buffers''' — присвойте этому параметру значение, равное примерно четверти доступной на машине физической памяти. Например, если на машине установлено 8 ГБ памяти, то этому параметру нужно присвоить значение <tt>2ГБ</tt>. | ||
+ | #*: Этот параметр задает общий объем памяти, совместно используемой всеми подключениями и процессами PostgreSQL. | ||
+ | #* '''work_mem''' — присвойте этому параметру значение 10 МБ | ||
+ | #*: Этот параметр задает объем памяти, выделяемый на каждый запрос {{an}}. | ||
+ | #* '''effective_cache_size''' — присвойте этому параметру значение, равное примерно половине доступной на машине физической памяти. Например, если на машине установлено 8 ГБ памяти, то этому параметру нужно присвоить значение <tt>4ГБ</tt>. | ||
+ | #*: Этот параметр сообщает PostgreSQL примерный объем файлового кеша операционной системы — эта оценка нужна оптимизатору для построения плана запросов. | ||
==== Создание базы данных и роли входа ==== | ==== Создание базы данных и роли входа ==== | ||
− | |||
Эти операции выполняются в консоли pgAdmin III, которую можно открыть, последовательно выбрав в меню Пуск следующие команды: '''Все программы\PostgreSQL\pgAdmin III'''. | Эти операции выполняются в консоли pgAdmin III, которую можно открыть, последовательно выбрав в меню Пуск следующие команды: '''Все программы\PostgreSQL\pgAdmin III'''. | ||
Строка 41: | Строка 52: | ||
===== Создание роли входа ===== | ===== Создание роли входа ===== | ||
− | #Откройте консоль '''pgAdmin III'''. | + | # Откройте консоль '''pgAdmin III'''. |
− | #В панели '''Браузер объектов''' щелкните правой кнопкой узел '''Роли входа''' и выберите '''Новая роль'''. | + | # В панели '''Браузер объектов''' щелкните правой кнопкой узел '''Роли входа''' и выберите '''Новая роль'''. |
− | #В окне '''Новая роль''' на вкладке '''Свойства''' в поле '''Имя роли''' задайте имя роли — <tt>xtrip_user</tt>. | + | # В окне '''Новая роль''' на вкладке '''Свойства''' в поле '''Имя роли''' задайте имя роли — <tt>xtrip_user</tt>. |
− | #На вкладке '''Определение''' дважды введите пароль: <tt>xtrip_pswdGN01</tt>. Остальные поля на этой вкладке оставьте пустыми. | + | # На вкладке '''Определение''' дважды введите пароль: <tt>xtrip_pswdGN01</tt>. Остальные поля на этой вкладке оставьте пустыми. |
− | #Перейдите на вкладку '''Привилегии''' и задайте привилегии, как показано на снимке экрана: | + | # Перейдите на вкладку '''Привилегии''' и задайте привилегии, как показано на снимке экрана: |
− | + | #:[[Image:PgAdmin_III_new_role_privileges.jpg]] | |
− | + | # Щелчком '''ОК''' закройте окно. | |
− | [[Image:PgAdmin_III_new_role_privileges.jpg]] | + | |
===== Создание базы данных ===== | ===== Создание базы данных ===== | ||
Строка 74: | Строка 84: | ||
В имени файла используются следующие обозначения: ГГГГ — год, ММ — месяц, ДД — день, ЧЧ — час, мм — минуты сборки версии, например имя файла <tt>xtrip-client-jre-win-3.0.201404031608.zip</tt> означает, что это дистрибутив клиента со встроенной средой JRE, собранный 3 апреля 2014 года в 16:08. | В имени файла используются следующие обозначения: ГГГГ — год, ММ — месяц, ДД — день, ЧЧ — час, мм — минуты сборки версии, например имя файла <tt>xtrip-client-jre-win-3.0.201404031608.zip</tt> означает, что это дистрибутив клиента со встроенной средой JRE, собранный 3 апреля 2014 года в 16:08. | ||
− | Выберите и загрузите файл дистрибутива клиента {{an}} и файл дистрибутива сервера {{an}}. | + | Выберите и загрузите файл дистрибутива клиента {{an}} и файл дистрибутива сервера {{an}}. Для установки {{an}} в Windows рекомендуется выбирать варианты дистрибутива со средой JRE. Для установки {{an}} в Linux рекомендуется выбирать варианты дистрибутива без среды JRE. |
=== Установка сервера {{an}} в Windows === | === Установка сервера {{an}} в Windows === | ||
Строка 80: | Строка 90: | ||
Сервер {{an}} устанавливается в следующей последовательности: | Сервер {{an}} устанавливается в следующей последовательности: | ||
− | #Создайте корневую папку для размещения сервера, например, <tt>C:\ | + | #Создайте корневую папку для размещения сервера, например, <tt>C:\mom\</tt>. |
+ | #: Рекомендуется не использовать в именах папок пробелов, потому что это может нарушать работу скриптов. | ||
#В созданной корневой папке создайте подпапку <tt>'''server'''</tt>. | #В созданной корневой папке создайте подпапку <tt>'''server'''</tt>. | ||
#Распакуйте архив сервера {{an}} в папку <tt> '''server''' </tt>. | #Распакуйте архив сервера {{an}} в папку <tt> '''server''' </tt>. | ||
− | #Сконфигурируйте сервер {{an}} (см. раздел | + | #Сконфигурируйте сервер {{an}} (см. раздел [[#Настройка подключения сервера Mid Office Manager к СУБД PostgreSQL|Настройка подключения сервера Mid Office Manager к СУБД PostgreSQL ]]). |
#Запустите на выполнение файл <tt>'''run-cleanup.bat'''</tt> из подпапки <tt>'''…\bin\xtrip\server'''</tt>, чтобы выполнить начальную инициализацию среды данных. | #Запустите на выполнение файл <tt>'''run-cleanup.bat'''</tt> из подпапки <tt>'''…\bin\xtrip\server'''</tt>, чтобы выполнить начальную инициализацию среды данных. | ||
#Запустите на выполнение файл <tt>'''run.bat'''</tt> в подпапке '''…\bin\server'''. | #Запустите на выполнение файл <tt>'''run.bat'''</tt> в подпапке '''…\bin\server'''. | ||
− | #: Признаком успешного запуска сервера {{an}} служит командное окно с информацией о работающем сервере приложения, | + | #: Признаком успешного запуска сервера {{an}} служит командное окно с информацией о работающем сервере приложения, как показано на снимке экрана. |
− | + | [[Файл:Running server.png]] | |
Чтобы корректно завершить работу сервера, надо в командном окне работающего сервера {{an}} последовательно нажать клавиши «q» и Enter. | Чтобы корректно завершить работу сервера, надо в командном окне работающего сервера {{an}} последовательно нажать клавиши «q» и Enter. | ||
+ | {{warn|Если вы планируете использовать функциональность синхронизации с Sabre Profiles, перезапустите сервер {{an}} дважды, каждый раз корректно завершая его работу последовательным нажатием клавиш «q» и Enter.}} | ||
{{info| | {{info| | ||
− | При выполнении | + | При выполнении run-cleanup.bat могут возникать ошибки, требующие диагностики и устранения. Но может оказаться, что сообщения об ошибках отображаются в окне командной строки некорректно или вообще нечитабельны. Далее описывается, как решать проблему нечитабельных сообщений. |
Чтобы обеспечить правильное отображение сообщений {{an}} на русском языке в окне командной строки Windows, выполните следующее: | Чтобы обеспечить правильное отображение сообщений {{an}} на русском языке в окне командной строки Windows, выполните следующее: | ||
Строка 114: | Строка 126: | ||
Установка сервера {{an}} в Linux выполняется в том же порядке, что и в Windows (см. выше), но для запуска и остановки сервера {{an}} нужно использовать файлы сценариев startup.sh и shutdown.sh. Названия других файлов также совпадают, но отличаются расширением <tt>'''.sh'''</tt>. | Установка сервера {{an}} в Linux выполняется в том же порядке, что и в Windows (см. выше), но для запуска и остановки сервера {{an}} нужно использовать файлы сценариев startup.sh и shutdown.sh. Названия других файлов также совпадают, но отличаются расширением <tt>'''.sh'''</tt>. | ||
− | === | + | === Настройка подключения сервера {{an}} к СУБД PostgreSQL === |
− | Сервер {{an}} использует СУБД PostgreSQL для хранения своих данных, поэтому нужно настроить | + | Сервер {{an}} использует СУБД PostgreSQL для хранения своих данных, поэтому нужно настроить подключение {{an}} к этой СУБД в следующей последовательности: |
− | # В подпапке <tt>..\server\config\xtrip\server</tt> папки сервера {{an}} откройте файл boot.properties | + | # В подпапке <tt>..\server\config\xtrip\server</tt> папки сервера {{an}} откройте файл '''boot.properties''' для редактирования. |
# Найдите строку, которая начинается текстом: <tt>com.gridnine.xtrip.server.db.url=jdbc:postgresql://</tt>, | # Найдите строку, которая начинается текстом: <tt>com.gridnine.xtrip.server.db.url=jdbc:postgresql://</tt>, | ||
#: например com.gridnine.xtrip.server.db.url=jdbc:postgresql://localhost:5432/xtrip-3-ru_prod?loginTimeout=10 | #: например com.gridnine.xtrip.server.db.url=jdbc:postgresql://localhost:5432/xtrip-3-ru_prod?loginTimeout=10 | ||
Строка 124: | Строка 136: | ||
# При необходимости замените значение после двоеточия на текущий порт СУБД. | # При необходимости замените значение после двоеточия на текущий порт СУБД. | ||
#: Обычно порт менять не надо, потому что используется порт по умолчанию 5432. | #: Обычно порт менять не надо, потому что используется порт по умолчанию 5432. | ||
+ | # Сохраните и закройте файл '''boot.properties'''. | ||
{{info|Если имя вашего сервера — myserv, а порт — 1000, тогда строка должна выглядеть так: | {{info|Если имя вашего сервера — myserv, а порт — 1000, тогда строка должна выглядеть так: | ||
− | < | + | <pre style="white-space: pre-wrap;">com.gridnine.xtrip.server.db.url=jdbc:postgresql://myserv:1000/xtrip-3-ru_prod?loginTimeout=10</pre>}} |
− | {{info|При первоначальной установке Mid Office Manager используется сервер БД, размещённый на этом же компьютере, то есть | + | {{info|При первоначальной установке Mid Office Manager используется сервер БД, размещённый на этом же компьютере, то есть в качестве имени сервера используется <tt>'''localhost'''</tt>.}} |
Далее необходимо выполнить первичную инициализацию среды данных. | Далее необходимо выполнить первичную инициализацию среды данных. | ||
{{info|Если не удается запустить сервер {{an}}, то одной из причин может быть нехватка оперативной памяти, выделяемой виртуальной машине Java. Чтобы исправить ситуацию, нужно открыть файл сервера <tt>'''run.bat'''</tt> на редактирование и найти в нем следующую строку: | {{info|Если не удается запустить сервер {{an}}, то одной из причин может быть нехватка оперативной памяти, выделяемой виртуальной машине Java. Чтобы исправить ситуацию, нужно открыть файл сервера <tt>'''run.bat'''</tt> на редактирование и найти в нем следующую строку: | ||
+ | <pre style="white-space: pre-wrap;">%JAVACMD% -server -Xms256m -Xmx512m -Djpf.boot.config=config/xtrip/server/boot.properties -jar lib\jpf-boot.jar</pre> | ||
+ | В этой строке необходимо изменить значение параметра <tt>–Xmx</tt>, определяющего верхнюю границу выделяемой оперативной памяти. Значение этого параметра задается в мегабайтах (m) и по умолчанию равно 512m, что соответствует 512 МБ. Нужно увеличить значение этого параметра, например значение -Xmx1024m обеспечивает увеличение выделяемой памяти до 1024 МБ.}} | ||
− | + | === Конфигурирование сервера {{an}} === | |
+ | Этот раздел посвящен настройке некоторых особых параметров сервера {{an}}, в том числе об определении идентификатора экземпляра {{an}} для целей лицензирования, о настройке подключения через прокси и подключения через порт, отличный от принятого по умолчанию, а также о конфигурировании обновления, резервного копирования и очистки и оптимизации базы данных. Также здесь рассказывается о конфигурировании служебных командных файлов {{an}}. | ||
− | В этой строке | + | ==== Определение идентификатора экземпляра {{an}} ==== |
+ | После установки {{an}} надо присвоить ему уникальный идентификатор, который нужен для предоставления лицензии вашему агентству. Этот идентификатор нужно сообщить компании Sabre, чтобы вашему экземпляру была предоставлена лицензия в соответствии с условиями договора. Лицензию экземплярам {{an}} автоматически предоставляет центральный сервер Sabre, основываясь на идентификаторах экземпляров {{an}}. | ||
+ | |||
+ | '''Чтобы задать идентификатор экземпляра {{an}}:''' | ||
+ | # В подпапке <tt>..\server\config\xtrip\server</tt> папки сервера {{an}} откройте файл '''boot.properties''' на редактирование. | ||
+ | # Найдите следующую строку: | ||
+ | #: <pre>com.gridnine.xtrip.server.appId = xtrip-node1 </pre> | ||
+ | # Внесите в строку идентификатор своего агентства, например (изменения выделены полужирным): | ||
+ | #: <pre>com.gridnine.xtrip.server.appId = '''myagency'''</pre> | ||
+ | # Сохраните и закройте файл '''boot.properties'''. | ||
+ | # Перезагрузите сервер {{an}}. | ||
+ | |||
+ | ==== Настройка подключения через прокси-сервер ==== | ||
+ | Если в агентстве доступ в Интернет осуществляется через прокси-сервер, его адрес нужно определить в конфигурации сервера {{an}}. Это нужно в первую очередь для обеспечения возможности обновления {{an}}. | ||
+ | |||
+ | '''Чтобы настроить подключение через прокси-сервер:''' | ||
+ | # В подпапке <tt>..\server\config\xtrip\server</tt> папки сервера {{an}} откройте файл '''boot.properties''' на редактирование. | ||
+ | # Найдите следующий блок параметров: | ||
+ | #: <tt># Update configuration | ||
+ | #: com.gridnine.xtrip.server.update.url=http://download.gridnine.com/xtrip/xtrip3/production/update/ | ||
+ | #: #com.gridnine.xtrip.server.update.proxy.host = 10.0.0.228 | ||
+ | #: #com.gridnine.xtrip.server.update.proxy.port = 3129 | ||
+ | #: #com.gridnine.xtrip.server.update.proxy.username = user | ||
+ | #: #com.gridnine.xtrip.server.update.proxy.password = 123 </tt> | ||
+ | # Удалите знак «решетка» (#) в относящихся к прокси-серверу строках и задайте параметры локального прокси-сервера: | ||
+ | #* '''<tt>com.gridnine.xtrip.server.update.proxy.host</tt>''' — в этой строке задайте ''IP-адрес'' своего прокси-сервера, например: | ||
+ | #*: <tt>com.gridnine.xtrip.server.update.proxy.host = 198.162.0.25</tt>; | ||
+ | #* '''<tt>com.gridnine.xtrip.server.update.proxy.port</tt>''' — в этой строке задайте ''порт'' своего прокси-сервера, например: | ||
+ | #*:<tt>com.gridnine.xtrip.server.update.proxy.port = 1234</tt>; | ||
+ | #* '''<tt>com.gridnine.xtrip.server.update.proxy.username</tt>''' — в этой строке задайте ''имя пользователя'' для подключения к прокси-серверу, например: | ||
+ | #*:<tt>com.gridnine.xtrip.server.update.proxy.username = jsmith</tt>; | ||
+ | #* '''<tt>com.gridnine.xtrip.server.update.proxy.password</tt>''' — в этой строке задайте ''пароль пользователя'' для подключения к прокси-серверу, например: | ||
+ | #*:<tt>com.gridnine.xtrip.server.update.proxy.password = p@ssw0rd</tt>; | ||
+ | # Сохраните и закройте файл '''boot.properties'''. | ||
+ | # Перезагрузите сервер {{an}}. | ||
+ | |||
+ | ==== Изменение порта для подключения к серверу {{an}} ==== | ||
+ | По умолчанию подключение к серверу {{an}} осуществляется через порт 8080 и изменять эту настройку не требуется. Но в некоторых ситуациях, например если этот порт используется для других целей или когда нужно поддерживать несколько экземпляров сервера на одной машине, можно изменить этот порт. Далее описывается, как это сделать. | ||
+ | |||
+ | '''Чтобы изменить порт подключения к серверу по умолчанию:''' | ||
+ | # В подпапке <tt>..\server\config\xtrip\server</tt> папки сервера {{an}} откройте файл '''boot.properties''' в режиме редактирования. | ||
+ | # Найдите следующую строку: | ||
+ | #: <tt>#com.gridnine.xtrip.server.tomcat.standard.port = 8080</tt> | ||
+ | # Замените строку на следующие две строки: | ||
+ | #: <tt>com.gridnine.xtrip.server.tomcat.standard.port = 9090 | ||
+ | #: com.gridnine.xtrip.server.tomcat.standard.default = true</tt> | ||
+ | # При необходимости замените значение после двоеточия на текущий порт СУБД. | ||
+ | # Сохраните и закройте файл '''boot.properties'''. | ||
+ | # Перезагрузите сервер {{an}}. | ||
+ | |||
+ | ==== Определение конфигурации резервного копирования ==== | ||
+ | Для обеспечения надежной работы и возможности восстановить потерпевший сбой экземпляр {{an}} нужно регулярно выполнять резервное копирование {{an}}. В общем случае резервные копии рекомендуется размещать на диске отличном от диска, на котором установлен {{an}}. | ||
+ | |||
+ | Для резервного копирования в {{an}}служит командный файл pgdb_backup_script.bat. Далее рассказывается о параметрах, которые надо сконфигурировать, чтобы обеспечить работоспособность резервного копирования в {{an}}. | ||
+ | |||
+ | # В подпапке <tt>..\bin\xtrip\server\</tt> папки сервера {{an}} откройте файл '''pgdb_backup_script.bat''' в режиме редактирования. | ||
+ | # Найдите следующую строку: | ||
+ | #: <tt>set BACKUP_FILE=C:\xtrip_backups\xtripdb_%datestr%.backup</tt> | ||
+ | #: и укажите в ней путь к папке, где будут размещаться резервные копии, например (изменения выделены полужирным): | ||
+ | #: <tt>set BACKUP_FILE='''D:\MOM_backup'''\xtripdb_%datestr%.backup</tt> | ||
+ | # В строке: | ||
+ | #: <tt>set POSTGRESBINDIR=C:\Program Files (x86)\PostgreSQL\8.3\bin</tt> | ||
+ | #: укажите путь к папке с исполняемыми файлами PostgreSQL на машине сервера, например (изменения выделены полужирным): | ||
+ | #: <tt>set POSTGRESBINDIR='''C:\Program Files\PostgreSQL\9.1\bin'''</tt> | ||
+ | # Если база данных и сервер {{an}} находятся на разных дисках, нужно предусмотреть переключение контекста между дисками, для чего надо внести в файл следующие изменения (выделены полужирным) (здесь предполагается, что {{an}} расположен на диске D:, а резервные копии создаются на диске C:): | ||
+ | #: <tt>set DB_USER=xtrip_user | ||
+ | #: '''C:''' | ||
+ | #: cd %POSTGRESBINDIR% | ||
+ | #: pg_dump -i -h localhost -p 5432 -U %DB_USER% -b -f %BACKUP_FILE% %DB_NAME% | ||
+ | #: ::pg_dump -Fc -h localhost -p 5432 -U %DB_USER% %DB_NAME% > %BACKUP_FILE% | ||
+ | #: '''D:''' | ||
+ | #: cd %OLDDIR% </tt> | ||
+ | # Сохраните и закройте файл '''pgdb_backup_script.bat'''. | ||
+ | |||
+ | ==== Настройка удаления устаревших резервных копий ==== | ||
+ | Резервные копии занимают значительное место на диске, поэтому рекомендуется регулярно удалять старые резервные копии, чтобы они не заняли все свободное дисковое пространство. В {{an}} для этого предусмотрен командный файл pgdb_cleanup_script.bat. В нем нужно указать, где хранятся резервные копии вашего экземпляра {{an}}. По умолчанию этот командный файл предусматривает удаление всех имеющихся резервных копий кроме последних четырех. Это количество также можно изменить. Далее рассказывается, как определить место хранения устаревших резервных копий и количество сохраняемых копий. | ||
+ | |||
+ | # В подпапке <tt>..\bin\xtrip\server\</tt> папки сервера {{an}} откройте файл '''pgdb_cleanup_script.bat''' в режиме редактирования. | ||
+ | # Найдите следующую строку: | ||
+ | #: <tt>cd c:\xtrip_backups</tt> | ||
+ | #: и укажите в ней путь к папке, где хранятся резервные копии, например (изменения выделены полужирным): | ||
+ | #: <tt>cd c:\'''my_backup_dir'''</tt> | ||
+ | # Если нужно изменить количество сохраняемых резервных копий, найдите следующую строку: | ||
+ | #: <tt>for /f "skip=4 tokens=* delims= " %%a in ('dir/b/o-n xtripdb_*.backup.7z') do del %%a</tt> | ||
+ | #: и замените цифру '''4''' на нужное количество резервных копий, которые должны оставаться в папке (изменения выделены полужирным): | ||
+ | #: <tt>for /f "skip='''10''' tokens=* delims= " %%a in ('dir/b/o-n xtripdb_*.backup.7z') do del %%a</tt> | ||
+ | # Сохраните и закройте файл '''pgdb_cleanup_script.bat'''. | ||
+ | |||
+ | ==== Определение конфигурации очистки и оптимизации базы данных {{an}} ==== | ||
+ | В процессе работы базы данных {{an}} она может фрагментироваться или в ней могут оставаться фантомные записи, а также накапливаться другие ошибки. Все это снижает производительность базы данных, поэтому в {{an}} предусмотрен командный файл очистки и оптимизации базы данных — он называется pgdb_vacuum_script.bat. Выполнять очистку и оптимизацию базы данных рекомендуется не чаще раза в месяц, а также после импорта в базу данных большого объема информации. Далее рассказывается, как нужно настроить командный файл очистки. | ||
+ | |||
+ | # В подпапке <tt>..\bin\xtrip\server\</tt> папки сервера {{an}} откройте файл '''pgdb_vacuum_script.bat''' в режиме редактирования. | ||
+ | # Найдите строку: | ||
+ | #: <tt>SET POSTGRESBINDIR=C:\Program Files (x86)\PostgreSQL\8.3\bin</tt> | ||
+ | #: и укажите в ней путь к папке с исполняемыми файлами PostgreSQL на машине сервера, например (изменения выделены полужирным): | ||
+ | #: <tt>set POSTGRESBINDIR='''C:\Program Files\PostgreSQL\9.1\bin'''</tt> | ||
+ | # Сохраните и закройте файл '''pgdb_vacuum_script.bat'''. | ||
=== Запуск сервера {{an}} в режиме службы Windows === | === Запуск сервера {{an}} в режиме службы Windows === | ||
− | Сервер приложения {{an}} можно запустить в режиме службы Windows. Для этого нужно запустить на выполнение файл | + | Сервер приложения {{an}} можно запустить в режиме службы Windows. Для этого нужно запустить на выполнение файл <tt>install.bat</tt> из подпапки <tt>..\server\bin\xtrip\server</tt> папки сервера {{an}}. После этого сервер {{an}} появится в системной консоли «Службы» под именем '''Trip Server'''. |
{{warn|В Windows Server 2008 работа {{an}} в режиме службы Windows не поддерживается.}} | {{warn|В Windows Server 2008 работа {{an}} в режиме службы Windows не поддерживается.}} | ||
=== Установка клиента === | === Установка клиента === | ||
− | + | {{info|Очень желательно, чтобы клиент и сервер {{an}} находились в одном часовом поясе, то есть время сервера и клиента должны совпадать, иначе {{an}} может работать некорректно.}} | |
Клиент устанавливается в следующей последовательности: | Клиент устанавливается в следующей последовательности: | ||
Строка 158: | Строка 270: | ||
− | [[Image:Mid Office Manager login.jpg|600px|center|Окно входа в {{an}}]] | + | [[Image:Mid Office Manager login.jpg|600px|thumb|center|Окно входа в {{an}}]] |
Строка 176: | Строка 288: | ||
=== Ссылки по теме === | === Ссылки по теме === | ||
− | [[ | + | *[[Конфигурирование Mid Office Manager]] |
− | + | ||
− | + | ||
− | [[ | + | *[[Профили]] |
− | [[ | + | *[[Договоры]] |
− | [[ | + | *[[Права доступа]] |
− | + |
Текущая версия на 12:41, 4 апреля 2018
Установка Mid Office Manager выполняется в следующем порядке:
- Установка и конфигурирование СУБД PostgreSQL.
- Создание базы данных и учетной записи пользователя для доступа к ней.
- Установка сервера Mid Office Manager.
- Установка клиентов Mid Office Manager.
Подробнее эти этапы описаны ниже.
Для полноценного начала работы программы после установки необходимо произвести конфигурирование Mid Office Manager.
[править] Установка и конфигурирование СУБД PostgreSQL
Перед установкой PostgreSQL рекомендуется ознакомиться с системными требованиями и инструкциями производителя этой СУБД, доступными на официальном сайте этого продукта, и следовать этим инструкциям при установке PostgreSQL. Если СУБД PostgreSQL уже установлена в вашей среде, пропустите это раздел и приступайте к следующему.
Выполните установку PostgreSQL в следующей последовательности:
- Загрузите дистрибутив СУБД PostgreSQL с официального сайта производителя по адресу http://postgresql.org.
- На сайте производителя также доступна информация о системных требованиях и особенностях установки PostgreSQL.
- Запустите установщик и следуйте инструкциям на экране. В мастере установки выполните следующие операции:
- Задайте пароль по умолчанию: xtrip_pswdGN01.
- Это пароль служебной учетной записи postgres, в контексте которой будет работать сервер СУБД. Вы вправе задать другой пароль, но делать этого не рекомендуется.
- В качестве порта СУБД PostgreSQL оставьте порт по умолчанию — 5432.
- Рекомендуется использовать именно этот порт, потому что он присутствует во многих конфигурационных файлах программы по умолчанию.
- В окне определения локализации выберите русский язык.
- Вы вправе выбрать другой язык, но так будет удобнее администрировать базу данных.
- На последней странице мастера установки снимите флажок запуска Stack Builder и завершите работу мастера установки.
[править] Дополнительное конфигурирование СУБД PostgreSQL
Для надежной и устойчивой работы PostgreSQL нужно сконфигурировать ряд параметров этой СУБД.
- На машине, где вы установили СУБД PostgreSQL перейдите в установочную папку PostgreSQL, например c:\Program Files\PostgreSQL\9.3\, и откройте подпапку data.
- В подпапке data откройте на редактирование файл postgresql.conf и найдите и измените в нем следующие параметры:
- shared_buffers — присвойте этому параметру значение, равное примерно четверти доступной на машине физической памяти. Например, если на машине установлено 8 ГБ памяти, то этому параметру нужно присвоить значение 2ГБ.
- Этот параметр задает общий объем памяти, совместно используемой всеми подключениями и процессами PostgreSQL.
- work_mem — присвойте этому параметру значение 10 МБ
- Этот параметр задает объем памяти, выделяемый на каждый запрос Mid Office Manager.
- effective_cache_size — присвойте этому параметру значение, равное примерно половине доступной на машине физической памяти. Например, если на машине установлено 8 ГБ памяти, то этому параметру нужно присвоить значение 4ГБ.
- Этот параметр сообщает PostgreSQL примерный объем файлового кеша операционной системы — эта оценка нужна оптимизатору для построения плана запросов.
- shared_buffers — присвойте этому параметру значение, равное примерно четверти доступной на машине физической памяти. Например, если на машине установлено 8 ГБ памяти, то этому параметру нужно присвоить значение 2ГБ.
[править] Создание базы данных и роли входа
Эти операции выполняются в консоли pgAdmin III, которую можно открыть, последовательно выбрав в меню Пуск следующие команды: Все программы\PostgreSQL\pgAdmin III.
В консоли pgAdmin III необходимо выполнить следующие операции:
- добавить роль входа;
- создать базу данных.
Подробнее эти операции описаны далее.
[править] Создание роли входа
- Откройте консоль pgAdmin III.
- В панели Браузер объектов щелкните правой кнопкой узел Роли входа и выберите Новая роль.
- В окне Новая роль на вкладке Свойства в поле Имя роли задайте имя роли — xtrip_user.
- На вкладке Определение дважды введите пароль: xtrip_pswdGN01. Остальные поля на этой вкладке оставьте пустыми.
- Перейдите на вкладку Привилегии и задайте привилегии, как показано на снимке экрана:
- Щелчком ОК закройте окно.
[править] Создание базы данных
- В панели Браузер объектов окна администрирования pgAdmin III щелкните правой кнопкой узел Базы данных и выберите Новая база данных.
- В диалоговом окне Новая база данных на вкладке Свойства задайте имя базы данных: xtrip-3, а в качестве владельца базы данных выберите созданную ранее роль входа xtrip_user.
- Остальные параметры следует оставить в состоянии по умолчанию.
- Щелчком кнопки OК завершите создание базы данных.
[править] Загрузка дистрибутива Mid Office Manager
Прежде чем приступать к установке Mid Office Manager нужно загрузить файлы Mid Office Manager с сервера компании-разработчика по адресу: http://download.gridnine.com/xtrip/xtrip3/production.
Дистрибутив состоит из двух компонентов — сервера и клиента, каждый из который представляет собой отдельный архивный файл. Доступны две версии дистрибутивов — со средой выполнения JRE (Java Runtime Environment) и без нее. Версии со встроенной JRE содержат в имени файла аббревиатуру jre. Рекомендуется использовать дистрибутив со встроенной JRE.
Вот перечень файлов дистрибутивов, размещенных на сайте производителя:
- Сервер
- xtrip-server-3.0.ГГГГММДДЧЧмм.zip — версия без среды JRE
- xtrip-server-jre-win-amd64-3.0.ГГГГММДДЧЧмм.zip — 64-разрядная версия со средой JRE
- xtrip-server-jre-win-i386-3.0.ГГГГММДДЧЧмм.zip — 32-разрядная версия со средой JRE
- xtrip-server-jre-win-ia64-3.0.ГГГГММДДЧЧмм.zip — 64-разрядная версия со средой JRE для процессоров с архитектурой IA-64
- Клиент
- xtrip-client-jre-win-3.0.ГГГГММДДЧЧмм.zip — версия со средой JRE
- xtrip-client-3.0.ГГГГММДДЧЧмм.zip — версия без среды JRE
В имени файла используются следующие обозначения: ГГГГ — год, ММ — месяц, ДД — день, ЧЧ — час, мм — минуты сборки версии, например имя файла xtrip-client-jre-win-3.0.201404031608.zip означает, что это дистрибутив клиента со встроенной средой JRE, собранный 3 апреля 2014 года в 16:08.
Выберите и загрузите файл дистрибутива клиента Mid Office Manager и файл дистрибутива сервера Mid Office Manager. Для установки Mid Office Manager в Windows рекомендуется выбирать варианты дистрибутива со средой JRE. Для установки Mid Office Manager в Linux рекомендуется выбирать варианты дистрибутива без среды JRE.
[править] Установка сервера Mid Office Manager в Windows
Сервер Mid Office Manager устанавливается в следующей последовательности:
- Создайте корневую папку для размещения сервера, например, C:\mom\.
- Рекомендуется не использовать в именах папок пробелов, потому что это может нарушать работу скриптов.
- В созданной корневой папке создайте подпапку server.
- Распакуйте архив сервера Mid Office Manager в папку server .
- Сконфигурируйте сервер Mid Office Manager (см. раздел Настройка подключения сервера Mid Office Manager к СУБД PostgreSQL ).
- Запустите на выполнение файл run-cleanup.bat из подпапки …\bin\xtrip\server, чтобы выполнить начальную инициализацию среды данных.
- Запустите на выполнение файл run.bat в подпапке …\bin\server.
- Признаком успешного запуска сервера Mid Office Manager служит командное окно с информацией о работающем сервере приложения, как показано на снимке экрана.
Чтобы корректно завершить работу сервера, надо в командном окне работающего сервера Mid Office Manager последовательно нажать клавиши «q» и Enter.
![]() |
Если вы планируете использовать функциональность синхронизации с Sabre Profiles, перезапустите сервер Mid Office Manager дважды, каждый раз корректно завершая его работу последовательным нажатием клавиш «q» и Enter. |
![]() |
При выполнении run-cleanup.bat могут возникать ошибки, требующие диагностики и устранения. Но может оказаться, что сообщения об ошибках отображаются в окне командной строки некорректно или вообще нечитабельны. Далее описывается, как решать проблему нечитабельных сообщений. Чтобы обеспечить правильное отображение сообщений Mid Office Manager на русском языке в окне командной строки Windows, выполните следующее:
Чтобы текст ошибок терминала PSQL корректно отображался на английском языке (не вопросительными знаками), сделайте следующее:
Эти же операции позволят решить проблему нечитабельных сообщений при выполнении других командных файлов Mid Office Manager. |
[править] Установка сервера Mid Office Manager в Linux
Установка сервера Mid Office Manager в Linux выполняется в том же порядке, что и в Windows (см. выше), но для запуска и остановки сервера Mid Office Manager нужно использовать файлы сценариев startup.sh и shutdown.sh. Названия других файлов также совпадают, но отличаются расширением .sh.
[править] Настройка подключения сервера Mid Office Manager к СУБД PostgreSQL
Сервер Mid Office Manager использует СУБД PostgreSQL для хранения своих данных, поэтому нужно настроить подключение Mid Office Manager к этой СУБД в следующей последовательности:
- В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties для редактирования.
- Найдите строку, которая начинается текстом: com.gridnine.xtrip.server.db.url=jdbc:postgresql://,
- например com.gridnine.xtrip.server.db.url=jdbc:postgresql://localhost:5432/xtrip-3-ru_prod?loginTimeout=10
- Замените значение, находящееся между двойной наклонной чертой и двоеточием на имя или IP-адрес сервера СУБД.
- При необходимости замените значение после двоеточия на текущий порт СУБД.
- Обычно порт менять не надо, потому что используется порт по умолчанию 5432.
- Сохраните и закройте файл boot.properties.
![]() |
Если имя вашего сервера — myserv, а порт — 1000, тогда строка должна выглядеть так:
com.gridnine.xtrip.server.db.url=jdbc:postgresql://myserv:1000/xtrip-3-ru_prod?loginTimeout=10 |
![]() |
При первоначальной установке Mid Office Manager используется сервер БД, размещённый на этом же компьютере, то есть в качестве имени сервера используется localhost. |
Далее необходимо выполнить первичную инициализацию среды данных.
![]() |
Если не удается запустить сервер Mid Office Manager, то одной из причин может быть нехватка оперативной памяти, выделяемой виртуальной машине Java. Чтобы исправить ситуацию, нужно открыть файл сервера run.bat на редактирование и найти в нем следующую строку:
%JAVACMD% -server -Xms256m -Xmx512m -Djpf.boot.config=config/xtrip/server/boot.properties -jar lib\jpf-boot.jar В этой строке необходимо изменить значение параметра –Xmx, определяющего верхнюю границу выделяемой оперативной памяти. Значение этого параметра задается в мегабайтах (m) и по умолчанию равно 512m, что соответствует 512 МБ. Нужно увеличить значение этого параметра, например значение -Xmx1024m обеспечивает увеличение выделяемой памяти до 1024 МБ. |
[править] Конфигурирование сервера Mid Office Manager
Этот раздел посвящен настройке некоторых особых параметров сервера Mid Office Manager, в том числе об определении идентификатора экземпляра Mid Office Manager для целей лицензирования, о настройке подключения через прокси и подключения через порт, отличный от принятого по умолчанию, а также о конфигурировании обновления, резервного копирования и очистки и оптимизации базы данных. Также здесь рассказывается о конфигурировании служебных командных файлов Mid Office Manager.
[править] Определение идентификатора экземпляра Mid Office Manager
После установки Mid Office Manager надо присвоить ему уникальный идентификатор, который нужен для предоставления лицензии вашему агентству. Этот идентификатор нужно сообщить компании Sabre, чтобы вашему экземпляру была предоставлена лицензия в соответствии с условиями договора. Лицензию экземплярам Mid Office Manager автоматически предоставляет центральный сервер Sabre, основываясь на идентификаторах экземпляров Mid Office Manager.
Чтобы задать идентификатор экземпляра Mid Office Manager:
- В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties на редактирование.
- Найдите следующую строку:
-
com.gridnine.xtrip.server.appId = xtrip-node1
-
- Внесите в строку идентификатор своего агентства, например (изменения выделены полужирным):
-
com.gridnine.xtrip.server.appId = '''myagency'''
-
- Сохраните и закройте файл boot.properties.
- Перезагрузите сервер Mid Office Manager.
[править] Настройка подключения через прокси-сервер
Если в агентстве доступ в Интернет осуществляется через прокси-сервер, его адрес нужно определить в конфигурации сервера Mid Office Manager. Это нужно в первую очередь для обеспечения возможности обновления Mid Office Manager.
Чтобы настроить подключение через прокси-сервер:
- В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties на редактирование.
- Найдите следующий блок параметров:
- # Update configuration
- com.gridnine.xtrip.server.update.url=http://download.gridnine.com/xtrip/xtrip3/production/update/
- #com.gridnine.xtrip.server.update.proxy.host = 10.0.0.228
- #com.gridnine.xtrip.server.update.proxy.port = 3129
- #com.gridnine.xtrip.server.update.proxy.username = user
- #com.gridnine.xtrip.server.update.proxy.password = 123
- Удалите знак «решетка» (#) в относящихся к прокси-серверу строках и задайте параметры локального прокси-сервера:
- com.gridnine.xtrip.server.update.proxy.host — в этой строке задайте IP-адрес своего прокси-сервера, например:
- com.gridnine.xtrip.server.update.proxy.host = 198.162.0.25;
- com.gridnine.xtrip.server.update.proxy.port — в этой строке задайте порт своего прокси-сервера, например:
- com.gridnine.xtrip.server.update.proxy.port = 1234;
- com.gridnine.xtrip.server.update.proxy.username — в этой строке задайте имя пользователя для подключения к прокси-серверу, например:
- com.gridnine.xtrip.server.update.proxy.username = jsmith;
- com.gridnine.xtrip.server.update.proxy.password — в этой строке задайте пароль пользователя для подключения к прокси-серверу, например:
- com.gridnine.xtrip.server.update.proxy.password = p@ssw0rd;
- com.gridnine.xtrip.server.update.proxy.host — в этой строке задайте IP-адрес своего прокси-сервера, например:
- Сохраните и закройте файл boot.properties.
- Перезагрузите сервер Mid Office Manager.
[править] Изменение порта для подключения к серверу Mid Office Manager
По умолчанию подключение к серверу Mid Office Manager осуществляется через порт 8080 и изменять эту настройку не требуется. Но в некоторых ситуациях, например если этот порт используется для других целей или когда нужно поддерживать несколько экземпляров сервера на одной машине, можно изменить этот порт. Далее описывается, как это сделать.
Чтобы изменить порт подключения к серверу по умолчанию:
- В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties в режиме редактирования.
- Найдите следующую строку:
- #com.gridnine.xtrip.server.tomcat.standard.port = 8080
- Замените строку на следующие две строки:
- com.gridnine.xtrip.server.tomcat.standard.port = 9090
- com.gridnine.xtrip.server.tomcat.standard.default = true
- При необходимости замените значение после двоеточия на текущий порт СУБД.
- Сохраните и закройте файл boot.properties.
- Перезагрузите сервер Mid Office Manager.
[править] Определение конфигурации резервного копирования
Для обеспечения надежной работы и возможности восстановить потерпевший сбой экземпляр Mid Office Manager нужно регулярно выполнять резервное копирование Mid Office Manager. В общем случае резервные копии рекомендуется размещать на диске отличном от диска, на котором установлен Mid Office Manager.
Для резервного копирования в Mid Office Managerслужит командный файл pgdb_backup_script.bat. Далее рассказывается о параметрах, которые надо сконфигурировать, чтобы обеспечить работоспособность резервного копирования в Mid Office Manager.
- В подпапке ..\bin\xtrip\server\ папки сервера Mid Office Manager откройте файл pgdb_backup_script.bat в режиме редактирования.
- Найдите следующую строку:
- set BACKUP_FILE=C:\xtrip_backups\xtripdb_%datestr%.backup
- и укажите в ней путь к папке, где будут размещаться резервные копии, например (изменения выделены полужирным):
- set BACKUP_FILE=D:\MOM_backup\xtripdb_%datestr%.backup
- В строке:
- set POSTGRESBINDIR=C:\Program Files (x86)\PostgreSQL\8.3\bin
- укажите путь к папке с исполняемыми файлами PostgreSQL на машине сервера, например (изменения выделены полужирным):
- set POSTGRESBINDIR=C:\Program Files\PostgreSQL\9.1\bin
- Если база данных и сервер Mid Office Manager находятся на разных дисках, нужно предусмотреть переключение контекста между дисками, для чего надо внести в файл следующие изменения (выделены полужирным) (здесь предполагается, что Mid Office Manager расположен на диске D:, а резервные копии создаются на диске C:):
- set DB_USER=xtrip_user
- C:
- cd %POSTGRESBINDIR%
- pg_dump -i -h localhost -p 5432 -U %DB_USER% -b -f %BACKUP_FILE% %DB_NAME%
- ::pg_dump -Fc -h localhost -p 5432 -U %DB_USER% %DB_NAME% > %BACKUP_FILE%
- D:
- cd %OLDDIR%
- Сохраните и закройте файл pgdb_backup_script.bat.
[править] Настройка удаления устаревших резервных копий
Резервные копии занимают значительное место на диске, поэтому рекомендуется регулярно удалять старые резервные копии, чтобы они не заняли все свободное дисковое пространство. В Mid Office Manager для этого предусмотрен командный файл pgdb_cleanup_script.bat. В нем нужно указать, где хранятся резервные копии вашего экземпляра Mid Office Manager. По умолчанию этот командный файл предусматривает удаление всех имеющихся резервных копий кроме последних четырех. Это количество также можно изменить. Далее рассказывается, как определить место хранения устаревших резервных копий и количество сохраняемых копий.
- В подпапке ..\bin\xtrip\server\ папки сервера Mid Office Manager откройте файл pgdb_cleanup_script.bat в режиме редактирования.
- Найдите следующую строку:
- cd c:\xtrip_backups
- и укажите в ней путь к папке, где хранятся резервные копии, например (изменения выделены полужирным):
- cd c:\my_backup_dir
- Если нужно изменить количество сохраняемых резервных копий, найдите следующую строку:
- for /f "skip=4 tokens=* delims= " %%a in ('dir/b/o-n xtripdb_*.backup.7z') do del %%a
- и замените цифру 4 на нужное количество резервных копий, которые должны оставаться в папке (изменения выделены полужирным):
- for /f "skip=10 tokens=* delims= " %%a in ('dir/b/o-n xtripdb_*.backup.7z') do del %%a
- Сохраните и закройте файл pgdb_cleanup_script.bat.
[править] Определение конфигурации очистки и оптимизации базы данных Mid Office Manager
В процессе работы базы данных Mid Office Manager она может фрагментироваться или в ней могут оставаться фантомные записи, а также накапливаться другие ошибки. Все это снижает производительность базы данных, поэтому в Mid Office Manager предусмотрен командный файл очистки и оптимизации базы данных — он называется pgdb_vacuum_script.bat. Выполнять очистку и оптимизацию базы данных рекомендуется не чаще раза в месяц, а также после импорта в базу данных большого объема информации. Далее рассказывается, как нужно настроить командный файл очистки.
- В подпапке ..\bin\xtrip\server\ папки сервера Mid Office Manager откройте файл pgdb_vacuum_script.bat в режиме редактирования.
- Найдите строку:
- SET POSTGRESBINDIR=C:\Program Files (x86)\PostgreSQL\8.3\bin
- и укажите в ней путь к папке с исполняемыми файлами PostgreSQL на машине сервера, например (изменения выделены полужирным):
- set POSTGRESBINDIR=C:\Program Files\PostgreSQL\9.1\bin
- Сохраните и закройте файл pgdb_vacuum_script.bat.
[править] Запуск сервера Mid Office Manager в режиме службы Windows
Сервер приложения Mid Office Manager можно запустить в режиме службы Windows. Для этого нужно запустить на выполнение файл install.bat из подпапки ..\server\bin\xtrip\server папки сервера Mid Office Manager. После этого сервер Mid Office Manager появится в системной консоли «Службы» под именем Trip Server.
![]() |
В Windows Server 2008 работа Mid Office Manager в режиме службы Windows не поддерживается. |
[править] Установка клиента
![]() |
Очень желательно, чтобы клиент и сервер Mid Office Manager находились в одном часовом поясе, то есть время сервера и клиента должны совпадать, иначе Mid Office Manager может работать некорректно. |
Клиент устанавливается в следующей последовательности:
- Создайте корневой каталог, например Mid Office Manager;
- В новом каталоге создайте подкаталог client.
- Распакуйте архив клиентской части в каталог client.
- Запустите на выполнение файл run.bat в подпапке …\bin\xtrip\client .
- В открывшемся окне входа введите имя пользователя, пароль и адрес сервера. При первом входе нужно задать следующие значения:
- Имя пользователя — admin
- Пароль — admin
- Сервер-репозиторий — IP–адрес сервера приложения, например 127.0.0.1, или DNS-имя, например localhost.
![]() |
Если не удается запустить клиент Mid Office Manager, то одной из причин может быть нехватка оперативной памяти, выделяемой виртуальной машине Java. Чтобы исправить ситуацию, нужно открыть файл сервера run.bat на редактирование и найти в нем следующую строку:
START "xTrip 3" %JAVACMD% -Xms128m -Xmx256m -Djpf.boot.config=config/xtrip/client/boot.properties -jar lib\jpf-boot.jar В этой строке необходимо изменить значение параметра –Xmx, определяющего верхнюю границу выделяемой оперативной памяти. Значение этого параметра задается в мегабайтах (m) и по умолчанию равно 512m, что соответствует 512 МБ. Нужно увеличить значение этого параметра, например значение -Xmx1024m обеспечивает увеличение выделяемой памяти до 1024 МБ. |
После первичной настройки клиента Mid Office Manager можно развернуть его на других машинах в следующем порядке:
- Скопируйте папку настроенного клиента Mid Office Manager вместе со всем подпапками на машину, где нужно установить еще один клиент Mid Office Manager.
- На целевой машине удалите temp из папки клиента.
- Если этого не сделать, запустить клиент Mid Office Manager на другой машине не удастся.
- Запустите клиент Mid Office Manager на целевой машине в обычном порядке.
После начальной установки нужно выполнить конфигурирование Mid Office Manager в соответствии с бизнес-процессами, распределением ролей, набором функциональности и особенностями работы агентства. Кроме того, необходимо наладить взаимодействие с рядом сервисов и предпринять ряд организационных действий для поставки исходных данных. Подробнее об этом см. раздел Ссылки по теме.