Установка Mid Office Manager — различия между версиями
Строка 88: | Строка 88: | ||
#: Признаком успешного запуска сервера {{an}} служит командное окно с информацией о работающем сервере приложения, пример которого приведен ниже. | #: Признаком успешного запуска сервера {{an}} служит командное окно с информацией о работающем сервере приложения, пример которого приведен ниже. | ||
− | [[Image: | + | [[Image:Running server.png]] |
+ | |||
+ | [[Файл:Running server.png]] | ||
Чтобы корректно завершить работу сервера, надо в командном окне работающего сервера {{an}} последовательно нажать клавиши «q» и Enter. | Чтобы корректно завершить работу сервера, надо в командном окне работающего сервера {{an}} последовательно нажать клавиши «q» и Enter. | ||
Строка 158: | Строка 160: | ||
− | [[Image:Mid Office Manager login.jpg| | + | [[Image:Mid Office Manager login.jpg|600px|thumb|center|Окно входа в {{an}}]] |
Версия 14:17, 25 апреля 2014
Установка Mid Office Manager выполняется в следующем порядке:
- Установка и конфигурирование СУБД PostgreSQL.
- Создание базы данных и учетной записи пользователя для доступа к ней.
- Установка сервера Mid Office Manager.
- Установка клиентов Mid Office Manager.
Подробнее эти этапы описаны ниже.
Для полноценной работы программы необходимо также настроить профили, взаимодействие с системами GDS. Полное описание процедуры развертывания Mid Office Manager см. в разделе Развертывание Mid Office Manager.
Установка и конфигурирование СУБД PostgreSQL
Перед установкой PostgreSQL рекомендуется ознакомиться с системными требованиями и инструкциями производителя этой СУБД, доступными на официальном сайте этого продукта, и следовать этим инструкциям при установке PostgreSQL. Если СУБД PostgreSQL уже установлена в вашей среде, пропустите это раздел и приступайте к следующему.
Выполните установку PostgreSQL в следующей последовательности:
- Загрузите дистрибутив СУБД PostgreSQL с официального сайта производителя по адресу http://postgresql.org.
- На сайте производителя также доступна информация о системных требованиях и особенностях установки PostgreSQL.
- Запустите установщик и следуйте инструкциям на экране. В мастере установки выполните следующие операции:
- Задайте пароль по умолчанию: xtrip_pswdGN01.
- Это пароль служебной учетной записи postgres, в контексте которой будет работать сервер СУБД. Вы вправе задать другой пароль, но делать этого не рекомендуется.
- В качестве порта СУБД PostgreSQL оставьте порт по умолчанию — 5432.
- Рекомендуется использовать именно этот порт, потому что он присутствует во многих конфигурационных файлах программы по умолчанию.
- В окне определения локализации выберите русский язык.
- Вы вправе выбрать другой язык, но так будет удобнее администрировать базу данных.
- На последней странице мастера установки снимите флажок запуска Stack Builder и завершите работу мастера установки.
Создание базы данных и роли входа
Эти операции выполняются в консоли 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. Рекомендуется выбирать варианты дистрибутива со средой JRE.
Установка сервера Mid Office Manager в Windows
Сервер Mid Office Manager устанавливается в следующей последовательности:
- Создайте корневую папку для размещения сервера, например, C:\Mid Office Manager\.
- В созданной корневой папке создайте подпапку server.
- Распакуйте архив сервера Mid Office Manager в папку server .
- Сконфигурируйте сервер Mid Office Manager (см. раздел "Конфигурация сервера приложения").
- Запустите на выполнение файл run-cleanup.bat из подпапки …\bin\xtrip\server, чтобы выполнить начальную инициализацию среды данных.
- Запустите на выполнение файл run.bat в подпапке …\bin\server.
- Признаком успешного запуска сервера Mid Office Manager служит командное окно с информацией о работающем сервере приложения, пример которого приведен ниже.
Чтобы корректно завершить работу сервера, надо в командном окне работающего сервера Mid Office Manager последовательно нажать клавиши «q» и Enter.
![]() |
При выполнении un-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 для хранения своих данных, поэтому нужно настроить его подключение в этой СУБД в следующей последовательности:
- В подпапке ..\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.
![]() |
Если имя вашего сервера — 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 в режиме службы 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;
- В новом каталоге создайте подкаталог 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 в соответствии с бизнес-процессами, распределением ролей, набором функциональности и особенностями работы агентства. Кроме того, необходимо наладить взаимодействие с рядом сервисов и предпринять ряд организационных действий для поставки исходных данных. Подробнее об этом см. раздел Ссылки по теме.