Instalar o BIKA LIMS e ReportLab no Ubuntu

Pré-requisitos

• Acesso root ou sudo no servidor Ubuntu.
• Conexão à internet para baixar pacotes e arquivos.
• Variáveis de ambiente no exemplo: $BIKA_WGET_ADDRESS, $DOWNLOAD_DIR, $BIKA_TARBALL, $MY_PRODUCTS_DIR, $REPORTLAB_WGET_ADDRESS, $REPORTLAB_TARBALL, $BIKAFONTS_WGET_ADDRESS, $BIKAFONTS_ZIPFILE, $BIKAFONTS_DIR, $BIKA_VERSION, $INSTANCE_HOME. Substitua por valores reais.
• Versão de Python compatível usada pelo ReportLab no ambiente (o exemplo usa Python 2.4/Plone antigo).

Nota: este guia segue a sequência clássica para versões antigas de Plone/BIKA. Se estiver usando versões atuais, adapte conforme compatibilidade de Python e ReportLab.

Passo a passo — baixar e extrair BIKA e ReportLab

Baixe o tarball do BIKA LIMS:

sudo wget $BIKA_WGET_ADDRESS -P $DOWNLOAD_DIR

Extraia o tarball do BIKA:

sudo tar -xzf $DOWNLOAD_DIR/$BIKA_TARBALL -C $MY_PRODUCTS_DIR

Baixe o tarball do ReportLab:

sudo wget $REPORTLAB_WGET_ADDRESS -P $DOWNLOAD_DIR

Extraia o ReportLab:

sudo tar -xzvf $DOWNLOAD_DIR/$REPORTLAB_TARBALL -C $MY_PRODUCTS_DIR

Instale a versão do ReportLab associada à sua distribuição (exemplo para versões antigas do Ubuntu):

sudo apt-get install python-reportlab

Preparar e instalar as fontes BIKA

Crie o diretório de instalação das fontes BIKA:

sudo mkdir $MY_PRODUCTS_DIR/$BIKAFONTS_DIR

Baixe o zip das fontes:

sudo wget $BIKAFONTS_WGET_ADDRESS -P $DOWNLOAD_DIR

Copie o arquivo zip para o diretório de produtos:

sudo cp $DOWNLOAD_DIR/$BIKAFONTS_ZIPFILE $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/$BIKAFONTS_ZIPFILE

Se necessário, instale o unzip:

sudo apt-get install unzip

Vá para o diretório das fontes e descompacte (sem preservar a estrutura de pastas, conforme -j):

cd $MY_PRODUCTS_DIR/$BIKAFONTS_DIR

sudo unzip -j $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/$BIKAFONTS_ZIPFILE

Localizar onde o ReportLab foi instalado

Procure a instalação do ReportLab (o exemplo filtra por python2.4):

REPORTLAB_INSTALL_LOCATION=`sudo find / -name reportlab -print | grep python2.4`

Defina a variável para o diretório de fontes dentro da instalação do ReportLab:

INSTALLED_FONTS_DIR=$REPORTLAB_INSTALL_LOCATION/fonts

Crie o diretório e copie as fontes:

sudo mkdir $INSTALLED_FONTS_DIR

