Instructions d'installation

  |   2574  |  Commentaires (3)  |  Storage@Home
Introduction

1. Lisez la FAQ avant tout. Lisez ensuite attentivement l’ensemble de ces instructions avant de commencer.

2. Si vous n’êtes pas à l’aise avec la configuration de l’adresse IP de votre machine et la mise en place de redirections de ports ou si vous ne pensez pas pouvoir suivre le rythme ce qui sera un projet mouvementé en septembre, trouvez quelqu’un pour vous donner un coup demain. ;) Dans cette première phase du projet Storage@Home, le temps est compté pour récolter un maximum de données.

Enregistrez vous et récupérer un identifiant machine (Machine ID)

(Note importante : les utilisateurs de Linux voudront peut être tester l’exécutable avant de poursuivre, vous devez disposer des Glibc 2.4 ou plus pour lancer le programme)

Rendez-vous sur http://vspm11.stanford.edu/sah/ et enregistrez-vous, puis récupérez un identifiant.

Téléchargez sah-monitor.exe

Windows
32 bits : http://www.stanford.edu/~beberg/sah/Win32-1.05-sah-monitor.zip
64 bits : http://www.stanford.edu/~beberg/sah/Win64-1.05-sah-monitor.zip

Mac OS X (Universal binary)
http://www.stanford.edu/~beberg/sah/OSX-1.05-sah-monitor.tgz

Linux 32 bit Compilé avec un kernel 2.6.22 et libc 2.4+.
http://www.stanford.edu/~beberg/sah/Lin32-1.05-sah-monitor.tgz

Linux 64 bit Compilé avec un kernel 2.6.28 et libc 2.4+.
http://www.stanford.edu/~beberg/sah/Lin64-1.05-sah-monitor.tgz

Redirection des ports et configuration du firewall

Le modem/routeur :
Vous devez rediriger le trafic UDP arrivant sur le port 300 vers votre machine. Si vous ne savez pas comment faire, voici une liste de quelques guides qui pourraient vous aider. Vous trouverez aussi des tutoriaux animés sur Youtube. Vous pouvez aussi vous référer à la documentation de votre modem/routeur.
(en anglais)

Certains utilisateurs de routeurs D-Link devront configurer le port UDP 300 dans l'onglet Serveurs Vituels (Virtual Servers) du menu Avancé (Advanced) (onglet par défaut du menu Avancé) au lieu du menu Redirection de ports (Ports Forwarding). Si la configuration de la redirection de ports semble correcte mais que sah-monitor n'est toujours pas capable de répondre aux pings, pensez-y.

Le firewall :
Quel que soit le firwall que vous utilisez, vous devez autoriser le trafic UDP sur le port 300 et/ou l’application sah-monitor.exe. Voici comment configurer les firewalls inclus dans les systèmes d’exploitation :

  • Windows (peut varier légèrement suivant XP/Vista/Seven)
    Menu démarrer, Panneau de configuration, Centre de sécurité, Firewall Windows, onglet Exceptions. Cliquez sur le bouton Ajouter un programme, recherchez l’exécutable sah-monitor.exe et cliquez sur OK pour l’ajouter. Cliquez à nouveau sur OK pour fermer la fenêtre de configuration du firewall Windows, et fermez le Panneau de configuration.
  • OS X
    OSX vous demandera si vous voulez autoriser sah-monitor.exe à accéder au réseau dès que vous le lancerez, ne soyez pas surpris.
  • Linux
    Il y a tellement de firewall différents sous Linux qu’il est impossible de les regrouper ici. Si le votre vous pose problème, référez vous à la documentation de votre distribution.


Installation

Service Windows :
Dézippez le fichier dans le dossier de votre choix. Sah-monitor.exe doit pouvoir écrire son log dans le dossier que vous choisirez. Munissez-vous de l’invite de commandes (Menu démarrer, Exécuter, “cmd” ), déplacez-vous (commande cd) dans le dossier où vous avez déposé sah-monitor.exe. Si vous l’exécutez, il vous affichera des instructions. Sous Vista/Seven vous devez démarrer l'invite de commandes en administrateur (click droit sur Invite de commande > Démarrer en tant qu'administrateur). Ceci est valable pour toutes les comandes de ces instructions.

Lancez l’installation avec la commande suivante :
Code :
sah-monitor.exe install machine_id -D "directory"
net start sah-monitor

Machine ID est l’identifiant machine que vous avez créé précédemment. « directory » est votre dossier d’installation (par exemple C:\SAH).

Si vous recevez l'erreur "OpenSCManager failed (5)" pendant l'installation, c'est que vous avez probablement oublié de lancer l'Invite de commandes en administrateur.

Si vous n’être pas à l’aise avec la ligne de commande pour démarrer et arrêter les serivices, vous pouvez le faire graphiquement : Menu démarrer > Panneau de configuration > Outils d’administration > Services. Autre méthode : Menu démarrer > Exécuter > services.msn > OK

Lorsque SAH est correctement installé, vous voyez une nouvelle entrée appellée Storage@Home Monitor.

Le programme démarrera automatiquement avec l’OS, mais n’oubliez pas les dates d’expiration !
Désinstallation : Code :
net stop sah-monitor
sah-monitor.exe uninstall

Mac OS X
Ouvrez un terminal (disponible dans Applications/Utilitaires)
Décompressez le fichier téléchargé (changez le numéro de version de l’exemple si nécessaire) : Code :
tar xfvz OSX-1.02-sah-monitor.tgz

