ADempiere: instalar no Debian/Ubuntu

O processo de instalação do ADempiere (e ADempiere LBR) no Debian e derivados é bem simples. Mas antes de dar sequência:

1) Já instalou alguma coisa antes no Debian/Ubuntu?
2) Entende de comandos básicos de shell para Debian/Ubuntu?
3) Sabe usar apt-get?
4) Sabe usar sudo ou su?
5) Sabe usar o nano ou vi ou pico?

Se você respondeu não a qualquer uma das perguntas anteriores ou não faz ideia do que se trata, considere:

1) Contratar um profissional com conhecimento básico em Linux E/OU
2) Aprenda sobre os conceitos acima (extenso material no Google)

Nada impede de seguir os passos adiante mas digamos que sem os pré-requisitos acima, a instalação pode ser um pouco mais complicada. Aí dependerá basicamente do quanto você quer tentar e/ou pesquisar.

Observações:

• Os comandos abaixo podem ser diferentes dependendo da versão que você instalar de Java e PostgreSQL.
• Em caso de erros, ler a mensagem de erro ajuda em 100% dos casos

Vamos lá!

0) Abra o terminal

1) Instalar Java JDK: 

sudo apt-get install sun-java6-jdk

2) Instalar PostgreSQL: 

sudo apt-get install postgresql

3) Configurar arquivo postgresql.conf (não esquecer que fazer uma cópia de segurança do arquivo original): 
descomentar a linha listen_adresses e mudar os valores para ficar como 

listen_addresses = '*' 

4) Mudar o arquivo pg_hba.conf para aceitar conexões e  não exigir senha (não esquecer que fazer uma cópia de segurança do arquivo original): 
As operações nesse item são necessárias porque geralmente na instalação padrão do PostgreSQL no Debian/Ubuntu o usuário postgres não vem com senha definida. Então primeiro abrimos o acesso para depois mudarmos a senha. 

Uma outra opção (mais fácil até) seria fazer o login como o usuário postgres na máquina e entrar no banco. Se usar essa opção, ignore as ações 4.1 a 4.4

root@fernando:/home/curso# su postgres

postgres@fernando:/home/curso$ psql

psql (8.4.11)

Digite "help" para ajuda.

postgres=# \q

4.1) mudar linha 

local   all         postgres                          ident

para 

local   all         postgres                          trust

4.2) mudar linha 

local   all         all                          ident

para 

local   all         postgres                          trust

4.3 mudar linha

host    all         all         127.0.0.1/32          md5

para

host    all         all         127.0.0.1/32          trust

4.4 Adicionar linha (apenas se quiser adicionar acesso de qualquer máquina de qualquer IP ao banco de dados)

host    all         all         0.0.0.0/0          trust 

Obs: mais adiante mudaremos essas opções de trust para md5

5) Reiniciar o banco

/etc/init.d/postgresql restart

6) Mudar senha do usuário postgres

psql -U postgres template1

#alter role postgres with password 'suasenha';

\q (para sair)

7) Criar usuário adempiere (pelo prompt):

createuser -U postgres -P adempiere 

Obs: deixar o usuário adempiere como superuser

8) Criar linguagem plpgsql no banco (pelo prompt)

createlang -U postgres plpgsql template1

Obs: em algumas distribuições pode ser que esse comando não seja necessário

9) Criar banco adempiere (pelo prompt)

createdb -U adempiere adempiere

10) Importar dump do LBR (pelo prompt)

psql -U adempiere -d adempiere -f arquivodump

Obs: em arquivodump indicar o nome e caminho completo do arquivo do dump do ADempiere.

11) Descompactar o ADempiere (se for o ADempiere 3.6.0 , é o arquivo Adempiere_360LTS.zip) na pasta que desejar instalar 
usualmente na / ou /usr/local ou /opt

root@fernando:/# unzip Adempiere_360LTS.zip 

Obs: baixar o ADempiere original de http://sourceforge.net/projects/adempiere/files/ADempiere%20Official%20Release/

12) Copiar o arquivo do LBR
copiar o arquivo customization.jar para a pasta lib da pasta do ADempiere

cp /home/curso/Downloads/customization.jar /Adempiere/lib

Obs: o comando acima supõe que o customization.jar está na pasta Downloads e que o ADempiere foi descompactado na pasta /.

Obs2: a pasta ADempiere deve estar com as permissões de execução. Na dúvida execute 

chmod -R 755 /Adempiere

13) Executar o instalador e preencher os campos que aparecem na janela(supondo que está instalado no /usr/local)

13.1) Com Gerenciador Gráfico

cd /usr/local/Adempiere

./RUN_setup.sh

13.2) Sem gerenciador gráfico

Copie no diretório raiz do ADempiere o seguinte arquivo:

root@fernando:/Adempiere# cp AdempiereEnvTemplate.properties AdempiereEnv.properties

Você deve editar esse segundo arquivo e alterar os parâmetros de acordo com seu ambiente.

Depois de alterar os parâmetros execute o instalador:

root@fernando:/Adempiere# ./RUN_silentsetup.sh

14) Mudar o arquivo pg_hba.conf para aceitar conexões de qualquer IP e exigir senha: 

Mudar todas as linhas de onde estiver trust para md5. Deve ficar mais ou menos assim (exemplo da minha máquina):

# Database administrative login by UNIX sockets

local   all         postgres                          trust

# TYPE  DATABASE    USER        CIDR-ADDRESS          METHOD

# "local" is for Unix domain socket connections only

local   all         all                               md5

# IPv4 local connections:

host    all         all         127.0.0.1/32          md5

host    all         all         0.0.0.0/0          md5

# IPv6 local connections:

host    all         all         ::1/128               md5

15) Reiniciar o banco (pelo prompt)

/etc/init.d/postgresql restart

16) Testar o Servidor de aplicação (pelo prompt)

Inicie o servidor de aplicação

root@fernando:/Adempiere/utils# ./RUN_Server2.sh

Ao final do processamento deve aparecer uma mensagem como

12:37:10,143 INFO  [Server] JBoss (MX MicroKernel) [4.2.3.GA (build: SVNTag=JBoss_4_2_3_GA date=200807181417)] Started in 1m:34s:336ms

17) Usar

Acesse o endereço no browser conforme o que foi configurado na instalação (http://ip-host:porta/). No nosso caso foi

http://fernando:8088/

O resultado tem que ser algo como:

Agradecimentos a Peter Fill pela revisão.

Quer aprender mais? Acesse: http://cursoadempiere.conceptia.com.br