// +---------------------------------------------------------------------------------------+
//  2002-2005 PMB Services / www.sigb.net pmb@sigb.net et contributeurs (voir www.sigb.net)
// +---------------------------------------------------------------------------------------+
// $Id: install.txt,v 1.8 2008-01-28 16:20:18 touraine37 Exp $

+--------------------------------------------------------------------------------+
| Installation de l'application PMB                                              |
|                                                                                |
| PMB v2.1 - Mai 2005                                                            |
+--------------------------------------------------------------------------------+

1 Pr-requis

PMB est une application 3 tiers bas sur un environnement
web classique. Pour fonctionner elle ncssite :


* Cot serveur :

  * Un serveur web quelconque capable d'intgrer le langage PHP

  * Le langage PHP pour excuter les scripts

  * Un serveur de base de donnes MySQL de version suprieure ou gale  4.0
    

* Cot client :

  * Un navigateur web de gnration rcente (MS I.E. 6, Netscape 7, ...)
    

* Spcificits du langage PHP requises :

  * Version suprieure ou gale  4.3

  * Modules impratifs : mysql, gd, xslt, curl

  * Modules optionnels pour activer certaines fonctionnalits
    : yaz pour la recherche z3950, bz2 pour la compression
    directe des sauvegardes.

(pour plus de dtails, sous windows, voir le fichier pre_requisite.txt)

2 Installation

