Instalação do Openbravo 2.4 com Tomcat, Ant e PostgreSQL no CentOS

Visão geral

Este guia descreve os comandos e as opções usados para instalar manualmente o Openbravo ERP 2.4 em um sistema CentOS, usando Tomcat 5.5 e Ant 1.7 instalados a partir dos arquivos binários. Mantemos os caminhos padrão em /opt para fácil remoção ou substituição por pacotes RPM posteriormente.

Importante: este Howto foi testado com Openbravo 2.4. Há uma versão 2.5 disponível, mas não foi testada neste guia — use sob sua responsabilidade.

Pré-requisitos rápidos

• Acesso root ou sudo.
• Java JDK instalado (ex.: /opt/java).
• PostgreSQL disponível (local ou remoto).
• Conexão de rede para downloads.

1. Apache Tomcat 5.5

Eu não testei a versão empacotada do Tomcat no repositório do CentOS; em vez disso, baixe e instale a partir do site oficial. Execute os passos a seguir como root ou com sudo:

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

Inicie o daemon do Tomcat e envie-o para o background:

/opt/tomcat/bin/startup.sh &

Para iniciar o Tomcat no boot, adicione ao rc.local:

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

Nota: por segurança, considere criar um usuário de sistema não-root para executar o Tomcat e ajustar permissões em /opt/tomcat.

2. Apache Ant 1.7

Baixei o Ant binário para manter consistência com a instalação manual:

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

Adicione a variável ANT_HOME ao rc.local para persistir no boot:

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

E exporte na sessão atual:

export ANT_HOME=/opt/ant

Observação: para uma configuração mais limpa, coloque a exportação em /etc/profile.d/ant.sh e ajuste o PATH para incluir $ANT_HOME/bin.

3. Executando o instalador do Openbravo 2.4

Crie um diretório temporário e baixe o instalador do SourceForge:

cd /tmp

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

Dê permissão de execução:

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

Execute o instalador:

./OpenbravoERP_2.40-linux-installer.bin

O instalador será baseado em texto e fará perguntas interativas. Abaixo está uma tradução orientativa das opções e respostas usadas no teste que funcionou para este guia.

Aceite a licença pressionando ENTER para rolar as seções e digite yes quando solicitado.

Perguntas e respostas orientativas (pressione ENTER para aceitar o valor entre colchetes):

• Diretório de instalação do Openbravo ERP
  • [ /opt/OpenbravoERP ] : <– ENTER
• Diretório para attachments
  • [ /opt/OpenbravoERP/AppsOpenbravo/attachments ] : <– ENTER
• Modo de instalação
  • Opções: 1 Complete (BD e app no mesmo host), 2 Distributed
  • Escolha: [1] : <– ENTER
• Tipo de instalação
  • Opções: 1 Standard (recomendada), 2 Development (compila fonte)
  • Escolha: [1] : <– ENTER
• Localização do JDK
  • [ /opt/java ] : <– ENTER
• Localização do executável Ant
  • [ /opt/ant/bin/ant ] : <– ENTER
• Diretório do Tomcat (pasta que contém webapps)
  • [ /opt/tomcat ] : <– ENTER
• Banco de dados
  • [1] PostgreSQL [2] Oracle
  • Escolha: [1] : <– ENTER
• Diretório dos binários do PostgreSQL (psql, pg_restore, vacuumdb)
  • [ /usr/bin ] : <– ENTER
• Endereço IP do banco de dados
  • Database host [ localhost ] : <– ENTER
• Porta do PostgreSQL
  • Database port [ 5432 ] : <– ENTER
• Senha do usuário administradores postgres
  • Password : <– (digite a senha do administrador postgres)
  • Retype password : <– (repita)
• Nome do banco de dados PostgreSQL para Openbravo
  • Database name [ openbravo ] : <– ENTER
• Nome de usuário para a base Openbravo
  • Username [ tad ] : <– admin
• Senha para o novo usuário do banco
  • Password : <– (senha a sua escolha)
  • Retype password : <– (repita)
