INSTALL.txt

GEPI-master (version de développement) -- Procédure d'installation
==========================================

Version de développement: NE PAS INSTALLER EN PRODUCTION !
La branche stable actuelle est la 1.7.4

****************************************************
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 (secure/modeles/).
Parmi ces fichiers figure le fichier "connect.cfg". La configuration
de ce fichier 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.
-  $gepiPath : il s'agit du chemin relatif du dossier dans lequel sont stockés
les fichiers gepi, à partir du répertoire www (htdocs dans le  cas d'apache).

Une fois que le fichier connect.cfg est renseigné et sauvegardé dans le répertoire secure, renommez ce fichier en : "connect.inc.php".

Certains fonctionnalités requièrent les dépendances suivantes :
- Accès LDAP :
* module php5-ldap
* module php5-mhash (génération des mots de passe sha)

- SSO avec CAS :
* module php5-curl

- A partir du 1er janvier 2012 (version 1.6.0 et suivantes)
* Le module mbstring devient indispensable (encodage utf-8)


************************************************
Installation - Etape 1 : 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 "gepi" dans le répertoire
web du serveur ("htdocs" dans le cas d'Apache).


***************************************************
Installation - Etape 2 : 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/gepi
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 répertoire /secure
doit être autorisé en écriture (la modification des attributs de ce répertoire est possible
avec la plupart des logiciel de transfert FTP).


* Installation manuelle :

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

Dans l'archive figure le répertoire 'sql' qui contient deux fichiers
structure_gepi.sql et data_gepi.sql à exécuter sur le serveur mysql et qui
contiennent l'ensemble des tables mysql ainsi que les données minimales pour
que ça fonctionne.

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

-  Connectez-vous à cette base.
-  Exécuter les fichiers structure_gepi.sql et data_gepi.sql dans cette base
(toujours avec phpMyAdmin par exemple)


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

Une fois le système installé, vous pouvez vous connecter à GEPI :
-  nom de connexion : 'admin' et mot de passe : 'azerty'),
-  Gepi vous demandera automatiquement de changer le mot de passe. Vous devrez
entrer un mot de passe suffisamment sécurisé.
-  allez dans la partie "gestion" (lien dans le bandeau en haut)


******************
Navigateurs testés
******************
-> Mozilla 1.6+
-> Internet Explorer 6
Note : des problèmes ont été régulièrement constatés avec les paramètres par défaut
de Internet Explorer concernant le niveau de sécurité, la gestion du cache, et la
gestion des cookies. Il est donc vivement recommandé d'utiliser Firefox, et de recommander
celui-ci aux utilisateurs de Gepi dans votre établissement.
-> Firefox 1.0.x+


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

Pour installer et faire fonctionner GEPI, 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.2.6

-> [optionnel] Le module php_dbase (importation de fichier GEP/DBF) doit être activé sur le serveur PHP
Note : ce module n'est nécessaire que dans l'hypothèse où vous souhaitez importer des données
depuis des fichiers GEP (qui sont au format dbase).

-> Le module php_gd (graphiques) doit être activé sur le serveur PHP

Fichier php.ini
---------------
-> Configuration de set_time_limit sur le serveur php :
* soit autoriser la fonction set_time_limit(0) dans les scripts php
* soit fixer la valeur de max_execution_time suffisamment élevée.
-> session.use_cookies = 1
-> session.cookie_path = /

-> autoriser l'utilisation des fichiers .htaccess (protection du répertoire
"secure") sur le serveur web. [recommandé mais pas indispensable depuis la version 1.4.2]

-> Droits d'écriture suffisants sur les répertoires :
* /documents          (pour l'utilisation des cahiers de texte)
* /documents/archives (pour l'archivage des cahiers de texte)
* /images             (changement du logo)
* /images/background  (pour le dégradé des couleurs personnalisées)
* /secure             (dans le cas d'une installation automatisée)
* /photos
* /backup
* /temp
* /artichow/cache
* /mod_ooo/mes_modeles et /mod_ooo/tmp (utilisation des modèles personnels openDocument
* /mod_notanet/OOo/tmp (inutile, ce répertoire n'est plus utilisé et est destiné à disparaître)
* /lib/standalone/HTMLPurifier/DefinitionCache/Serializer

- > Renommer le fichier /style_screen_ajout.css.ori en /style_screen_ajout.css et donner des droits d'écriture suffisants sur le fichier :
* /style_screen_ajout.css

***********************************************
Utilisation de Gepi sur le module Scribe d'Eole
***********************************************

Depuis la version 1.4.3-beta1, Gepi peut fonctionner en interaction avec l'annuaire
LDAP de Scribe, module du projet Eole. (voir http://eole.orion.education.fr/diff/rubrique.php3?id_rubrique=14)

Pour utiliser Gepi avec Scribe, vous devez d'abord installer Gepi en suivant la procédure normale d'installation,
puis effectuer les opérations suivantes :

- renommez le fichier /secure/config_ldap.cfg en /secure/config_ldap.inc.php puis éditez-le avec les informations
nécessaires pour que Gepi se connecte au serveur LDAP de Scribe
- connectez-vous en tant qu'admin sur Gepi, puis aller dans Gestion Générale->Gestion des connexions, puis dans la
partie Mode d'Authentification, sélectionnez "Authentification sur serveur Eole SCRIBE (LDAP)" et cliquez sur "Valider".
- déconnectez-vous de l'interface Gepi
- connectez-vous en utilisant le login d'administrateur de Scribe (login: administrateur)
- allez dans Gestion générale->Initialisation à partir de l'annuaire LDAP du serveur Eole Scribe
- procédez à l'importation des données, en prenant les étapes dans l'ordre
- revenez à la page d'accueil et terminez la configuration de Gepi à l'aide des outils de Gestion des bases.

Si vous ne parvenez pas à vous connecter sur Gepi avec le login administrateur de scribe, vous pouvez
forcer la désactivation de l'authentification sur le LDAP en éditant le fichier /lib/global.inc et en mettant la
variable $block_sso à "true" au lieu de "false". Vous pourrez alors à nouveau vous connecter en tant qu'admin Gepi
(avec le login 'admin').

Si le compte administrateur de Scribe a pour login 'admin', alors il y a conflit avec l'utilisateur admin de Gepi.
Pour pallier ce problème, bloquez l'authentification sur LDAP avec la procédure décrite ci-dessus et connectez-vous
en tant qu'admin Gepi. Allez dans Gestion des bases->Gestion des utilisateurs, et créez un nouvel utilisateur Gepi
avec le statut administrateur, en lui donnant un login qui n'entre pas en conflit avec les utilisateurs présents
dans le LDAP de Scribe. Lorsque c'est fait, connectez vous sur Gepi avec ce nouvel utilisateur, supprimez l'utilisateur
qui générait le conflit, et réactivez l'authentification sur LDAP en remettant $block_sso = false; dans /lib/global.inc.
Vous devriez maintenant pouvoir vous connecter sans problème.

***

En cas de problème, n'hésitez pas à nous contacter par le biais de la liste
de diffusion gepi-users (voir site web officiel de Gepi : http://gepi.mutualibre.org).