/*
 * @version $Id: LISEZMOI.txt,v 1.30 2006/03/02 22:07:10 moyo Exp $
 ----------------------------------------------------------------------
 GLPI - Gestionnaire Libre de Parc Informatique
 Copyright (C) 2003-2006 by the INDEPNET Development Team.
 
 http://indepnet.net/   http://glpi.indepnet.org
 ----------------------------------------------------------------------

 LICENSE

	This file is part of GLPI.

    GLPI is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    GLPI is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with GLPI; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 ------------------------------------------------------------------------
*/

// ----------------------------------------------------------------------
// Original Author of file:
// Purpose of file:
// ----------------------------------------------------------------------
 
Contenu :

- Qu'est ce que c'est ?
- Dpendances
- Installation et configuration
- Mise  jour
- Plugins




*************************************************************************************************************
--- Qu'est-ce que c'est ?
*************************************************************************************************************


GLPI est un gestionnaire de parc informatique.
Il permet de recenser et de grer l'intgralit des composantes matrielles
ou logicielles d'un parc informatique, et ainsi d'optimiser le travail des
techniciens grce  une maintenance plus cohrente.
Les fonctionnalits principales de l'application s'articulent autour de deux
axes :

1) L'inventaire prcis de toutes les ressources techniques, matrielles et
logicielles, existantes dont les caractristiques seront stockes dans
une base de donnes.


2) La gestion et l'historisation, des diverses oprations de maintenance et
des procdures lies, ralises sur ces ressources techniques.

Enfin, cette application a pour but d'tre dynamique et directement relie
aux utilisateurs. Une interface autorise donc ces derniers  ventuellement
prvenir le service de maintenance et  rpertorier un problme rencontr
avec l'une des ressources techniques  laquelle ils ont accs.


*************************************************************************************************************
--- Dpendances (uniquement test avec ces configurations)
*************************************************************************************************************

1) Apache 1.3.>6 avec PHP 4 ou PHP 5
2) MySQL 4.2 et suprieures
3) Javascript activ




*************************************************************************************************************
--- INSTALLATION DE GLPI ET CONFIGURATION
*************************************************************************************************************

L'installation de GLPI est assez simple. Depuis la version 0.4 il n'y a plus, en particulier, de fichier  
modifier   la main .

La procdure est la suivante :

1. Rcuprez l'archive de GLPI sur notre serveur, et la dcompacter sur votre ordinateur personnel. 
Vous obtenez un dossier glpi contenant l'ensemble des fichiers du logiciel GLPI.

2. Copier ce dossier sur le serveur destin  accueillir GLPI.

3. Connectez-vous avec votre navigateur sur GLPI. GLPI vous proposera une interface graphique vous permettant 
de configurer le logiciel. Une fois ces quelques informations de configuration fournies, 
GLPI sera totalement install et vous pourrez commencer  travailler.

------ Procdure dtaille

--- Configuration ncessaire

Vous devez au minimum disposer d'un espace sur un serveur Web avec :
-  un accs au serveur pour l'installation des fichiers (FTP, SSH, etc);
-  le support de PHP4 ou suprieure compile avec le support des sessions ;
-  un accs  une base de donnes MySQL.

Avant l'installation, vous devez avoir une base MySQL disponible. Si vous n'tes pas l'administrateur 
du serveur, il faut demander l'activation d'une base MySQL  l'administrateur.

