Gepi

h1. Instructions génériques pour l'installation de Gepi

h2. Pré-requis

Pour installer et faire fonctionner GEPI, vous avez besoin de :

* Un serveur web équipé de php et un serveur mysql (éventuellement sur la même machine)

* Version de php version supérieure ou égale à 5.2, avec le module php_gd (pour la génération des graphiques)

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

h3. Configuration de PHP (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 = /

h3. Droits d'écriture suffisants sur les répertoires et fichiers suivants

* /documents    (pour l'utilisation des cahiers de texte)

* /images       (changement du logo)

* /secure       (dans le cas d'une installation automatisée)

* /photos

* /backup

* /temp

* /mod_ooo/mes_modele et /mod_ooo/tmp (utilisation des modèles personnels OpenOffice)

* /mod_notanet/OOo/tmp (13 mai 2010 : inutile, ce dossier n'est plus utilisé et est appelé à disparaître)

* /style_screen_ajout.css

h3. Récupération des fichiers

L'ensemble des fichiers nécessaires à l'installation sont rassemblés dans l'archive que vous avez du télécharger depuis le site officiel de Gepi, ou bien directement depuis le gestionnaire de sources.

Parmi ces fichiers figure le fichier "/secure/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 racine du serveur.

Une fois que le fichier connect.cfg est renseigné et sauvegardé, renommer ce fichier en : "connect.inc.php".

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

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.

h2. Etape 2 : création de la base Mysql

h3. Prérequis sql-mode

Lors de l'installation, les fichiers sql/structure_gepi.sql et sql/data_gepi.sql vont être importés.

MySQL et MariaDB ont durci les conditions par défaut dans leur paramétrage.

Pour que l'installation Gepi se passe sans erreur, il faut un paramétrage particulier au niveau de *sql-mode*:

Avec mysql, vous pouvez créer un fichier */etc/mysql/conf.d/perso.cnf* avec pour contenu:

> sql_mode="NO_ENGINE_SUBSTITUTION"

Avec mariaDB, vous pouvez créer un fichier */etc/mysql/mariadb.conf.d/50-z_perso.cnf* contenant:

> sql-mode="NO_ENGINE_SUBSTITUTION"

Notez la petite différence de syntaxe dans un cas et l'autre: sql_mode et sql-mode.

h3. Méthodes d'installation : Introduction

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

h3. 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.example.com/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).

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

-  Connectez-vous à cette base.

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

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