Installer BIKA LIMS et ReportLab sur Ubuntu

Objectif principal et variantes recherchées

Installer BIKA LIMS sur une instance Plone/Zope
Intégrer ReportLab et ses polices BIKA
Configurer l’id-server et zope.conf

Variantes liées : installation sur plusieurs instances Plone, résolution des conflits de ports, installation de polices personnalisées, ajustements pour Python 2.4/2.7 selon l’environnement.

Prérequis rapides

Accès root ou sudo sur la machine Ubuntu
Variables d’environnement utilisées dans les commandes (par ex. $BIKA_WGET_ADDRESS, $DOWNLOAD_DIR, $MY_PRODUCTS_DIR, $BIKAFONTS_WGET_ADDRESS, $BIKAFONTS_ZIPFILE, $BIKA_TARBALL, $REPORTLAB_TARBALL, $REPORTLAB_WGET_ADDRESS, $INSTANCE_HOME, $BIKA_VERSION)
Plone/Zope déjà installé et une instance opérationnelle

Important: conservez les chemins et noms de fichiers exacts dans les commandes; ce guide respecte ces variables telles qu’elles apparaissent dans votre environnement.

Téléchargement de BIKA et ReportLab

Téléchargez les archives BIKA et ReportLab dans votre répertoire de téléchargement.

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

Installer la version ReportLab compatible

Installez le paquet ReportLab disponible pour votre version d’Ubuntu afin d’assurer l’intégration correcte :

sudo apt-get install python-reportlab

Note: sur des systèmes plus récents, le paquet peut différer (python-reportlab pour Python 2, reportlab pour Python 3). Adaptez selon votre environnement.

Préparer et installer les polices BIKA

Créez le répertoire local pour les polices et récupérez l’archive.

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 unzip n’est pas installé :

sudo apt-get install unzip

Extrayez les fichiers de polices dans le dossier créé :

cd $MY_PRODUCTS_DIR/$BIKAFONTS_DIR

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

Localiser l’installation de ReportLab

Repérez l’emplacement où ReportLab a été installé (ex. pour Python 2.4) :

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

Créez ensuite le répertoire qui recevra les polices BIKA au sein de l’installation ReportLab :

INSTALLED_FONTS_DIR=$REPORTLAB_INSTALL_LOCATION/fonts

sudo mkdir $INSTALLED_FONTS_DIR

Copiez les polices :

