Предварительный заказ книги по системе

Установка Adempiere на Linux (OpenSUSE 11)
Хороший пошаговый туториал есть в разделе документации - InstallationGuide_Thai.zip. На то, что язык комментариев закорючками внимания можно почти не обращать - там в основном скришоты и вставки с командами латиницей.
-1. Установить необходимые пакеты из стандартного репозитория OpenSUSE
postgresql-server
postgresql-jdbc
java-1_5_0-sun (важно не 1.6!!!)

java-1_5_0-sun-devel

В OpenSUSE 11 версия PostgreSQL 8.3

0. Запустить сервер postgres

sudo /etc/init.d/postgresql start
Initializing the PostgreSQL database at location /var/lib/pgsql/data done
Starting PostgreSQL done

1. Создать базу данных и пользователя для нее
Зайти как пользователь postgres:
стать рутом
>su

стать постгресом без ввода пароля (залогиниться пользователем postgres просто так не получится - так сделано из соображений безопасности именно в OpenSUSE)
#su - postgres

Создать пользователя и базу данных (пользователь должен быть админ, иначе дальше будут ошибки)
параметр -P тоже важен, чтобы пароль ввести прямо сейчас

~> createuser adempiere -P
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) y
CREATE ROLE
~> createdb adempiere -e unicode
CREATE DATABASE adempiere;
CREATE DATABASE
COMMENT ON DATABASE adempiere IS 'unicode';
COMMENT
2. Установить pljava и заодно настроить доступ к серверу postgres
Готового пакета pljava в момент написания данной инструкции ни в официальном, ни в одном из неофицильных репозиториев OpenSUSE не было, поэтому эту библиотеку нужно скачать с официальной страницы загрузки проекта - нужно скачать версию, соответсвующую установленной версии postgresql (в OpenSUSE 11 это 8.3) и архитектуре системы (i386/x86_64)
Распаковать скачаный архив в любое место в системе (например в /usr/local/pljava)

2.1 Открыть postgresql.conf - /var/lib/pgsql/data - через файловый менеджер krusader можно зайти только рутом, в консоли можно пользователем postgres - см наверху

Добавить записи из инструкции, только исправить
pljava.classpath = '/usr/local/pljava/pljava.jar'

#---------------------------------------------------------------------------
# CUSTOMIZED OPTIONS
#---------------------------------------------------------------------------
custom_variable_classes = 'pljava'
# list of custom variable class names
# define the class path that the JVM will use when loading the
# initial library. Only meaningful for non GJC installations
#
pljava.classpath = '/usr/local/pljava/pljava.jar'
# Set the size of the prepared statement MRU cache
#
#pljava.statement_cache_size = 10
# If true, lingering savepoints will be released on function exit. If false,
# the will be rolled back
#
pljava.release_lingering_savepoints = true
# Define startup options for the Java VM.
#
pljava.vmoptions = '-Xmx64M -Dbackchannel.port=48'
# Setting debug to true will cause the postgres process to go
# into a sleep(1) loop on its first call to java. This is
# only useful if you want to debug the PLJava internal C code.
#
pljava.debug = false

Изменить существующую запись:
dynamic_library_path = '/usr/local/pljava'

2.2 Там же
listen_addresses = '*' - слушать все адреса в сети - потом подумать как лучше задать с т.зр безопасности
port=5432

2.3 !!!!!!! Разрешить доступ к серверу Postgres - в файле /var/lib/pgsql/data/pg_hba.conf
поменять:
#local all all ident sameuser
local all all trust
(это для локальных логинов) и

# IPv4 local connections:
#host all all 127.0.0.1/32 ident sameuser
host all all 127.0.0.1/32 trust
это для соединений через сокеты (например через jdbc)

иначе будет ошибка: psql: FATAL: Ident authentication failed for user "adempiere"

Добавить еще (означает мой хост benderamp):
host all all 127.0.0.2/32 trust
иначе будет ошибка
org.postgresql.util.PSQLException: FATAL: no pg_hba.conf entry for host "127.0.0.2", user "adempiere", database "adempiere", SSL off

Добавить в конец (полагаю пригодится, если сервер БД и Adempiere будут на разных машинах физически)
host all all 192.168.1.4 255.255.255.0 trust

2.4 Сделать доступными необходимые библиотеки java для сервера Postgres
Для нормальной работы с pljava postgres обязательно должен иметь доступ к некоторым библиотекам из установленной в системе Java - на моей 64й-битной системе c Java, установленной из non-oss репозитория, команда для экспорта этих библиотек выглядит следующим образом:

