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

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

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

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

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

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

Установка и конфигурирование СУБД 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 можно с сервера компании-разработчика по адресу: 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.

Развертывание сервера приложения в Windows

Для развертывания сервера приложения необходимо:

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

Рис. 2.2.4.1.

Чтобы корректно завершить работу сервера необходимо нажать «q» в командном окне запущенного сервера приложения.

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

Развертывание сервера приложения в Linux

Действия аналогичны п. 2.2.4, но для запуска сервера и остановки сервера приложения Mid Office Manager используются файлы сценариев startup.sh и shutdown.sh, другие скрипты имеют такие же названия, но отличаются расширением .sh.

Конфигурация сервера приложения

Для того чтобы программа использовала СУБД PostgreSQL необходимо выполнить конфигурацию сервера приложения. В директории <Директория установки Mid Office Manager>\server\config\server нужно открыть файл boot.properties в режиме редактирования и заменить <db_server_name> на имя или IP-адрес сервера, где установлена СУБД, а <db_server_port> нужно заменить значением порта, или оставить порт по умолчанию 5432.

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

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

Если запуск сервера, описанный в пункте п/п. 6 п. 2.2.4, не удастся, то одной из причин может быть нехватка оперативной памяти, выделяемой виртуальной машине Java при запуске сервера приложения. Чтобы скорректировать объем памяти, который должен быть выделен при запуске сервера приложения надо открыть файл запуска сервера приложения run.bat и найти строку запуска сервера №19: %JAVACMD% -server -Xms256m -Xmx512m -Djpf.boot.config=config/xtrip/server/boot.properties -jar lib\jpf-boot.jar В ней необходимо изменить значение ключа запуска сервера приложения для верхней границы оперативной памяти –Xmx. Величина указывается в мегабайтах (МБ) и по умолчанию установлено 512 МБ. Ключ -Xms — нижняя граница оперативной памяти.

Запуск сервера в режиме службы 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 в режиме службы не поддерживается.

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

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

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.