Installation du logiciel libre de gestion de bibliothèque (SIGB) PMB

PMB est un système intégré de gestion de bibliothèque. C'est une application 100 % web, reposant sur une plate-forme Apache + PHP + MySQL. PMB répond aux règles de la bibliothéconomie : il permet le recours à la norme Z39.50 (permet d'importer sur différents serveurs des notices bibliographiques intégrables directement dans la base de données), gère le format Unimarc et le format d'échange ISO 2709. Il intègre également le format de données XML. L'implantation de PMB dans un environnement numérique de travail (ENT) est tout à fait envisageable.

D'après l'enquête annuelle de Livres Hebdo, PMB se classait troisième SIGB en France en 2005 par le nombre d'installations avec 165 installations réalisées.

PMB se divise en deux parties ou modules :

• Le module de Gestion et le module d'interrogation (OPAC).
• Le module Gestion se décompose en différents onglets qui appellent chacun des fonctions spécifiques.

Les onglets sont au nombre de sept : circulation, catalogue, autorités, éditions, DSI (diffusion sélective de l'information), acquisitions et administration. L'OPAC est l'interface de recherche pour les utilisateurs de PMB.

PMB étant une application web, elle nécessite l'installation d'un serveur web comme Apache munis de php, et d'un serveur de base de donnée comme Mysql. Il est possible de les installer un par un, ou de passer par l'installation d'un LAMP qui inclue tous ces prérequis. Une fois votre serveur opérationnel, il faut encore installer quelques extensions à php et faire quelques modifications dans la configuration de php.

PMB étant une application php, son installation se déroule comme beaucoup d'outils du même type, par le biais d'une page d'installation accessible par navigateur web. Néanmoins, quelques extensions php sont nécessaires au bon fonctionnement du logiciel.

• Bibliothèque GD : php5-gd
• Bibliothèque PHP_BZ2 : installée par défaut
• Bibliothèque PHP_XSLT : php5-xsl
• Bibliothèque PHP_CURL : php5-curl

Le module php-yaz est le plus difficile à installer car il n'existe plus dans les dépôts d'Ubuntu à partir de Lucid (10.04). Il est possible par contre de passer par php-pear, qui est en quelque sorte un gestionnaire de dépôt adapté à PHP.

Il faut donc commencer par installer le paquet php-pear, ainsi que les paquets yaz , libyaz4, libyaz4-dev, et php5-dev.

puis dans un terminal, lancer la commande suivante :

sudo pecl install yaz

php-pear va alors se charger d'installer l'extenzion php-yaz pour vous.

Editer le fichier /etc/php5/apache2/php.ini et ajouter la ligne suivante juste après [PHP] :

extension=yaz.so

Pour vérifier la bonne installation des extensions php :

• Dans un terminal sur le serveur :

php --ini

devrait renvoyer ceci :

Configuration File (php.ini) Path: /etc/php5/cli
Loaded Configuration File:         /etc/php5/cli/php.ini
Scan for additional .ini files in: /etc/php5/cli/conf.d
Additional .ini files parsed:      /etc/php5/cli/conf.d/curl.ini,
/etc/php5/cli/conf.d/gd.ini,
/etc/php5/cli/conf.d/mysql.ini,
/etc/php5/cli/conf.d/mysqli.ini,
/etc/php5/cli/conf.d/pdo.ini,
/etc/php5/cli/conf.d/pdo_mysql.ini,
/etc/php5/cli/conf.d/xsl.ini,
/etc/php5/cli/conf.d/yaz.ini

• Dans un nouveau fichier 'phpinfo.php' à la base de votre site :

<?php
phpinfo();
?>

qu'il faut ensuite appeler dans un navigateur :

http://votre_site/phpinfo.php

et vérifier que les modules gd, bz2, curl, xsl et yaz sont bien chargés.

Editer le fichier /etc/php5/apache2/php.ini et remplacer respectivement :

• Temps d'éxécution

max_execution_time = 120

par

max_execution_time = 3600

• Taille maximale de fichier téléchargé (varie en fonction de votre catalogue):

upload_max_filesize = *

par

upload_max_filesize = 128M

Editer le fichier /etc/mysql/my.cnf et remplacer :

set-variable = max_allowed_packet=1M

par

set-variable = max_allowed_packet=128M

Fixer ce dernier paramètre à la même valeur que dans le fichier php.ini

Afin de rendre effective la nouvelle configuration, lancer la commande suivante dans un terminal :

sudo /etc/init.d/apache2 restart

En bref, voici les étapes d'installation :

• Télécharger l'archive du logiciel
• Extraire son contenu dans un dossier à la racine de votre site ( /var/www par défaut ).
• Accéder via un navigateur web à la page d'installation (ex : http://votresite/pmb/tables/install.php )
• Suivre les indications à l'écran.

Si vous rencontrez un message d'erreur vous informant qu'un dossier n'est pas accessible en écriture, ou qu'il ne possède pas les permissions adéquates, vous pouvez essayer de faire ce dossier au groupe "www-data" et lui donner les permissions nécessaires. Le groupe "www-data" est créé par apache2 lors de son installation et permettra au serveur d'avoir tous les droits sur ledit dossier. C'est quand même mieux que de donner toutes les permissions à tout le monde…

Pour changer le groupe du dossier :

sudo chgrp -R www-data /chemin/du/dossier

et pour changer les permissions du groupe sur ce dossier :

sudo chmod -R 774  /chemin/du/dossier/

Une fois ces manipulations effectuées, il ne devrait plus y avoir de problème…

Si vous avez décompressé pmb dans /var/www de sorte d'obtenir /var/www/pmb/… , l'adresse de l'installateur est http://localhost/pmb/tables/install.php.h

Si cela retourne une erreur 404, essayer de décompresser pmb plutôt dans le dossier /var/www/html et essayez de nouveau l'adresse ci-dessus (sans ajouter /html).

Un guide d'utilisation est disponible sur le site documentation du logiciel.

Outre le mot de passe au début, il existe d'autres pièges. Spécialement celui de l'absence d'un code statistique pour les exemplaires : dans ce cas ils n'apparaissent pas dans l'OPAC. Il faut donc créer un code statistique quelconque via Administration. Il sera attribué par défaut à chaque création de livre.

Quant aux sauvegardes, elles sont enregistrées en …/pmb/admin/backup/backups . Elles sont restaurées dans une autre installation en passant par la page emergency. Il faut avoir correctement réglé /etc/php5/apache2/php.ini selon ces explications, avoir relancé php (php –ini) et apache2.

Un guide d'administration est disponible sur le site documentation du logiciel.

Un guide pour les Webservices est disponible sur le site documentation du logiciel.

Un guide pour la fonction portail (version 4.0 et plus) est disponible sur le site documentation du logiciel.

• Forge PMB (fr)
• Site du développeur PMB Services (fr)
• Site du logiciel PMB (fr)
• Listes de discussion
• Wikipedia - PMB (fr)
• Forum pour les Linuxiens - Ce forum est tout à fait indépendant de la société PMB Services. Il a été mis en place par LaurentBDP976, sur TuxFamily.org
• Documentation pour Debian
• Liste de ressources de documentation sur le site de la communauté d'utilisateurs belges PMB-BUG

Contributeurs principaux : smon Arthus Belliqueux patch-works