Установка Mid Office Manager

Материал из Mid Office Manager Help
Перейти к: навигация, поиск

Установка Mid Office Manager выполняется в следующем порядке:

  1. Установка и конфигурирование СУБД PostgreSQL.
  2. Создание базы данных и учетной записи пользователя для доступа к ней.
  3. Установка сервера Mid Office Manager.
  4. Установка клиентов Mid Office Manager.

Подробнее эти этапы описаны ниже.

Для полноценного начала работы программы после установки необходимо произвести конфигурирование Mid Office Manager.

Содержание

Установка и конфигурирование СУБД PostgreSQL

Перед установкой PostgreSQL рекомендуется ознакомиться с системными требованиями и инструкциями производителя этой СУБД, доступными на официальном сайте этого продукта, и следовать этим инструкциям при установке PostgreSQL. Если СУБД PostgreSQL уже установлена в вашей среде, пропустите это раздел и приступайте к следующему.

Выполните установку PostgreSQL в следующей последовательности:

  1. Загрузите дистрибутив СУБД PostgreSQL с официального сайта производителя по адресу http://postgresql.org.
    На сайте производителя также доступна информация о системных требованиях и особенностях установки PostgreSQL.
  2. Запустите установщик и следуйте инструкциям на экране. В мастере установки выполните следующие операции:
    • Задайте пароль по умолчанию: xtrip_pswdGN01.
    Это пароль служебной учетной записи postgres, в контексте которой будет работать сервер СУБД. Вы вправе задать другой пароль, но делать этого не рекомендуется.
    • В качестве порта СУБД PostgreSQL оставьте порт по умолчанию — 5432.
    Рекомендуется использовать именно этот порт, потому что он присутствует во многих конфигурационных файлах программы по умолчанию.
    • В окне определения локализации выберите русский язык.
    Вы вправе выбрать другой язык, но так будет удобнее администрировать базу данных.
  3. На последней странице мастера установки снимите флажок запуска Stack Builder и завершите работу мастера установки.

Дополнительное конфигурирование СУБД PostgreSQL

Для надежной и устойчивой работы PostgreSQL нужно сконфигурировать ряд параметров этой СУБД.

  1. На машине, где вы установили СУБД PostgreSQL перейдите в установочную папку PostgreSQL, например c:\Program Files\PostgreSQL\9.3\, и откройте подпапку data.
  2. В подпапке data откройте на редактирование файл postgresql.conf и найдите и измените в нем следующие параметры:
    • shared_buffers — присвойте этому параметру значение, равное примерно четверти доступной на машине физической памяти. Например, если на машине установлено 8 ГБ памяти, то этому параметру нужно присвоить значение 2ГБ.
      Этот параметр задает общий объем памяти, совместно используемой всеми подключениями и процессами PostgreSQL.
    • work_mem — присвойте этому параметру значение 10 МБ
      Этот параметр задает объем памяти, выделяемый на каждый запрос Mid Office Manager.
    • effective_cache_size — присвойте этому параметру значение, равное примерно половине доступной на машине физической памяти. Например, если на машине установлено 8 ГБ памяти, то этому параметру нужно присвоить значение 4ГБ.
      Этот параметр сообщает PostgreSQL примерный объем файлового кеша операционной системы — эта оценка нужна оптимизатору для построения плана запросов.

Создание базы данных и роли входа

Эти операции выполняются в консоли pgAdmin III, которую можно открыть, последовательно выбрав в меню Пуск следующие команды: Все программы\PostgreSQL\pgAdmin III.

В консоли pgAdmin III необходимо выполнить следующие операции:

  • добавить роль входа;
  • создать базу данных.

Подробнее эти операции описаны далее.

Создание роли входа
  1. Откройте консоль pgAdmin III.
  2. В панели Браузер объектов щелкните правой кнопкой узел Роли входа и выберите Новая роль.
  3. В окне Новая роль на вкладке Свойства в поле Имя роли задайте имя роли — xtrip_user.
  4. На вкладке Определение дважды введите пароль: xtrip_pswdGN01. Остальные поля на этой вкладке оставьте пустыми.
  5. Перейдите на вкладку Привилегии и задайте привилегии, как показано на снимке экрана:
    PgAdmin III new role privileges.jpg
  6. Щелчком ОК закройте окно.
