You are on page 1of 12

Comment installer SACOCHE

sous un serveur Amonecole 2.3 du projet EOLE


cole Marie Curie, Lzignan par Thierry Munoz, version mise jour le 13 septembre 2012
Cette cration est mise disposition selon le Contrat
Paternit-Pas d'Utilisation Commerciale-Partage des Conditions Initiales l'Identique 2.0 France
disponible en ligne http://creativecommons.org/licenses/by-nc-sa/2.0/fr/ ou par courrier postal Creative
Commons, 171 Second Street, Suite 300, San Francisco, California 94105, USA.
Site de rfrence sur lapplication SACOCHE :
http://sacoche.sesamath.net
Site de rfrence sur la solution EOLE :
http://eole.orion.education.fr/

Ce document est un compte-rendu d'exprience en franais, fait d'abord pour me servir d'aide-mmoire
et de "check-list". Je pense qu'il pourra aider d'autres personnes utiliser la solution SACOCHE permettant la
gestion dvaluations par comptences des lves.

Table des matires


I. Prsentation de SACOCHE :..............................................................................................................................2
II. Description succincte du serveur Amonecole 2.3..............................................................................................2
III. Procdure dinstallation de SACoche sur le serveur Amonecole 2.3...............................................................3
A-Avertissement................................................................................................................................................3
B-Environnement et prrequis...........................................................................................................................3
C-Rcupration et installation des fichiers sur le serveur Scribe......................................................................3
D-Modification des droits d'accs du dossier " sacoche ":................................................................................4
E-Cration de la base de donnes ncessaire Sacoche :.................................................................................5
a)Mthode EOLE (trs rapide et trs simple !) :...........................................................................................5
b)Mthode semi-manuelle (non teste!!!) :...................................................................................................5
F-Configuration du serveur Amonecole 2.3......................................................................................................6
G-Suppression du fichier " .htaccess " cause derreur 500 :..............................................................................7
H-Installation automatique via un navigateur WEB :........................................................................................7
IV. Paramtrage de SACOCHE pour lENT et lauthentification CAS...............................................................11
V. Importation des logins et identifiants de Amoncole vers SACoche...............................................................11
VI. Problme de mise jour automatique de SACoche.......................................................................................11

Retour la table des matires

page 1 / 12

