Installer PMB sur Debian ou sur l'hébergement académique mutualisé

De Wiki Dane (ex wikitice)
Aller à : navigation, rechercher

Document en cours de rédaction

Document ayant servi à la rédaction de celui-ci :

PMBDoc Site communautaire et universitaire sur PMB [1] Linux, PMB & le logiciel libre en bibliothèque [2]

Installation sur un serveur autonome

Cette partie n'est pas nécessaire si vous exploitez l'hébergement académique mutualisé. Cf 2 

Installation du serveur web

Installation d'Apache 2 et de PHP 5

Dans un terminal tapez la commande suivante :

aptitude install apache2 php5 libapache2-mod-php5

Dans votre navigateur taper l'adresse : localhost
Vous devez voir s'afficher It Works ! qui vous informe qu'Apache fonctionne correctement.

Pour vérifier que votre serveur PHP fonctionne correctement, créez le fichier phpinfo.php dans le dossier /var/www :

vi /var/www/phpinfo.php

Tapez sur la touche [a] du clavier : pour entrer dans le mode insertion.

Tapez ou collez le code suivant :

<?php 
phpinfo(); 
?> 

Tapez sur la touche [esc] pour quitter le mode insertion.
Tapez deux fois sur la touche [Z] pour sauvegarder et sortir de vi.

Relancer Apache pour que les modifications soient prises en compte :

/etc/init.d/apache2 reload

Installation de MySQL 5.0

Dans un terminal tapez la commande suivante :

aptitude install mysql-server

Tapez le mot de passe root de Mysql que vous avez choisi.

Si ultérieurement vous voulez modifier votre mot de passe root de Mysql tapez la commande suivante :

dpkg-reconfigure mysql-server-5.0

Installation de Phpmyadmin

Tapez la commande suivante :

aptitude install phpmyadmin

Sélectionner Apache2 en appuyant sur la barre d'espace du clavier.
Appuyer sur la touche [tab] pour vous rendre sur OK et appuyer sur [Entrée]

En cas d'erreur vous pouvez reconfigurer php myadmin avec la commande suivante :

dpkg-reconfigure phpmyadmin

