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

Версия 13:16, 6 мая 2015

Locarus Server, Version 3.1
Copyright (c) 2011-2013, Locarus Co. LTD, Chelyabinsk, Russia. All rights reserved
Written by Dmitry G. Qusnetsov <murray@locarus.ru>

Начальная установка

1. Качаем и устанавливаем Java Runtime Environment (JRE) под нужную операционку: http://www.oracle.com/technetwork/java/javase/downloads/index.html. Конкретно (может меняться с появлением новых версий) отсюда: http://www.oracle.com/technetwork/java/javase/downloads/java-se-jre-7-download-432155.html

2. Качаем и устанавливаем PostgreSQL под нужную операционку: http://www.postgresql.org/download

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

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

5. Разворачиваем дистрибутив сервера в папку, например /usr/local/locarus (linux) или c:\java\locarus (windows)

6. Определяем внешний IP адрес будущего сервера, либо доменное имя, получаем на этот адрес лицензию

• Нужно отправить запрос на лицензию в свободной форме на адрес help@locarus.ru, в заявке нужно указать IP адрес или доменное имя сервера, полное название организации, контактный e-mail и ФИО контактного лица.
• Лицензия предоставляется бесплатно. Срок действия лицензии 1 год.
• В ответ на запрос Вы получите файл лицензии, который нужно скопировать в основную папку сервера, например в /usr/local/locarus (linux) или c:\java\locarus (windows)

Тестирование

Делаем папку сервера текущей: Linux/Unix:

cd /usr/local/locarus

Windows:

cd c:\java\locarus

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

java -Xms1500m -Xmx1500m -Xss2048k -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 1129
Starting TCP listener at port 1333
Server started at 2011-10-19 11:51:16.837

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

Установка и запуск сервисом/демоном

Сервер может работать в режиме службы Windows или как демон в Linux/Unix. Система обеспечения этих режимов работы не входит в состав дистрибутива сервера, и может быть получена отдельно по ссылке http://service.locarus.ru/download/server-control.zip.

Поддерживаются платформы:

• aix-ppc-32/64
• freebsd-x86-32/64
• hpux-ia-32/64
• hpux-parisc-32/64
• linux-armel-32/64
• linux-ppc-32/64
• linux-x86-32/64
• macosx-universal-32/64
• solaris-sparc-32/64
• solaris-x86-32/64
• windows-x86-32/64

Система контроля сервера поставляется в виде архива, который необходимо развернуть в рабочую папку сервера вместе с вложенными папками.

ВНИМАНИЕ!
Управляющий скрипт версии враппера для Windows bin\server-control.bat 
в случае если в системе не определена переменная среды JAVA_HOME
пытается определить путь к исполняемым файлам Java. Для этого проверяет 
пути C:\Program Files\Java\jre7 и C:\Program Files (86)\Java\jre7
Если у вас другая версия Java или другой путь установки, необходимо
перед установкой и запуском сервера определить переменную среды JAVA_HOME:
set JAVA_HOME=C:\Program Files\Java\jre7

Для установки сервиса в систему и его старта сервисом нужно запустить: Linux/Unix:

/usr/local/locarus/bin/server-control install
/usr/local/locarus/bin/server-control start

Windows:

c:\java\locarus\bin\server-control install
c:\java\locarus\bin\server-control start

Остановка сервера Linux/Unix:

/usr/local/locarus/bin/server-control stop

Windows:

c:\java\locarus\bin\server-control stop

Принудительный перезапуск сервера: Linux/Unix:

/usr/local/locarus/bin/server-control restart

Windows:

c:\java\locarus\bin\server-control restart

Удалить демон/сервис из системы: Linux/Unix:

/usr/local/locarus/bin/server-control remove

Windows:

c:\java\locarus\bin\server-control remove

Обновление с версии старше 3.1.199.990

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

1. Остановить сервер командой

java -jar locarus-server.jar -stop

2. Удалить из системы службу сервера

java -jar locarus-server.jar -remove

3. Удалить приложение враппера, для этого нужно удалить папку locarus/wrapper и файл locarus/conf/wrapper-server.conf

4. Развернуть дистрибутив сервера в рабочую папку