рутом:
#export LD_LIBRARY_PATH=/usr/lib64/jvm/java/jre/lib/amd64:/usr/lib64/jvm/java/jre/lib/amd64/native_threads:/usr/lib64/jvm/java/jre/lib/amd64/server
#/etc/init.d/postgresql restart
Для 32х битной системы эти пути будут немного отличаться.
-------------------
Важно! В дальнейшем при запуске сервера postgres ВСЕГДА нужно делать
export LD_LIBRARY_PATH=/usr/lib64/jvm/java/jre/lib/amd64:/usr/lib64/jvm/java/jre/lib/amd64/native_threads:/usr/lib64/jvm/java/jre/lib/amd64/server

и после этого уже
/etc/init.d/postgresql start

просто '/etc/init.d/postgresql start' будет недостаточно - система запустится и даже внешне будет выглядеть работающей, но например не будут появляться списки товаров. См: http://www.compiere.com.ua/modules.p...iewtopic&t=155

При этом в логе будет видно ошибку, связанную с загрузкой pljava.so - см Инструменты/Настройки/ последняя закладка "Ошибки"
(лог файл - Adempiere/issues/pljava-error-traceInfo.log)
Команду экспорта библиотек можно добавить или в один из стартовых скриптов системы, или модифицировать системный скрипт запуска сервера postgres, или использовать свой маленький скрипт для запуска postgres (2 строчки как наверху, только вместо restart будет просто start)
-------------------
2.5 Дальше добавить поддержку pljava в созданную базу данных:
#su - postgres
#java -cp /usr/local/pljava/deploy.jar:/usr/share/pgsql/postgresql-8.2-506.jdbc3.jar org.postgresql.pljava.deploy.Deployer -install -user adempiere -database adempiere
Выполнить команды внутри базы данных:
~> psql -U adempiere -d adempiere
Welcome to psql 8.2.6, the PostgreSQL interactive terminal.

Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit

adempiere=# CREATE SCHEMA adempiere;
CREATE SCHEMA
adempiere=# SET search_path TO adempiere,sqlj;
SET
adempiere=# SELECT sqlj.install_jar('file:///usr/local/Adempiere/lib/sqlj.jar', 'sqlj', true);
install_jar
-------------

(1 row)

adempiere=# select sqlj.set_classpath('adempiere','sqlj');
set_classpath
---------------

(1 row)

3. Создать первоначальную структуру базы
Для этого нужно загрузить в нее дамп, которые поставляется с дистрибутивом Adempiere
Нужно войти в каталог, куда был распакован архив Adempiere/data
и выполнить в нем команду:
>psql -U adempiere -d adempiere < Adempiere_pg.dmp
Подождать, когда она выполнится это займет некоторое время, при этом будет выведено множество сообщиний по типу таких:
SET
SET
SET
SET
SET
........
GRANT
GRANT
REVOKE
REVOKE
GRANT
GRANT
4. Запустить скрипт RUN_setup.sh из каталога Adempiere
Значения должны быть примерно следующие (benderamp - имя текущего компьютера в сети - должно быть обязательно задано в сетевых настройках системы, localhost в данном случае использовать нельзя)

Нажать кнопку Save и подождать некоторое время, пока закончится процесс первоначальной настройки системы (лог текущих процессов можно увидеть в терминале, из которого был запущен скрипт RUN_setup - там же будет видно сообщения об ошибках, если они произойдут)
Если все закончилось хорошо, после этого в отдельном терминале можно запустить сервер Adempiere - можно поместить все эти команды в отдельный скрипт - adepiere_server.sh:
export JAVA_HOME=/usr/lib64/jvm/java-1.5.0
export ADEMPIERE_HOME=/home/benderamp/apps/Adempiere
cd $ADEMPIERE_HOME/utils
./RUN_Server2.sh
Если в логе запуска ошибок не видно, можно запустить клиента в другом терминале (на будущее можно тоже создать скрипт adempiere_client.sh):
export JAVA_HOME=/usr/lib64/jvm/java-1.5.0
export PATH=$JAVA_HOME/bin:$PATH
export ADEMPIERE_HOME=/home/benderamp/apps/Adempiere
cd $ADEMPIERE_HOME
./RUN_Adempiere.sh
Должно появиться окно входа в Adempiere с предложением ввести имя пользователя и пароль:

При первом запуске здесь придется опять задать еще некоторые настройки (возможно это баг, который будет исправлен в следующих версиях, тк. эти значения уже вводили в диалоге URN_setup): нужно кликнуть на поле host и в открывшемся диалоге ввести значения для сервера приложений Adempiere и базы данных:

Если Test Application Server и Test Database завершились успешно, можно вернуться в диалог входа в систему и начать с ней работу (System:System для начала настройки системы, или как GardenAdmin:GardenAdmin / GardenUser:GardenUser для ознакомления с тестовой конфигурацией).