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

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

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

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

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

Для полноценной работы программы необходимо также настроить профили, взаимодействие с системами GDS. Полное описание процедуры развертывания 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.

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

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

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

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

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

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

1. Откройте консоль pgAdmin III.
2. В панели Браузер объектов щелкните правой кнопкой узел Роли входа и выберите Новая роль.
3. В окне Новая роль на вкладке Свойства в поле Имя роли задайте имя роли — xtrip_user.
4. На вкладке Определение дважды введите пароль: xtrip_pswdGN01. Остальные поля на этой вкладке оставьте пустыми.
5. Перейдите на вкладку Привилегии и задайте привилегии, как показано на снимке экрана:

Создание базы данных

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-jre-win-3.0.ГГГГММДДЧЧмм.zip — версия со средой JRE
  • xtrip-server-3.0.ГГГГММДДЧЧмм.zip — версия без среды JRE
• Клиент
  • 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

Сервер Mid Office Manager устанавливается в следующей последовательности:

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

   Признаком успешного запуска сервера Mid Office Manager служит командное окно с информацией о запущенном сервере приложения, пример которого приведен ниже.

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

При выполнении un-cleanup.bat могут возникать ошибки, требующие диагностики и устранения. Но может оказаться, что сообщения об ошибках отображаются в окне командной строки некорректно или вообще нечитабельны. Далее описывается, как решать проблему нечитабельных сообщений. Чтобы обеспечить правильное отображение сообщений Mid Office Manager на русском языке в окне командной строки Windows, выполните следующее: В окне командной строки щелкните правой кнопкой заголовок окна и выберите Свойства. В открывшемся окне перейдите на вкладку Шрифт и выберите шрифт Lucida Console. Повторно выполните командный файл. Чтобы текст ошибок терминала PSQL корректно отображался на английском языке (не вопросительными знаками), сделайте следующее: В консоли pgAdmin III в меню Инструменты последовательно выберите Конфигурация сервера и postgresql.conf. В окне Редактор конфигурации сервера найдите параметр lc_messages и измените его значение на AMERICAN_AMERICA.CL8MSWIN1251. Перезапустите сервер PostgreSQL. Повторно выполните командный файл. Эти же операции позволят решить проблему нечитабельных сообщений других командных файлов 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 для хранения своих данных, поэтому нужно настроить его подключение в этой СУБД в следующей последовательности:

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.

<Описание>

При первоначальной установке Mid Office Manager используется сервер БД, размещённый на этом же компьютере, то есть, в качестве имени сервера используется localhost.

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

{{info|Если не удается запустить сервер 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 МБ.

Запуск сервера в режиме службы Windows

Сервер приложения Mid Office Manager можно запустить в режиме службе Windows. Чтобы установить службу, запустите файл «install.bat» из папки <папка установки Mid Office Manager\server\bin\xtrip\server>. После этого сервер приложения Mid Office Manager будет доступен через стандартное меню «Панель управления > Администрирование > Службы» под именем «xTrip Server».

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

Развертывание клиента

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

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

Если запустить клиент не удалось, то одной из причин может быть нехватка оперативной памяти, выделяемой виртуальной машине Java при запуске клиента. Чтобы скорректировать объем памяти, который должен быть выделен при запуске клиента надо открыть файл запуска клиента run.bat и найти строку запуска сервера №18: START "xTrip 3" %JAVACMD% -Xms128m -Xmx256m -Djpf.boot.config=config/xtrip/client/boot.properties -jar lib\jpf-boot.jar В ней необходимо изменить значение ключа запуска клиента для верхней границы оперативной памяти –Xmx. Величина указывается в мегабайтах (МБ) и по умолчанию установлено 256 МБ. Ключ -Xms — нижняя граница оперативной памяти.

После первичной настройки клиентского приложения Mid Office Manager, можно развёртывать клиентскую часть Mid Office Manager на других машинах посредством копирования. При этом обязательно удалите папку «temp» из папки клиента. В противном случае программа не запустится на другой машине.

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