/*
 * @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 ?
- Dépendances
- 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 gérer l'intégralité des composantes matérielles
ou logicielles d'un parc informatique, et ainsi d'optimiser le travail des
techniciens grâce à une maintenance plus cohérente.

Les fonctionnalités principales de l'application s'articulent autour de deux
axes :

1) L'inventaire précis de toutes les ressources techniques, matérielles et
logicielles, existantes dont les caractéristiques seront stockées dans
une base de données.


2) La gestion et l'historisation, des diverses opérations de maintenance et
des procédures liées, réalisées sur ces ressources techniques.

Enfin, cette application a pour but d'être dynamique et directement reliée
aux utilisateurs. Une interface autorise donc ces derniers à éventuellement
prévenir le service de maintenance et à répertorier un problème rencontré
avec l'une des ressources techniques à laquelle ils ont accès.


*************************************************************************************************************
--- Dépendances (uniquement testé avec ces configurations)
*************************************************************************************************************

1) Apache 1.3.>6 avec PHP 4 ou PHP 5
2) MySQL 4.1.13 et supérieures
3) Javascript activé




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

----- Procédure simplifiée

1. Récupérez l'archive de la dernière version de GLPI sur le site www.glpi-project.org.

2. Décompactez 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.

------ Procédure détaillée

--- Configuration nécessaire

Vous devez au minimum disposer d'un espace sur un serveur Web avec :
-  un accès au serveur pour l'installation des fichiers (FTP, SSH, etc);
-  le support de PHP4 ou supérieur compilé avec le support des sessions ;
-  un accès à une base de données 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 connaître les paramêtres 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 données.

--- Récupérer GLPI

GLPI est disponible en téléchargement sur le site Web du projet à l'adresse :
-  http://glpi-project.org rubrique "télécharger".

Choisissez la version qui vous intéresse, décompactez l'archive sur votre ordinateur dans un répertoire de votre choix, puis transférez le contenu de ce répertoire sur le serveur Web.

Si vous êtes l'administrateur du serveur décompresser l'archive dans le répertoire 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 nécessaire d'accorder des permissions à certains répertoires, de manière à ce que PHP ait les droits en écriture sur : /files et /config

--- Début de l'installation

Désormais tout se déroule en ligne. Pour débuter l'installation il vous suffit de faire pointer votre navigateur web sur le dossier racine de GLPI : http://votreserveur/glpi/ (par défaut).

Lors de la première connexion à cette adresse, une procédure d'installation pas-à-pas démarre. 
L'interface est intuitive, il suffit d'entrer les informations demandées.

--- Fin de l'installation

La dernière étape vous indique que l'installation de GLPI est maintenant terminée, et vous récapitule un certain nombre d'informations. Lisez attentivement ces informations et cliquez sur « utiliser GLPI » pour effectuer votre première connection à l'application.

Remarque : Pour plus de sécurité, il est préférable de limiter l'accès 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 procédure 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 défaut) relancera alors la procédure de configuration (en réalité, c'est l'absence de fichier « config_db.php » qui provoque le lancement de cette procédure).



*************************************************************************************************************
--- 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 données via l'interface de sauvegarde de GLPI. 
2 - Sauvegardez tout le répertoire GLPI (il contiendra la sauvegarde de votre base SQL et vos documents (GLPI >= 0.5))

A partir de là, si la mise à jour se déroule mal ou que les nouvelles fonctionnalités de 
la version ne vous conviennent pas, il sera facile de revenir à votre version précédente.

Si néanmoins vous rencontrez des problèmes 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 procédure utilisée 
et du message d'erreur que vous obtenez.

II) Récupération et installation des fichiers.

1) Téléchargez le tarball de la dernière version  disponible dans la rubrique téléchargement du site du projet glpi (http://glpi-project.org).

Cas où vous passer en GLPI >= 0.68 :

Sauvegardez bien l'ensemble de votre répertoire GLPI et supprimez le.


2) Décompressez la nouvelle archive de GLPI, à la place de l'ancienne.

 !-  Certains répertoires 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 manière à 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) Sélectionnez la langue dans laquelle vous souhaitez effectuer la mise à jour et cliquez sur « ok ».

3) Cliquez sur « mise à jour ».

4) Vérifiez que les tests d'environnement on bien tous été réalisé avec succès, sinon suivez les 
instructions et réessayez.

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

5) Configurez l'accès au serveur Mysql, aidez vous du fichier config.php que vous avez sauvegardé, 
pour remplir :
Mysql serveur : le nom d'hôte 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) Sélectionnez la base de données que vous souhaitez mettre à jour.
Si vous ne connaissez pas son nom, référez 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 sûr de vouloir mettre à jour votre base de données, 
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 données.


9) Il existe une différence majeure en les versions < à 0.5 et les versions > 0.5 : la gestion des lieux.
En effet, celle-ci est maintenant hiérarchique. 
Un système vous permet donc d'adapter vos anciens lieux a cette nouvelle architecture.
Pour cela, deux paramètres vous sont présentés en bas de la page :

1 - le caractère de séparation qui vous avez peut-etre utilisé pour définir votre hierarchie interne
2 - la définition d'un lieu RACINE si vous le voulez

Une fois ces options choisies un tableau vous présenta la nouvelle hierarchie générée.
Si elle vous convient vous pouvez valider en dessous du tableau.
Sinon, vous pouvez changer vos paramètres et regénérer 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 créer 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 donnée à 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 données).

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 données est a jour, vous pouvez désormais 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 déjà existant).
######

11) Mise à jour du contenu

En fonction de votre version antérieure, le contenu des données présentes dans votre base de données 
peuvent avoir été stocké de manière non conforme au moteur de GLPI actuel. 
Pour remédier à cela et afin que l'affichage de vos données soit correcte, l'ensemble de votre base données
est analysée et mise à jour. Cela peut prendre pas mal de temps en fonction du volume d'information
contenu dans votre base de données.

12) Fin de la Mise à jour

Si cette procédure réussi, votre base de données maintenant à jour vous pouvez configurer GLPI en cliquant sur « utilisez GLPI » et en vous connectant avec l'utilisateur que vous venez de créer.

Une fois la configuration terminée, 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 problèmes avec les sources de données externes.


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

Les plugins sont gérés par GLPI au sein du répertoire "plugins".
Il suffit d'installer le repertoire qui contient le plugin dans ce répertoire et il apparait ensuite dans le menu.
Vous pourrez configurer éventuellement votre plugin par la suite.
