{{tag>ged bibliothèque BROUILLON}}

----

====== 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.

===== Présentation de l'interface =====

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.

===== Installation =====

==== Prérequis ====

PMB étant une application web, elle nécessite l'installation d'un serveur web comme [[apache2|Apache]] munis de [[php|php]], et d'un serveur de base de donnée comme [[mysql|Mysql]].
Il est possible de les installer un par un, ou de passer par l'installation d'un [[lamp|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.


==== Installation des modules PHP complémentaires ====

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.

  * Librairie GD  : **[[apt://php5-gd|php5-gd]]**
  * Librairie PHP_BZ2 :  installée par défaut 
  * Librairie PHP_XSLT : **[[apt://php5-xsl|php5-xsl]]**
  * Librairie PHP_CURL : **[[apt://php5-curl|php5-curl]]**


==== Installation du module php-yaz pour l'importation de notices à la norme z39.50 ====

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 **[[apt://php-pear|php-pear]]**, ainsi que les paquets  **[[apt://yaz|yaz]]** , **[[apt://libyaz4|libyaz4]]**, **[[apt://libyaz4-dev|libyaz4-dev]]**, et **[[apt://php5-dev|php5-dev]]**.

puis dans un terminal, lancer la commande suivante :

<code>sudo pecl install yaz</code>

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

<note important>Sous 14.04 un bug répertorié peut empêcher le fonctionnement normal de pear et donc pecl. La commande ci-dessus renvoie "failed". Des solutions sont rapportées [[http://forum.ubuntu-fr.org/viewtopic.php?pid=18092311#p18092311|là]].</note>

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

<code>extension=yaz.so</code>




Pour vérifier la bonne installation des extensions php :

  * Dans un terminal sur le serveur :

<code bash>php --ini</code>

devrait renvoyer ceci :

<code bash>
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
</code>

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

<code php>
<?php
phpinfo();
?>
</code>

qu'il faut ensuite appeler dans un navigateur : <file>http://votre_site/phpinfo.php</file> et vérifier que les modules gd, bz2, curl, xsl et yaz sont bien chargés.

<note>
Il est possible que le fichier yaz.ini n'apparaisse pas dans la section "Additional ini files parsed", mais que la section Yaz soit tout de même présente et le module actif.
</note>

{{http://bambou.viens.la/autres/phpinfo1.gif}}


==== Modification du fichier php.ini ====

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

  * Temps d'éxécution 

<code>max_execution_time = 120</code>

par 

<code>max_execution_time = 3600</code>

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

<code>upload_max_filesize = *</code>

par

<code>upload_max_filesize = 128M</code>


====  Modification du fichier my.cnf ====

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

<code>set-variable = max_allowed_packet=1M</code>

par

<code>set-variable = max_allowed_packet=128M</code> //Fixer ce dernier paramètre à la même valeur que dans le fichier php.ini//

====  Redémarrage du serveur Apache ====

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

<code>sudo /etc/init.d/apache2 restart</code>
==== Installation de PMB ====

En bref, voici les étapes d'installation :
  * Télécharger [[http://forge.sigb.net/redmine/projects/pmb/files|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.

=== Erreur de permission lors de l'installation ? ===

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 :

<code>
sudo chgrp -R www-data /chemin/du/dossier
</code>

et pour changer les permissions du groupe sur ce dossier :

<code>
sudo chmod -R 774  /chemin/du/dossier/
</code>

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


=== Erreur 404 : Not found ? ===
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
]].

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).
===== Utilisation =====

Un  [[http://doc.sigb.net/pmb/co/guide_complet_web.html|guide d'utilisation]] est disponible sur le site documentation du logiciel.

<note tip>Une fois le site installé on l'atteint en http://localhost/.../pmb/index.php . Il faut alors entrer //admin// comme utilisateur et mot de passe.

En admettant que le serveur ait pour IP 198.168.1.53,  on atteint le site depuis un autre PC du réseau à l'adresse 198.168.1.53/pmb/index.php . Ça va si bien sans dire... que personne le dit. LOL
</note>
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 [[http://localhost//pmb/admin/sauvegarde/emergency/emergency.php|emergency]]. Il faut avoir correctement réglé /etc/php5/apache2/php.ini selon ces [[http://www.citedoc.net/gestion/pmb_fiches/pmb_2_9_sauvegarder_restaurer_donnees_20120228.pdf|explications]], avoir relancé php (php --ini) //et// apache2.

===== Administration et configuration avancée=====

Un [[http://doc.sigb.net/pmb/co/guide_complet_web_section_administration.html|guide d'administration]] est disponible sur le site documentation du logiciel.

Un [[http://doc.sigb.net/doc_webservices_pmb/co/guideWeb.html|guide pour les Webservices]] est disponible sur le site documentation du logiciel.

Un [[http://doc.sigb.net/portail_pmb/co/guide%20web%20portail.html|guide pour la fonction portail]] (version 4.0 et plus) est disponible sur le site documentation du logiciel.

===== Voir aussi =====

  * [[http://forge.sigb.net/redmine/projects/pmb|Forge PMB]] **(fr)**
  * [[http://www.pmbservices.fr/index.php?lvl=cmspage&pageid=14&id_article=52|Site du développeur PMB Services]] **(fr)**
  * [[http://www.pmbservices.fr/index.php?lvl=cmspage&pageid=2&id_logiciel=18|Site du logiciel PMB]] **(fr)**
  * [[http://www.pmbservices.fr/index.php?lvl=cmspage&pageid=18|Listes de discussion]]
  * [[wpfr>PMB_(logiciel)|Wikipedia - PMB]] **(fr)**
  * [[http://biblinuxiens.tuxfamily.org/|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
  * [[https://www.isalo.org/wiki.debian-fr/index.php?title=Installation_d%27un_serveur_Pmb|Documentation pour Debian]]
  * [[http://www.pmb-bug.be/?q=biblio/keyword/28|Liste de ressources de documentation sur le site de la communauté d'utilisateurs belges PMB-BUG]]

----

//Contributeurs principaux : [[:utilisateurs:smon]] [[:utilisateurs:Arthus Belliqueux]] [[:utilisateurs:patch-works]]//