Skip to content

Commit

Permalink
Initialisation à partir du trunk de Gepi du 2 novembre au matin.
Browse files Browse the repository at this point in the history
  • Loading branch information
tbelliard committed Nov 2, 2011
0 parents commit 5bf1e65
Show file tree
Hide file tree
Showing 4,655 changed files with 1,212,203 additions and 0 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
340 changes: 340 additions & 0 deletions COPYING.txt

Large diffs are not rendered by default.

203 changes: 203 additions & 0 deletions INSTALL.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,203 @@
GEPI-trunk -- Proc�dure d'installation
==========================================

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

ATTENTION! Ce paquetage contient la version en cours de d�veloppement de Gepi, dite "trunk", c'est-�-dire une version
destin�e � identifier et corriger les bugs induits par les nouvelles fonctionnalit�s.

NE PAS UTILISER CETTE VERSION EN PRODUCTION ! Vous exposeriez votre base de donn�es � des incoh�rences
qui pourraient la rendre incompatible avec la version stable.

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.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�, renommer 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


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

-> [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 OpenOffice
* /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).
62 changes: 62 additions & 0 deletions MAJ.TXT
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
GEPI-trunk -- Proc�dure de mise � jour
==========================================

*************
Mise en garde
*************

La proc�dure de mise � jour vers cette version de Gepi est utilisable � partir d'une version GEPI-1.5.0 ou plus r�cente.
Si vous travaillez actuellement sur une version plus ancienne que GEPI-1.5.0, cette proc�dure de mise � jour ne fonctionnera pas.

Ne prenez pas de risque, n'utilisez *que* des versions estampill�es *stable* pour une utilisation en production.


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

L'ensemble des fichiers n�cessaires � la mise � jour sont rassembl�s dans
l'archive que vous avez t�l�charg�e.

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

La premi�re �tape de la mise � jour consiste � transf�rer tous les fichiers de
l'archive que vous avez t�l�charg�e vers le serveur web/php en �crasant les fichiers de la version GEPI pr�c�dente.

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).
Faire les sauvegardes n�cessaires de la base de donn�es
Puis, dans le r�pertoire h�te de Gepi :
- "mettre de c�t�" les r�pertoires existants "documents", "backup" et "photos" (recopier en un endroit s�r, ext�rieur au r�pertoire h�te de Gepi, mais provisoire, en cas de fausse manoeuvre).
- "mettre de c�t�" le fichier servant de logo personnalis� situ� dans le r�pertoire "images" (ce fichier porte le nom donn� par l'admin lors de la configuration g�n�rale)
- "mettre de c�t�" le fichier "connect.inc.php" situ� dans le r�pertoire "secure"
- vider tout le r�pertoire h�te, sauf les �l�ments cit�s ci-dessus (soit les r�pertoires "documents", "backup", "photos", le logo dans le r�pertoire "images", et "connect.inc.php" dans "secure")
- copier dans le r�pertoire h�te l'int�gralit� de l'archive de la nouvelle version de Gepi. L'outil ftp va sans doute demander l'autorisation d'�craser quelques fichiers dans les r�pertoires conserv�s : accepter cet �crasement. Le logo (si l'admin lui a donn� un nom diff�rent de "logo.gif" ou "logo.png") et "connect.inc.php" ne devraient pas �tre �cras�s : ils n'existent pas dans l'archive, de m�me que les documents attach�s par les profs au cahier de texte ("documents"), vos sauvegardes pr�c�dentes ("backup") et les photos de vos �l�ves ("photos").
- ne pas oublier de restaurer les droits d'�criture-ex�cution aux r�pertoires "documents", "images", "photos", "backup", "temp", "mod_ooo/mes_modele", "mod_ooo/tmp", "mod_notanet/OOo/tmp", "lib/standalone/HTMLPurifier/DefinitionCache/Serializer", "documents/archives".

*********************************************************************
Installation - Etape 2 : Renommer le fichier connect.inc si n�cessaire
**********************************************************************

* UNIQUEMENT SI VOUS METTEZ A JOUR UNE VERSION ANTERIEURE A LA 1.3.4 *

Depuis la version GEPI-1.3.4, le fichier "connect.inc" situ� dans le r�pertoire /secure, s'appelle d�sormais "connect.inc.php".
Vous devez donc renommer votre ancien fichier "connect.inc" actuellement pr�sent dans le r�pertoire /secure en "connect.inc.php".
Attention, si vous avez d�j� un fichier "connect.inc.php", ne cherchez pas � renommer le "connect.inc" ! Cela constituerait une faille de s�curit�.

*****************************************************
Installation - Etape 3 : mise � jour de la base MySql
*****************************************************

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 tant qu'administrateur.
Si une mise � jour de la base de donn�e est n�cessaire, vous serez imm�diatement renvoy� sur une page vous permettant d'un seul clic d'effectuer la mise � jour de votre base de donn�e.
Il est possible que certains messages d'erreurs s'affichent mais soit non fatals. Apr�s toute mise � jour, faite une v�rification en profondeur
du bon fonctionnement du logiciel.

