Sentinelle Guide d`installation rapide v2.0 (Sentinelle Web)

Sentinelle
Guide d'installation rapide
v2.0 (Sentinelle Web)
Installation
Une partie de la procédure d'installation de Sentinelle est commune à celle des modules EoleNg. Je ne rentrerais donc pas ici dans les détails de l'installation de base, et considérerais comme acquis les notions de base de l'installation d'un module Eole. Afin d'installer Sentinelle, télécharger la dernière version de la distribution EoleNg (Ref. http://eole.ac­dijon.fr).
○
○
○
○
Booter sur le CD et choisir l'entrée Sentinelle dans le menu.
Une fois l'installation terminée retirer le CD et rebooter le serveur
Connecter vous au serveur
Lancer la commande gen_config
La fenêtre de paramétrage des variables du serveur apparaît , rapportez vous à la documentation EoleNg pour plus d'informations sur la signification de ces variables.
Veillez à renseigner la variable « adresse ip ou dns du serveur zephir »
Les variables spécifiques à Sentinelle Web sont
Libellé
Variable
Nom dns complet du sentinelleweb_dns
serveur Sentinelle­web
Description
Décrit le nom dns complet du serveur sentinelle.
Port de sentinelle­web
tomcat_port
Clé de l API GoogleMap
sentinelleweb_googlekey Clé google pour l'accès a l'API de cartographie
Port d'écoute de l'application web
La clé google est récupérable a cette adresse (Page en anglais)
http://code.google.com/intl/fr/apis/maps/signup.html
Accepter les conditions d'utilisations de l'API
Renseigner comme suit le champ « My web site URL »: https://<sentinelleweb_dns>:<tomcat_port>
où <sentinelleweb_dns> et <tomcat_port> sont à remplacer par les valeurs que vous avez renseignées lors du gen_config.
○
Instancier votre serveur
Le fonctionnement de Sentinelle nécessite l'installation de la machine virtuelle Java de Sun (1.6), afin d'installer le paquet sun­java6­bin il est donc nécessaire de choisir le niveau de mise à jour à « complète » .
Lors de ll'instanciation, le système va récupérer les paquets sun­java6­bin et toutes ces dépendances. La récupération peut être longue ( ~ 25 Mo à récupérer )
Si le message d'erreur suivant apparaît :
Impossible de trouver le paquet sun­java6­jre
Les runtime java 6 sont nécessaires au fonctionnement de sentinelle
Abanbon de la procédure d'instance
Vous n'avez certainement pas mis le niveau de mise à jour à complète. Changer le niveau de mise à jour et relancer l'instanciation. Lors de la première procédure d'instance le système vous demande d'entrer les mots de passes suivants
○ Le super­utilisateur root de mysql ○ L'utilisateur sentinelle de mysql ○ Le login d'accès à zephir
Un utilisateur ayant les droits d'accès en lecture seul est suffisant a Sentinelle pour accéder a Zephir. Je vous conseille donc sur Zephir de créer un login sentinelle et de ne lui affecter que le droit en lecture sur tout les modules.
La procédure va ensuite initialiser la base mysql, et récupérer les établissements.
Si un message d'erreur apparaît Erreur lors de la récupération, vérifier vos identifiants Zephir
Vérifier l'adresse IP de Zephir et votre identifiant de connexion.
Si la connexion à Zephir s'est correctement effectuée vous devez avoir le message suivant
Récupération des établissements : xxx établissements récupérés
où xxx représente le nombre d'établissement extraits de Zephir.
La procédure vous demande ensuite de créer le fichier de coordonnées des établissements. Si vous voulez créer ce fichier répondez par oui. Reportez­vous à la section « Génération des coordonnées des établissements » pour plus d'informations sur cette étape. Si vous répondez non à cette question vous aurez toujours la possibilité plus tard de générer ce fichier.
NOTE : Lors d'un reconfigure si le fichier de coordonnées n'existe pas le message suivant apparaitra :
============================================
ATTENTION
Le fichier de coordonnées des établissements n'existe pas
Veuillez vous munir d'une clef googleMap
http://code.google.com/intl/fr/apis/maps/signup.html
et lancer les commandes suivantes
cd /usr/share/sentinelle-server/scripts
python RecupGPSEtabsFromZephir.py
===========================================
La procédure continue ensuite le paramétrage de Sentinelle
Lancement du client Sentinelle
Ouvrez un navigateur et taper l'url renseignée dans le gen_config
https://<sentinelleweb_dns>:<tomcat_port>/SentinelleOnAir
Sentinelle fonctionne avec les principaux navigateurs : Firefox (>3.0), Opéra, Safari, Chrome. Actuellement je ne peux que vous conseiller d'utiliser chrome car se dernier utilise un moteur java­script le plus rapide. Installation de l'handler
Un handler permettra à votre navigateur d 'exécuter des actions depuis Sentinelle­
Web. Il s'agit tout simplement de préciser au navigateur comment ouvrir le « scheme » sentinelle://
Postes Windows : ✔
Récupérez l'archive:
https://<sentinelleweb_dns>:<tomcat_port>/SentinelleOnAir/handler/handler.zip
✔
Décompresser l'archive
✔
Copier le dossier sentinelle­handler­win sur votre poste ­> Exemple dans C:\Documents and Settings\<username>\ <­
✔
Double cliquez sur install­handler.reg
Ouvrez test.html avec firefox
Suivez le lien sur la page La première fois firefox vous demande de l'associer à un programme
choisissez donc sentinelle­handler.exe
✔
✔
✔
✔
Si le ping fonctionne c'est OK
Postes Linux
✔
Récupérer l'archive
https://<sentinelleweb_dns>:<tomcat_port>/SentinelleOnAir/handler/handler.zip
✔
Décompresser l'archive
Copier le dossier sentinelle­handler­linux sur votre poste Mettre le droit d'exécution sur sentinelle­handler.sh dans le dossier sentinelle­
handler­linux ✔
✔
Pour Firefox
✔ Ajouter les lignes suivantes dans ~/.mozilla/firefox/<profile>/prefs.js en remplaçant "path/sentinelle­handler.sh" par le chemin complet de sentinelle­
handler.sh
user_pref("network.protocol­handler.app.sentinelle","path/sentinelle­handler.sh");
user_pref("network.protocol­handler.expose.sentinelle",true);
user_pref("network.protocol­handler.external.sentinelle",true);
user_pref("network.protocol­handler.warn­external.sentinelle",false);
Pour chrome (dans un environnement gnome)
✔ Lancer gconf­editor
✔ Créer la clef /desktop/gnome/url­handlers/sentinelle
✔ Créer les entrées suivantes
command : le chemin complet de sentinelle­handler.sh (String)
enabled : true (booléen)
needs_terminal : false (booléen)
L'équivalent doit exister sur les autres environnements.
Note : La source de l'handler windows se trouve dans sentinelle­handler.au3, il s'agit un script AutoIt que vous pouvez bien sur adaptez en fonction de vos besoins.
Les scripts font références à des exécutables externes (vncviewer, putty, ....); assurez vous qu'ils soient accessibles depuis votre path.
Génération des coordonnées des établissements
Contrairement à la version précédente du client Sentinelle, il n'est plus nécessaire de faire une interpolation des coordonnées. La version web utilise directement l'API de google basé sur les coordonnées GPS.
Il existe un script permettant de récupérer les coordonnées GPS des établissements à partir de leur adresse postale renseignée dans Zephir. Ce script se base sur les adresses postales afin de récupérer les coordonnées GPS depuis GoogleMap, Avant de lancer ce script vous devez valider les pré­requis suivants.
●
Munissez­vous de la clef G o o g l e API : Cette clef permettra de vous connecter à l'api de G o o g l e, et de récupérer ainsi les coordonnées GPS. Pour plus d'informations sur l'obtention de cette clef aller à l'url http://www.google.com/apis/maps/
○
●
Si cette clef est renseignée dans le dictionnaire, cette dernière sera utilisé
Assurez­vous que les adresses postales soient bien renseignées dans Zephir. Au minimum doivent figurer la ville et le code postal.
Lancer le script de récupération
python /usr/share/sentinelle­server/scripts/RecupGPSEtabsFromZephir.py
Si le message d'erreur suivant apparaît
Problème lors de la récupération des coordonnées Essayer la requete suivante dans un navigateur http://maps.google.com/maps/geo?q=Dijonfe%20%2C%20France&output=csv&key=..
Et consulter le site GoogleMap pour plus d'infos Entrer l'url dans un navigateur et repérer le code d'erreur (1er nombre), consulter l'API G o o g l e pour plus d'informations sur la signification du code.
Les codes les plus communs sont les suivants :
Code
Description
610
Cette erreur retournée par G o o g l e signifie que votre clé (google api) que vous avez renseigné est incorrecte et pas pour ce domaine
602
La localisation n'a pu être trouvée
La procédure va ensuite récupérer les coordonnées de tous les établissements et les enregistrer dans /etc/sentinelle/web/map/etabs.gps. Lors de la récupération, il est possible que l'API google ne puisse pas localiser tous les établissements, le message formaté comme suit s'affiche
<code rne>:<nom>:<adresse>, <ville> = (0,0) ­> Erreur lors de la récupération de <code rne>:<nom>
Il sera possible via l'interface web de repositionner les établissements nom localisés
A la fin de la récupération redémarrer tomcat5.5 pour prendre en compte les nouvelles coordonnées (/etc/init.d/tomcat5.5 restart)
Positionnement manuel des établissements
Lors de la génération des coordonnées, il est probable d'avoir des points qui se situent hors de la carte, ou que les établissements soient mal placés. Pour cela, Sentinelle offre la possibilité de repositionner les établissements à la main. Ce positionnement peut également être utile afin d'éclater les établissements se trouvant dans une grosse agglomération.
Le déplacement des établissements peut être délégué à des utilisateurs, pour cela
Éditer le fichier /etc/sentinelle/web/local.properties
Ajouter la ligne suivante security/usergroups.<login>=GPS
ceci aura pour effet d'autoriser <login> à déplacer les établissements
Redémarrer tomcat5.5
Connectez vous sur l'interface web de Sentinelle.
La carte s'affiche avec tous les établissements. Sur la carte en haut à gauche, sélectionnez « déplacement d'étab.»
Image 1: Activation du déplacement des établissements
Vous pouvez, maintenant déplacer librement les établissements.
Pour les établissements, qui ne sont pas positionnés,
✔
Étendre le panneau de gauche (en cliquant sur les chevrons)
✔
Cliquer sur « Mode » et cocher « Uniquement Etabs. Non GPS » (Image1: Activation du déplacement des établissements)
✔
Actualiser la liste en cliquant sur La liste n'affichera donc que les établissements ne disposant pas de coordonnées GPS, il suffit maintenant de les « glisser/Déposer » sur la carte a l'endroit souhaité.
Image 2: Afficher les établissement non GPS