Installazione di OpenBravo 2.4 su CentOS con Tomcat 5.5, Ant 1.7 e PostgreSQL

Questa guida spiega come scaricare e installare manualmente Apache Tomcat 5.5, Apache Ant 1.7 e OpenBravo ERP 2.4 su una macchina CentOS. Include i comandi principali, le risposte da fornire all’installer testuale e una checklist di verifica e troubleshooting per mettere in produzione l’applicazione.

Sommario rapido

• Scaricare e posizionare Tomcat e Ant in /opt
• Avviare Tomcat e rendere persistente l’avvio
• Scaricare e avviare l’installer di OpenBravo 2.4
• Configurare PostgreSQL, utenti e parametri consigliati

3.3 Apache Tomcat 5.5

Non ho provato il pacchetto Tomcat presente nel repository CentOS; ho scaricato invece la versione ufficiale dal sito Apache e l’ho installata in /opt per avere controllo completo sulla versione.

Esempio di comandi eseguiti (mantenuti esattamente come nel sistema):

cd /opt

wget http://apache.cyberuse.com/tomcat/tomcat-5/v5.5.27/bin/apache-tomcat-5.5.27.tar.gz

tar xzf apache-tomcat-5.5.27.tar.gz

mv apache-tomcat-5.5.27 tomcat

Avviare il demone Tomcat e mandarlo in background:

/opt/tomcat/bin/startup.sh &

Rendere l’avvio persistente aggiungendo il comando a rc.local:

echo "/opt/tomcat/bin/startup.sh &" >> /etc/rc.local

Note utili

• Conservare la struttura di directory /opt/tomcat per facilitare aggiornamenti manuali.
• Se preferisci, puoi creare un servizio systemd invece di usare /etc/rc.local (consigliato per sistemi moderni).

3.4 Apache Ant 1.7

Per mantenere coerenza tra strumenti ho scaricato anche Apache Ant in /opt. Con questo approccio puoi rimuovere facilmente le directory esportate e reinstallare i pacchetti RPM stock forniti da CentOS in seguito, se necessario.

Comandi eseguiti:

cd /opt

wget http://apache.promopeddler.com/ant/binaries/apache-ant-1.7.1-bin.tar.gz

tar xzf apache-ant-1.7.1-bin.tar.gz

mv apache-ant-1.7.1 ant

Aggiungere ANT_HOME a /etc/rc.local per renderlo persistente e esportarlo nella sessione corrente:

echo "export ANT_HOME=/opt/ant" >> /etc/rc.local

export ANT_HOME=/opt/ant

Suggerimenti

• Verificare che /opt/ant/bin sia nel PATH se esegui comandi Ant senza il percorso completo.
• Per ambienti multiutente valuta di creare un file /etc/profile.d/ant.sh con l’export di ANT_HOME.

4. Download e installazione di OpenBravo 2.4

Sto usando OpenBravo 2.4 perché questa guida è stata testata con quella versione. Esiste una release più recente (2.5) che non è stata testata qui: provarla è a proprio rischio.

Scaricare l’installer in /tmp:

cd /tmp

wget http://surfnet.dl.sourceforge.net/sourceforge/openbravo/OpenbravoERP_2.40-linux-installer.bin

Rendere l’installer eseguibile:

chmod +x OpenbravoERP_2.40-linux-installer.bin

Eseguire l’installer:

./OpenbravoERP_2.40-linux-installer.bin

L’installer testuale guiderà l’installazione. Di seguito sono riportate le domande mostrate dall’installer con le risposte consigliate (“<–“ indica la risposta data durante l’installazione di riferimento):

Accettare la licenza:

Do you accept this license? [y/n]: <– y

Prima dell’installazione verranno poste alcune domande; rispondere come indicato di seguito.

Specificare la directory di installazione di Openbravo ERP:

Please specify the directory where Openbravo ERP will be installed

[/opt/OpenbravoERP]: <– ENTER

Directory per gli allegati di Openbravo:

Please specify a directory for the Openbravo ERP attachments

[/opt/OpenbravoERP/AppsOpenbravo/attachments]: <– ENTER

Modalità di installazione (Complete o Distributed):

Please select the installation mode you wish to perform

[1] Complete

The database and the application server in the same computer

[2] Distributed

The database and the application server in different computers

Please choose an option [1] : <– ENTER

Tipo di installazione (Standard o Development):

Please select the installation type you wish to perform

[1] Standard

Installs the database and sets up the application server.

Recommended.

[2] Development

Installs the database and and sets up the application server

through a compilation process.

Recommended for developers.

Please choose an option [1] : <– ENTER

Directory del JDK:

Please specify the directory where the JDK is located

[/opt/java]: <– ENTER

Posizione dell’eseguibile Ant:

Please specify the location where the Ant executable is located

[/opt/ant/bin/ant]: <– ENTER

Directory di Tomcat (se Tomcat è suddiviso in due directory, selezionare quella contenente webapps):

Please specify the directory where Tomcat is located.

[/opt/tomcat]: <– ENTER

Selezione del database (PostgreSQL o Oracle):

Please select a database

[1] PostgreSQL

[2] Oracle

Please choose an option [1] : <– ENTER

Directory dei binari PostgreSQL (psql, pg_restore, vacuumdb):

Please specify the directory where the binaries of the PostgreSQL installation are located (psql, pg_restore, vacuumdb)

[/usr/bin]: <– ENTER

Indirizzo IP del database PostgreSQL:

Database host [localhost]: <– ENTER

Porta del database PostgreSQL:

Database port [5432]: <– ENTER

Password dell’utente amministratore “postgres”:

