Instalar BIKA LIMS y ReportLab en Ubuntu

Antes de empezar

Asegúrate de tener acceso sudo en la máquina Ubuntu donde instalarás BIKA y Zope/Plone.
Ten a mano las variables de entorno requeridas en los comandos (por ejemplo: $BIKA_WGET_ADDRESS, $DOWNLOAD_DIR, $MY_PRODUCTS_DIR, $REPORTLAB_WGET_ADDRESS, etc.).
Si no estás seguro de una variable, sustituye por rutas concretas como /tmp o /opt/products.

Important: Corre cada comando con cuidado y verifica rutas antes de copiar ficheros al directorio del instance de Plone.

Descarga e instalación básica de BIKA y ReportLab

Ejecuta los siguientes comandos para descargar los paquetes y desplegarlos en tu directorio de productos.

sudo wget $BIKA_WGET_ADDRESS -P $DOWNLOAD_DIR

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

sudo wget $REPORTLAB_WGET_ADDRESS -P $DOWNLOAD_DIR

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

Instalar la versión de ReportLab empaquetada para Ubuntu

Para asegurar la integración con tu versión de Ubuntu (ej. Hardy Heron en documentación antigua) instala el paquete del sistema:

sudo apt-get install python-reportlab

Nota: En sistemas modernos podrías necesitar un paquete para Python 2 o migrar a alternativas compatibles con Python 3. Esta guía sigue los pasos del entorno legacy indicado en la fuente.

Preparar y copiar las fuentes BIKA a ReportLab

Crea un directorio temporal para las fuentes BIKA y descárgalas:

sudo mkdir $MY_PRODUCTS_DIR/$BIKAFONTS_DIR

sudo wget $BIKAFONTS_WGET_ADDRESS -P $DOWNLOAD_DIR

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

Si no tienes unzip, instálalo y descomprime:

sudo apt-get install unzip

cd $MY_PRODUCTS_DIR/$BIKAFONTS_DIR

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

Localizar la instalación de ReportLab

Busca la ruta donde reportlab quedó instalado (ejecuta con sudo para abarcar todo el sistema):

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

Define el directorio objetivo para las fuentes instaladas por ReportLab:

INSTALLED_FONTS_DIR=$REPORTLAB_INSTALL_LOCATION/fonts

sudo mkdir $INSTALLED_FONTS_DIR

