GUIA DE INSTALAÇÃO DO ERP5<br/><br/>Rafael Manhães Monnerat Outubro, 2005<br/><br/>GUIA DE INSTALAÇÃO DO ERP5<br/><br/><br/>Idioma: Português Autor : Rafael Manhães Monnerat Email : rmonnerat@gmail.com Data : 16/10/2005<br/><br/>A versão web ( em html ) e alguns outros documentos sobre o assunto encontra-se no site: http://monnerat.objectis.net/erp5<br/><br/>Agradecimento ao Núcleo de Pesquisa em Sistemas de Suporte a Decisão do CEFET CAMPOS e seus integrantes.<br/><br/>Copyright (c) 2005 Rafael Monnerat, NPSSD. É garantida a permissão para copiar, distribuir e/ou modificar este documento sob os termos da Licença de Documentação Livre GNU (GNU Free Documentation License), Versão 1.2 ou qualquer versão posterior publicada pela Free Software Foundation; sem Seções Invariantes, Textos de Capa Frontal, e sem Textos de Quarta Capa. Uma cópia da licença é incluída na seção intitulada &quot;GNU Free Documentation License&quot;.<br/><br/>Sumário<br/><br/>1. Considerações Iniciais ................................................................................................. 04 2. Instalando o ZOPE ....................................................................................................... 04 3. Instalando o Banco de Dados e bibliotecas relacionadas........................................... 05 3.1 Instalando o Banco ............................................................................................ 05 3.2 Instalando ZMySQLDA e Mysql-python .......................................................... 05 4. Instalando outras Dependências .................................................................................. 06 4.1 Instalando as Bibliotecas ................................................................................... 06 4.2 Instalando os Products........................................................................................ 07<br/><br/><br/>4.3 A instalação do CMFWiki ................................................................................ 08 5. Instalando o ERP5 ......................................................................................................... 08 5.1 Passos adicionais ................................................................................................ 08 6. Instalando o Portal ......................................................................................................... 09 6.1 Iniciando o Zope ................................................................................................. 09 6.2 Instalando o Portal ERP5..................................................................................... 09 7. Acessando o ERP5 e Instalando os Business Templates ............................................. 10 7.1 Indexando pelo portal_activies ........................................................................... 10 7.2 Instalando os Business Templates ...................................................................... 10 8. Listas de discussão e Sites .............................................................................................. 11<br/><br/>1. Considerações Iniciais<br/>Este tutorial foi escrito baseado na instalação do ERP5 no Slackware 10.1 e refeita no Mandriva 2005 ( Mandrake 10.2) . O zope utilizado foi o de versão 2.7.6b2 disponível no repositório de pacotes RPM para mandrake da Nexedi (O ZOPE presente no repositório da nexedi possui algumas alterações que a versão normal baixada no site www.zope.org). Foram utilizados também alguns pacotes RPM que facilitou o uso da instalação de algumas dependências . O Python utilizado foi o de versão 2.4 ( o 2.3 é incompatível com esta versão do ZOPE ) . A instalação não incluiu o ERP5Shop e ERP5CPS, o motivo é que não se chegaram em uma versão totalmente disponível para instalação, e optou-se no não aprofundamento deste ponto por enquanto. O ERP5Shop já possui uma instância funcionando (www.storever.com), mais informações consulte o site do ERP5 ou utilize as listas de Discussão citadas ao fim deste guia. Foi tentada a instalação do ERP5 com os pacotes RPM porém estes não são compatíveis com a última versão dos Business Templates presentes na CVS, assim a instalação seguiu com erros no Business Templates até que foi decidido a instalação pelos arquivos presentes no CVS. Isso foi indicado em vários emails na lista de discussão e mostrou resolver o problema de incompatibilidade. Os arquivos dentro da CVS estão em constante atualização assim pode ocorrer que esta última<br/><br/><br/>contenha algum bug recente, porém não a motivos para pânico. Para contribuição para comunidade de desenvolvedores , reporte o bug nas listas do Erp5 para que algum esclarecimento, correção ou explicação possa ser levantada para a resolução do mesmo. Foi Atribuído uma seqüência para facilitar a instalação no Mandriva e separei alguns pontos pertinentes devido a tentar retratar dois tipos de instalações: Mandriva e Slackware. Dividi em sessões para o melhor entendimento e compreensões da lógica.<br/><br/>2. Instalando o ZOPE<br/>Como visto anteriormente o ZOPE a ser utilizado é o que se encontra disponível para download em :<br/>·<br/><br/>http://www.nexedi.org/sections/software/nexedi_rpms/view<br/><br/>A instalação no slackware foi utilizado o comando rpm2tgz para a conversão dos pacotes e após utilizou o &quot;installpkg&quot; para efetuar a instalação. No mandrake foi usado o inslatador gráfico de pacotes integrado com o Konqueror. A Dependência relevante é o Python 2.4.<br/><br/>3. Instalando o Banco de Dados e bibliotecas relacionadas<br/>Tive alguns problemas de compreensão inicial neste ponto. Com relação a instalação do Mysql ou do mysql-max. A princípio instalei o normal e tive muitos problemas para trocar ( visto que eu uso slackware e não existem pacotes mysql-max). Após uma pesquisa ostensiva na internet descubri alguns pontos relevantes:<br/>· ·<br/><br/>·<br/><br/>O mysql-max foi criado para o suporte ao tipo InnoDB de tabelas nas versões 3.x do mysql, porém as versões mais recentes já vem com o tipo incluído. O Mysql-4.x alterou as funções de conecção gerando uma incompatibilidade com o Mysqldb do python, porém possui uma opção de compilação que permite que seja compilado com as antigas conecções. O mysql-3.x e o Mysql-max-3.x (pelo menos os que eu testei baixados diretos do mysql.com) possuíram algumas restrição ao tamanho das chaves ( KEY ) gerando muitos problemas de criação das tabelas.<br/><br/>Analizado isso e alguns outros pontos mínimos chego a uma algumas necessidades que o mysql precisa ter:<br/>· · ·<br/><br/>Ter suporte a InnoDB. Ter a antiga forma de connecção antiga. não possuir restrições do tamanho das Chaves.<br/><br/>3.1 Instalando o Banco Assim chegou-se aos dois tipos de instalação:<br/>· ·<br/><br/>Instalar o pacote mysql-4.0.20a.tgz que vem do mídia de instalação do Slackware-10.1; Instalar no Mandriva o MySql-Max-4.1.11-1mdk.i586.rpm encontrado no rpmfind.net e iniciar o banco com o script no &quot;/etc/rc.d/init.d/mysql-max start&quot;, é necessário o Mysqlcommon e é necessário remover caso esteja instalado outro banco mysql.<br/><br/><br/>Maiores discussões aqui podem ser proposta na lista de discussão erp-brasil (português) e erp5-dev (inglês). 3.2 Instalando ZMySQLDA e Mysql-python No Slackware baixe os dois em (http://sourceforge.net/projects/mysql-python) e instale normalmente. ( Descompactar e copia para lib do python ) No Mandriva baixe os RPMs e use o instalador gráfico ( primeiro o MySQL-python ) :<br/>·<br/><br/>·<br/><br/>MySQL-python ( 1.2.0) · http://www.rpmfind.net//linux/RPM/mandrake/2006.0/i586/media/contrib/ MySQLpython-1.2.0-1mdk.i586.html ZMySQLDA ( 2.0.9b2) · http://nexedi.org/static/Mandrake/10.2/RPMS/ZMySQLDA-2.0.9b25mdk.noarch.rpm<br/><br/>4. Instalando outras Dependências<br/>As outras dependências são basicamente bibliotecas ou ZOPE Products que o ERP5 utiliza no seu funcionamento. 4.1 Instalando as Bibliotecas No Mandriva os RPMs foram instalados com o Instalador gráfico, no Slackware a maioria foram descompactando e copiando para o lib do ZOPE ( /usr/lib/zope/lib/python)<br/>·<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>PyXML (v. 0.8.4) · Slackware, Escolha um mirror em http://prdownloads.sourceforge.net/pyxml/PyXML-0.8.4.tar.gz?download · Mandriva , Encontra-se no mídia de instalação 3 ( python-pyxml ) Numeric · Slackware, Instalação from source ( http://numeric.scipy.org/ ) · Mandriva , Encontra-se no cd de instalação ( python-numeric ) PIL · Slackware, Presente em Imaging (http://effbot.org/downloads/Imaging-1.1.5.tar.gz) · Mandriva , Encontra-se no cd de instalação 3 ( python-imaging ) ReportLab (utilizado o RPM do repositório da nexedi ) · http://nexedi.org/static/Mandrake/10.2/RPMS/python-reportlab-1.201mdk.noarch.rpm · No Slackware foi utilizado o rpm2tgz e o installpkg neste caso. ElementTree (1.2.6) e Expat (1.95.8) · No Mandriva , o RPM possui uma dependência do expat. Os RPMs : · ElementTree, http://www.rpmfind.net//linux/RPM/cooker/cooker/i586/media/contrib/ python-elementtree-1.2.6-1mdk.noarch.html · Expat , http://www.rpmfind.net//linux/RPM/mandrake/10.2/i586/media/main/ expat-1.95.8-1mdk.i586.html · No Slackware, via fonte, http://effbot.org/downloads/elementtree-1.2.620050316.tar.gz e uso do rpm2tgz e installpkg no Expat Psyco ( 1.3 ) · No Mandriva, o RPM<br/><br/><br/>·<br/><br/>http://fr2.rpmfind.net//linux/RPM/conectiva/snapshot/i386/RPMS.devel/ psyco-1.373326cl.i386.html No Slackware, via source , http://psyco.sourceforge.net<br/><br/>4.2 Instalando os Products A instalação dos Products é bastante simples e segue a instalação normal dos Produtos do zope. Quando o arquivo for &quot;tar.gz&quot; , descompacte-o e copie as pastas dos products para pasta /usr/lib/zope/lib/python/Products dentro da instalação do ZOPE. Quando for um arquivo RPM utilize o instalador gráfico no Mandriva ou o rpm2tgz + installpkg no Slackware.<br/>·<br/><br/>· ·<br/><br/>Formulator (1.9.0) · ftp://fr2.rpmfind.net/linux/Mandrake/2006.0/i586/media/contrib/ zope-Formulator1.9.0-3mdk.noarch.rpm Photo (1.2.3 - Utilizado o que estava no Repositório do Nexedi) · http://nexedi.org/static/Mandrake/10.2/RPMS/Photo-1.2.3-5mdk.noarch.rpm Localizer (1.1.0) · O Localizer utilizado foi o RPM encontrado no Repositório do Nexedi e este possui duas dependências que também estão no mesmo repositório: · Localizer, http://nexedi.org/static/Mandrake/10.2/RPMS/Localizer-1.1.01mdk.noarch.rpm · iHotFix, http://nexedi.org/static/Mandrake/10.2/RPMS/iHotfix-0.5.21mdk.noarch.rpm · itools, http://nexedi.org/static/Mandrake/10.2/RPMS/itools-0.7.41mdk.noarch.rpm CMF (1.4.8) · ftp://fr2.rpmfind.net/linux/Mandrake/2006.0/i586/media/contrib/ zope-CMF-1.4.83mdk.noarch.rpm TranslationService (0.4) · ftp://fr2.rpmfind.net/linux/Mandrake/2006.0/i586/media/contrib/ TranslationService0.4-1mdk.noarch.rpm BTreeFolder2 (1.0.1) · ftp://fr2.rpmfind.net/linux/Mandrake/2006.0/i586/media/contrib/ zopeBTreeFolder2-1.0.1-3mdk.noarch.rpm CMFPhoto (1.2.3) · ftp://fr2.rpmfind.net/linux/MandrakeCooker/10.2/i586/media/contrib/ CMFPhoto1.2.3-4mdk.noarch.rpm ZMailin (1.0.1) · ftp://fr2.rpmfind.net/linux/Mandrake/2006.0/i586/media/contrib/ ZMailIn-1.0.12mdk.noarch.rpm CMFMailin ( 1.0.1) · ftp://fr2.rpmfind.net/linux/Mandrake/2006.0/i586/media/contrib/ CMFMailIn-1.0.05mdk.noarch.rpm CMFReportTool · http://nexedi.org/static/Mandrake/10.2/RPMS/ CMFReportTool-0.1.1.200504221mdk.noarch.rpm<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>·<br/><br/>4.3 A instalação do CMFWiki Este é um ponto da instalação muito delicado, pois as versões atuais deste Product são incompatíveis com o CMF 1.4.x, assim foi lançada uma busca para achar uma versão compatível, encontrou-se a 'retired-20040908' no CVS ( http://svn.zope.org/CMF/tags/CMFWiki-retired-<br/><br/><br/>20040908/CMFWiki/ ). Tive o trabalho de baixar arquivo por arquivo até conseguir montar o Product. Pretendo disponibilizar um TarBall em breve para facilitar o trabalho. e acrescentar um link aqui. Qualquer duvida solicite um esclarecimento deste ponto na Lista de discussão.<br/><br/>5. Instalando o ERP5<br/>O download é feito apartir do CVS Repository do Nexedi ( http://openbrick.org/cgibin/viewcvs.cgi// ). Vale a pena destacar que a instalação via pacotes RPM gera um problema na hora de instalar os business templates, isso ocorre porque as versões dos Business Templates presentes no CVS são para última versão do ERP5 também do CVS. Como o CVS é atualizado regularmente vale a pena destacar que foi usada para este tutorial a versão no dia 02/09/2005 ( Slackware ) e dia 13/10/2005 ( Mandriva ). Os Zope Products a serem baixados são:<br/>· · · · · · · · · · · · ·<br/><br/>Base18 ( http://openbrick.org/cgi-bin/viewcvs.cgi/Base18.tar.gz?view=tar ) CMFActivity (http://openbrick.org/cgi-bin/viewcvs.cgi/CMFActivity.tar.gz?view=tar) CMFCategory ( http://openbrick.org/cgi-bin/viewcvs.cgi/CMFCategory.tar.gz?view=tar) CMFTranslation ( http://openbrick.org/cgibin/viewcvs.cgi/CMFTranslation.tar.gz?view=tar) ERP5 ( http://openbrick.org/cgi-bin/viewcvs.cgi/ERP5.tar.gz?view=tar) ERP5Catalog ( http://openbrick.org/cgi-bin/viewcvs.cgi/ERP5Catalog.tar.gz?view=tar) ERP5Compatibility ( http://openbrick.org/cgibin/viewcvs.cgi/ERP5Compatibility.tar.gz?view=tar) ERP5Form ( http://openbrick.org/cgi-bin/viewcvs.cgi/ERP5Form.tar.gz?view=tar) ERP5OOo ( http://openbrick.org/cgi-bin/viewcvs.cgi/ERP5OOo.tar.gz?view=tar) ERP5SyncML ( http://openbrick.org/cgi-bin/viewcvs.cgi/ERP5SyncML.tar.gz?view=tar) ERP5Type ( http://openbrick.org/cgi-bin/viewcvs.cgi/ERP5Type.tar.gz?view=tar) ZMySQLDDA ( http://openbrick.org/cgi-bin/viewcvs.cgi/ZMySQLDDA.tar.gz?view=tar) ZSQLCatalog ( http://openbrick.org/cgi-bin/viewcvs.cgi/ZSQLCatalog.tar.gz?view=tar)<br/><br/>Após o download, é efetuada a instalação descompactando cada arquivo e copiando a pasta resultante para '/usr/lib/zope/lib/python/Products'. 5.1 PASSOS ADICIONAIS Copie os arquivos :<br/>· ·<br/><br/>/usr/lib/zope/python/Products/ERP5/Extensions/InventoryBrain.py /usr/lib/zope/python/Products/ZSQLCatalog/zsqlbrain.py<br/><br/>Para:<br/>·<br/><br/>/var/lib/zope/Extensions<br/><br/>Edite o ERP5Compatibility/__init__.py Encontrado na pasta Products do Zope. Adicione a linha abaixo junto aos imports iniciais.<br/>·<br/><br/>import Products.ERP5.Tool.Category<br/><br/>Remover os arquivos de MySQLDDA/help Remover os seguintes arquivos dentro da pasta MySQLDDA/help também dentro da pasta Products do Zope.<br/><br/><br/>6. Instalando o Portal<br/>6.1 Iniciando o Zope Antes de iniciar o zope crie um usuário &quot;manager&quot; para acessar a ZMI. No bash como root digite:<br/>·<br/><br/>zopectl adduser meu_usuario minha_senha runzope ( exibe mensagens que podem ser úteis quando houver um erro na inicialização ); zopectl start ( sem mensagens).<br/><br/>E inicie o zope com:<br/>· ·<br/><br/>Caso esteja ocorrendo algum erro dentro da ZMI, pode-se usar o comando &quot;zopectl logtail&quot; para ver as mensagens do zope no bash. O Zope no Mandriva ele inicia junto com o sistema , como também o Mysql. Caso não esteja podese procurar o gerenciador de inicialização de serviços e configure como preferir. Este Zope usa a porta 9080, assim o acesso ocorre via browser no endereço, http://localhost:9080/. Mais informações sobre o Zope consulte o site www.zope.org ou www.tchezope.org . 6.2 Instalando o Portal ERP5 Após entrar na ZMI como o usuário criado, acesse a Caixa de seleção para adicionar o ERP5, selecione &quot;ERP5 Site&quot;. Após isso aparecerá um formulário, não é necessário alterá-lo para que a instalação ocorra apenas confirmar. Porém caso necessite de fazer uma versão de produção leia mais atentamente os campos e procure mais informações de alguns que não for totalmente claro.<br/><br/>7. Acessando o ERP5 e Instalando os Business Templates<br/>7.1 Indexando pelo portal_activies O ERP5, por default, não indexa os objetos automaticamente, assim é necessário após a criação de qualquer objeto ( incluindo na última versão até o que é instalado inicialmente ) invocar manualmente a indexação no endereço:<br/>·<br/><br/>http://localhost:9080/erp5/portal_activities/manageActivities<br/><br/>7.2 Instalando os Business Templates Os business Templates são os módulos do ERP5, eles se encontram na CVS podendo ser instalado via download do próprio ERP5. Entre os Business Templates presentes estão:<br/>· · · · · ·<br/><br/>erp5_trade erp5_pdm erp5_mrp erp5_accounting erp5_payroll erp5_crm<br/><br/>Todos se encontram no endereço http://openbrick.org/cgi-bin/viewcvs.cgi/erp5_bt5/ . Vale ressaltar que alguns podem causar erros muito desagradáveis (como o erp5_catalog, não o instale) e eu<br/><br/><br/>realmente não chequei todos muito afundo, então não instale algum que não conheça em uma versão que está sendo usada. Vale também lembrar que para instalar dois portais em um mesmo zope é necessário criar um novo database como é explicado no tutorial &quot;Instalando dois portais ERP5 em um mesmo Zope&quot; no endereço:<br/>·<br/><br/>http://monnerat.objectis.net/erp5/2erp5install<br/><br/>Para a instalação dos Business Templates é necessário ir na ferramenta portal_templates do seu portal ERP5. ele encontra-se no endereço:<br/>·<br/><br/>http://maquina_do_portal:9080/erp5/portal_templates<br/><br/>Após isso clique na figura abaixo ( Import ):<br/><br/>No formulário que aparecerá, altere a caixa de seleção para &quot;Download Business Template&quot;, coloque o nome do Business Template ( Ex.: erp5_trade ) , e depois o endereço ( Ex.: http://openbrick.org/cgi-bin/viewcvs.cgi/*checkout*/erp5_bt5/erp5_trade.bt5 ). Este serve para todos os outros Templates.<br/><br/>8. Listas e Sites oficiais<br/>Listas de discussão<br/>· · ·<br/><br/>erp5-users@erp5.org erp5-dev@erp5.org erp5-brasil@erp5.org<br/><br/>Websites:<br/>· ·<br/><br/>NPSSD:<br/><br/>http://www.cefetcampos.br/ensino/dppg/nucleos_pesquisa/npssd/home.html<br/><br/>Oficial ERP5 : http://www.erp5.org<br/><br/>Se você tem sugestões, correções ou esclarecimentos, envie um email para a lista erp5brasil@erp5.org .