Vous devez connatre les donnes de votre connexion MySQL (fournies par l'administrateur) :
-  l'adresse du serveur MySQL ;
-  votre login MySQL ;
-  votre password MySQL ;
-  le nom de la base de donnes

--- Rcuprer GLPI

GLPI est disponible en tlchargement par le Web  l'adresse :
-  http://glpi.indepnet.org rubrique tlchargement.

Choisissez la version qui vous intresse, dcompactez l'archive sur votre ordinateur dans un rpertoire 
de votre choix, puis transfrez le contenu de ce rpertoire sur le serveur Web.

Si vous tes l'administrateur du serveur dcompresser l'archive dans le rpertoire racine d'Apache 
(/var/www  ou /var/www/html).

--- Installer les fichiers

Installez l'ensemble des fichiers de GLPI dans l'espace Web,  l'endroit o vous voulez que GLPI soit 
accessible au public.

Maintenant, il est ncessaire d'accorder des permissions  certains rpertoires, de manire  ce que PHP 
ait les droits en criture sur : /backups/dump /glpi/config et glpi/docs

--- Dbut de l'installation

Dsormais tout se droule en ligne. Pour dbuter l'installation il vous suffit de faire pointer votre 
navigateur web sur le dossier racine de GLPI : http://votreserveur/glpi/ (par dfaut).

Lors de la premire connexion  cette adresse, une procdure d'installation pas--pas dmarre. 
L'interface est intuitive, il suffit d'entrer les informations demandes.

--- tapes prliminaires :

A- Choix de la langue.

Vous arrivez alors sur la premire tape prliminaire, qui consiste  choisir la langue dans laquelle 
se droulera l'installation.

Si vous voulez que la langue soit le Franais slectionnez  french  et cliquez sur  OK .

B- Installation ou mise  jour.

Vous souhaitez faire une installation, donc cliquez sur  Installation .

C- Vrification de la compatibilit de votre environnement avec l'excution de GLPI

Cette tape va vrifier que vous avez correctement ralis les pr-requis  l'installation. Si ce n'est 
pas le cas, il vous sera impossible d'accder aux tapes suivantes. Un message d'erreur assez explicite 
vous indiquera les actions  raliser avant de ressayer.

Si toutes les vrifications ont t ralises avec succs, cliquez sur  continuer .

--- tapes de l'installation

tape 1 : Configuration des informations de connection au serveur de base de donnes.

Vous arrivez alors sur un formulaire vous permettant d'entrer les informations ncessaire  la connection 
au serveur MySQL.

Dans le champs  Mysql server  entrez le chemin rseau d'accs au serveur, par exemple : localhost, ou 
mysql.domaine.tld

Dans le champs  Mysql user  entrez le nom d'utilisateur vous permettant de vous connecter au serveur Mysql.

Dans le champs  Mysql pass  entrez le mot de passe associ  l'utilisateur que vous venez d'entrer dans le 
champs  Mysql user  Ce champs peut tre laiss vide si l'utilisateur n'as pas de mot de passe (Il ne sera 
pas fait de commentaires sur la scurit d'un tel usage de Mysql car ce n'est pas l'objet de cet article).

Une fois que ces trois champs sont correctement remplis cliquez sur  continuer .

L deux possibilits :

-  soit vos paramtres sont valides, auquel cas vous passez  l'tape suivante.
-  Soit vos paramtres sont invalides, auquel cas un message d'erreur est affich, cliquez sur retour pour 
modifier vos paramtres de connection et essayer de nouveau.

tape 2 : Cration ou choix de la base de donnes et initialisation.

Maintenant que vous tes correctement connect au serveur MySQL, vous devez crer ou choisir la base de donnes 
destine  accueillir l'application GLPI.

Deux possibilits :

-  Une base dj existante destine  accueillir GLPI est dj en place :

Slectionnez cette base dans la liste des bases affiches. Cliquez sur continuer pour initialiser 
la base de donnes.

-  Vous souhaitez crer une nouvelle base de donnes pour accueillir GLPI :

Attention cette tape ncessite que l'utilisateur ait les droits ncessaires  la cration d'une nouvelle base.

Slectionnez  crer une nouvelle base de donnes . Entrez le nom que vous souhaitez donner  la base 
dans le champ texte prvu  cet effet. Cliquez sur continuer pour initialiser la base de donnes.

tape 3 : Transition et explications :

Cette tape vous informe que la base de donnes est initialise avec les valeurs par dfaut. 
Et vous donne un certain nombre d'indications sur ces valeurs. Lisez attentivement ces informations 
et cliquez sur  continuer .

L'tape 4 : vous indique que l'installation de GLPI est maintenant termine, et vous rcapitule un 
certain nombre d'informations. Lisez attentivement ces informations et cliquez sur  utiliser GLPI  
pour effectuer votre premire connection  l'application.

--- Fin de l'installation

En cas de grosse erreur (du genre : vous avez oubli votre propre accs  GLPI...), pour  relancer  cette 
procdure d'installation, il faut utiliser votre logiciel FTP (par exemple) et effacer le fichier suivant :
-  glpi/config/config_db.php

Pointer votre navigateur web sur le dossier racine de GLPI : http://votreserveur/glpi/ (par dfaut) relancera 
alors la procdure de configuration (en ralit, c'est l'absence de fichier  config_db.php  qui provoque le 
lancement de cette procdure).



*************************************************************************************************************
--- MISES A JOUR 
*************************************************************************************************************


I) Sauvegarde de votre ancienne configuration :

Avant de faire quoi que ce soit il convient de faire deux choses :

1 - Sauvegardez votre base de donne via l'interface de sauvegarde de glpi. 
2 - Sauvegardez tout le rpertoire GLPI (il contiendra la sauvegarde de votre base SQL et vos documents (GLPI >= 0.5))

A partir de l, si la mise  jour se droule mal ou que les nouvelles implantation de 
la version ne vous conviennent pas, il sera facile de revenir  votre version prcdente.

Si nanmoins cette procdure se droulait mal, merci de nous faire parvenir au plus vite sur 
les mailing listes, ou sur le forum du site du projet, ou sur le bugtrack la procdure utilise 
et le message d'erreur que vous obtenez.

II) Rcupration et installation des fichiers.

1)Tlchargez le tarball de la dernire version  disponible dans la rubrique tlchargement du site du 
projet glpi (http://glpi.indepnet.org).

2)Dcompressez la nouvelle archive de GLPI,  la place de l'ancienne.

3)Supprimez le fichier [votre_racine_http/]glpi/glpi/config/config_db.php

4) Verifiez ou changez les droits sur les dossiers suivants :

-[votre_racine_http/]glpi/backups/dump
-[votre_racine_http/]glpi/glpi/config/
-[votre_racine_http/]glpi/docs/

