Instalação Odoo v8 em Ubuntu Server 14.04 LTS

⚠ Atenção: Este tutorial foi escrito com base na versão v.8.0 do Odoo, datada de janeiro de 2015. Desde então, tanto o Odoo quanto outras ferramentas relacionadas podem ter passado por atualizações e mudanças significativas. Isso pode tornar algumas instruções ou referências obsoletas. Para garantir que você está seguindo as orientações corretas, verifique sempre a documentação mais recente e os anúncios oficiais das ferramentas mencionadas.

Neste tutorial será apresentado como fazer a instalação padrão do Odoo v8 pelo Github, com isso, teremos sempre as últimas versões liberadas pela comunidade. Antes de seguir os passos abaixo, sugerimos ter uma instalação limpa do Ubuntu, com as configurações de rede já definidas.

• Instale o OpenSSH, que além de acesso ao servidor, permite também limitar potenciais ataques de força bruta:

  sudo apt-get install openssh-server

• Deve-se agora definir as configurações locais (Locale) do servidor. No terminal, execute os 4 comandos a seguir:

  export LANGUAGE=pt_BR.UTF-8

  export LANG=pt_BR.UTF-8

  sudo locale-gen pt_BR pt_BR.UTF-8

  sudo dpkg-reconfigure locales

Caso esteja acessando o servidor via SSH, após os comandos acima, desconecte-se (logout) e conecte-se novamente (login).

• Ainda no terminal, atualize o seu sistema:

  sudo apt-get update

  sudo apt-get dist-upgrade

• Crie o usuário “odoo” e que será o proprietário da aplicação e a sua respectiva pasta:

  sudo adduser --system --home=/opt/odoo --group odoo

• Instalar e configurar o serviço de banco de dados PostgreSQL:

  sudo apt-get install postgresql

• Deve-se agora configurar o usuário “odoo” no postgres, para isso, altere o usuário atual para postgres, a fim de ter os privilégios necessários para configurar a base de dados:

  sudo su - postgres

• Agora, crie o novo usuário do banco de dados. O usuário “odoo” terá direitos de acesso para se conectar, criar e eliminar bancos de dados. Anote a senha definida aqui, pois será necessário mais adiante:

  createuser --createdb --username postgres --no-createrole --no-superuser --pwprompt odoo

  Enter password for new role: ******* (Sua Senha para o usuário postgres 'odoo' )

  Enter it again: *******

• Saia do usuário postgres:

  exit

• Instalar git:

  sudo apt-get install git

• Instale as bibliotecas Python necessárias para o Odoo:

  sudo apt-get install python-dev python-yaml python-feedparser python-geoip python-imaging python-pybabel python-unicodecsv wkhtmltopdf libxml2-dev libxmlsec1-dev python-argparse python-babel python-cups python-dateutil python-decorator python-docutils python-feedparser python-gdata python-gevent python-greenlet python-jinja2 python-libxslt1 python-lxml python-mako python-markupsafe python-mock python-openid python-passlib python-psutil python-psycopg2 python-pychart python-pydot python-pyparsing python-pypdf python-ldap python-yaml python-reportlab python-requests python-simplejson python-six python-tz python-unittest2 python-vatnumber python-vobject python-webdav python-werkzeug python-wsgiref python-xlwt python-zsi python-dev libpq-dev poppler-utils python-pdftools antiword

• Instale as bibliotecas Python necessárias para o Odoo:

  sudo apt-get install python-pip #Necessário para o PIP

  sudo apt-get install python-setuptools #Para Python v3 (python3-setuptools)

  sudo pip install pyserial==2.7

  sudo pip install psycogreen==1.0

  sudo pip install pyusb==1.0.0b1

  sudo pip install qrcode==5.0.1

  sudo pip install Pillow==2.5.1

  sudo pip install boto==2.38.0

  sudo pip install oerplib==0.8.4

  sudo pip install jcconv==0.2.3

  sudo pip install pytz==2014.4