Tlchargez la dernire version sur le site de PMB [http://www.sigb.net].
Le fichier est au format d'archive zip (pour windows comme pour linux). 

Extraire l'archive dans le rpertoire de votre serveur web
o vous souhaitez installer PMB. Dans la suite du document, 
nous prendrons comme exemple une extraction dans le sous rpertoire pmb du rpertoire
racine de votre serveur web sur la machine monserveur. 

2.1 Cration de la base de donnes et initialisation de l'application

A partir de l'endroit o vous avez extrait l'archive, appellez
la page tables/install.php (dans notre exemple appellez
l'URL http://monserveur/pmb/tables/install.php).
Cette page vous permet de crer la base de donnes sur le
serveur MySQL, la remplit avec le minimum requis pour le fonctionnement de PMB et cr l'utilisateur administrateur de
PMB. Deux zones sont  renseigner.

!!!!!!!!!!!!!!!! ATTENTION !!!!!!!!!!!!!!!!! :
SI VOUS N'UTILISEZ PAS CETTE PROCEDURE, PENSEZ A SUPPRIMER LES DEUX FICHIERS
		INSTALL.PHP et INSTALL_REP.PHP
EN PLUS : PENSEZ A CHANGER LE MOT DE PASSE DE L'UTILISATEUR ROOT DE MYSQL
IL EST VIDE PAR DEFAUT, CE QUI CONSTITUE UN TROU EVIDENT.
!!!!!!!!!!!!!!!! ATTENTION !!!!!!!!!!!!!!!!! :
	

2.1.1 Paramtres systme

Ce sont les paramtres du serveur MySQL qui seront utiliss
pour crer la base de donnes. Il est impratif que l'utilisateur
MySQL aie les droits d'administration du serveur pour pouvoir
crer la base de PMB et crer l'utilisateur MySQL de cette
base. Le champ Serveur permet d'indiquer le nom de la machine
hbergeant le serveur MySQL (il peut bien sr tre diffrent
de la machine hbergeant le serveur web).

2.1.2 Paramtres PMB

Ce sont ces paramtres que le script utilisera pour crer
la base PMB et l'utilisateur MySQL correspondant :

* Utilisateur PMB/Mot de passe : utilisateur MySQL qui sera
  cr pour accder  la base de PMB

* Base de donnes PMB : nom de la base de donnes qui sera
  cre.

* Remplir les tables avec le jeu d'exemples : si vous cochez
  cette case, la base sera remplie avec un jeu d'exemple
  de notices et d'autorits ce qui peut vous permettre de
  tester l'application.

Une fois les paramtres remplis, cliquez sur le bouton Crer
la base.

2.2 Fichiers de configuration de connexion  la base de donnes

Une fois la base cr, vrifiez les fichiers de configuration
de connexion de PMB  la base de donnes. Editer le
fichier db_param.inc.php dans le sous rpertoire includes
du rpertoire d'installation.

Vrifiez la ligne :

define('LOCATION','nom_de_votre_base');

(nom_de_votre_base est le nom saisi dans le champ Base de donnes PMB de la page d'installation. 
Si vous avez laiss les paramtres par dfaut : bibli),

Vrifiez que les paramtres de la section nom_de_votre_base correspond aux
paramtres de connexion de l'installation :

nom_de_votre_base:                // valeurs pour l'accs local

        define('SQL_SERVER', 'chemin_du_serveur');              //nom du serveur

        define('USER_NAME', 'utilisateur_pmb');                   //nom utilisateur

        define('USER_PASS', 'mot_de_passe');                   //mot de passe

        define('DATA_BASE', 'nom_de_votre_base');                   //nom base de donnes

        break;

Faites la mme vrification avec le fichier opac_db_param.incp.php dans opac_css/includes.

2.3 Premire connexion

Une fois toutes les oprations prcdentes effectues, vous
pouvez tester la connexion  l'application PMB. Tapez l'adresse
de votre installation dans votre navigateur http://monserveur/pmb

Dans la page de connexion,
connectez vous avec  :

* Utilisateur : admin

* Mot de passe : admin

Si tout s'est bien pass, vous devez avoir la premire page
de PMB  l'cran avec en haut 5 onglets dont l'onglet circulation activ. Au centre de la page, 
un champ de saisie du code barres d'un lecteur

Remarque : Lors de la cration de la base de donnes, un
seul utilisateur ayant tous les droits d'aministration est
cr. Cet utilisateur a pour nom Super User, pour login
admin et comme mot de passe admin

2.4 Cration du paramtrage et mise  niveau de la base

Afin de conserver la base  jour, aprs chaque installation ou mise  jour :

* Cliquez sur l'onglet 'Administration'

* dans le menu  gauche de l'cran d'administration, cliquez
  sur Outils puis sur le lien 'Maj base' en haut de l'cran 
  
* Cliquez sur le lien 'cliquez ici pour commencer la mise  jour'

* Cliquez sur poursuivre jusqu'au message 'Votre base est  jour en version vxxx !'
  
3 Changement du mot de passe administrateur

Nous n'aborderons pas dans ce document la gestion des droits
et les diffrents paramtrages possibles de PMB. Pour cela
reportez vous au Guide de l'administrateur.

Afin de scuriser l'accs  PMB, la deuxime chose  faire
aprs l'installation est de modifier le mot de passe de
l'utilisateur admin. 

Cet utilisateur dispose de tous les droits dans PMB et il
porte pour cela le nom par dfaut "Super
User". Il n'est pas possible de supprimer cet utilisateur. 


Pour modifier le mot de passe :


1. cliquez sur l'onglet 'Administration' 

2. dans le menu  gauche de l'cran d'administration, cliquez
  sur le lien 'utilisateurs'

3. dans la page de gestion des utilisateurs, cliquez sur le
  lien [mot de passe] de l'utilisateur Super User.

4. saisissez deux fois le nouveau mot de passe que vous souhaitez
  utiliser dans les cases nouveau mot de passe et confirmation

5. enfin cliquez sur le bouton Enregistrer
  

Vous pouvez aussi modifier le login admin et le nom Super
User en cliquant sur le lien admin de l'utilisateur Super
User dans la page de gestion des utilisateurs.

4 Configurations testes

Le logiciel PMB a t test sur les plateformes suivantes :


* Windows XP avec EeasyPHP 1.6 et 1.7

* Windows 98 avec EasyPHP 1.6 et 1.7

* Windows 2000 server avec IIS/MySQL 3.23

* Linux Mandrake 8.2 avec Apache 1.3.23/ MySQL 3.23

* MacOsX avec Apache/MySQL

Annexes : 
Droits sur le serveur : 
	Afin d'utiliser la possibilit de chargement de fiches UNIMARC
	 partir de l'administration, il faut que le service http de votre
	hbergement dispose des droits d'criture sur le rpertoire admin/import de
	PMB (ce qui est en principe le cas). En outre, votre fichier ne 
	doit pas dpasser une certaine taille (limite d'upload de votre hber-
	geur).
	A dfaut, la solution pour les imports de fiches UNIMARC consiste  
	tlcharger le fichier  charger dans le rpertoire admin/import de 
	PMB, par FTP par exemple, puis  choisir l'option 
	"prchargement"  partir de la page d'import de l'administration.
	
	Pour pouvoir gnrer des codes barres, le serveur web doit avoir le droit 
	d'criture dans le rpertoire temp de PMB