sudo cp $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/* $INSTALLED_FONTS_DIR

Para inspeccionar la ruta en shell puedes mostrar la variable:

$INSTALLED_FONTS_DIR

Ejemplo de ruta: usr/lib/python2.4/site-packages/reportlab/fonts

Configurar rl_config.py para incluir las fuentes BIKA

Edita el archivo de configuración de ReportLab para declarar la nueva ruta de fuentes:

sudo nano $REPORTLAB_INSTALL_LOCATION/rl_config.py

Nano es un editor de texto. Muévete con las flechas; corta con Ctrl-K y pega con Ctrl-U. Busca la primera línea que describa la localización de las fuentes Adobe en Linux, por ejemplo:

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

Cópiala (corta una vez y pega dos veces) y reemplaza una de las entradas por la ruta de tus fuentes BIKA.

Ejemplo de línea modificada:

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

Guardar y salir: Ctrl-X, luego Y para confirmar.

Important: Mantén las comillas y la coma final exactamente como están en el archivo original.

Instalar Bika en tu instancia de Plone

Copia los productos BIKA al directorio Products de tu instancia Plone:

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

Copia el script start-id-server al home de la instancia:

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

Algunos howtos recomiendan editar start-id-server para ajustar puertos; si sólo tienes una instancia de Plone no es necesario. Si tienes varias, selecciona un puerto distinto (p. ej. 8081) si 8081 está en uso.

Configurar zope.conf para usar el id-server

Localiza zope.conf:

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

Edita el archivo:

sudo nano $ZOPECONF_FILE

Encuentra la sección de environment y modifica para que quede exactamente así:

    
      IDServerURL http://localhost:8081

Guarda (Ctrl-X, Y) y cierra.

Iniciar id-server y Zope

Arranca el id-server y Zope (reemplaza USERNAME por tu usuario real):

su USERNAME $INSTANCE_HOME/start-id-server

$INSTANCE_HOME/bin/zopectl start

Acceder a Zope y crear el sitio BIKA

Abre un navegador y ve a la interfaz de Zope:

http://LIMSERVERlocalip:8080

Nota: LIMSERVERlocalip es la IP local del servidor, la obtienes con ifconfig.

En la interfaz de Zope Management Interface (ZMI) inicia sesión como admin. Si no conoces la contraseña, búscala en el sistema:

sudo find / -name *password*

Abre el archivo con sudo nano y busca la contraseña.

Para crear el sitio BIKA dentro de Plone:

En ZMI pulsa Manage → Add.
Selecciona Plone Site en el menú desplegable.
En id escribe el nombre del sitio, p. ej. bika-site-name.
En las opciones de Plone selecciona bika y pulsa Add.

Accede al sitio BIKA:

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

¡Disfruta!

Resolución de problemas común

Error: reportlab no encuentra las fuentes
- Verifica que $INSTALLED_FONTS_DIR apunte al directorio correcto dentro de reportlab. Comprueba que rl_config.py contiene exactamente la ruta.
Error: permisos denegados al copiar archivos
- Revisa permisos con ls -la y usa sudo chown/chmod según convenga. Evita ejecutar Plone como root.
Zope no arranca o puerto en uso
- Revisa procesos con ps aux | grep zope y netstat -tulpn | grep 8080/8081. Cambia puertos en start-id-server o zope.conf si es necesario.
Contraseña admin desconocida
- Busca archivos que contengan ‘password’ como se indica arriba y revisa el fichero con sudo nano.

Lista de verificación rápida (Checklist)

Variables de entorno definidas ($DOWNLOAD_DIR, $MY_PRODUCTS_DIR, etc.).
Archivos .tar y .zip descargados correctamente.
ReportLab del sistema instalado (python-reportlab).
Fuentes BIKA copiadas a reportlab/fonts y rl_config.py actualizado.
Copiados los productos BIKA al INSTANCE_HOME/Products.
start-id-server copiado y zope.conf apuntando a IDServerURL.
id-server y zopectl iniciados.
[ ] Acceso a http://LIMSERVERlocalip:8080 y creación del sitio Plone/Bika.

Snippets y comandos útiles (Cheat sheet)

Buscar rutas o ficheros:

sudo find / -name  -print

Ver puertos en uso:

sudo netstat -tulpn | grep -E "8080|8081"

Cambiar propietario y permisos rápidamente:

sudo chown -R username:group $INSTANCE_HOME
sudo chmod -R 750 $INSTANCE_HOME

Glosario (1 línea cada término)

rl_config.py: Archivo de configuración de ReportLab que declara rutas de fuentes.
id-server: Servicio que gestiona identidades entre instancias de Plone/Zope.
ZMI: Zope Management Interface, la interfaz administrativa de Zope.

Notas de seguridad y privacidad

Evita exponer puertos administrativos (8080/8081) a Internet sin un firewall o proxy. Limita el acceso por IP o usa VPN.
No dejes contraseñas en ficheros accesibles para otros usuarios. Ajusta permisos con chown/chmod.

Resumen

Descargaste e instalaste BIKA y ReportLab, copiaste las fuentes BIKA a la carpeta de ReportLab y ajustaste rl_config.py. Configuraste el id-server y zope.conf para que Plone pueda usar el id-server, arrancaste los servicios y creaste el sitio Plone/Bika.

Notas: Si trabajas en un entorno moderno considera adaptar la guía a Python 3 y a versiones recientes de Plone/ReportLab; los pasos aquí corresponden a un entorno legacy documentado originalmente.