Pour vérifier que l'installation a réussi tapez dans la barre d'adresse de votre navigateur : localhost/phpmyadmin (si besoin remplacer localhost par l'adresse de votre serveur).
L'interface web de PhpMyAdmin se lance,connectez-vous en tant que root avec le mot de passe Mysql que vous avez défini.

Installation des extensions Php5

Pour fonctionner pleinement PMB a besoin de certain module php.
Pour les installer tapez la commande suivante :

aptitude install php5-gd php5-xsl php5-curl

Si vous souhaitez utiliser l'identification ldap installez le module suivant :

aptitude install php5-ldap

Modifications à réaliser dans « php.ini »

Pour ne pas avoir de souci, notamment lors de la conversion de votre base, il faut modifier certains paramètres dans le fichier php.ini. Pour ce faire éditer le fichier avec la commande suivante :

vi /etc/php5/apache2/php.ini

Rechercher dans le fichier les lignes suivantes et donner les valeurs indiquées ci-dessous :

max_execution_time = 300 ; Maximum execution time of each script, in seconds
memory_limit = 200M ; Maximum amount of memory a script may consume (8MB)
post_max_size = 200M
upload_max_filesize = 200M

Installation pour le protocole Z39-50

L'installation n'est pas obligatoire mais ce protocole permet de récupérer directement des notices de la BNF, de Citédoc... Dans un terminal tapez la commande suivante

aptitude install build-essential fakeroot checintstall yaz libyaz3-dev dh-make-php php5-dev autoconf automake

Les paquets yaz correspondent à des outils liés au protocole Z39.50. Les autres permettent d'installer des paquets non debian. Une fois ces paquets installés, nous allons télécharger la version 1.0.14 de yaz. Ouvrez un terminal et exécutez les commandes suivantes :

wget http://pecl.php.net/get/yaz-1.0.14.tgz

Décompressez l'archive :

tar xzvf yaz-1.0.14.tgz

Placez vous ensuite dans le répertoire décompressé :

cd yaz-1.0.14

Nous allons maintenant opérer une compilation, opération nécessaire pour que le système puisse interpréter le code source. Créez le ./configure en exécutant la commande :

phpize

Puis, tapez la commande qui permet d'adapter le code source au système :

./configure

Enfin, compilez le code à l'aide de la commande :

make

L'opération n'est pas terminée. Il s'agit maintenant d'intégrer le module dans php5. Pour cela, restez dans le terminal et exécutez la commande :

sudo cp modules/yaz.so /usr/lib/php5/20060613+lfs/

Puis éditez le fichier php.ini

sudo gedit /etc/php5/apache2/php.ini

Recherchez la rubrique Dynamic Extensions, et ajoutez la ligne suivante : extension=yaz.so. Redémarrez le serveur apache :

sudo /etc/init.d/apache2 restart


Méthode alternative et plus simple d'installation de YAZ

Ajoutez la ligne :

deb http://ftp.indexdata.dk/debian lenny main

dans /etc/sources.list

remplacez lenny par le nom de votre distribution puis tapez :

aptitude update 

et :

aptitude install php5-yaz 

Confirmez et c'est fini. On peut charger la clé indexdata avant de lancer la procédure d'installation pour éviter le message d'alerte, c'est plus propre mais pas nécessaire, pour cela tapez :

wget http://ftp.indexdata.dk/debian/indexdata.asc

puis

apt-key add indexdata.asc

Installation de PMB

Pour utiliser PMB dans un CDI il faut installer la base Bretagne qui permet de créer 7 champs qui n'existent pas d'origine dans PMB : nature du document (fiction, documentaire, essai), thèmes, genres, niveaux, discipline, année de péremption et date de saisie (dans l'ancienne base). De plus cela permet de ne pas perdre ces informations lors d'une migration depuis un autre logiciel.

Télécharger les fichiers nécessaires

Télécharger la dernière version de la base Bretagne Unesco (actuellement il s'agit de la version 3.1.27) à l'adresse suivante : http://www.citedoc.net/index_bis.php?page=pmb_telechargement

Télécharger la dernière version de PMB (actuellement il s'agit de la version 3.3.7) à l'adresse suivante : http://www.pmbservices.fr/download/download.php

Installer les fichiers de PMB sur le serveur web autonome

Décompresser l'archive de PMB.

Vous pouvez le faire en ligne de commande (dans la suite vous devez avoir téléchargé l'archive de PMB dans le répertoire à votre nom et votrecompte correspond à votre nom d'utilisateur)

Ouvrez un terminal en tant que root

# su

Tapez votre mot de passe root Debian

# cd /home/votrecompte/

Décompresser l'archive

# unzip pmb3.3.7.zip

Une fois l'archive décompressée copiez le dossier pmb dans le répertoire /var/www

# cp -r pmb /var/www

Modifier les droits d'accès au répertoire pmb

Dans votre terminal déplacez vous dans le répertoire /var :

# cd /var 

On définit le propriétaire du répertoire /www :

# chown -R www-data:www-data www 

Déplacez vous dans le répertoire www :

# cd www 

On définit les droits sur les fichiers :

# find -type f -exec chmod 0640 {\} \; 

On définit les droits sur les dossiers :

# find -type d -exec chmod 0750 {\} \;

Installation de la base

Lancez votre navigateur sur l'adresse : localhost/pmb/tables/install.php

L'écran d'installation de PMB s'affiche, faite les choix nécessaire.

Encodage de caractère (charset) :iso-8859-1 (pour l'instant je n'ai pas tenté l'installation et la conversion d'une base en UTF-8 mais la base Bretagne étant en iso je ne suis pas sûr que cela soit possible)

Langue:Français

Paramètres système Utilisateur MySql : root Mot de passe : celui que vous avez attribué à l'installation de Mysql Serveur : localhost Base de données: laisser vide

Paramètres PMB Utilisateur PMB : bibli (modifier) Mot de passe : bibli (modifier) Base de données PMB : bibli

Chargement de données PMB Créer la structure de la base de données : Obligatoire Insérer le minimum : Obligatoire Insérer les données essentielles pour démarrer rapidement : oui Insérer les données du jeu de test opérationnel : non

Choix du thésaurus Aucun thésaurus UNESCO AGNEAUX ENVIRONNEMENT

Choisir Aucun thésaurus ou le thésaurus de l'UNESCO à décider avec le professeur documentaliste.

Choix de l'indexation interne Aucune indexation décimale BM de Chambéry Style Dewey 100 cases du savoir ou Marguerite des catégories : oui

La base de donnée est créer cliquer sur : Allez à la page d'accueil

Installation de la base Bretagne Tapez dans votre navigateur l'adresse suivante (remplacer si besoin localhost par l'adresse de votre serveur) : http://localhost/pmb/admin/sauvegarde/emergency/emergency.php

Pour garder le choix de thésaurus que vous avez déterminé lors de l'installation désélectionner thesaurus, categories, noeuds, voir aussi. Il est préférable de garder la configuration des serveurs Z39-50 déterminé lors de l'installation de PMB, pour cela désélectionner : z-attr, z-bib, z-notices, z-query

Connectez-vous à PMB normalement, Utilisateur : admin Mot de passe : admin

Allez en Administration > Outils > Mise à jour de la base Cliquer sur le lien pour mettre à jour la base de PMB


Paramétrer le Slis pour permettre la recherche Z39.50

Installation sur l'hébergement académique mutualisé

Préparation de l'hébergement

Création d'une base de donnée pour PMB

Il faut d'abord créer une nouvelle base de donnée pour PMB.

Connectez-vous à la console des webmestres de l'académie de Versailles

https://console.crdp.ac-versailles.fr/

Cliquez sur Accéder à « Mes hébergements »

Connectez-vous avec vos identifiants

Dans l'onglet Base de données, cliquez sur Ajouter une base de données. Le nom de la base de donnée est généré automatiquement.

Générez le mot de passe.

Notez le nom de la base de donnée crée et le mot de passe, ils seront nécessaires au moment de l'installation de PMB.

Modification de certaines valeurs de l'hébergement

Pour installer et transférer sa base vers PMB il faut modifier certaines valeurs dans php.ini, cela n'est pas possible directement sur l'hébergement académique. Avant de procéder à l'installation il faut donc demander, de façon temporaire, une modification de certains paramètres de votre hébergement.

Pour ce faire envoyez un mél à webmaster@crdp.ac-versailles.fr et demandez les valeurs suivantes :

  • Mémoire php : 256Mo (si les 192Mo alloués ne suffisent pas)
  • Upload autorisé : 500Mo
  • Time out : 500s

Une fois votre installation et votre transfert de base effectués envoyé un nouveau mél à webmaster@crdp.ac-versailles.fr pour revenir aux valeurs antérieures.

Installation de PMB

Pour utiliser PMB dans un CDI il faut installer la base Bretagne qui permet de créer 7 champs qui n'existent pas d'origine dans PMB :

  • nature du document (fiction, documentaire, essai)
  • thèmes
  • genres
  • niveaux
  • discipline
  • année de péremption
  • date de saisie (dans l'ancienne base)

Cela permet de ne pas perdre ces informations lors d'une migration depuis un autre logiciel.

Télécharger les fichiers nécessaires

Télécharger la dernière version de la base Bretagne Unesco (actuellement il s'agit de la version 3.4.16) à l'adresse suivante : http://www.citedoc.net/index_bis.php?page=pmb_telechargement

Télécharger la dernière version de PMB (actuellement il s'agit de la version 4.0.7) à l'adresse suivante : http://www.sigb.net/download/index.php

Transférer les fichiers de PMB vers l'hébergement académique

Décompresser l'archive de PMB et transférer le répertoire PMB par FTP sur l'hébergement académique.

L'adresse de PMB sera alors :

  • Pour un collège : www.clg-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/
  • Pour un lycée : www.lyc-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/

Installation de PMB

Lancez votre navigateur sur l'adresse :

www.clg-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/tables/install.php

ou

www.lyc-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/tables/install.php


L'écran d'installation de PMB s'affiche, faire les choix nécessaires.

PMB 01.png

  • Encodage de caractère (charset) : iso-8859-1
  • Langue : Français


Un deuxième écran apparaît

PMB 02.png

Paramètres système  :

  • Utilisateur MySql : nom de la base de donnée crée sur l'hébergement académique pour PMB 
  • Mot de passe : celui de la base de donnée crée sur l'hébergement académique pour PMB
  • Serveur : localhost 
  • Base de données: nom de la base de donnée crée sur l'hébergement académique pour PMB


PMB 03.png

Chargement de données PMB :

  • Créer la structure de la base de données : Obligatoire
  • Insérer le minimum : Obligatoire
  • Insérer les données essentielles pour démarrer rapidement : oui
  • Insérer les données du jeu de test opérationnel : non
  • Insérer les données du portail de test : non

Choix du thésaurus :

  • Choisir le thésaurus de l'UNESCO ou aucun thésaurus, à décider avec le professeur documentaliste.

Choix de l'indexation interne :

  • 100 cases du savoir ou Marguerite des catégories : oui


Finaliser l'installation en cliquant sur Créer la base en bas de la page.

Cet écran indique que l'installation s'est passée correctement.

PMB 04.png

Vous pouvez cliquer sur Allez à la page d'accueil et vous connecter :

  • Utilisateur : admin 
  • Mot de passe : admin


Cet écran vous indique que PMB n'est pas à jour, ne pas faire la mise à jour maintenant.

Il faut d'abord installer la base Bretagne.

PMB 05.png

Installation de la base Bretagne

Décompresser l'archive de la base Bretagne Unesco sur votre poste.

Tapez dans votre navigateur l'adresse suivante :

www.clg-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/admin/sauvegarde/emergency/emergency.php

ou

www.lyc-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/admin/sauvegarde/emergency/emergency.php

Vous obtenez l'écran suivant :

PMB 06.png

Indiquez le chemin du fichier bretagne_unesco_3.4.16.sav que vous avez décompressé précédemment avec le bouton parcourir.

Cliquez sur le bouton Click here to start restoring data

Un nouvel écran nommé Restauration de la sauvegarde... apparaît, rendez-vous en bas de la page et indiquez les informations de connexion au serveur, ce sont les mêmes que lors de l'installation de PMB.

PMB 07.png

  • Adresse du serveur : localhost 
  • Utilisateur autorisé : nom de la base de donnée crée sur l'hébergement académique pour PMB
  • Mot de passe : celui de la base de donnée crée sur l'hébergement académique pour PMB
  • Base de données: nom de la base de donnée crée sur l'hébergement académique pour PMB

Cliquez sur le bouton Lancer la restauration.

La restauration s'effectue, à la fin de celle-ci vous devez obtenir le message suivant : La restauration s'est passé correctement.


Connectez-vous à PMB en tapant dans votre navigateur l'adresse suivante :

www.clg-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/

ou

www.lyc-nom de l'établissement-ville de l'établissement.ac-versailles.fr/pmb/

  • Utilisateur : admin 
  • Mot de passe :

La base Bretagne restaure un mot de passe vide, après la connexion il faut donc rapidement indiquer un mot de passe pour l'utilisateur admin.

PMB vous indique que Votre version de base de données n'est pas à jour !

PMB 08.png

  • Cliquez sur OK
  • Cliquez sur Mettre à jour
  • Cliquez sur Cliquer ici pour commencer la mise à jour.
  • La mise à jour se fait étape par étape, à chaque étape cliquez su Cliquer ici pour poursuivre...

Votre base est désormais à jour.

N'oubliez pas d'indiquer un mot de passe pour le compte admin.

Migration et conversion de la base de données du CDI vers PMB

Pour une migration depuis BCDI consultez les sites suivants :

Citédoc : site des documentalistes de l'enseignement catholique de Bretagne

http://www.citedoc.net/index_bis.php?page=pmb_fiches

  • fiche Préparer vos bases BCDI pour la conversion à PMB
  • fiche 1.3.1 : Convertir les données de BCDI dans PMB
  • fiche 1.7 : Quelques manips post conversion de Superdoc ou de BCDI

Documentation PMB de l'académie de Rennes http://espaceeducatif.ac-rennes.fr/jahia/Jahia/lang/fr/pid/15730

  • fiche 2.3 Convertir les données de BCDI dans PMB
  • fiche 2.5 Manipulations post conversion