• Nome do contexto (usado na URL: http://:/context_name)
  • Context name [ openbravo ] : <– openbravoerp
• Formatos de data e hora (opções traduzidas)
  • Formato de data: [1] DD MM YYYY [2] MM DD YYYY [3] YYYY MM DD
  • Separador de data: [1] - [2] / [3] . [4] : (escolha [2])
  • Formato de hora: [1] 12h [2] 24h (escolha [2])
  • Separador de hora: [1] : [2] . (escolha [1])
• Popular o banco com dados de demonstração?
  • [Y/n] : Y <– ENTER

Quando solicitado a continuar, confirme com Y. O instalador mostrará uma barra de progresso e, ao final, informará que a instalação foi concluída.

4. Testando a instalação

Se tudo ocorreu bem, acesse o Openbravo pelo navegador em:

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

Credenciais iniciais de login (padrão de teste):

• Usuário: Openbravo
• Senha: openbravo

Importante: por segurança troque a senha padrão imediatamente e verifique permissões do diretório de attachments.

Critérios de aceitação

• A página de login do Openbravo é exibida no navegador no contexto definido.
• É possível autenticar com usuário e senha fornecidos.
• O banco de dados PostgreSQL contém os schemas e tabelas do Openbravo após a instalação.
• O Tomcat está em execução como serviço (não como root) e responde na porta 8080.

Plano de reversão (rollback)

• Parar o Tomcat: /opt/tomcat/bin/shutdown.sh
• Remover diretórios criados: rm -rf /opt/OpenbravoERP /opt/tomcat /opt/ant (apenas se tiver certeza)
• Remover usuário e banco do PostgreSQL criado para Openbravo (pelo psql):
  • DROP DATABASE openbravo;
  • DROP ROLE ;
• Reverter alterações em /etc/rc.local e variáveis de ambiente adicionadas.

Checklist por função

• Administrador de sistema
  • Validar requisitos do SO e Java
  • Criar usuário não-root para Tomcat e ajustar owners/permissions
  • Configurar firewall para permitir porta 8080 (se necessário)
  • Configurar backup do banco de dados
• Administrador de banco de dados
  • Garantir acesso psql, executar pg_restore se necessário
  • Monitorar conexões e desempenho
• Desenvolvedor
  • Verificar ANT_HOME e que ant esteja no PATH
  • Testar compilação no modo Development (se usar)

Problemas comuns e correções rápidas

• Tomcat não inicia: verifique JAVA_HOME, permissões em /opt/tomcat e logs em /opt/tomcat/logs/catalina.out.
• Erro de conexão com PostgreSQL: confirme host, porta, usuário, senha e que psql está no diretório informado.
• Instalador trava em compilação: verifique ANT_HOME e memória disponível (swap).

Dicas de segurança

• Não execute Tomcat como root; crie um usuário dedicado.
• Alterar senhas padrão imediatamente.
• Restringir acesso ao console administrativo do Tomcat e ao diretório de attachments.
• Habilitar firewall (iptables/firewalld) e, se possível, colocar o servidor Web por trás de um proxy reverso autenticado.

Mini-metodologia de implantação (3 etapas)

1. Preparar ambiente: Java, PostgreSQL, usuários e backups.
2. Instalar componentes: Tomcat, Ant, Openbravo. Testes locais.
3. Hardening e monitoramento: trocar senhas, configurar backups, revisar logs.

Glossário rápido

• Tomcat: servidor de aplicações Java que hospeda a interface web do Openbravo.
• Ant: ferramenta de construção (build) usada para compilar e empacotar partes da aplicação.
• Context name: segmento da URL que identifica a aplicação (ex.: openbravoerp).

Links úteis

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

Resumo final

Seguindo os passos deste guia você terá um ambiente Openbravo 2.4 funcional em CentOS com Tomcat 5.5 e Ant 1.7. Priorize segurança (usuários não-root, senhas fortes e firewall) e teste o rollback antes de colocar em produção.