• 12. Para a instalação do WKHTMLtoPDF, necessário para geração dos arquivos PDF, deve-se escolher o download de acordo com o sistema operacional e arquitetura de seu sistema em http://wkhtmltopdf.org/downloads.html ou em http://download.gna.org/wkhtmltopdf/0.12/ . No nosso caso, o sistema operacional é Ubuntu 14.04 (Trusty) e a arquitetura é 64 bits. No momento, somente a versão 0.12.1 está funcional.

  cd /tmp

  wget http://download.gna.org/wkhtmltopdf/0.12/0.12.1/wkhtmltox-0.12.1_linux-trusty-amd64.deb #Altere o download se necessário

  sudo dpkg -i wkhtmltox-0.12.1_linux-trusty-amd64.deb

  sudo cp /usr/local/bin/wkhtmltopdf /usr/bin

  sudo cp /usr/local/bin/wkhtmltoimage /usr/bin

• Confira a versão do wkhtmltopdf, digitando o seguinte comando no terminal:

  wkhtmltopdf –version # Se a versão for 0.12.1, está correta.

• Altere para o usuário “odoo”. Com esse procedimento, vamos direto para a pasta /opt/odoo:

  sudo su - odoo -s /bin/bash

• Faça o download do corrente branch do odoo que está no github:

  git clone https://www.github.com/odoo/odoo --depth 1 --branch 8.0 --single-branch .

• Após finalizada a cópia, saia do usuário “odoo”:

  exit

• Deve-se agora criar um arquivo de configuração, baseado em um arquivo padrão e definir as respectivas permissões:

  sudo cp /opt/odoo/debian/openerp-server.conf /etc/odoo-server.conf

  sudo chown odoo: /etc/odoo-server.conf

  sudo chmod 640 /etc/odoo-server.conf

• Para permitir que o Odoo instale os módulos corretamente, deve-se alterar duas linhas nesse arquivo recém criado e adicionar uma terceira linha para o log. Use o seu editor de texto favorito: ex: sudo nano /etc/odoo-server.conf

  Altere "db_password = False" para “db_password = senha do postgres” (passo 6).

  Modifique a linha "addons_path = /usr/lib/python2.7/dist-packages/openerp/addons" para "addons_path = /opt/odoo/addons"

  Adicione a seguinte linha: logfile = /var/log/odoo/odoo-server.log

Mais adiante, voltaremos a editar esse arquivo para colocar o caminho da localização.

• Crie a pasta para o arquivo de log e defina o respectivo proprietário:

  sudo mkdir /var/log/odoo

  sudo chown -R odoo:root /var/log/odoo

• Criação do script de inicialização. Utilizaremos o script padrão (/opt/odoo/debian/init), pode ser baixado também em: https://raw.githubusercontent.com/odoo/odoo/8.0/debian/init

  cd /etc/init.d/ #Pasta padrão do Ubuntu dos scripts de inicialização

  sudo wget https://raw.githubusercontent.com/odoo/odoo/8.0/debian/init -O odoo-server

  sudo chmod 755 /etc/init.d/odoo-server #Permissão para executar arquivo

  sudo chown root: /etc/init.d/odoo-server #Usuário root como proprietário do arquivo

• Edite o arquivo /etc/init.d/odoo-server (ex.: sudo nano /etc/init.d/odoo-server)

  DAEMON=/usr/bin/odoo.py mudar para diretório /opt/odoo/odoo.py CONFIG=/etc/odoo/openerp-server.conf mudar para /etc/odoo-server.conf

• Podemos agora testar o servidor. Para iniciar o servidor Odoo, digite:

  sudo /etc/init.d/odoo-server start

• É posssível também verificar o arquivo de log e conferir como o servidor foi iniciado:

  cat /var/log/odoo/odoo-server.log

• Se arquivo de log estiver ok, aponte o seu navegador de internet para o seguinte endereço:

  http://IP_ou_domain:8069

