/*
 * @version $Id: LISEZMOI.txt 3909 2006-09-18 22:27:53Z jmd $
 -------------------------------------------------------------------------
 GLPI - Gestionnaire Libre de Parc Informatique
 Copyright (C) 2003-2006 by the INDEPNET Development Team.

 http://indepnet.net/   http://glpi-project.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
 --------------------------------------------------------------------------
*/


Contenu :

-  GLPI : 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.1.13 et suprieures
3) Javascript activ




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

----- Procdure simplifie

1. Rcuprez l'archive de la dernire version de GLPI sur le site www.glpi-project.org.

2. Dcompactez cette archive sur votre ordinateur personnel. 
Vous obtenez un dossier "glpi" contenant l'ensemble des fichiers du logiciel GLPI.

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

4. Faites pointer votre navigateur vers l'url d'installation de  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 suprieur compil 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 paramtres 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 sur le site Web du projet  l'adresse :
-  http://glpi-project.org rubrique "tlcharger".

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 : /files et /config

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

--- Fin de l'installation

La dernire tape 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.

Remarque : Pour plus de scurit, il est prfrable de limiter l'accs en lecture au fichier config/config_db.php  l'utilisateur du serveur web.

Exemple : chmod 400 config/config_db.php

---- En cas de grosse erreur 

Pour  relancer  cette procdure d'installation, il faut utiliser votre logiciel FTP (par exemple) et effacer le fichier suivant :
-  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).



*************************************************************************************************************
--- MISE A JOUR 
*************************************************************************************************************


I) Sauvegarde de votre ancienne configuration :

Avant de ancienne_installation_GLPI/backup/dumpfaire quoi que ce soit il convient de faire deux choses :

1 - Sauvegardez votre base de donnes 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 fonctionnalits de 
la version ne vous conviennent pas, il sera facile de revenir  votre version prcdente.

Si nanmoins vous rencontrez des problmes de mise  jour, merci de nous en informer sur 
les mailing listes, ou sur le forum du site du projet, ou sur le bugtrack de la procdure utilise 
et du 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-project.org).

Cas o vous passer en GLPI >= 0.68 :

Sauvegardez bien l'ensemble de votre rpertoire GLPI et supprimez le.


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

 !-  Certains rpertoires ont chang. Il vous faut donc copier leur contenu -!

ancienne_installation_GLPI/backup/dump -> nouvelle_installation_glpi/files/_dumps
ancienne_installation_GLPI/docs/ -> nouvelle_installation_glpi/files


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

-[votre_racine_http/]/glpi/files
-[votre_racine_http/]/glpi/config/

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 d'installer le repertoire qui contient le plugin dans ce rpertoire et il apparait ensuite dans le menu.
Vous pourrez configurer ventuellement votre plugin par la suite.
