PROMETHEE Guide d installation

Transcription

1 PROMETHEE Guide d installation Prométhée est un logiciel placé sous licence GNU/GPL v3 (General Public License) : deux contraintes pour quatre libertés. liberté d'utilisation du logiciel pour tous usages. liberté d'étudier le fonctionnement du logiciel. liberté de modifier, ou de faire modifier par un tiers, le logiciel. liberté de copie et de redistribution illimitées de la version originale ou modifiée du logiciel. obligation de respecter le droit d'auteur des développeurs du logiciel en laissant la mention de leurs noms et commentaires. obligation, dans le cas où l'on publie une version modifiée du logiciel, de fournir gratuitement (hors frais d'enregistrement sur support physique et de distribution postale) l'accès au code source à tous ceux qui en font la demande.

2 1. Configuration nécessaire pour installer Prométhée. Pour installer PROMETHEE sur votre machine, il faut au préalable vérifier que votre système d'exploitation vous donne accès : à un serveur de pages internet (ex : Apache au langage de programmation PHP4 ou supérieur ( au système de base de données MySQL ( Si c'est le cas, extrayez tous les fichiers de l'archive ZIP vers le répertoire «epl» où pointe le serveur de pages html (voir dans le fichier «/etc/httpd/httpd.conf» pour Apache). Sinon, installez les packages à partir des CD de votre distribution Linux ou *BSD. Remarque : une gestionnaire de base de données 1 n est pas obligatoire mais est vivement conseillé pour faciliter la maintenance de la base de données. Alias "/intranet" "/var/www/html/epl/" <Directory "/var/www/html/epl/"> Options Indexes FollowSymLinks Includes AllowOverride All #Order allow,deny Allow from all </Directory> Exemple de modification à apporter au fichier de configuration «/etc/httpd/httpd.conf». La copie des fichiers étant effectuée, vous pouvez maintenant configurer PROMETHEE en vous rendant sur la page intranet/setup.php. Sur le serveur, indiquez (boucle locale) comme adresse IP. Par contre, sur les postes clients il faudra indiquer l adresse IP du serveur. Selon les droits dont vous disposez, il vous faudra créer préalablement une base de données. Si vous êtes sur un serveur local, utilisez un gestionnaire pour créer la base «epl». Dans le cas contraire, demandez à votre hébergeur le nom de la base de données installée par défaut. mysql -u root mysql> create database epl; mysql> exit Exemple de commandes à lancer pour créer la base de données «epl» à partir d une console. Remarque : afin que les utilisateurs de l'intranet puissent disposer des sources PROMETHEE, copiez l'archive ZIP dans le répertoire download/source. 1 PhpMyAdmin : Eskuel : Guide installation.pdf - Page 2-10/02/2010

3 2. L installation de PROMETHEE. Laissez-vous guider par la procédure d'installation automatisée en 4 étapes. Vous pouvez choisir la langue d installation en cliquant sur le drapeau ad hoc. Si tous les indicateurs sont au «vert» ou «orange», vous pourrez installer Prométhée. Guide installation.pdf - Page 3-10/02/2010

4 Sur un serveur local (ie, votre machine) si vous n avez pas l habitude de configurer un serveur MySQL, laissez les paramètres ci-dessus par défaut. Si vous installez Prométhée sur le serveur d'un hébergeur, indiquez dans les champs de saisie cidessus les informations que votre hébergeur vous aura donné pour vous connecter à la base de données. Votre base MySQL a été installée sur notre serveur. Voici les données techniques: MySQL: Serveur : mysql5-15 Utilisateur : lettretc001 Nom de la base : lettretc001 Mot de passe : 5LW2RDTb Exemple de mél envoyé par un hébergeur qui donne toutes les informations nécessaires. Guide installation.pdf - Page 4-10/02/2010

5 La base de données a pour nom «epl». Les tables de la base de données «epl» ont été créées avec certaines valeurs par défaut. Guide installation.pdf - Page 5-10/02/2010

6 Puis terminez par la configuration personnalisée de votre intranet. Cette étape permet de choisir une charte graphique et d indiquer les données propres à chaque établissement. Choisissez une charte graphique qui correspond le mieux au logo de votre établissement avant de passer à l étape suivante. Guide installation.pdf - Page 6-10/02/2010

7 PROMETHEE permet la gestion de plusieurs centres constitutifs. Un établissement peut être constitué de plusieurs centres constitutifs. Ainsi un EPL 2 de l'enseignement agricole est souvent constitué d'un LEGTA 3, d'un CFA 4 ou CFPPA 5 et d'une exploitation agricole (la ferme). Pour éviter de créer un groupe «stagiaires» (dans le cas d'un CFPPA par exemple) qui compromettrait la sécurité et la confidentialité de certaines informations de l'intranet, il est préférable de créer un nouveau centre et d'y attribuer le personnel et les stagiaires. Définir plusieurs centres peut avoir d'autres avantages : Pour des petits établissements scolaires qui doivent mutualiser les moyens, il peut être intéressant de regrouper le collège et le lycée (voire même un GrEta 6 ). Ex : Groupe d établissements «Verdun» (collège Centre, Lycée D. Villars) De même pour les écoles primaires. Il est sans doute intéressant de créer un réseau local ou départemental où chaque centre représente une école. 2 Etablissement Public Local. 3 Lycée d'enseignement Général et Technologique Agricole 4 Centre de Formation des Apprentis 5 Centre de Formation Professionnelle et de Promotion Agricoles 6 Groupe d établissements scolaires. Guide installation.pdf - Page 7-10/02/2010

8 Remarque : PROMETHEE ayant été développé à l origine pour les établissements de l enseignement public agricole, la configuration par défaut des flash-infos fait mention des LEGTA. Les établissements qui font partie de l Education Nationale ou qui veulent un flash-infos par défaut différent devront procéder de la façon suivante : se connecter à l intranet comme administrateur (compte «admin», pas de mot de passe) ouvrir et paramétrer les flash-infos à l aide de l accès au backoffice (icône de la clef ( ) du menu «INFOS») cliquer sur le lien «Configuration» du menu «ADMINISTRATEUR», puis choisir la page d accueil par défaut dans le menu déroulant de la rubrique «Affichage» Le lien sur la clef du menu des flash-infos donne accès au backoffice. Il suffit ensuite d ouvrir ou de fermer les flash-infos ad hoc et de définir la page d'accueil selon les groupes. 3. Création des comptes. Ca y est! PROMETHEE est configuré et opérationnel. Il ne vous reste plus qu'à : créer les comptes des utilisateurs (table user_id), créer les comptes des élèves (table user_student), éventuellement, renseigner les adresses IP des postes clients connectés au serveur intranet (table ip) afin d identifier les stations et de sécuriser l intranet par filtrage IP 7. Il existe deux méthodes pour créer un compte : par invitation, par importation de données. Invitation Cette méthode consiste à demander à l utilisateur de créer lui-même son compte lors de sa première connexion. L ouverture de ce compte devra être par la suite validée par l administrateur de l intranet. Pour cela, il faut positionner deux variables situées dans le fichier «config.php». static $AUTHUSER = 1; // autoriser les utilisateurs à créer leur compte static $NOPASSWD = 0; // autoriser les mots passe vide (1 pour activer) static $AUTOVAL = 0; // validation automatique des comptes créés par les utilisateurs (1 pour activer) static $AUTODEL = 0; // suppression automatique des comptes non visités au bout de x heures (0 pour désactiver) Extrait du fichier «config.php». La validation des comptes s effectue en mode administrateur par l interface PROMETHEE. 7 Cette option n est pas obligatoire mais est vivement conseillée pour élever le niveau de sécurité de l intranet. Guide installation.pdf - Page 8-10/02/2010

9 La deuxième variable $NOPASSWD est optionnelle mais elle oblige les utilisateurs à indiquer un mot de passe si elle vaut 0. Nous conseillons son utilisation pour augmenter la sécurisation du système. L utilisateur peut créer un compte lorsqu il arrive sur la page de connexion. Importation de données L importation de données dans PROMETHEE s effectue à travers le format de fichiers xls généré en natif par le tableur M$- Excel ou la suite bureautique OpenOffice 8. Un classeur intitulé «import.xls» se trouve dans le répertoire Mysql afin de permettre un import direct des comptes de connexions, des comptes élèves, des classes, des groupes,... depuis l interface PROMETHEE (menu Administrateur/Import), et ceci de façon très intuitive. Respectez le format d exportation des données comme indiqué en en-tête de la feuille de calcul. Le fichier import.xls propose 5 onglets ; pour l importation dans la base de données MySQL utilisée par PROMETHEE. Remarque : un compte administrateur 9 par défaut a été créé avec le login 'admin' et aucun mot de passe. Nous vous recommandons, bien évidemment, de donner un mot de passe à ce login une fois vos tests terminés. De même, nous vous recommandons de supprimer le fichier «setup.php» pour éviter qu'un utilisateur reparamètre votre configuration intranet ainsi que votre base de données! Un profil enseignant (ID : prof, pas de mot de passe) et élève (ID : élève, pas de mot de passe) ont également été créés pour faciliter vos tests. Guide installation.pdf - Page 9-10/02/2010

10 4. Connexions à l intranet. Il existe trois façons de se connecter à l intranet : Manuelle, en donnant l adresse IP du serveur. Automatique, en paramétrant la page d accueil du navigateur. Identification unique 10. Connexion manuelle Pour une connexion plus conviviale à l intranet, nous vous recommandons de paramétrer le fichier /etc/hosts afin que les utilisateurs n aient pas à se souvenir d une adresse IP localhost # boucle locale intranet # intranet Prométhée On suppose ici que le serveur a comme adresse IP Evidemment, elle peut être changée selon le plan d adressage de votre réseau. Sur un poste client, l utilisateur n aura qu à taper «intranet» dans la barre d adresse du navigateur. Connexions automatiques Vous pouvez également opter pour une connexion automatique : à l affichage de la page d accueil Il faut positionner la variable AUTOLOGIN déclarée dans le fichier «config.php» de la façon suivante : static $AUTOLOGIN = "id=visiteur&pwd=visiteur"; En ayant créé au préalable un compte avec un identifiant (id) et un mot de passe (pwd) ad hoc. au lancement du navigateur Pour cela, il suffit de paramétrer les préférences du navigateur en indiquant l ID de connexion et le mot de passe de l utilisateur dans l adresse URL de démarrage. Il faut donner 2 paramètres au script index.php : id=<id utilisateur> et pwd=<mot de passe de l utilisateur> Nous déconseillons évidemment ces types de connexion pour des utilisateurs dits «sensibles», c est-à-dire autre qu une connexion élève anonyme ou visiteur. Connexion par identification unique PROMETHEE permet une identification unique à travers 2 approches : centralisée : protocole LDAP (OpenLDAP 11 et Active Directory 12 ) coopérative : système CAS (Central Authentication Service) Pour cela, connectez-vous à l intranet avec le compte administrateur créé automatiquement à l installation (login «admin», pas de mot de passe) puis cliquez sur le lien «Identification» du menu «Administrateur» Single Sign-On (SSO) : méthode permettant à un utilisateur de ne procéder qu'à une seule authentification pour accéder à plusieurs applications informatiques. : OpenLDAP est un projet libre de serveur d'annuaire conforme à la norme LDAP 3. LDAP (Lightweight Directory Access Protocol : Protocole d'accès aux Annuaires Légers) est un protocole standard permettant de gérer des bases d'informations sur les utilisateurs d'un réseau. résultat de l'évolution de la base de données de comptes du domaine SAM (Security Account Manager) et une implémentation de LDAP. Guide installation.pdf - Page 10-10/02/2010

11 5. Création de Login de connexion. Pour les administrateurs qui veulent créer un login de connexion, à partir des fichiers élèves importés dans la base de données de PROMETHEE, un backoffice 13 (accessible par le symbole ) est disponible sur la page principale. Pour ceux qui auraient besoin de restreindre l accès à certains modules de PROMETHEE, reportezvous à la gestion des ACL 14 décrite dans le «guide technique». Après validation, un login de connexion et un mot de passe sont attribués à chaque élève 15. ID de connexion élève<n élève>, mot de passe <date de naissance> Exemple : COUTON Marion (ID : élève113, mdp : ) 6. Les problèmes fréquemment rencontrés. Malgré le soin apporté au module d installation automatique de PROMETHEE, il arrive parfois que les administrateurs rencontrent quelques problèmes lors du déploiement. Nous avons listé cidessous les erreurs principalement rencontrées. Droits Unix Il est possible que les droits Unix sur les fichiers et/ou les répertoires ne soient pas corrects si vous rencontrez les problèmes suivants : message d'erreur : "Echec à la création de config.php" impossible de sauvegarder la personnalisation de l intranet message d erreur lors des dépôts de fichiers messages d erreur dans le chat Assurez-vous, dans ce cas, que le propriétaire et le groupe soient bien "apache" et que les droits Unix soient positionnés à rwxr-xr-x pour les fichiers et les sous répertoires. Si ce n'est pas le cas, exécutez la commande : "chown R apache:apache *" dans le répertoire d installation. De même, si vous recopiez les tables de la base de données "à la main" lors des mises à jour de PROMETHEE, assurez-vous que le propriétaire et le groupe soient bien "mysql" et que les droits Accès réservé à l administrateur et qui n est pas disponible pour les utilisateurs (front office). Access Control List. Liste des personnes ayant le droit d'accéder à une ressource (un fichier, un réseau...), et parfois sous quelles conditions. Il est possible de paramétrer les formats du login et du mot de passe dans le fichier «config.php» ou par l interface Prométhée dans le menu configuration. Guide installation.pdf - Page 11-10/02/2010

12 Unix soient rwxr-xr-x. Si ce n'est pas le cas, exécutez la commande : "chown mysql:mysql *" dans le répertoire /var/lib/mysql/epl. Droits MySQL S'il y a des problèmes d'accès à la base de données vérifiez que l'utilisateur de la base "epl" (en principe localhost) possède les droits ad hoc. Si ce n'est pas le cas, exécutez la requête SQL : "grant all on epl.* to root@localhost". L interface phpmyadmin permet de lancer rapidement des requêtes SQL. Si vous avez indiqué un mot de passe (ex : promethee) pour accéder au serveur dans l étape 1, la requête devient : " grant all on epl.* to root@localhost identified by promethee ". Installation sur un serveur distant Pour des raisons de sécurité, le script d installation vérifie s il a été lancé en local. Si vous désirez tester PROMETHEE sur un serveur distant (chez un hébergeur par exemple), assurez-vous que la variable globale $DEMO est positionnée à "1" dans le fichier «config.ini» 16. if ( $REMOTE_ADDR!= " " AND!$DEMO ) print(" <p align=\"center\" style=\"margin-top: 10; margin-bottom: 0\"> <span style=\"color:#ff0000;\" class=\"small\"> ". $msg->read($msg_onserver, $Host)." </span> </p> "); Extrait du code source du script d installation. Sur un serveur distant, le message d erreur suivant s affiche à l écran : "Vous devez être sur le serveur pour lancer la procédure d'installation." Problème de session Chez certains hébergeurs il est nécessaire de créer le répertoire «sessions» à la racine du répertoire «epl» pour permettre un fonctionnement correct des sessions (ce répertoire doit posséder les droits d écriture!). Warning: session_start() [function.session-start]: open(/mnt/119/sdb/c/e/ramep/sessions/sess_e8d9302dd8b7017f9c9861ae8a7852a8, O_RDWR) failed: No such file or directory (2) Exemple de message d erreur. 16 Cette variable autorise également les connexions multiples avec le même login. Remettez la valeur à "0" après l installation. Guide installation.pdf - Page 12-10/02/2010

13 7. Mises à jour. Lors des évolutions de version de PROMETHEE, procédez de la façon suivante : Sauvegardez votre base de données Dézippez l archive dans le répertoire d installation Lancez le script d installation automatique «setup.php» A l étape 2, cochez la case «NE PAS effacer la base de données existante» N oubliez pas de cocher cette case. Sinon les données de la bdd seront perdues! Et c est tout! Le programme met à jour automatiquement la structure des tables MySQL à partir des fichiers.sql du répertoire MySql/update. Les mises à jour s'effectuent automatiquement sur la branche actuelle et la précédente. Pour des versions plus anciennes, procédez par étapes successives de branche majeure en branche majeure. 8. Support. En cas de problèmes lors de l installation de PROMETHEE, vous pouvez contacter le support par mél ou téléphone (Hot-Line gratuite). Installation et déploiement : Cédric Ghirardi poste 364 Bugs et conception : Dominique Laporte Forum : pour résoudre vos soucis au niveau de l installation et des divers paramétrages 19 Le projet est toujours en développement et l'équipe est à la recherche de contributeurs (graphistes, développeurs, relecteurs, béta-testeurs,...) aussi n'hésitez pas à nous contacter. 9. Licence. Copyright Dominique LAPORTE. Permission est accordée de copier, distribuer et/ou modifier ce document selon les termes de la Licence de Documentation Libre GNU (GNU Free Documentation License), version 1.1 ou toute version ultérieure publiée par la Free Software Foundation ; avec les Sections Invariables qui sont «sans Sections Invariables» ; avec les Textes de Première de Couverture qui sont «sans Textes de Première de Couverture», et avec les Textes de Quatrième de Couverture qui sont «sans Textes de Quatrième de Couverture». Une copie de la présente Licence est disponible ici. 17 cedric.ghirardi@educagri.fr 18 dominique.laporte@educagri.fr 19 Guide installation.pdf - Page 13-10/02/2010