• Para seguir os pŕoximos passos, pare o servidor Odoo, digitando:

  sudo /etc/init.d/odoo-server stop

Os próximos passos são necessários para a instalação da localização brasileira. Para facilitar o entendimento, vamos colocar os módulos na pasta /opt/odoo/localizacao.

• Altere para o usuário “odoo”. Com esse procedimento, vamos direto para a pasta /opt/odoo:

  sudo su - odoo -s /bin/bash

• Crie uma pasta chamada “localizacao” e acesse-a:

  mkdir localizacao

  cd localizacao

• Faça o download do branch 8.0 da localização que está no github:

  git clone https://github.com/oca/l10n-brazil.git --branch 8.0 --depth 1

• Download do branch 8.0 do “Acoount Fiscal Rule”, que são dependências da localização:

  git clone https://github.com/oca/account-fiscal-rule.git --branch 8.0 --depth 1

• Faça o download do branch 8.0 do “Eletronic Documents”, que são dependências da NFe:

  git clone https://github.com/odoo-brazil/odoo-brazil-eletronic-documents.git --branch 8.0 --depth 1

• Download do branch 8.0 do “Server Tools”, que são dependências, mantidas pela OCA:

  git clone https://github.com/OCA/server-tools --branch 8.0 --depth 1

• Após finalizado os downloads, saia do usuário “odoo”, retornando ao usuário padrão:

  exit

• Instalação do “Geraldo Reports”, necessário para relatórios pdf:

  cd /tmp

  git clone https://github.com/odoo-brazil/geraldo --branch master

  cd geraldo

  sudo python setup.py install

• Instalação do PySPED (e instalação manual da dependência pyxmlsec), necessário para NFe:

  cd /tmp

  wget http://labs.libre-entreprise.org/download.php/430/pyxmlsec-0.3.0.tar.gz

  tar xvzf pyxmlsec-0.3.0.tar.gz

  cd pyxmlsec-0.3.0

  sudo python setup.py install

  cd /tmp

  git clone https://github.com/odoo-brazil/PySPED.git --branch 8.0

  cd PySPED

  sudo python setup.py install

• Instalação do “pyxmlsec”, necessário para NFe:

  cd /tmp

  git clone https://github.com/odoo-brazil/pyxmlsec --branch master

  cd pyxmlsec

  sudo python setup.py install

• Após o download dos módulos, deve-se reconfigurar o arquivo de configurações. Use o seu editor de texto favorito: ex: sudo nano /etc/odoo-server.conf.

  addons_path = /opt/odoo/addons,/opt/odoo/openerp/addons,/opt/odoo/localizacao/l10n-brazil,/opt/odoo/localizacao/account-fiscal-rule,/opt/odoo/localizacao/odoo-brazil-eletronic-documents,/opt/odoo/localizacao/server-tools

Caso tenha algum outro módulo, este deve ser indicado em “addons_path”.

• Podemos agora testar o servidor. Para iniciar o servidor Odoo, digite:

  sudo /etc/init.d/odoo-server start

• É posssível também verificar o arquivo de log e conferir como o servidor foi iniciado:

  cat /var/log/odoo/odoo-server.log

• Se arquivo de log estiver ok, aponte o seu navegador de internet para o seguinte endereço:

  http://IP_ou_domain:8069

• Caso tenha funcionado corretamente, pode-se adicionar o script para que inicie automaticamente na inicialização do sistema:

  sudo update-rc.d odoo-server defaults

Agora é possível reiniciar o servidor que o Odoo iniciará automaticamente.

• Ao digitar o comando a seguir:

  ps aux | grep odoo

• Você deve ver uma linha similar a mostrada abaixo, informando que o servidor está funcionando.

  odoo 22743 0.2 9.3 147444 71392 ? Sl 01:30 0:05 python /opt/odoo/openerp-server -c /etc/odoo-server.conf