Dans certains cas la connexion au site peut �chouer tant que la mise �jour n'a pas �t� effectu�e.
Si vous �tes dans cette situation, connectez-vous directement � l'interface de mise � jour de la base en tapant :
http://www.monsite.fr/gepi/utilitaires/maj.php (dans le cas o� l'adresse serait http://www.monsite.fr/gepi)
107 changes: 107 additions & 0 deletions README.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
GEPI-trunk
==============

Eric ABGRALL <[email protected]>
Thomas BELLIARD <[email protected]>
Didier BLANQUI <[email protected]>
Stephane BOIREAU <[email protected]>
Regis BOUGUIN <[email protected]>
Laurent DELINEAU <[email protected]>
Jerome ETHEVE <[email protected]>
Pascal FAUTRERO <[email protected]>
Josselin JACQUARD <[email protected]>
Julien JOCAL <[email protected]>
Eric LEBRUN <[email protected]>

http://gepi.mutualibre.org/

ATTENTION! Ce paquetage contient la version en cours de d�veloppement de Gepi, dite "trunk", c'est-�-dire une version
destin�e � identifier et corriger les bugs induits par les nouvelles fonctionnalit�s.

NE PAS UTILISER CETTE VERSION EN PRODUCTION ! Vous exposeriez votre base de donn�es � des incoh�rences
qui pourraient la rendre incompatible avec la version stable.

GEPI (Gestion des El�ves Par Internet) est une application d�velopp�e en PHP/MySQL/HTML
dont les fonctions s'articulent autour d'un objectif : permettre la gestion et surtout le suivi des r�sultats scolaires
des �l�ves, et tout ce qui y est attach�, par une interface Web. Cela signifie, entre autre,

* la saisie des notes via un module "carnet de notes",
* leur consultation,
* la saisie des appr�ciations des professeurs,
* l'�dition des bulletins scolaires,
* un module "cahier de texte",
* un outil trombinoscope
* un module de saisie des absences par les professeurs
* un module emploi du temps / calendrier

1. Installation
2. Licence
3. Remarques concernant la s�curit�
4. D�veloppements en cours
5. Documentation


1. Installation
=======================================

Pour obtenir une description compl�te de la proc�dure d'installation,
veuillez vous reporter au fichier "INSTALL.txt".

Pour une installation simplifi�e, d�compressez simplement cette archive sur un
serveur, et indiquez l'adresse o� se trouvent les fichiers extraits dans un navigateur (ex: http://www.monsite.fr/gepi).

* Pr�alables pour l'installation automatis�e :
- disposer d'un espace FTP sur un serveur avec PHP 5 ou sup�rieur, pour y transf�rer les fichiers
- disposer d'une base de donn�es MySQL (adresse du serveur MySQL, login, mot
de passe)


2. Licence
=======================================

GEPI est publi� sous les termes de la GNU General Public Licence, dont le
contenu est disponible dans le fichier "COPYING.txt", en anglais.
GEPI est gratuit, vous pouvez le copier, le distribuer, et le modifier, �
condition que chaque partie de GEPI r�utilis�e ou modifi�e reste sous licence
GNU GPL.
Par ailleurs et dans un soucis d'efficacit�, merci de rester en contact avec
l'�quipe de d�veloppement de GEPI pour �ventuellement int�grer vos
contributions � une distribution ult�rieure.

Enfin, GEPI est livr� en l'�tat sans aucune garantie. Les auteurs de cet outil
ne pourront en aucun cas �tre tenus pour responsables d'�ventuels bugs.


3. Remarques concernant la s�curit�
=======================================

La s�curisation de GEPI est un point crucial, �tant donn� la sensibilit� des
donn�es enregistr�es. Malheureusement la s�curisation de GEPI est d�pendante
de celle du serveur. Nous vous recommandons d'utiliser un serveur Apache sous
Linux, en utilisant le protocole https (transferts de donn�es crypt�es), et en
veillant � toujours utiliser les derni�res versions des logiciels impliqu�s
(notamment Apache et PHP). GEPI n'a pas encore �t� test� sur d'autres
serveurs.

L'EQUIPE DE DEVELOPPEMENT DE GEPI NE SAURAIT EN AUCUN CAS ETRE TENUE
POUR RESPONSABLE EN CAS D'INTRUSION EXTERIEURE LIEE A UNE FAIBLESSE DE GEPI OU
DE SON SUPPORT SERVEUR.

Abonnez-vous � la liste de diffusion 'gepi-news' pour �tre tenu inform� des
mises � jours en mati�re de s�curit�, et � la liste 'gepi-users' pour participer
aux discussions relatives � l'utilisation et au d�veloppement de Gepi.


4. D�veloppements en cours
=======================================

Les d�veloppeurs de Gepi travaillent en fonction des besoins de leurs �tablissements
respectifs. N'h�sitez pas � leur sugg�rer des fonctionnalit�s, par le biais
de la liste de diffusion des utilisateurs.


5. Documentation
=======================================

La documentation de Gepi se trouve � l'adresse suivante :
http://www.sylogix.org/projects/gepi/wiki
Loading

0 comments on commit 5bf1e65

Please sign in to comment.