Enter the password for your “postgres” administrator user

Password : <– testpassword

Retype password : <– testpassword

Nome del database PostgreSQL:

Please enter the name of the PostgreSQL database

Database name [openbravo]: <– ENTER

Nome utente per il database Openbravo:

Please enter a username for the Openbravo ERP PostgreSQL database

Username [tad]: <– admin

Password per il nuovo utente database:

Please enter a password for the new database user

Password : <– adminpassword

Retype password : <– adminpassword

Inserire un context name (usato nell’URL di accesso a Openbravo):

Enter a context name.

This is used in the URL to access Openbravo ERP:

http://:/context_name

Context name [openbravo]: <– openbravoerp

Formati data/ora preferiti:

Date format

[1] DD MM YYYY

[2] MM DD YYYY

[3] YYYY MM DD

Please choose an option [1] : <– ENTER

Date separator

[1] -

[2] /

[3] .

[4] :

Please choose an option [2] : <– ENTER

Time format

[1] 12h

[2] 24h

Please choose an option [2] : <– ENTER

Time separator

[1] :

[2] .

Please choose an option [1] : <– ENTER

Popolare il database con dati demo:

Should the installer populate the database with demo data?

[Y/n]: Y <– ENTER

Confermare per iniziare l’installazione:

Setup is now ready to begin installing Openbravo ERP on your computer.

Do you want to continue? [Y/n]: Y <– ENTER

L’installazione richiederà alcuni minuti; attendere fino al completamento.

Al termine comparirà un messaggio di conferma dello setup.

5. Testare l’installazione

Se tutto è andato a buon fine, puoi accedere a Openbravo tramite:

• http://www.example.com:8080/openbravoerp
• oppure http://192.168.1.1:8080/openbravoerp

Credenziali di default per il primo accesso (da cambiare subito dopo il login):

• Username: Openbravo
• Password: openbravo

Nota: non sono state incluse schermate in questa guida. Usa i link nella sezione collegamenti per ulteriore documentazione.

6. Collegamenti utili

• Openbravo: http://www.openbravo.com/
• CentOS: http://www.centos.org
• PostgreSQL 8.3 (repository yum): http://yum.pgsqlrpms.org

Criteri di accettazione

• Tomcat avviato e raggiungibile su porta 8080
• Ant configurato e ANT_HOME esportato
• Database PostgreSQL accessibile e con utente Openbravo creato
• Openbravo risponde all’URL di context indicato e permette il login con le credenziali iniziali

Checklist pre-produzione

• Cambiare le password di default (postgres, admin Openbravo)
• Disabilitare l’account di test o rimuovere demo data se non necessario
• Configurare un firewall per consentire solo le porte necessarie (80/443/8080 e porta DB solo tra host autorizzati)
• Configurare backup regolari del database PostgreSQL (pg_dump, pg_basebackup)
• Abilitare monitoring per Tomcat e risorse di sistema (CPU, RAM, disco)

Suggerimenti di sicurezza

• Non esporre direttamente Tomcat su Internet senza un reverse proxy (nginx o Apache HTTPD) con TLS.
• Eseguire Tomcat come utente non privilegiato.
• Applicare aggiornamenti di sicurezza al sistema operativo e al JDK.
• Limitare l’accesso alla porta del database solo agli host applicativi.

Risoluzione problemi comuni

• Tomcat non si avvia: controlla i log in /opt/tomcat/logs/catalina.out e verifica permessi su /opt/tomcat.
• Errore di connessione al DB: conferma host, porta, nome database e che il servizio PostgreSQL sia in ascolto su tale indirizzo (pg_hba.conf e postgresql.conf).
• L’installer si blocca: rieseguire con console separata e verificare spazio su disco e permessi di scrittura nelle directory specificate.

Alternative e varianti

• Usare i pacchetti RPM/DEB forniti dal sistema (yum/apt) per Tomcat e Ant per semplificare aggiornamenti e gestione dei servizi.
• Creare unità systemd per Tomcat e Ant invece di usare /etc/rc.local per integrazione con strumenti di orchestration.
• Per ambienti di sviluppo scegliere l’opzione “Development” dell’installer per compilare sorgenti locali.

Mini-metodologia per aggiornamenti

1. Effettuare snapshot o backup completi del database e dei file di configurazione.
2. Testare l’aggiornamento in un ambiente di staging che replica la produzione.
3. Applicare l’aggiornamento a bassa attività e monitorare i log.
4. Se si verifica un problema critico, ripristinare il backup e analizzare i log prima di procedere.

Ruoli e responsabilità (sintesi)

• Sysadmin: installazione di OS, Tomcat, Ant, backup e firewall
• DBA: gestione PostgreSQL, backup/restore, tuning
• Applicazione/DevOps: configurazione Openbravo, deploy, testing di integrazione

Fattbox con numeri chiave

• Porta web predefinita Tomcat: 8080
• Porta PostgreSQL predefinita: 5432
• Versioni citate: Tomcat 5.5.27, Ant 1.7.1, OpenBravo 2.4

Test di accettazione (basici)

• Verificare accesso all’URL del context e login con le credenziali iniziali.
• Creare e recuperare un record anagrafico per confermare operatività CRUD.
• Eseguire un backup del DB e ripristino su istanza di test.

Conclusione

Seguendo questi passi dovresti ottenere un’installazione funzionante di Openbravo 2.4 su CentOS con Tomcat 5.5 e Ant 1.7. Valuta di adattare l’approccio all’infrastruttura organizzativa (uso di package manager, systemd, ambienti di staging) per mantenere la manutenzione nel tempo.