Nas próximas etapas, vamos criar o banco de dados e instalar os módulos necessários para a localização brasileira.

• Acesso o Oddo pelo seu navegador de internet:

  http://IP_ou_domain:8069

• Começaremos configurando o banco de dados, portanto, a tela que aparece defina o seguinte:

  *Senha da administração: mantenha a atual (admin)

  *Selecione nome da base de dados: database_odoo (ex: comdesk_odoo)

  *Carregar dados de demonstração: desmarcado

  *Idioma predefinido: Português (BR)

  *Escolha uma palavra-passe: Defina a sua senha

  *Confirmar senha: Mesma escolhida na etapa anterior

• Após a configuração do banco de dados, deve-se instalar os módulos básicos para o funcionamento do Odoo. Em “Configurações”, vá até “Módulos→Local Modules” e na listagem de módulos, instale os seguintes:

  CRM *Módulo CRM padrão.

  Gestão de Vendas * Módulo de vendas padrão. Escolha o plano de contas Brasileiro, moeda e impostos básicos de compra e venda.

  Online Biling *Módulo padrão de transações on-line.

  Contabilidade e Finanças * Módulo contábil padrão.

  Gestão de Armazém #Módulo de estoque padrão.

  Gestão de Compras #Módulo de compras padrão.

Demais módulos e dependências serão instalados automaticamente.

• Continuando com a instalação, deve-se agora instalar os módulos desenvolvidos pela comunidade brasileira (Akretion, Danimar, Kmee, etc.). Ainda em “Módulos→Local Modules”, remova o item “Aplicativos” do campo de pesquisa e para facilitar a instalação, defina a “visualização em lista” e ordene por “autor”.

• Na listagem de módulos locais, marque os seguintes módulos:

1. • • • Account Fiscal Position Rule Purchase
2. • • • Account Product Fiscal Classification
3. • • • Nota Fiscal Eletronica
4. • • • Account Fiscal Position Rule
5. • • • Account Fiscal Position Rule Sale
6. • • • Account Fiscal Position Rule Stock
7. • • • Scheduler Error Mailer
8. • • • Web Context Tunnel
9. • • • Brasileiro - Contabilidade
10. • • • Localização Brasileira - Módulo base contabilidade
11. • • • Localização Brasileira - Módulo de Pagamentos
12. • • • Localização Brasileira - Módulo Informações Contabéis do Produto
13. • • • Localização Brasileira - Módulo Contábil de Serviços
14. • • • Localização Brasileira - Módulo de Serviços
15. • • • Localização Brasileira - Módulo de Recibo de Pagamentos
16. • • • Localização Brasileira - Módulo Base
17. • • • Localização Brasileira - Módulo de CRM
18. • • • Localização Brasileira - Dados para o módulo de contabilidade
19. • • • Localização Brasileira - Dados do módulo de produtos
20. • • • Localização Brasileira - Dados do módulo de serviço
21. • • • Localização Brasileira - Dados do módulo Base
22. • • • Localização Brasileira - Módulo de Entrega
23. • • • Localização Brasileira - Módulo de Produtos
24. • • • Localização Brasileira - Módulo de compras
25. • • • Localização Brasileira - Módulo de Vendas
26. • • • Brazilian Localization Sale Product
27. • • • Brazilian Localization Sale Service
28. • • • Localização Brasileira - Módulo de Estoque
29. • • • Localização Brasileira - CEP
30. • • • Localização Brasileira - Módulo de Vendas e Estoque
31. • • • Manifesto Destinatário NFe

• Após todos marcados, clique no botão [Mais], localizado na parte superior da tela de módulos locais e escolha a opção “Instale o módulo de imediato”.

A instalação de todos os módulos num mesmo momento, busca evitar o problema de dependências não instaladas.

Se a instalação foi completada com sucesso, deve-se agora parametrizar o Odoo para que funcione de forma adequada às suas necessidades.