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

Версия 13:12, 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