Openbravo environment installation/it

Introduzione

Questo articolo spiega in dettaglio come installare e configurare l'intero stack richiesto per Openbravo ERP da eseguire :

• PostgreSQL or Oracle database
• Sun Java Development Kit (JDK)
• Apache Tomcat
• Apache Ant

I passi di installazione di ogni componente sono spiegati per i seguenti sistemi operativi :

• Microsoft Windows
• Debian Etch/Lenny/Sid
• Ubuntu/Kubuntu
• Linux Mint 4.0 Daryna
• Gentoo Linux 2007.0
• FreeBSD 6.2/6.3
• Fedora Core 7/8
• CentOS 4/5

Database PostgreSQL

Openbravo ERP supporta PostgreSQL come engine di database.

• La versione PostgreSQL 8.2.x è stata un grosso impulso a livello di performance (i tempi compilazione saranno all'incirca 3 volte più veloci ), dunque è raccomandato di usare versioni superiori alla 8.1.x.
• La versione PostgreSQL 8.3.x sarà pienamente supportata da Openbravo ERP 2.40, è più veloce della 8.2.x e dunque raccomandata.

Per la documentazione e i tutorials PostgreSQL ci sono un paio di riferimenti :

• PostgreSQL Documentation
• Postgres rocks documentation

Microsoft Windows

Seguire questa guida per installare il database PostgreSQL su Microsoft Windows.

Debian (Ubuntu/Kubuntu/Linux Mint)

Per installare il package:

sudo apt-get install postgresql-8.2

Per impostare la password postgres:

sudo su - postgres -c psql
alter role postgres with password 'new_password';
\q

Gentoo

Per installare il package:

echo dev-db/postgresql >> /etc/portage/package.keywords
echo dev-db/libpq >> /etc/portage/package.keywords
emerge -av postgresql
emerge --config =postgresql-8.2.7 #Portage will tell you which version to use
/etc/init.d/postgresql start
rc-update add postgresql default

Per impostare la password postgres:

psql -U postgres
alter role postgres with password 'new_password';
\q
sed -i 's/trust$/md5/' /var/lib/postgresql/data/pg_hba.conf
/etc/init.d/postgresql reload

FreeBSD

Per installare il package:

cd /usr/ports/databases/postgresql82-server
make clean install
echo 'postgresql_enable="YES"' >> /etc/rc.conf
/usr/local/etc/rc.d/postgresql initdb
/usr/local/etc/rc.d/postgresql start

Per creare l'utente postgres:

psql -d postgres -U pgsql
create role postgres with password 'new_password';
alter role postgres login superuser createdb createrole;
\q

Fedora

Per installare il package:

yum install postgresql-server

Per creare il database iniziale:

/etc/init.d/postgresql initdb
/etc/init.d/postgresql start

Per impostare la password postgres:

sudo sed -i 's/ident sameuser$/trust/' /var/lib/pgsql/data/pg_hba.conf
sudo /etc/init.d/postgresql reload
psql -U postgres
alter role postgres with password 'new_password';
\q
sudo sed -i 's/trust$/md5/' /var/lib/pgsql/data/pg_hba.conf
sudo /etc/init.d/postgresql reload

CentOS 5

Per installare il package (come utente root ):

# yum install postgresql postgresql-server

Per creare il database iniziale:

# chkconfig postgresql on
# service postgresql start

Output

Initializing database:                                     [  OK  ]
Starting postgresql service:                               [  OK  ]

Per impostare la password postgres (as root user):

# sed -i 's/ident sameuser$/trust/' /var/lib/pgsql/data/pg_hba.conf
#service postgresql reload
#service postgresql restart
#psql -U postgres

in psql shell (come utente postgres)

postgres=# alter role postgres with password 'new_password';
ALTER ROLE
postgres=#\q

in bash (come utente root )

#sed -i 's/trust$/md5/' /var/lib/pgsql/data/pg_hba.conf
#service postgresql reload
#service postgresql restart

Verifica (come utente normale):

$ psql -U postgres
Password for user postgres: (type new_password)
Welcome to psql 8.1.11, 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
postgres=#

OpenSuse 10.2+

Per installare il package :

install via Yast

Per creare il database iniziale:

/etc/init.d/postgresql start

Modificare il file /var/lib/pgsql/pg_hba.conf aggiungendo questa riga alla fine del file :

host      all       all         xxxx   255.255.255.255  trust

Dove xxxx è l'ip address della macchina dove è in esecuzione Postgres.

Dunque creare una shortcut come segue :

ln -sf /usr/bin/pgsql /usr/bin/postgres

(Quando l'installer chiede il file binario di Postgres inserire /usr/bin)

Database Oracle

Openbravo ERP supporta anche Oracle 10g Express Edition (XE) come engine di database.

Ecco una serie di link di documentazione e tutorials su Oracle XE :

• Oracle Database 10g Release 2 Documentazione
• Oracle Database Express Edition Guida introduttiva
• Oracle Database 10g Express Edition Tutorial
• Oracle XE Database Administration su Debian

Microsoft Windows

Download e installare Oracle 10g XE database.

Aggiungere le variabili di ambiente ORACLE_HOME e ORACLE_SID :

• Click-destro su My Computer quindi selezionare Properties.
• In System properties pop-up window, click on Advanced tab then click on Environment Variables button.
• Click on New button and type:
  • ORACLE_HOME as Variable name.
  • Oracle XE installation directory in Variable value text field (usually C:\oraclexe\app\oracle\product\10.2.0\server).
• Click on New button and type:
  • ORACLE_SID as Variable name.
  • XE in Variable value text field for Express Edition.
• Edit PATH environment variable and add the path to bin folder inside your Oracle XE installation directory (usually C:\oraclexe\app\oracle\product\10.2.0\server\bin).

Check it's up and running by either opening http://127.0.0.1:8080/apex in a web browser.

Debian (Ubuntu/Kubuntu/Linux Mint)

Seguire questa guida per installare Oracle 10g XE database su Debian (Ubuntu/Kubuntu).

Gentoo

Please follow this guide to install Oracle 10g XE database on Gentoo.

FreeBSD

Fedora

OpenSuse 10.2+

Please follow this guide to install Oracle 10g XE database on OpenSuse.

Sun JDK

Sun Java Development Kit versione 1.5 (chiamata anche JDK 5.0) e 1.6 (chiamata anche JDK 6.0) sono supportate da Openbravo ERP. Questa guida usa JDK 1.5.

Microsoft Windows

Download e installare JDK 1.5.

Aggiungere la variabile di ambiente JAVA_HOME :

• Click destro su My Computer quindi selezionare Proprietà.
• In Proprietà del Systema appare una finestra di pop-up, cliccare su Avanzate quindi cliccare sul pulsante Variabili di Ambiente .
• Cliccare sul pulsante Nuovo e scrivere:
  • JAVA_HOME as Nome di variabile.
  • La directory di installazione del JDK in Valori della Variabile (di solito C:\Java\jdk1.5).
• Modificare la variabile di ambiente PATH e aggiungere il path nella cartella bin all'interno della directory di installazione del JDK (di solito C:\Java\jdk1.5\bin).

Debian (Ubuntu/Kubuntu/Linux Mint)

• Utenti Debian: è necessario aggiungere i repositories Apt instabili/non-free per installare sun-java-jdk5.
• Utenti Ubuntu/Kubuntu: aggiungere repository Multiverse per installare sun-java-jdk5. Dalla Versione 7.10 è abilitato per default. Far riferimento a : https://help.ubuntu.com/ubuntu/desktopguide/C/programming.html
• Utenti Linux Mint: il repository Multiverse dovrebbe essere già installato di default. Non è necessario aggiungere questo repository.

Per installare il package:

sudo apt-get install sun-java5-jdk

E per impostarlo come JDK di default :

sudo update-java-alternatives -s java-1.5.0-sun

Creare la variabile JAVA_HOME :

echo 'JAVA_HOME="/usr/lib/jvm/java-1.5.0-sun"' | sudo tee -a /etc/environment

Per rendere questa variabile disponibile nel terminale corrente :

source /etc/environment

Per rendere disponibili questa variabile al sistema , riavviare la sessione utente.

Gentoo

To install the package:

emerge -av sun-jdk

And to set it as the default JDK:

java-config -S sun-jdk-1.5

Portage sets the JAVA_HOME variable for you.

FreeBSD

To install the package:

cd /usr/ports/java/diablo-jdk15
make clean install

Due to license issues, Ports will tell you to download the package by hand. It will give you the links where to download the files. Afterwards, copy the file into /usr/ports/distfiles and launch the installation again:

cd /usr/ports/java/diablo-jdk15
make clean install

And to set the JAVA_HOME variable:

echo 'JAVA_HOME=/usr/local/diablo-jdk1.5.0' >> /etc/profile

Fedora

Download the latest Java 2 Platform Standard Edition. If you have problems downloading this due to Sun's UI that requires you to accept the license and gives you a cookie, use the following mirror:

wget http://distfiles.gentoo.org/distfiles/jdk-1_5_0_13-dlj-linux-i586.bin

Position yourself in /opt folder and execute (as root) the downloaded installer using:

sh jdk-1_5_0_13-dlj-linux-i586.bin --unpack

To set the environment variables:

echo 'export JAVA_HOME=/opt/jdk1.5.0_13' > /etc/profile.d/jdk.sh
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile.d/jdk.sh

You have to source the file you just created by typing:

source /etc/profile.d/jdk.sh

Test if Java environment is successfully installed by typing in this in the shell:

java -version

OpenSuse 10.2+

Please follow this guide to install Sun JDK on OpenSuse.

Apache Tomcat

Openbravo ERP richiede la versione Apache Tomcat 5.5 come servlet container.

Microsoft Windows

Download e installare Apache Tomcat 5.5.

Aggiungere le variabili di ambiente CATALINA_HOME, CATALINA_BASE e CATALINA_OPTS :

• Click destro su My Computer quindi selezionare Proprietà.
• In Proprietà del Systema appare una finestra di pop-up, cliccare su Avanzate quindi cliccare sul pulsante Variabili di Ambiente .
• Cliccare sul pulsante Nuovo e scrivere:
  • CATALINA_HOME come Nome di variabile.
  • La directory di installazione di Apache Tomcat in Valori della Variabile (di solito C:\Apache Software Foundation\Tomcat 5.5).
• Cliccare sul pulsante Nuovo e scrivere:
  • CATALINA_BASE come Nome di variabile.
  • La directory di installazione di Apache Tomcat in Valori della Variabile

(di solito C:\Apache Software Foundation\Tomcat 5.5).

• Cliccare sul pulsante Nuovo e scrivere:
  • CATALINA_OPTS come Nome di variabile.
  • -Xms384M -Xmx512M -XX:MaxPermSize=256M in Valori della Variabile .
• Modificare la Variabile di Ambiente PATH e aggiungere il path della cartella bin nella directory di di installazione di Apache Tomcat (di solito C:\Apache Software Foundation\Tomcat 5.5\bin).

Check it's up and running by either opening http://localhost:8080 in a web browser.

Debian (Ubuntu/Kubuntu/Linux Mint)

Per installare il package:

sudo apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps
sudo rm /var/log/tomcat5.5/catalina.out
sudo /etc/init.d/tomcat5.5 start

Controllare se è su Tomcat eseguendo in un web browser il link http://localhost:8180 on con nmap:

nmap localhost -p 8180

La porta dovrebbe essere aperta.

Per impostare le variabile CATALINA_HOME, CATALINA_BASE e CATALINA_OPTS :

echo 'CATALINA_HOME="/usr/share/tomcat5.5"' | sudo tee -a /etc/environment
echo 'CATALINA_BASE="/var/lib/tomcat5.5"' | sudo tee -a /etc/environment
echo 'CATALINA_OPTS="-server -Xms384M -Xmx512M -XX:MaxPermSize=256M"' | sudo tee -a /etc/environment

Per rendere questa variabile disponibile nel terminale corrente :

source /etc/environment

Per rendere disponibili questa variabile al sistema , riavviare la sessione utente.

// permissions for Openbravo ERP
grant codeBase "file:${catalina.home}/webapps/openbravo/-" {
  permission java.security.AllPermission;
};

sudo nano /etc/tomcat5.5/policy.d/20openbravo.policy

sudo /etc/init.d/tomcat5.5 restart

Gentoo

To install the package:

emerge -av tomcat

Due to some license restrictions by Sun, you'll have to download some packages by hand and copy them to /usr/portage/distfiles. Portage will tell you when.

Edit: All of the packages for Tomcat are now available in portage.

To start Tomcat:

/etc/init.d/tomcat-6 start
rc-update add tomcat-6 default

You can check that Tomcat is working by opening http://localhost:8080 in a web browser, or using nmap:

nmap localhost -p 8080

Set the CATALINA_HOME and CATALINA_BASE variables:

 touch /etc/env.d/99tomcat
 echo 'CATALINA_HOME=/usr/share/tomcat-6' >> /etc/env.d/99tomcat
 echo 'CATALINA_BASE=/var/lib/tomcat-6' >> /etc/env.d/99tomcat

To update the environment and make this variables system-wide available:

 env-update && source /etc/profile

Set the CATALINA_OPTS variable by editing the /etc/conf.d/tomcat-6 file:

 CATALINA_OPTS="-server -Xms384M -Xmx512M -XX:MaxPermSize=256M"

FreeBSD

To install the package:

cd /usr/ports/www/tomcat55
make clean install
echo 'tomcat55_enable="YES"' >> /etc/rc.conf
/usr/local/etc/rc.d/tomcat5.5 start

To set the CATALINA_HOME, CATALINA_BASE and CATALINA_OPTS variables:

echo 'export CATALINA_HOME=/usr/local/tomcat5.5' >> /etc/profile
echo 'export CATALINA_BASE=/usr/local/tomcat5.5' >> /etc/profile
echo 'export CATALINA_OPTS="-server -Xms384M -Xmx512M -XX:MaxPermSize=256M"' >> /etc/profile

Check it's up and running by either opening http://localhost:8180 in a web browser or with nmap:

nmap localhost -p 8180

Fedora

To install the package:

yum install tomcat5
/etc/init.d/tomcat5 start

Check it's up and running by either opening http://localhost:8080 in a web browser or with nmap:

nmap localhost -p 8080

The port should be opened.

To set the CATALINA_HOME, CATALINA_BASE and CATALINA_OPTS variables:

echo "export CATALINA_HOME=/usr/share/tomcat5" > /etc/profile.d/tomcat.sh
echo "export CATALINA_BASE=/var/lib/tomcat5" >> /etc/profile.d/tomcat.sh
echo "export CATALINA_OPTS=-server -Xms384M -Xmx512M -XX:MaxPermSize=256M" >> /etc/profile.d/environment

Logout and login again to make this variable system-wide.

OpenSuse 10.2+

Please follow this guide to install Apache Tomcat on OpenSuse.

Apache Ant

Apache Ant è un tool basato su Java utilizzato da Openbravo ERP per automatizzare la maggior parte dei task di sviluppo.

Microsoft Windows

Download e estrarre Apache Ant nel proprio sistema (per esempio, C:\Apache-Ant).

Aggiungere la variabile d'ambiente ANT_HOME :

• Edit PATH environment variable and add the path to bin folder inside your Ant directory (usually C:\Apache-Ant\bin).

• Click destro su My Computer quindi selezionare Proprietà.
• In Proprietà del Systema appare una finestra di pop-up, cliccare su Avanzate quindi cliccare sul pulsante Variabili di Ambiente .
• Cliccare sul pulsante Nuovo e scrivere:
  • ANT_HOME come Nome di variabile.
  • La directory di installazione di Ant in Valori della Variabile (di solito 'C:\Apache-Ant).
• Modificare la variabile di ambiente PATH e aggiungere il path nella cartella bin all'interno della directory di installazione di Ant (di solito C:\Apache-Ant\bin).

Debian (Ubuntu/Kubuntu/Linux Mint)

Per installare il package:

sudo apt-get install ant

Per impostare la variabile ANT_HOME :

echo 'ANT_HOME="/usr/share/ant"' | sudo tee -a /etc/environment

Per rendere disponibile questa variabile nel terminale in esecuzione :

source /etc/environment

Per rendere disponibili questa variabile al sistema , riavviare la sessione utente.

Gentoo

To install the package:

emerge -av dev-java/ant

It is necessary to make this link, otherwise the installer will fail:

ln -sf /usr/bin/ant /usr/share/ant-core/bin/ant

Portage sets the ANT_HOME variable for you.

FreeBSD

To install the package:

cd /usr/ports/devel/apache-ant
make clean install

With FreeBSD 6.2 you will need to create a symbolic link to ant:

ln -s /usr/local/bin/ant /usr/local/share/java/apache-ant/bin/ant

And use setenv to ensure the ANT_HOME variable is set correctly:

setenv ANT_HOME /usr/local/share/java/apache-ant

Fedora

To install the package:

yum install ant

To set the ANT_HOME variable:

sudo echo 'export ANT_HOME=/usr/share/ant' > /etc/profile.d/ant.sh

It is necessary to make this link, otherwise the installer will fail:

mkdir /usr/share/ant/bin
ln -sf /usr/bin/ant /usr/share/ant/bin/ant

Logout and login again to make this variable system-wide.

OpenSuse 10.2+

To install the package:

Install via Yast

To set the ANT_HOME variable:

sudo echo 'export ANT_HOME=/usr/share/ant' > /etc/profile.d/ant.sh

It is necessary to make this link, otherwise the installer will fail:

ln -sf /usr/bin/ant /usr/share/ant/bin/ant

Logout and login again to make this variable system-wide.

Performance e suggerimenti di sicurezza

Per ambienti di produzione , è consigliato fare alcune modifiche per migliorare la performance di Openbravo ERP and la sicurezza .

Questioni note

Di seguito una lista di questioni note durante l'installazione dell'ambiente Openbravo : Openbravo ERP installation issues.

Ant jar

Se avete dei file jar in conflitto con la directory lib di Ant (/usr/share/ant/lib), eseguendo ant install.source fallirà con errori di ClassNotFound.

La soluzione per questo è di rimuovere questi file dalla directory lib di Ant.

Jasper Reports

In alcune configurazioni per fare funzionare JasperReports , bisogna aggiungere alla variabile di ambiente CATALINA_OPTS il parametro -Djava.awt.headless=true. CATALINA_OPTS dovrebbe sembrare a qualcosa di simile a CATALINA_OPTS ="-server -Xms384M -Xmx512M -Djava.awt.headless=true".

Oracle

Oracle XE 10g setta per default il massimo numero di processi a 20. Questo modo causa a Openbravo di lanciare un eccezione indicando che non ha connessioni disponibili. Per fissare questo problema settare il valore di questo parametro a 150 eseguendo :

alter system set processes=150 scope=spfile;

nella linea di comando di Oracle loggandosi come sysdba e riavviare il database.

Problemi di hot-deployment su Tomcat su Windows

C'è una questione nota con Tomcat lavorando sotto Windows. Openbravo ERP esegue un hot-deploy del file openbravo.war in Tomcat ma su Windows spesso incontra problemi di file locking. Windows non lascerà Tomcat undeploy il file vecchio perchè i files sono bloccati dal Sistema Operativo . Tomcat ha meccanismi per permettere di evitare il locking. In Tomcat 5.5 e 6.0, questo meccanismo è disabilitato per default. Per abilitarlo modificare %CATALINA_BASE%\conf\context.xml. Trovare il root <context> e aggiungere questi due attributi :

<context antiJARLocking="true" antiResourceLocking="true" />

Openbravo ERP FAQ

Openbravo's ERP Frequently Asked Questions (FAQ).

Sommario

E' molto importante per installare e configurare propiamente tutto lo stack per evitare problemi durante l' Openbravo ERP installazione.

Supporto

Per ogni quesito o dubbio relativo all'installazione di Openbravo, postarli in Openbravo Help forum o collegarsi a #openbravo IRC channel in Freenode.