Installez : Code :
sudo ./OSX-launchd-gen.pl MACHINE_ID "`pwd`"

Démarrez le programme : Code :
sudo launchctl load -w /Library/LaunchDaemons/sah-monitor.plist

La première fois que vous le lancerez, OSX vous demandera si vous voulez l’autoriser à accéder au réseau, répondez OUI ! ;)
Vérifiez que le programme fonctionne et regardez les pings (appuyez sur Contorl + C pour quitter la commande tail) Code :
tail -f sah-monitor.log

C’est installé, il devrait démarrer seul avec le système, mais n’oubliez pas des dates d’expiration !
Désinstalaltion : Code :
sudo launchctl unload -w /Library/LaunchDaemons/sah-monitor.plist

Linux: x86
Dans un terminal :
Code :
tar xfvz LinXX-1.02-sah-monitor.tgz
sudo ./sah-monitor.exe machine_id -d "`pwd`"
(après avoir entré votre mot de passe et que le programme a démarré, appuyez sur CRTL + Z et tapez immediatement la ligne suivante)
bg


Codes d'erreur

  • -1 or 65535 or 4294967295 = Oubli du -d avant d'indiquer le chemin du client, mauvais paramètres ou le Machine ID n'est pas un Machine ID valide.
  • -2 or 65534 or 4294967294 = La machine a déjà planté (cas rare).
  • -3 or 65533 or 4294967293 = Problème de chemin d'accès au log ou de droits, souvent un mauvais chemin indiqué à l'installation ou les mauvais déliminteur (le \) à la fin du chemin d'accès.
  • -4 or 65532 or 4294967292 = Client expiré (normal).


Surveiller le fonctionnement – page d’information pour chaque machine

Rendez-vous sur http://vspm11.stanford.edu/sah/, identifiez vous et cliquez sur l’identifiant machine pour afficher les informations. Vous pouvez aussi regarder dans votre fichier sah-monitor.log. ;)

Vous devriez voir le démarrage et un ping peu après. S’il y a des problèmes réseau ou si le serveur est en panne, il réessayera toutes les 6 minutes. Vérifiez que votre Machine ID est correct, sinon il sera ignoré. Si vous voyez plusieurs lignes « Checkin », si vous ne voyez jamais de ping ou si vous voyez une IP 0.0.0.0, votre redirection de port ne fonctionne pas ou votre firewall est mal configuré. Si vous voyez des pings, mais que la page d’information de votre machine n’affiche pas de pongs, vos paquets sortant sont bloqués, vérifiez qu’une règle de firewall ou configuration du modem/router n’est pas mal configurée en sortie. Certains fournisseurs d’accès à Internet peuvent également bloquer le trafic entrant et/ou sortant. Consultez les forums officiels pour obtenir de l’aide.

Si le fichier sah-monitor.log affiche la ligne suivante :
Citation:
Unable to open listening socket

Il y a deux causes possibles :
  • Oubli du sudo (Linux/OSX)
  • Programme lancé plus d'une fois en même temps

Un reboot de la machine peut aussi aider à libérer le socket dans le cas où les deux cas ci-dessus ne s'appliquent pas.

Si votre client n’a pas l’air de fonctionner au bout d’une demi-heure (à la fois les pings dans le log et les pongs sur le site) merci de bien vouloir arrêter sah-monitor.exe en utilisant la première étape des instructions de désinstallation ci-dessous. Laisser tourner un client dans ces conditions est inutile. :(

Mises à jour

Windows
Dans un invite de commandes (Menu démarrer, Exécuter, “cmd”;), déplacez-vous dans le dossier où vous avez mis sah-monitor.exe (commande cd) et tapez :
Code :
net stop sah-monitor

(copiez maintenant la nouvelle version de sah-monitor.exe et relancez-le …)

net start sah-monitor

Mac OS X
Dans un Terminal (disponible dans Applications/Utilitaires), déplacez-vous dans le dossier où vous avez mis sah-monitor.exe (commande cd) et tapez
Code :
sudo launchctl unload -w /Library/LaunchDaemons/sah-monitor.plist

(copiez maintenant la nouvelle version de sah-monitor.exe et relancez-le …)

sudo launchctl load -w /Library/LaunchDaemons/sah-monitor.plist

Linux
Dans un terminal, tuez simplement le client.
Code :
sudo killall sah-monitor.exe

(copiez maintenant la nouvelle version de sah-monitor.exe et relancez-le …)

sudo ./sah-monitor.exe machine_id -d "`pwd`"


Désinstallation

Windows
Dans un invite de commandes (Menu démarrer, Exécuter, “cmd”;), déplacez-vous dans le dossier où vous avez mis sah-monitor.exe (commande cd) et tapez :
Code :
net stop sah-monitor
sah-monitor.exe uninstall

Mac OS X
Dans un Terminal (disponible dans Applications/Utilitaires) :
Code :
sudo launchctl unload -w /Library/LaunchDaemons/sah-monitor.plist
sudo rm /Library/LaunchDaemons/sah-monitor.plist

Linux
Dans un terminal, tuez simplement le client, il n’y a rien à désinstaller puisque rien n’a été installé.
Code :
sudo killall sah-monitor.exe

Vous pouvez maintenant supprimer les fichiers sah-monitor.* si vous ne souhaitez pas les conserver.