Sommaire Note

Ubuntu/Debian, PhP5, YAZ et PMB.
1/4
PDF créé le dimanche 11 avril 2010 – v 2.0.0
Auteur : Jacques Barzic ([email protected])
Sommaire
Page
Le point de départ
2/4
La problématique
2/4
Le schéma général
2/4
Le déroulé commenté
3/4
Contrôles et essais
4/4
Note
Le but de cette notice est de participer à faire tomber la barrière qui existe manifestement encore entre YAZ et
PHP5 dans l’usage qu’en a PMB.
N’étant un spécialiste ni de l’un, ni de l’autre, et confronté au besoin de les faire travailler ensemble, j’ai
décidé de charger le tout sur une distribution Ubuntu 6.06 Dapper Drake LTS Serveur (dont je découvre aussi
le fonctionnement car je suis un NéoLinuxien…).
Le résultat de mes tâtonnements, éclairés par des aides trouvées sur la toile (merci aux contributeurs plus ou
moins anonymes), est cette méthode empirique : mais ça marche !!!
Elle est perfectible, adaptable et parfois catalysatrice de mes doutes.
J’espère qu’elle est encore d’actualité et qu’elle pourra être une synthèse de ce qu’il faut faire pour associer ces
fonctionnalités. Cela, parfois au prix de l’expression de certaines évidences, en direction de personnes qui
découvrent cet univers (comme moi au début).
Je renouvelle mes remerciements aux contributeurs de la toile et en particulier ceux de la lettre de diffusion de
PMB ([email protected]).
Et bien entendu, aux développeurs de PMB qui mettent cette application à disposition.
Suivi des corrections :
1. le 21/10/2007 : étape 5 du déroulé (erreur sur le nom de l’archive), étape 9 du déroulé (erreur sur le
chemin)
2. le 11/04/2010 : je viens de faire une installation de PMB sur la configuration ci-dessous, cette
procédure fonctionne (il faut adapter en conséquence les numéros de versions dans le déroulé).
Debian GNU/Linux 5.0.4, Apache/2.2.9 (Debian), PHP Version 5.2.6-1+lenny8, MySQL Serveur
5.0.51a-24+lenny3, MySQL Client : 5.0.51a, phpMyAdmin - 2.11.8.1deb5+lenny3, PMB 3.3.5 et
yaz-4.0.3.tar.gz.
Ubuntu/Debian, PhP5, YAZ et PMB.
2/4
PDF créé le dimanche 11 avril 2010 – v 2.0.0
Le point de départ
Le point de départ de cette notice est :
1. une distribution Ubuntu Dapper Drake server 6.06.1 i3 LTS installée avec le choix LAMP au
menu d’installation, c'est-à-dire avec :
a. Apache 2.0,
b. PHP 5.1.2,
c. serveur MySQL 5.0.22-Debian_Oubuntu6.06.5-log,
2. PMB 3.0.26 installé dans un répertoire qui sera nommé ici [PMB],
3. Les extensions suivantes pour PhP5 installées : php5-gd, php5-xsl,
4. les autres extensions (mysql, bz2, iconv, mbstring, mime_magic) le sont dans l’installation par
défaut de LAMP par le CD d’installation server de Ubuntu.
Note 1 : si des installations de YAZ ou php-yaz on été tentées au préalable, il est bon de les désinstaller :
• apt-get remove yaz
• suppression de yaz.so dans le répertoire des extensions de php (par défaut dans mon cas :
/usr/lib/php5/20051025/).
Note 2 : j’ai aussi installé sur le serveur ProFTPD (un serveur FTP) qui me permet de gérer les fichiers
sur le serveur Web de tous autres postes de notre réseau, et en particulier du mien ;-)
La problématique
Une installation de la librairie YAZ sur le système et de l’extension nécessaire pour PHP n’est pas, à ma
connaissance, disponible dans les dépôts pour PHP5.
Il faut donc mettre un peu les mains dans le cambouis.
Que les nouveaux venus dans le monde Linux et PMB se rassurent : je n’ai pas réussi du premier coup
mais après de nombreux tâtonnements et récupérations d’informations sur la toile.
Je ne donne ici que les résultats.
Le schéma général
Voici, sans chronologie, les grandes étapes de cette procédure :
1. installer l’extension YAZ de PHP à partir de PECL qui est un dépôt d'extensions PHP (sur le
même principe que les dépôts Debian ou Ubuntu),
2. installer le paquetage php-dev nécessaire à l’exécution des commandes PECL (commande qui,
dans notre cas, nécessite une commande phpize),
3. télécharger, compiler et installer la libraire YAZ 3.0.2, version minimum nécessaire à notre
extension PHP (en effet, cette version de YAZ n’est pas disponible sur les dépôts Debian/Ubuntu),
4. installer le paquetage libyaz-dev nécessaire à l’exécution notre commande PECL (qui recherche un
fichier configure dans YAZ),
5. valider le chargement de l’extension dans php.ini.
Ubuntu/Debian, PhP5, YAZ et PMB.
3/4
PDF créé le dimanche 11 avril 2010 – v 2.0.0
Le déroulé commenté
1)
Actions/Commandes
sudo apt-get install php-pear
Commentaires
Installe PEAR qui permet l’interprétation des
commandes PECL.
Pour en savoir plus sur PEAR :
http://pear.php.net/
Pour en savoir plus sur PECL :
http://fr2.php.net/manual/fr/install.pecl.php
Et aussi http://pecl.php.net/
2)
sudo apt-get install php5-dev
Nécessaire pour disposer de la commande phpize
utilisée par la commande PECL d’installation de
l’extension (voir 16))
3)
sudo apt-get install libyaz-dev
Nécessaire pour disposer du fichier configure lors
de l’installation de l’extension PHP.
4)
sudo apt-get install build-essential
Installe les outils de compilation.
5)
Télécharger l’archive yaz-3.0.2.tar.gz
6)
sudo mkdir ~/sources
On la trouve ici : http://ftp.indexdata.dk/pub/yaz
J’ai fait le téléchargement sur un autre poste, d’où
l’utilité du serveur ftp (voir Note 2 du § Point de
départ).
Crée un répertoire sources dans le /home de
l’utilisateur en cours (il faut bien mettre quelque
part notre archive).
7)
sudo cp […]/yaz-3.0.2.tar.gz ~/sources
Copie l’archive dans le répertoire créé en 6).
[…] = là où est l’archive suite au téléchargement.
8)
tar zxvf ~/sources/yaz-3.0.2.tar.gz
Décompresse l’archive dans ~/
On y trouve ensuite un repertoire /yaz-3.0.2 qui
contient tous les fichiers et dossiers de yaz.
9)
cd ~/yaz-3.0.2.tar.gz
On va dans le répertoire décompressé.
10)
./configure
Configure la future compilation
11)
make
Là, ça compile dûr !!!
Il faut être dans le répertoire concerné pour que la
commande simple fonctionne (voir 9)).
12)
sudo make install
Installe la version compilée de YAZ (3.0.2 ici).
Il faut être dans le répertoire concerné pour que la
commande simple fonctionne (voir 9)).
13)
sudo apt-get build-dep yaz
Recherche les dépendances éventuelles de
l’installation précédente. Je ne sais pas si cela est
nécessaire (je rappelle mon manque d’expertise et
l’empirisme de ma procédure), mais comme je l’ai
fait je préfère le signaler.
Ubuntu/Debian, PhP5, YAZ et PMB.
4/4
PDF créé le dimanche 11 avril 2010 – v 2.0.0
Actions/Commandes
sudo nano /usr/bin/yaz-config
Commentaires
Edite le fichier yaz-config.
On y trouve la ligne suivante :
YAZVERSION=2.1.8
Je la modifie en :
YAZVERSION=3.0.2
sudo pecl install yaz
Evite une erreur sur le numéro de version.
14)
15)
16)
Télécharge et installe automatiquement l’extension
yaz pour PHP.
Cela à notamment pour effet de créer un fichier
yaz.so dans le répertoire des extensions de PHP
(par défaut pour moi : /usr/lib/php5/20051025/)
Faire Return à la question :
Path to yaz installation ? [autodetect]
sudo nano /etc/php5/apache2/php.ini
Edite le fichier de paramétrage de PHP.
19)
Ajouter dans le fichier la ligne :
extension=yaz.so
Indique qu’il faut charger le module YAZ au
démarrage du serveur.
20)
sudo /etc/init.d/apache2 restart
Redémarre le serveur Apache, ce qui permet le
chargement des modules PHP (entres autres).
17)
18)
Contrôles et essais
1)
Si vous avez posé un fichier phpinfo.php sur votre serveur lancez-le à partir d’un navigateur.
Vous devriez y trouver une rubrique telle que celle-ci (et c’est bon signe !!!) :
2)
Lancer PMB d’un navigateur et faire un essai de recherche et d’importation de notices de bibliothèques
en ligne (personnellement, j’ai fait ce test avec le jeu de données d’essai fourni avec PMB) :
• onglet Catalogue,
• menu Z39.50/Recherche,
• j’ai fait sur ENS Paris – INNOPAC en mettant le sujet Informatique,
• message au bout de quelques secondes :
TERMINE : le serveur a retourné 100 notices sur 232 trouvées.
• clic sur le bouton Résultats,
• clic sur une des notices : elle s’affiche,
• clic sur le bouton Intégrer la notice : ça fonctionne !