Создание базы данных
  1. В панели Браузер объектов окна администрирования pgAdmin III щелкните правой кнопкой узел Базы данных и выберите Новая база данных.
  2. В диалоговом окне Новая база данных на вкладке Свойства задайте имя базы данных: xtrip-3, а в качестве владельца базы данных выберите созданную ранее роль входа xtrip_user.
    Остальные параметры следует оставить в состоянии по умолчанию.
  3. Щелчком кнопки 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 устанавливается в следующей последовательности:

  1. Создайте корневую папку для размещения сервера, например, C:\mom\.
    Рекомендуется не использовать в именах папок пробелов, потому что это может нарушать работу скриптов.
  2. В созданной корневой папке создайте подпапку server.
  3. Распакуйте архив сервера Mid Office Manager в папку server .
  4. Сконфигурируйте сервер Mid Office Manager (см. раздел Настройка подключения сервера Mid Office Manager к СУБД PostgreSQL ).
  5. Запустите на выполнение файл run-cleanup.bat из подпапки …\bin\xtrip\server, чтобы выполнить начальную инициализацию среды данных.
  6. Запустите на выполнение файл run.bat в подпапке …\bin\server.
    Признаком успешного запуска сервера Mid Office Manager служит командное окно с информацией о работающем сервере приложения, как показано на снимке экрана.

Running server.png

Чтобы корректно завершить работу сервера, надо в командном окне работающего сервера Mid Office Manager последовательно нажать клавиши «q» и Enter.

Alert.png Если вы планируете использовать функциональность синхронизации с Sabre Profiles, перезапустите сервер Mid Office Manager дважды, каждый раз корректно завершая его работу последовательным нажатием клавиш «q» и Enter.
Info.png

При выполнении run-cleanup.bat могут возникать ошибки, требующие диагностики и устранения. Но может оказаться, что сообщения об ошибках отображаются в окне командной строки некорректно или вообще нечитабельны. Далее описывается, как решать проблему нечитабельных сообщений.

Чтобы обеспечить правильное отображение сообщений Mid Office Manager на русском языке в окне командной строки Windows, выполните следующее:

  1. В окне командной строки щелкните правой кнопкой заголовок окна и выберите Свойства.
  2. В открывшемся окне перейдите на вкладку Шрифт и выберите шрифт Lucida Console.
  3. Повторно выполните командный файл.

Чтобы текст ошибок терминала PSQL корректно отображался на английском языке (не вопросительными знаками), сделайте следующее:

  1. В консоли pgAdmin III в меню Инструменты последовательно выберите Конфигурация сервера и postgresql.conf.
  2. В окне Редактор конфигурации сервера найдите параметр lc_messages и измените его значение на AMERICAN_AMERICA.CL8MSWIN1251.
  3. Перезапустите сервер PostgreSQL.
  4. Повторно выполните командный файл.

Эти же операции позволят решить проблему нечитабельных сообщений при выполнении других командных файлов 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 к этой СУБД в следующей последовательности:

  1. В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties для редактирования.
  2. Найдите строку, которая начинается текстом: com.gridnine.xtrip.server.db.url=jdbc:postgresql://,
    например com.gridnine.xtrip.server.db.url=jdbc:postgresql://localhost:5432/xtrip-3-ru_prod?loginTimeout=10
  3. Замените значение, находящееся между двойной наклонной чертой и двоеточием на имя или IP-адрес сервера СУБД.
  4. При необходимости замените значение после двоеточия на текущий порт СУБД.
    Обычно порт менять не надо, потому что используется порт по умолчанию 5432.
  5. Сохраните и закройте файл boot.properties.
Info.png Если имя вашего сервера — myserv, а порт — 1000, тогда строка должна выглядеть так: 
com.gridnine.xtrip.server.db.url=jdbc:postgresql://myserv:1000/xtrip-3-ru_prod?loginTimeout=10
Info.png При первоначальной установке Mid Office Manager используется сервер БД, размещённый на этом же компьютере, то есть в качестве имени сервера используется localhost.