sudo cp $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/* $INSTALLED_FONTS_DIR

Para inspecionar o caminho instalado das fontes, mostre a variável:

$INSTALLED_FONTS_DIR

Exemplo de saída possível: usr/lib/python2.4/site-packages/reportlab/fonts

Atualizar o arquivo de configuração do ReportLab

Edite o rl_config.py para apontar para o diretório das fontes BIKA:

sudo nano $REPORTLAB_INSTALL_LOCATION/rl_config.py

No nano, mova-se com as teclas de seta. Use Ctrl-K para cortar linhas e Ctrl-U para colar. Para salvar e sair: Ctrl-X e depois Y.

Encontre a linha que descreve localizações de fontes Linux, por exemplo:

'/usr/lib/Acrobat9/Resource/Font',     #Linux, Acrobat 5?

Copie ou duplique essa entrada e edite uma cópia para apontar ao diretório de fontes BIKA que você anotou, por exemplo:

' usr/lib/python2.4/site-packages/reportlab/fonts ',     #Linux, fontes BIKA

Salve e saia (Ctrl-X, Y).

Instalar os produtos BIKA no Plone (Products)

Copie os produtos do BIKA para o diretório Products da sua instância Plone:

sudo cp $MY_PRODUCTS_DIR/$BIKA_VERSION/PloneProducts/* $INSTANCE_HOME/Products -r

Copie o script start-id-server para a raiz da instância:

sudo cp $INSTANCE_HOME/Products/bika/scripts/start-id-server $INSTANCE_HOME

Observação sobre múltiplas instâncias Plone: se tiver mais de uma instância, verifique a necessidade de alterar a porta do id-server (8081 pode já estar em uso).

Configurar o zope.conf para usar o id-server

Localize o arquivo zope.conf:

ZOPECONF_FILE=`sudo find / -name zope.conf -print`

Edite o arquivo:

sudo nano $ZOPECONF_FILE

Procure a seção de ambiente (environment) e edite para incluir o URL do ID server:

    
      IDServerURL http://localhost:8081
    

Salve e saia (Ctrl-X, Y).

Iniciar o id-server e o Zope

Execute o start-id-server com o usuário da instalação e inicie o Zope:

su USERNAME $INSTANCE_HOME/start-id-server

$INSTANCE_HOME/bin/zopectl start

Substitua USERNAME pelo nome do usuário criado durante a instalação do Ubuntu.

Acessar a interface e criar o site BIKA

Abra um navegador e acesse a interface do Zope (Zope Management Interface):

http://LIMSERVERlocalip:8080

Onde LIMSERVERlocalip é o IP local do servidor (verifique com ifconfig ou ip addr).

Entre com o usuário admin e sua senha. Se não souber a senha, localize arquivos com “password” e verifique:

sudo find / -name *password*

Abra o arquivo encontrado com sudo nano para ver a senha.

Para criar o site Plone com o produto BIKA instalado:

1. No ZMI (Zope Management Interface) clique em Manage.
2. Em Add selecione Plone site.
3. Em id informe um nome para o site BIKA, por exemplo bika-site-name.
4. Nas opções de tipo de Plone selecione bika e clique em Add.

Quando a criação terminar, acesse o site BIKA:

http://LIMSERVERlocalip:8080/bika-site-name

Critérios de aceitação

• O servidor responde em http://LIMSERVERlocalip:8080 e mostra a ZMI.
• É possível autenticar com o usuário admin no ZMI.
• O site Plone com id especificado aparece e o item BIKA está disponível no assistente de criação.
• Relatórios gerados usam as fontes BIKA (verifique relatórios PDF gerados pelo ReportLab).

Verificações e solução de problemas comuns

1. ReportLab não encontrado ao procurar com find:

   • Remova o filtro grep (p.ex. python2.4) para buscar todas as instalações: sudo find / -name reportlab -print.
   • Verifique a versão de Python usada pela sua instância Plone (2.x vs 3.x) e instale a versão apropriada do reportlab.

2. As fontes não aparecem nos relatórios PDF:

   • Confirme que a entrada em rl_config.py contém o caminho exato para o diretório de fontes.
   • Reinicie o id-server e o Zope após alterações.

3. Porta 8081 em uso:

   • Escolha uma porta livre (ex.: 8082) e atualize start-id-server e zope.conf de acordo.

4. Erros de permissão ao copiar arquivos:

   • Execute os comandos com sudo ou ajuste permissões do diretório $INSTANCE_HOME.

Lista de verificação por função

• Administrador de sistema

  • Verificar pacotes apt instalados (python-reportlab, unzip).
  • Garantir permissões e usuários corretos.
  • Confirmar serviços Zope/Plone iniciados.

• Administrador do Plone/BIKA

  • Validar que os produtos BIKA estão em $INSTANCE_HOME/Products.
  • Criar o site Plone e ativar o perfil BIKA.
  • Testar geração de relatórios PDF.

• Desenvolvedor

  • Verificar configurações no rl_config.py.
  • Testar importação de módulos reportlab no Python usado pela instância.

Procedimento de reversão rápido

• Faça backup do diretório $INSTANCE_HOME antes de copiar produtos.
• Para reverter uma instalação, remova os arquivos copiados em $INSTANCE_HOME/Products e restaure o backup.
• Remova as fontes copiadas para reportlab/fonts se necessário.

Cheat sheet de comandos úteis

• Procurar arquivos: sudo find / -name -print
• Abrir arquivo com nano: sudo nano (Ctrl-X para sair, Y para salvar)
• Iniciar Zope: $INSTANCE_HOME/bin/zopectl start
• Iniciar id-server: su USERNAME $INSTANCE_HOME/start-id-server

Resumo

• Baixe e extraia BIKA e ReportLab nos diretórios de produtos.
• Instale python-reportlab compatível e copie as fontes BIKA para a pasta reportlab/fonts.
• Atualize rl_config.py com o caminho das fontes.
• Copie os produtos BIKA para $INSTANCE_HOME/Products e configure zope.conf para o IDServer.
• Inicie id-server e Zope, crie o site Plone e verifique geração de relatórios.

Notas importantes: sempre faça backup antes de sobrescrever Products. Para ambientes modernos, considere atualizar para versões suportadas de Python, Plone e ReportLab.

Enjoy!