GRR -- Procédure d'installation
=====================================

****************************************************
Installation - Etape 0 : téléchargement de l'archive
****************************************************

L'ensemble des fichiers nécessaires à l'installation sont rassemblés dans
l'archive que vous avez téléchargée.
Parmi ces fichiers figure le fichier "connect.inc.php.ori". 
Faites-en une copie ou renommez-le en "connect.inc.php". 
La configuration du fichier "connect.inc.php" n'est pas obligatoire si vous optez pour une
installation automatisée de la base de donnée. En effet, la procédure
d'installation vous invitera alors à entrer dans un formulaire vos paramètres
de connexion.

Dans le cas contraire, vous devez impérativement renseigner ce fichier :
-  $dbHost : le nom du serveur qui héberge votre base de donnée mysql. Si
   c'est le même que celui qui héberge les fichiers php, mettre "localhost".
-  $dbDb : le nom de votre base mysql.
-  $dbUser : le nom de l'utilisateur mysql qui a les droits sur la base.
-  $dbPass : le mot de passe de l'utilisateur mysql ci-dessus.
-  $dbPort : le port de communication utilisé par le serveur MySQL (3306 par défaut).

***********
Pré-requis
***********

Pour installer et faire fonctionner GRR, vous avez besoin de :
-> Un serveur web/php et un serveur mysql (éventuellement sur la même
machine)
-> Nécessité de disposer d'une version de php version supérieure ou égale à 5.6.0 (gestion des variables de type $_SESSION, fonction mysql_real_escape_string(),  ...)
-> Nécessite au moins les modules php-fileinfo, php-gd, php-iconv, php-mbstring, php-mysqli, php-mysqlnd, php-xml ; si vous utilisez php 8.1+, il faut soit inclure le module php-intl, soit désactiver les messages E_DEPRECATED

************************************************
Installation - Etape 1 : Configuration de GRR
************************************************
Bien qu'un grand nombre de paramètres de GRR soient modifiables directement dans l'interface web de GRR,
le fichier "/include/config.inc.php" contient quelques paramètres à configurer avant de transférer les fichiers vers le serveur web. Toutes les indications à la configuration de ce fichier sont disponibles dans la documentation ainsi que dans le fichier lui-même.

************************************************
Installation - Etape 2 : transfert des fichiers
************************************************

La première étape de l'installation consiste à transférer tous les fichiers de
l'archive que vous avez téléchargée vers le serveur web/php.

Pour cela, munissez-vous des codes des paramètres de connexion au serveur et
utilisez un logiciel de transfert de fichiers (FTP). Vous aurez besoin de l'adresse du serveur ftp, de votre login, et de votre  mot de passe (fournis par l'hébergeur si vous utilisez un service extérieur, par l'administrateur système si vous utilisez un serveur au sein de l'établissement).

On pourra par exemple créer un répertoire "grr" dans le répertoire
web du serveur ("htdocs" en général dans le cas d'un serveur Apache).

Modification des droits : les droits d'écriture doivent être attribués (à l'utilisateur www-data en général dans le cas d'un serveur Apache)
* au répertoire "/images"       (chargement d'images pour les fiches de présentation des ressources)
* au fichier "include/connect.inc.php"      (dans le cas d'une installation automatisée)
* au fichier "include/config_ldap.inc.php"  (dans le cas d'une authentification ldap)

***************************************************
Installation - Etape 3 : création de la base Mysql
***************************************************

Vous avez le choix entre deux types d'installation de la base de donnée Mysql:

-  une installation automatisée,
-  une installation manuelle, réservée aux experts.


* Installation automatisée :

Une fois que les fichiers php sont en place sur le serveur web/php (étape 1),
lancez un navigateur et connectez-vous au site en tapant l'adresse complète du
genre : http://www.monsite.fr/grr
Vous n'avez plus qu'à cliquer sur le lien vous proposant d'installer la base
et à suivre la procédure. Pour ce type d'installation, le fichier connect.inc.php
doit être autorisé en écriture (la modification des attributs de ce fichier est possible
avec la plupart des logiciels de transfert FTP).


* Installation manuelle :

Si vous optez pour cette installation, il est nécessaire d'avoir renseigné le
fichier "connect.inc.php" (voir plus haut)

Dans l'archive figure le fichier tables.my.sql à exécuter sur le serveur mysql et qui
contient l'ensemble des tables mysql ainsi que les données minimales pour
que ça fonctionne.

-  Sur le serveur mysql :
* créez une base mysql (avec phpMyAdmin par exemple) en lui donnant un nom (par
exemple "grr")
* créez un utilisateur de cette base,
* n'oubliez pas de relancer le serveur.

-  Connectez-vous à cette base.
-  Exécuter le  fichier tables.my.sql dans cette base
(toujours avec phpMyAdmin par exemple)

Remarque : le fichier tables.my.sql est codé au format UTF-8. Si votre serveur est configuré pour accepter un autre format, il convient de convertir tables.my.sql au format convenable avant de lancer la procédure d'installation.


******************************************************
Après l'installation : configuration de GRR en ligne
******************************************************

Une fois le système installé, vous pouvez vous connecter à GRR :
-  nom de connexion : 'administrateur' et mot de passe : 'azerty', sauf dans le cas d'une installation assistée
-  Par sécurité, CHANGEZ LE MOT DE PASSE de 'administrateur' grâce au lien "gérer mon
compte" dans le bandeau en haut !
-  allez dans la partie "Administration" (lien dans le bandeau en haut) pour créer domaines, ressources et utilisateurs.


************************************************************
Procédure de mise à jour (depuis GRR 1.9.7e, voir plus bas)
************************************************************

Il n'y a pas de procédure de mise à jour automatique de l'ensemble logiciel GRR.
Par sécurité, avant de mettre les scripts à jour, faites une sauvegarde de la base de données, puis de l'ensemble de l'arborescence de GRR.
Téléchargez sur votre serveur les scripts de la nouvelle version de GRR.
Recopiez les fichiers de configuration (/include/config.inc.php, /include/connect.inc.php et - éventuellement - /include/config_ldap.inc.php).
Vérifiez les droits en écriture sur les fichiers et le dossier indiqués à l'étape 2.
Connectez-vous à GRR avec un compte administrateur. Si vous avez fait une montée de version, GRR demandera une mise à jour de la base de données. Faites-la puis connectez-vous. Vous devriez avoir de nouveau GRR opérationnel.

Pour mettre à jour depuis GRR 1.9.7e ou antérieur, voici les étapes recommandées :
- faire une sauvegarde depuis GRR197
- éventuellement vider la table de connexions (grr_log)
- refaire une sauvegarde depuis GRR 1.9.7e
- déplacer les scripts de GRR197 à titre de sauvegarde
- installer les scripts de GRR 3.5.2 dans un dossier vide
- initialiser GRR 3.5.2
- convertir le fichier de sauvegarde GRR197 à l'encodage UTF-8 (sans BOM) pour convertir les accents
- restaurer dans GRR 3.5.2 la sauvegarde faite avec GRR 1.9.7e
- connectez-vous avec un compte administrateur et faites la mise à jour de montée de version.
Vous devriez avoir de nouveau GRR opérationnel.