Далее необходимо выполнить первичную инициализацию среды данных.

Info.png Если не удается запустить сервер 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:

  1. В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties на редактирование.
  2. Найдите следующую строку: 
    com.gridnine.xtrip.server.appId = xtrip-node1
  3. Внесите в строку идентификатор своего агентства, например (изменения выделены полужирным): 
    com.gridnine.xtrip.server.appId = '''myagency'''
  4. Сохраните и закройте файл boot.properties.
  5. Перезагрузите сервер Mid Office Manager.

Настройка подключения через прокси-сервер

Если в агентстве доступ в Интернет осуществляется через прокси-сервер, его адрес нужно определить в конфигурации сервера Mid Office Manager. Это нужно в первую очередь для обеспечения возможности обновления Mid Office Manager.

Чтобы настроить подключение через прокси-сервер:

  1. В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties на редактирование.
  2. Найдите следующий блок параметров:
    # 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
  3. Удалите знак «решетка» (#) в относящихся к прокси-серверу строках и задайте параметры локального прокси-сервера:
    • 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;
  4. Сохраните и закройте файл boot.properties.
  5. Перезагрузите сервер Mid Office Manager.

Изменение порта для подключения к серверу Mid Office Manager

По умолчанию подключение к серверу Mid Office Manager осуществляется через порт 8080 и изменять эту настройку не требуется. Но в некоторых ситуациях, например если этот порт используется для других целей или когда нужно поддерживать несколько экземпляров сервера на одной машине, можно изменить этот порт. Далее описывается, как это сделать.

Чтобы изменить порт подключения к серверу по умолчанию:

  1. В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties в режиме редактирования.
  2. Найдите следующую строку:
    #com.gridnine.xtrip.server.tomcat.standard.port = 8080
  3. Замените строку на следующие две строки:
    com.gridnine.xtrip.server.tomcat.standard.port = 9090
    com.gridnine.xtrip.server.tomcat.standard.default = true
  4. При необходимости замените значение после двоеточия на текущий порт СУБД.
  5. Сохраните и закройте файл boot.properties.
  6. Перезагрузите сервер Mid Office Manager.

Определение конфигурации резервного копирования

Для обеспечения надежной работы и возможности восстановить потерпевший сбой экземпляр Mid Office Manager нужно регулярно выполнять резервное копирование Mid Office Manager. В общем случае резервные копии рекомендуется размещать на диске отличном от диска, на котором установлен Mid Office Manager.

Для резервного копирования в Mid Office Managerслужит командный файл pgdb_backup_script.bat. Далее рассказывается о параметрах, которые надо сконфигурировать, чтобы обеспечить работоспособность резервного копирования в Mid Office Manager.

  1. В подпапке ..\bin\xtrip\server\ папки сервера Mid Office Manager откройте файл pgdb_backup_script.bat в режиме редактирования.
  2. Найдите следующую строку:
    set BACKUP_FILE=C:\xtrip_backups\xtripdb_%datestr%.backup
    и укажите в ней путь к папке, где будут размещаться резервные копии, например (изменения выделены полужирным):
    set BACKUP_FILE=D:\MOM_backup\xtripdb_%datestr%.backup
  3. В строке:
    set POSTGRESBINDIR=C:\Program Files (x86)\PostgreSQL\8.3\bin
    укажите путь к папке с исполняемыми файлами PostgreSQL на машине сервера, например (изменения выделены полужирным):
    set POSTGRESBINDIR=C:\Program Files\PostgreSQL\9.1\bin
  4. Если база данных и сервер 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%
  5. Сохраните и закройте файл pgdb_backup_script.bat.

Настройка удаления устаревших резервных копий

Резервные копии занимают значительное место на диске, поэтому рекомендуется регулярно удалять старые резервные копии, чтобы они не заняли все свободное дисковое пространство. В Mid Office Manager для этого предусмотрен командный файл pgdb_cleanup_script.bat. В нем нужно указать, где хранятся резервные копии вашего экземпляра Mid Office Manager. По умолчанию этот командный файл предусматривает удаление всех имеющихся резервных копий кроме последних четырех. Это количество также можно изменить. Далее рассказывается, как определить место хранения устаревших резервных копий и количество сохраняемых копий.

  1. В подпапке ..\bin\xtrip\server\ папки сервера Mid Office Manager откройте файл pgdb_cleanup_script.bat в режиме редактирования.
  2. Найдите следующую строку:
    cd c:\xtrip_backups
    и укажите в ней путь к папке, где хранятся резервные копии, например (изменения выделены полужирным):
    cd c:\my_backup_dir
  3. Если нужно изменить количество сохраняемых резервных копий, найдите следующую строку:
    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
  4. Сохраните и закройте файл pgdb_cleanup_script.bat.

Определение конфигурации очистки и оптимизации базы данных Mid Office Manager

В процессе работы базы данных Mid Office Manager она может фрагментироваться или в ней могут оставаться фантомные записи, а также накапливаться другие ошибки. Все это снижает производительность базы данных, поэтому в Mid Office Manager предусмотрен командный файл очистки и оптимизации базы данных — он называется pgdb_vacuum_script.bat. Выполнять очистку и оптимизацию базы данных рекомендуется не чаще раза в месяц, а также после импорта в базу данных большого объема информации. Далее рассказывается, как нужно настроить командный файл очистки.

  1. В подпапке ..\bin\xtrip\server\ папки сервера Mid Office Manager откройте файл pgdb_vacuum_script.bat в режиме редактирования.
  2. Найдите строку:
    SET POSTGRESBINDIR=C:\Program Files (x86)\PostgreSQL\8.3\bin
    и укажите в ней путь к папке с исполняемыми файлами PostgreSQL на машине сервера, например (изменения выделены полужирным):
    set POSTGRESBINDIR=C:\Program Files\PostgreSQL\9.1\bin
  3. Сохраните и закройте файл 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.

Alert.png В Windows Server 2008 работа Mid Office Manager в режиме службы Windows не поддерживается.

Установка клиента

Info.png Очень желательно, чтобы клиент и сервер Mid Office Manager находились в одном часовом поясе, то есть время сервера и клиента должны совпадать, иначе Mid Office Manager может работать некорректно.

Клиент устанавливается в следующей последовательности:

  1. Создайте корневой каталог, например Mid Office Manager;
  2. В новом каталоге создайте подкаталог client.
  3. Распакуйте архив клиентской части в каталог client.
  4. Запустите на выполнение файл run.bat в подпапке …\bin\xtrip\client .
  5. В открывшемся окне входа введите имя пользователя, пароль и адрес сервера. При первом входе нужно задать следующие значения:
    • Имя пользователя — admin
    • Пароль — admin
    • Сервер-репозиторий — IP–адрес сервера приложения, например 127.0.0.1, или DNS-имя, например localhost.


Окно входа в Mid Office Manager


Info.png Если не удается запустить клиент 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 можно развернуть его на других машинах в следующем порядке:

  1. Скопируйте папку настроенного клиента Mid Office Manager вместе со всем подпапками на машину, где нужно установить еще один клиент Mid Office Manager.
  2. На целевой машине удалите temp из папки клиента.
    Если этого не сделать, запустить клиент Mid Office Manager на другой машине не удастся.
  3. Запустите клиент Mid Office Manager на целевой машине в обычном порядке.

После начальной установки нужно выполнить конфигурирование Mid Office Manager в соответствии с бизнес-процессами, распределением ролей, набором функциональности и особенностями работы агентства. Кроме того, необходимо наладить взаимодействие с рядом сервисов и предпринять ряд организационных действий для поставки исходных данных. Подробнее об этом см. раздел Ссылки по теме.

Ссылки по теме

Источник — «http://xtrip-wiki.gridnine.com/wiki/index.php?title=Установка_Mid_Office_Manager&oldid=12683»
Личные инструменты
Пространства имён

Варианты
Действия
Навигация
Печать/экспорт
Инструменты