sudo cp $MY_PRODUCTS_DIR/$BIKAFONTS_DIR/* $INSTALLED_FONTS_DIR

Affichez le chemin installé pour le mémoriser (ou collez-le dans un fichier texte pour référence) :

$INSTALLED_FONTS_DIR

Exemple de chemin : usr/lib/python2.4/site-packages/reportlab/fonts

Mettre à jour la configuration de ReportLab (rl_config.py)

Éditez le fichier de configuration pour indiquer le chemin des polices BIKA :

sudo nano $REPORTLAB_INSTALL_LOCATION/rl_config.py

Dans l’éditeur, repérez la ligne décrivant l’emplacement des polices Adobe Linux, par exemple :

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

Copiez cette ligne, puis modifiez une des occurrences pour y placer le chemin vers les polices BIKA que vous avez noté, par exemple :

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

Quittez nano avec Ctrl-X puis Y pour enregistrer.

Important: conservez les apostrophes et la virgule si elles sont présentes, car rl_config.py s’attend à une liste de chemins.

Installer BIKA dans Plone

Copiez les composants BIKA dans le répertoire Products de votre instance Plone :

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

Copiez le script start-id-server à la racine de l’instance :

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

Note: certains guides recommandent d’éditer start-id-server pour ajuster le port. Si vous n’avez qu’une seule instance Plone, la modification n’est généralement pas nécessaire. Si vous avez plusieurs instances, assurez-vous d’utiliser un numéro de port non conflictuel (par ex. 8081).

Configurer zope.conf pour l’id-server

Localisez le fichier zope.conf :

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

Éditez-le :

sudo nano $ZOPECONF_FILE

Trouvez la section d’environnement et modifiez-la pour inclure l’URL du serveur d’identité :

    
      IDServerURL http://localhost:8081

Enregistrez et quittez.

Démarrer l’id-server et Zope

Démarrez le serveur d’identité puis Zope :

su USERNAME $INSTANCE_HOME/start-id-server

$INSTANCE_HOME/bin/zopectl start

Remplacez USERNAME par le nom d’utilisateur que vous avez utilisé lors de l’installation d’Ubuntu.

Accéder à l’interface et créer le site BIKA

Ouvrez un navigateur vers :

http://LIMSERVERlocalip:8080

Remarque: LIMSERVERlocalip est l’adresse IP locale de votre serveur (trouvée via ifconfig).

Vous arriverez sur l’interface de gestion Zope (ZMI). Connectez-vous avec l’utilisateur admin. Si vous ne connaissez pas le mot de passe, cherchez le fichier mot de passe :

sudo find / -name *password*

Ouvrez-le avec sudo nano pour récupérer ou réinitialiser les identifiants.

Dans la ZMI :

Cliquez sur “manage” puis “add”
Sélectionnez “Plone site”
Donnez un identifiant (par ex. bika-site-name)
Dans les options de Plone, sélectionnez bika puis “add”

Après création, le site sera accessible :

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

Bonne utilisation !

Dépannage fréquent

Problème : erreurs liées aux polices dans ReportLab
- Vérifiez que le chemin $REPORTLAB_INSTALL_LOCATION/fonts contient bien les fichiers .pfb/.afm
- Vérifiez rl_config.py et relancez Zope
Problème : conflit de ports (8080/8081)
- Utilisez netstat ou ss pour identifier quel service utilise le port
- Changez le port de l’id-server et mettez à jour zope.conf
Problème : Plone ne montre pas l’option bika au moment de créer le site
- Assurez-vous que les paquets BIKA sont dans $INSTANCE_HOME/Products
- Redémarrez Zope après copie
Problème : mot de passe admin inconnu
- Recherchez les fichiers contenant « password » et inspectez avec sudo nano
- Considérez la réinitialisation via la console Zope si nécessaire

Checklist par rôle

Administrateur système
- Vérifier les droits sudo
- S’assurer que les variables d’environnement pointent vers les bons dossiers
- Vérifier ports libres (8080, 8081)
Administrateur Plone
- Copier les produits BIKA dans Products
- Vérifier la disponibilité de bika dans l’interface d’ajout
- Tester la génération de rapports
Utilisateur final
- Accéder au site BIKA créé
- Valider que les modèles de rapport affichent correctement les polices

Mini-méthodologie de validation

Vérifier que ReportLab est installé et détecté par Python.
Vérifier la présence des polices dans $REPORTLAB_INSTALL_LOCATION/fonts.
Démarrer id-server et Zope; vérifier les logs pour erreurs.
Créer un site Plone + BIKA et générer un rapport de test.
Confirmer que les polices s’affichent correctement dans le PDF.

Fiche technique

Composants : BIKA LIMS, Plone, Zope, ReportLab
Ports courants : Zope 8080, id-server 8081
Emplacements typiques : /usr/lib/python2.4/site-packages/reportlab/fonts

Critères d’acceptation

L’interface BIKA est accessible via le navigateur
La génération PDF s’effectue sans erreurs liées aux polices
L’id-server répond sur l’URL configurée
Les services Zope et id-server démarrent sans erreurs dans les logs

Glossaire (une ligne chacun)

BIKA LIMS : solution open source de gestion de laboratoire intégrée à Plone.
ReportLab : bibliothèque Python de génération de PDF.
id-server : service d’identité utilisé par BIKA pour gérer certaines fonctions.
ZMI : Zope Management Interface, interface d’administration de Zope.

Notes finales

Si vous gérez plusieurs instances Plone, planifiez des ports distincts et des profils d’instance séparés.
Conservez une copie de sauvegarde de rl_config.py avant modification.

Résumé : suivez les étapes de téléchargement, installez ReportLab, placez les polices BIKA dans l’installation ReportLab, mettez à jour rl_config.py, installez les produits BIKA dans Plone, configurez l’id-server dans zope.conf et démarrez les services. Vérifiez l’accès via un navigateur et testez la génération de rapports.