I. Prsentation de SACOCHE :
Source : http://sacoche.sesamath.net/index.php?fichier=presentation
Il sagit dune application WEB libre et ouverte dveloppe par Thomas Crespin permettant le suivi des
acquisitions des comptences des lves en cochant des items. Au dpart elle tait plutt destine aux collges
mais elle s'est aussi rvle adapte lcole primaire. Elle permet aux professeurs :
d'valuer leurs lves par comptences,
de conserver un historique de leur parcours,
de dterminer un tat d'acquisition de chaque comptence,
de les collecter pour assister la validation du socle commun.
et depuis peu d'diter des bulletins.
Bref, cette application gratuite (ce qui n'est pas ngligeable pour des coles qui courent aprs les financements
notamment pour les outils informatiques) est apparue bien avant l'outil institutionnel (propos rcemment
titre gratuit) CERISE (http://www.cerise-collection.fr/prim-index.php) alors que les Instructions Officielles
demandait dj un suivi des acquis des comptences (voir la mise en place du Livret Personnel de
Comptences ou LPC).
SACoche ne serait pas ce qu'il est sans la disponibilit, la ractivit, la comptence et la gentillesse de
l'auteur Thomas Crespin qui informe, dpanne, et adapte son application en fonction des demandes
(nombreuses) des utilisateurs. Un grand merci lui !

II. Description succincte du serveur Amonecole 2.3


Notre cole a un serveur Intranet/Extranet permettant laccs extrieur qui sappuie sur la solution
Amonecole du projet EoleNG en version 2.3 . Ce serveur s'appuie sur la distribution GNU/Linux Ubuntu 10.04
LTS. Cette solution combine en un seul serveur diffrents services dont notamment un proxy, serveur web, etc.
De plus, on peut se servir de ce mme serveur pour utiliser des clients lgers via le module Eclair (pas encore
fonctionnel l'heure actuellemais a ne saurait tarder).
Voir la description des diffrents modules dans le document ci-dessous :
ftp://eoleng.ac-dijon.fr/pub/Documentations/manuels/2.3/partielles/PDF/Modules.pdf
Bon savoir :
- EOLE dpend du Ministre de l'ducation nationale donc autant se servir de cet outil dans nos
coles (paradoxalement cette information est assez confidentielle )
- Les responsables interviennent sur les listes de diffusion pour informer, dpanner en cas de besoin,
notamment Jol Cuissinat, Emmanuel Garette. Un grand merci eux pour leur aide essentielle.

Retour la table des matires

page 2 / 12

III. Procdure dinstallation de SACoche sur le serveur Amonecole 2.3


A- Avertissement
L'installation d'une application web tierce sur la version Amonecole 2.3 est diffrente de la 2.2 du
fait de l'apparition du mode conteneur ! Voir le lien ci-dessous :
http://eoleng.ac-dijon.fr/pub/Documentations/manuels/2.3/partielles/HTML/commun/co/04-conteneur.html

B- Environnement et prrequis
Lide est de se servir de notre serveur pour hberger lapplication WEB . Notre serveur est conu pour
pouvoir le faire grce la solution ENVOLE base sur le trio Apache2/php/MySql.
Cette notice dcrira linstallation de SACOCHE sur un serveur Amonecole 2.3 fonctionnel. Elle ne
traitera ni de la mise en place du serveur proprement dit, ni de lutilisation de Sacoche proprement dite (voir la
trs bonne documentation sur le site Source : http://sacoche.sesamath.net/ )
Linstallation se fera au dbut en ligne de commande partir de la console de lAmoncole (qui permet
daccder aux conteneurs " web " et " bdd ") puis par le biais dun navigateur WEB (installation automatise de
SACoche).
Remarque : Toutes les manipulations sont faites partir de mon portable par connexion ssh vers le serveur ou
via le navigateur Internet par le biais de l'EAD de l'Amoncole.

C- Rcupration et installation des fichiers sur le serveur Scribe


Voici les informations donnes par Jol Cuissinat (merci lui) :
Sources : http://eole.orion.education.fr/listes/arc/scribe/2012-09/msg00097.html
Pour commencer, il faut se rappeler comment sont rpartis les services sur AmonEcole-2.3 :
http://eoleng.ac-dijon.fr/pub/Documentations/manuels/2.3/partielles/HTML/commun/co/04-conteneur.html
On constate que sur une installation standard (cf. fichier /etc/eole/containers.conf) :
- les applications web sont dans le conteneur "reseau" avec l'IP interne : 192.0.2.51
- la base de donnes Mysql est dans le conteneur "bdd" avec l'IP interne : 192.0.2.50
Depuis le matre, on peut envoyer les donnes dans le conteneur web :
- soit par scp : # scp -r SACoche 192.0.2.51:/var/www/html/sacoche
- soit en utilisant le chemin complet du conteneur : # cp -r SACoche
/opt/lxc/reseau/rootfs/var/www/html/sacoche
Ensuite on peut se connecter au conteneur via SSH pour effectuer les manipulations ncessaires sur les
fichiers (chown, chmod, rm...) :
- # ssh 192.0.2.51 (ou # ssh reseau ou encore # ssh web)
Le paramtrage d'apache au travers de l'interface *gen_config* est le mme que sur 2.2.
Le script "/usr/share/eole/mysql_add.py" est toujours disponible sur 2.3 mais il y a une question
supplmentaire :
Nom du conteneur source : web
En rpondant "web" cela permet que les requtes soient autorises depuis le conteneur o tournent les
applications web
On peut ensuite utiliser la procdure d'installation du logiciel.
La seule diffrence tant que dans les paramtres MySQL, il faut donner l'adresse IP du conteneur "bdd"
(192.0.2.50) comme Hte ou IP.
Au niveau du SSO, la configuration est normalement la mme que sur 2.2.
Retour la table des matires

page 3 / 12

Tout dabord, il faut rcuprer le fichier zip de Sacoche cette adresse :


https://sacoche.sesamath.net/index.php?dossier=utilisation&fichier=serveur_perso__download ou le lien
direct http://sacoche.sesamath.net/telechargement.php
Remarque : jai rcupr la version du 2012-08-31
Puis, je le dcompresse dans mon portable dans mon /home/thierry/Downloads/ . Jobtiens un dossier
" SACoche " contenant tous les fichiers et rpertoires ncessaires l'installation. Il faut maintenant transfrer
ce dossier sur le serveur AMONECOLE (adresse ip sur eth1 : 192.168.0.2), j'ai choisi de le mettre dans un
rpertoire la racine du serveur intitul " install_sacoche " en tapant la ligne de commande suivante (on
demandera le mot de passe de root sur l'amonecole) :
scp -r -p /home/thierry/Downloads/SACoche root@192.168.0.2:/install_sacoche/

Ensuite, il faut aller dans la console du serveur Amoncole (directement ou via ssh partir dun poste distant).
partir de mon portable reli lIntranet, il suffit de taper la ligne ci-dessous et de rentrer le mot de passe :
ssh -X root@192.168.0.2
Il faut maintenant que je transfre les fichiers d'installation du serveur matre vers le conteneur " web " en
tapant :
scp -r /install_sacoche 192.0.2.51:/var/www/html/sacoche

Remarque : on peut ensuite effacer le rpertoire " install_sacoche " en tapant :


rm -r -f /install_sacoche/

D- Modification des droits d'accs du dossier " sacoche ":


Une fois que le transfert des fichiers est fait, il faut modifier les droits d'accs du dossier " sacoche " dans le
conteneur " web ". Pour cela, partir de la console Amonecole, il faut d'abord aller dans le conteneur :
ssh 192.0.2.51
Puis on tape :
chown -R www-data:www-data /var/www/html/sacoche
Suivi de :
chmod -R 770 sacoche/
On n'oublie pas de se dconnecter du conteneur web en utilisant au clavier la combinaison CTRL D.

Retour la table des matires

page 4 / 12

E- Cration de la base de donnes ncessaire Sacoche :


a) Mthode EOLE (trs rapide et trs simple !) :
partir de la console de l'Amonecole (en 192.168.0.2), on tape le nom du script suivant :
/usr/share/eole/mysql_add.py
Il suffit de rpondre aux questions suivantes :
Nom de la base de donnes crer : sacoche
Nom de l'utilisateur MySQL administrant la base : sacoche
Mot de passe de l'utilisateur Mysql administrant la base : votre_mot_de_passe
Nom du conteneur source : web
Un message indique que la base a bien t cre : ## Cration de la base sacoche ##

b) Mthode semi-manuelle (non teste!!!) :


On peut choisir dutiliser une base de donnes existantes mais via phpMyAdmin ( partir d'un
navigateur Internet) en crant un utilisateur spcifique nomm " sacoche " avec une base de donnes propre
associe nomme elle aussi (comble de loriginalit) " sacoche ". Pour cela aprs nous tre connect MySql
via phpMyAdmin, on passe par le menu " Privilges " puis " Ajouter un utilisateur " et cocher loption
indiquant quon lui associe une nouvelle base de donne.
Cette base ne contient encore aucune table mais linstallation automatique y remdiera.

Retour la table des matires

page 5 / 12

F- Configuration du serveur Amonecole 2.3


Pour accder directement SACOCHE sans avoir rentrer le chemin complet, on va crer un alias (un
raccourci) pour avoir une adresse du type http://nomdedomaine/sacoche
Pour cela, il faut configurer le serveur Amonecole grce loutil graphique " gen_config " en tapant :
gen_config
Ouvrir le fichier " config.eol ", choisir le mode " Expert ", aller dans le module " Apache " et dans la
partie " Applications supplmentaires " indiquer dans " chemin complet de lapplication" (attention la casse):
/var/www/htlm/sacoche. Puis dans lalias : " sacoche" (ou un autre de votre choix)

Ensuite, il faut sauvegarder le fichier " config.eol " et quitter linterface graphique " gen_config ".
Il faut ensuite reconfigurer le serveur dans la console du Amonecole :
reconfigure
Remarque : pour tout mettre en place, notamment au niveau de lauthentification SSO (voir en tapant
" diagnose " dans la console de lamonecole), il faudra faire ventuellement un reboot ou ventuellement
redmarrer les services via l'EAD.

Retour la table des matires

page 6 / 12

G- Suppression du fichier " .htaccess " cause derreur 500 :


Il faut supprimer le fichier .htaccess la racine du rpertoire Sacoche, en allant dans le conteneur web.
Pour cela taper les commandes partir de la console de lAmoncole :
ssh 192.0.2.51
puis
rm /var/www/html/sacoche/.htaccess
sources : http://sacoche.sesamath.net/index.php?dossier=utilisation&fichier=faq_utilisation__erreur_500
http://eoleng.ac-dijon.fr/documentations/Envole/co/52_ajout_web_2.html (encart en bas de page)

H- Installation automatique via un navigateur WEB :


http://sacoche.sesamath.net/index.php?dossier=utilisation&fichier=serveur_perso__installation
Pour faire linstallation, dans un navigateur (tel que Mozilla Firefox), taper ladresse suivante :
http://adresseduserveur/sacoche
partir de l, il suffit de suivre les instructions et de donner les renseignements demands
automatiquement au fur et mesure de linstallation (je n'ai captur que les fentres importantes).

Valider les diffrentes tapes et choisir un seul tablissement :

Retour la table des matires

page 7 / 12

Retour la table des matires

page 8 / 12

Retour la table des matires

page 9 / 12

Comme il sagit dune installation de type monostructure, il faut mmoriser le login et le mot de passe
du premier administrateur :
Login : admin

MdP : h989ytz6 (plus valable car modifi par la suite)

Puis pour une installation de type mono-structure, se connecter comme administrateur avec le login cidessus, puis changer (c'est fortement recommand) ventuellement le mot de passe. SACoche est prt
fonctionner.

Retour la table des matires

page 10 / 12

IV. Paramtrage de SACOCHE pour lENT et lauthentification CAS


L'intrt de la solution EOLE est d'utiliser diffrentes applications avec un seul et mme identifiant.
Pour cela, on utilise ce qu'on appelle une authentification extrieure-CAS qui va aiguiller vers la page de
connexion SSO de l'Amonecole.
Donc il suffit d'indiquer SACoche que l'on va s'identifier partir des donnes dj saisie dans le
serveur Amonecole. Pour cela, il faut se connecter en tant qu'administrateur dans SACoche et aller dans le
menu "Paramtrages" > " Mode d'identification "

Choix : Configuration CAS manuelle


Domaine : mon_adresse_dyndns.org (nom de domaine de notre serveur)
Port : 8443
Chemin : (laiss vide)
Cela fonctionne, car Sacoche me rpond ceci :
|Identification russie mais identifiant ENT "thierry.munoz" inconnu dans SACoche !
Une fois cre lutilisateur " thierry.munoz " dans Sacoche, lauthentification SSO dEnvole fonctionne
correctement pour ce login existant auparavant sous Envole.

V. Importation des logins et identifiants de Amoncole vers SACoche


Maintenant pour que tous les professeurs et lves puissent se connecter SACoche via leur identifiant
Amoncole, il faut les importer dans SACoche pour cela il y a plusieurs possibilits, pour savoir comment
procder, voir la doc suivante :
https://sacoche.sesamath.net/appel_doc.php?fichier=faq_documentation__detail_identifiants

VI. Problme de mise jour automatique de SACoche


Le conteneur web de l'Amonecole ne permet pas par dfaut aux applications installes de communiquer
l'extrieur, du coup il tait impossible pour SACoche de connatre les mises jour : message " Dernire
version non dtecte " (cf capture ci-dessous).

Retour la table des matires

page 11 / 12

Explications dans la documentation SACoche :


https://sacoche.sesamath.net/index.php?dossier=utilisation&fichier=faq_utilisation__communication_serveurs
Il faut donc crer une autorisation particulire vers le serveur communautaire de SACoche (adresse ip :
46.105.46.87 sur le port 443 car c'est une adresse https). Voir le message de Jol Cuissinat
(http://eole.orion.education.fr/listes/arc/scribe/2012-09/msg00115.html)
La plupart des conteneurs ne peuvent effectivement pas sortir sur Internet car les connexions sont bloques
par eole-firewall :
http://eoleng.ac-dijon.fr/pub/Documentations/manuels/2.3/partielles/HTML/commun/co/09b-eolefirewall.html
Pour autoriser le conteneur web accder au serveur de mise jour de SACoche, vous pouvez crer le fichier
:
/usr/share/eole/firewall/00_web_sachoche.fw
et y mettre la ligne suivante :
allow_dest(ip='46.105.46.87', port='443')

Retour la table des matires

page 12 / 12

You might also like