Сервер:Установка и первый запуск

Версия 13:14, 28 марта 2012

• Качаем и устанавливаем Java Runtime Environment (JRE) под нужную операционку [1], конкретно (может меняться с появлением новых версий) отсюда [2].

• Качаем и устанавливаем PostgreSQL под нужную операционку [3]

• В PostgreSQL создаем роль locarus с паролем locarus (или любым другим, но в этом случае потребуется дополнительная настройка сервера).

• В PostgreSQL создаем базу данных locarus, кодировка UTF-8, владелец - locarus. Выдаем все права на эту базу пользователю locarus.

• Проверяем доступность портов для телематики. Порты необходимые для работы сервера перечислены в разделе Сервер:Описание портов

• Разворачиваем дистрибутив сервера в папку, например /usr/local/locarus (linux) или c:\java\locarus (windows). В поставке сервера с именем locarus-server-3.x.x.zip содержится программное обеспечение которое работает только в интерактивном-тестовом режиме. Если вы хотите запускать сервер сервисом/службой (под MS Windows) или демоном (под Linux) вам понадобится ПО wrapper, которое вы можете взять тут: [4] Содержимое архива нужно просто распаковать в папку, где у вас развернут сервер.

• Делаем эту папку текущей

cd /usr/local/locarus

или

cd c:\java\locarus

• Проверяем сервер. Запускаем

java -jar locarus-server.jar -test

• Если настройки базы данных не совпадают со стандартными, сервер при первом запуске запросит ввод параметров подключения к базе данных. В скобках при этом отображаются значения по умолчанию. Если просто нажать Enter они будут приняты как текущие.

C:\java\locarus>java -jar locarus-server.jar -test
Locarus Server, version 3.0.13/JRE
Copyright (c) 2011, Locarus Co. LTD, Chelyabinsk, Russia. All rights reserved
Written by Dmitry G. Qusnetsov <murray@locarus.ru>
Enter the DataBase settings
Host (localhost):
Name (locarus):
Schema (main):
Login (locarus):
Password (locarus):
DataBase settings saved

После этого сервер запускается. На экране можно видеть примерно следующее:

Synchronizing time...
Real time 2011-10-19 11:51:16.467
Starting TCP listener at port 1130
Starting UDP listener at port 1129
Starting TCP listener at port 1128
Starting TCP listener at port 1129
Starting TCP listener at port 1333

Server started at 2011-10-19 11:51:16.837

• Смотрим логи в подкаталоге ./logs. Если все в порядке, и в логах нет сообщений о критических Exception, запускаем сервер сервисом (службой, демоном, как угодно назовите), в случае если у вас установлен wrapper (см. п. 6):

java -jar locarus-server.jar -auto

Запускаем SOAP сервер (следим за сообщениями об ошибках):

java -jar locarus-soap.jar -auto