de manire  ce que PHP y ait les droits d'criture.


III)Lancement de la mise  jour :

1) Faites pointer votre navigateur web sur http://votreserveur/glpi/

2) Slectionnez la langue dans laquelle vous souhaitez effectuer la mise  jour et cliquez sur  ok .

3) Cliquez sur  mise  jour .

4) Vrifiez que les tests d'environnement on bien tous t ralis avec succs, sinon suivez les 
instructions et ressayez.

Si tout c'est bien pass, cliquez sur  continuer .

5)Configurez l'accs au serveur Mysql, aidez vous du fichier config.php que vous avez sauvegard, 
pour remplir :
Mysql serveur : le nom d'hte mysql
Mysql user : le nom d'utilisateur mysql
Mysql pass : le mot de passe associ au nom d'utilisateur mysql

Une fois tout ceci fait cliquez sur  continuer 

6) Slectionnez la base de donnes que vous souhaitez mettre  jour.
Si vous ne connaissez pas son nom, rfrez vous au fichier config.php que vous avez sauvegard, 
il s'agit du nom se trouvant dans la variable $dbdefault.
Cliquez sur  continuer 

7) Un cran vous demande si vous tes sr de vouloir mettre  jour votre base de donnes, 
cliquez sur  continuer  si c'est la cas.

8) La mise  jour commence, cela peut prendre un certain temps en fonction de la taille de 
votre base de donnes.


9) Il existe une diffrence majeure en les versions <  0.5 et les versions > 0.5 : la gestion des lieux.
En effet, celle-ci est maintenant hirarchique. 
Un systme vous permet donc d'adapter vos anciens lieux a cette nouvelle architecture.
Pour cela, deux paramtres vous sont prsents en bas de la page :
1 - le caractre de sparation qui vous avez peut-etre utilis pour dfinir votre hierarchie interne
2 - la dfinition d'un lieu RACINE si vous le voulez

Une fois ces options choisies un tableau vous prsenta la nouvelle hierarchie gnre.
Si elle vous convient vous pouvez valider en dessous du tableau.
Sinon, vous pouvez changer vos paramtres et regnrer une hierarchie en cliquant sur le premier << Valider >>

### PAS FORCEMENT VISIBLE SUIVANT VOS CONFIGURATIONS ###
10 ) Il vous faudra utiliser les formulaires de configuration post-installation dans le menu  configuration 
 de l'application.

Ces menus ne sont accessibles qu'a un nouveau type d'utilisateur ajout dans glpi : le  super-admin , 
la mise a jour effectue donc automatiquement la conversion  admin -> super-admin  ou vous permet 
de crer un utilisateur  super-admin 

A partir de ce moment, plusieurs cas sont possibles en fonction de la version depuis laquelle vous 
mettez votre base de donne  jour et de vos anciennes configurations.


CAS 1: Vous aviez des utilisateurs de type  admin , ou qu'au moins un des utilisateurs de type 
 admin  ne se connectaient pas  l'application depuis des sources externes (ldap,imap) (puisque 
dans ce cas le mot de passe n'est pas stock dans la base de donnes).

Tous vos utilisateurs ayant auparavant les droits  admin  et un mot de passe non vide se retrouvent 
avec les droits  super-admin , un message vous en informe.

Votre base de donnes est a jour, vous pouvez dsormais configurer GLPI en cliquant sur  utiliser GLPI  
et en vous connectant avec l'un des utilisateurs anciennement admin.

CAS 2: Vous n'aviez pas d'utilisateurs de type  admin  ou que tous les  admin  ont un mot de passe vide 
(puisqu'ils se connectent depuis des sources externes).

Le script vous demande de bien vouloir saisir un nom d'utilisateur et de un mot de passe associ (n'entrez 
pas le nom d'un utilisateur dj existant).
######

11) Mise  jour du contenu
En fonction de votre version antrieure, le contenu des donnes prsentes dans votre base de donnes 
peuvent avoir t stock de manire non conforme au moteur de GLPI actuel. 
Pour remdier  cela et afin que l'affichage de vos donnes soit correcte, l'ensemble de votre base donnes
est analyse et mise  jour. Cela peut prendre pas mal de temps en fonction du volume d'information
contenu dans votre base de donnes.

12) Fin de la Mise  jour

Si cette procdure russi, votre base de donnes maintenant  jour vous pouvez configurer GLPI en cliquant 
sur  utilisez GLPI  et en vous connectant avec l'utilisateur que vous venez de crer.

Une fois la configuration termine, vous pourrez supprimer cet utilisateur. Attention assurez vous qu'il 
reste toujours un utilisateur  super-admin  ayant la possibilit de se connecter  l'application, 
ne serait qu'en cas de problmes avec les sources de donnes externes.


*************************************************************************************************************
--- PLUGINS
*************************************************************************************************************

Les plugins sont grs par GLPI au sein du rpertoire plugins.
Il suffit de mettre en place le rpertoire du plugin dans ce rpertoire et il apparait ensuite dans le menu.
