Pygrenouille


Sommaire

Pygrenouille

Windows

Pré-requis:

Si ce n'est pas déjà fait, commencez par vous inscrire et par télécharger PyGrenouille

Installation
  • Double cliquez sur l'exécutable pygrenouille.exe qui lancera l'assistant d'installation.
  • L'installation se déroule en 6 étapes.
Présentation et recommandation:

Image:win1.JPG

  • Cliquez sur suivant
Acceptation du contrat de licence:

Image:win2.JPG

  • Lisez et acceptez le contrat de licence (Licence GPL) afin de continuer l'installation
  • Cliquez sur suivant
Dossier d'installation

Image:win3.JPG

  • Cette fenêtre vous permet de choisir le dossier d'installation. Le chemin par défaut convient à la plupart des utilisateurs.
  • Cliquez sur parcourir si vous souhaitez choisir un autre dossier et enfin sur suivant pour continuer.
Ajout du raccourci dans le menu démarrer

Image:win4.JPG

  • Vous pouvez ici choisir l'emplacement du raccourci dans le menu démarrer. La plupart des utilisateurs sont satisfaits du choix par défaut.
  • Cliquez sur suivant.
Option

Image:win5.JPG

  • Cette fenêtre vous permet d'ajouter un icône sur le bureau et/ou d'automatiser le lancement au démarrage de windows.Faites votre choix et cliquez sur suivant.
Récapitulatif

Image:win6.JPG

  • Cliquez sur installer afin de terminer l'installation de PyGrenouille.


L'installation est terminée.

Image:win7.JPG

  • Cliquez sur terminer pour lancer l'assistant de configuration.
Configuration de Pygrenouille

Image:conf1.JPG

  • Cliquez sur next.
Identifiant

Image:conf2.JPG

  • Tapez l'identifiant et le mot de passe que vous avez choisi lors de votre inscription puis cliquez sur next.
Tout est prêt

Image:conf3.JPG

  • Cliquez sur finish.

Désormais il vous suffit de lancer PyGrenouille soit par l'icône sur le bureau soit par le menu démarrer. Une icône supplémentaire (représentant une grenouille grise) apparaît dans la zone de notification. Les tests débutent immédiatement et l'icône changera de couleur en fonction des performances de votre connexion Internet.

Un double clic sur cette icône montre les dernières valeurs mesurées du débit descendant, du débit montant et du ping. Ces valeurs sont rappelées également dans une infobulle qui s'ouvre lorsque la souris survole l'icône.

Image:lancement.JPG

Au prochain démarrage d'une session Windows la Grenouille sera lancée automatiquement.

[Sommaire]


Installation Debian ~ Ubuntu

Téléchargez Pygrenouille, puis décompressez le dossier pygrenouille que l'archive contient dans votre dossier personnel, et mettez vous à son niveau :

   cd /home/$USER/pygrenouille 

Rendez alors les fichiers pygrenouille.py et trafic.py exécutables à l'aide des commandes :

   chmod +x pygrenouille.py
   chmod +x contrib/linux2/trafic/trafic.py

Ces fichiers ont été développés à l'aide de Windows, or des différences dans le code source existent entre les systèmes Dos et Unix : par exemple, Unix verra des ^M à chaque fin de ligne créée dans un univers Dos. Un outil, dos2unix, intégré au paquet sysutils, permet la conversion : installez le puis convertissez les deux fichiers pygrenouille.py et trafic.py à l'aide de :

   apt-get install sysutils
   dos2unix pygrenouille.py
   dos2unix -a contrib/linux2/trafic/trafic.py

Il faut ensuite créer le fichier conf de pygrenouille : un assistant apparaît au premier lancement du script :

   ./pygrenouille.py

Une fois ces informations renseignées, pygrenouille peut être lancé à l'aide de la même commande.

Pygrenouille est maintenant fonctionnel, mais son exécution doit être manuelle : un simple script sh et une commande cron permettent d'automatiser son lancement au démarrage :

Mettez vous au niveau du dossier de pygrenouille comme précédemment, puis créez un fichier pygrenouille.sh :

   vi pygrenouille.sh

Remplissez le alors ainsi :

   #!/bin/sh
   cd /home/$USER/pygrenouille
   ./pygrenouille.py 

Puis enregistrez et quittez en tapant successivement : [Echap] [:] [w] [q] [Entrée] Comme pour les fichiers py, il faut rendre ce sh exécutable afin de l'utiliser :

   chmod +x pygrenouille.sh 

Utilisez finalement cron pour l'éxecuter au démarrage :

   crontab -e 

Puis ajoutez la ligne

   @reboot /home/$USER/pygrenouille/pygrenouille.sh 

et redémarrez le service :

   /etc/init.d/cron restart

source et remerciements: Henri Sohier


P.S. : Sous Ubuntu, si vous rencontrez des difficultés pour automatiser le lancement au démarrage, rendez-vous dans la fenêtre Système > Préférences > Sessions et positionnez-vous dans l'onglet Programmes au démarrage. Il suffit d'ajouter le chemin du sh (/home/(utilisateur)/pygrenouille/pygrenouille.sh) dans la liste des commandes à lancer.

KeyError: 'eth0'  : Si vous rencontrez cette erreur, rendez vous dans home/(utilisateur)/pygrenouille-1.11/contrib/linux2/trafic/trafic.py :

    cd home/$USER/pygrenouille-1.11/contrib/linux2/trafic/trafic.py

Puis, remplacez la ligne (touche Inser):

    process = popen('/sbin/ifconfig '+interface)

Par

    process = popen('LANG=C /sbin/ifconfig '+interface)

Sauvegardez la modification en tapant successivement: [Echap] [:] [w] [q] [Entrée] et relancez votre grenouille.


[Sommaire]


Installation Mandriva

Pré-requis

Si ce n'est pas déjà fait, commencez par vous inscrire et par télécharger PyGrenouille

Pour bénéficier de l'interface graphique vous devez vous assurer :

  • que la ligne GUI = Yes figure dans le fichier de configuration pygrenouille/pygrenouille.conf (elle y est par défaut)
  • que WXPython est installé sur votre machine. S'il ne l'est pas, ouvrez une console et tapez:
su
<ici le mot de passe root>
urpmi wxPythonGTK
  • Les utilisateurs de Mandriva 2007 x86_64 devront taper dans une console la commande suivante:
cp /usr/lib/python2.4/site-packages/wx.pth /usr/lib64/python2.4/site-packages/wx.pth
Installation
  • Mettez vous au niveau du fichier(nous partirons du principe que le fichier téléchargé se trouve dans votre dossier personnel, à savoir /home/(utilisateur)), ouvrez une nouvelle console(ou tapez exit pour sortir du mode super utilisateur) puis tapez:
cd /home/$USER
  • Extraction du fichier,tapez:
tar zxvf pygrenouille-v1.11.tar.gz  
  • Ensuite nous allons rendre les fichiers pygrenouille.py et trafic.py exécutables:
cd pygrenouille-1.11
chmod +x pygrenouille.py
chmod +x contrib/linux2/trafic/trafic.py
  • Tapez la commande suivante qui va ouvrir l'assistant de configuration en mode graphique:
./pygrenouille.py
Configuration de Pygrenouille

Image:configmdk1.JPG

Cliquez sur next.

Identifiant

Image:configmdk2.JPG

  • Tapez l'identifiant et le mot de passe que vous avez choisi lors de votre inscription puis cliquez sur next.
Tout est prêt

Image:configmdk3.JPG

  • Cliquez sur finish.
Script de lancement

Nous allons maintenant faciliter le lancement de pygrenouille en créant un script sh.Toujours dans une console,tapez:

cd /home/$USER/pygrenouille
vi pygrenouille.sh

Taper sur la touche "Inser" de votre clavier pour éditer et ajoutez les lignes.

#!/bin/sh
cd /home/$USER/pygrenouille
./pygrenouille.py

(Notez que /home/(utilisateur)/pygrenouille peut être remplacé par ~/pygrenouille ou $HOME/pygrenouille si vous souhaitez que ce script soit portable sur un autre PC, avec un autre utilisateur.)

Pour enregistrer tapez successivement [Echap] [:] [w] [q] [Entrée]

Nous allons là aussi rendre ce fichier exécutable,tapez:

chmod +x pygrenouille.sh 

Un fichier pygrenouille.sh a été crée dans /home/(utilisateur)/pygrenouille,un double clic sur celui-ci lancera pygrenouille.Il vous sera alors possible d'éditer votre menu et d'y rajouter un raccourci qui pointe sur ce fichier.

De la même façon que sous Ubuntu vous pouvez automatiser le lancement de pygrenouille :

--> vous utilisez GNOME : rendez-vous dans la fenêtre Système > Préférences > Sessions et positionnez-vous dans l'onglet Programmes au démarrage. Il suffit d'ajouter le chemin du sh (/home/(utilisateur)/pygrenouille/pygrenouille.sh) dans la liste des commandes à lancer.

--> vous utilisez KDE : copiez simplement votre script pygrenouille.sh dans le répertoire ~/.kde/Autostart en tapant dans la console

cp pygrenouille.sh ~/.kde/Autostart/pygrenouille.sh

[Sommaire]


Installation sur un NAS SYNOLOGY

Adaptation du client grenouille pour fonctionner sur les NAS Synology. Testé sur un CS407, DS207.

Pré-requis

Si ce n'est pas déjà fait, commencez par vous inscrire

Sur votre NAS : avoir installé IPKG et le paquet Python (2.4 ou 2.5) cela fonctionne quelque soit la version.

Nota : Utiliser de préférence la version IPKG

Installation IPKG
  • Connexion telnet en root.
  • Modifier le fichier /opt/etc/ipkg.conf en ajoutant la ligne suivante
 src philware http://devel.grenouille.com/pub/pygrenouille/distributions/synology/
  • mise à jour de ipkg
 ipkg update
  • installation de pygrenouille
 ipkg install pygrenouille
  • le fichier de configuration sa lance automatiquement, pour remplir le fichier de configuration, répondez simplement aux messages.

user, mot de passe, logs de connexion, logs de résultats.

Lorsque vous quittez le script de configuration la grenouille démarre.

Lors du prochain démarrage le script /opt/etc/init.d/S99gre.sh s'exécutera automatiquement au boot de votre Synology.

DesInstallation IPKG
  • Vous pouvez desinstaller pygrenouille proprement en entrant la commande suivante
 ipkg remove pygrenouille
Script de demarrage

Le lancement de la grenouille est effectué automatiquement lors du démarrage du NAS Synology. Le script de lancement accepte les paramètres suivants : start, stop, restart, debug.

  • /opt/etc/init.d/S99gre.sh start > demarrage de la grenouille
  • /opt/etc/init.d/S99gre.sh stop > arret de la grenouille
  • /opt/etc/init.d/S99gre.sh restart > arret puis demarrage de la grenouille
  • /opt/etc/init.d/S99gre.sh debug > demarrage de la grenouille en mode console avec affichage de tous les messages.
Script de setup

j'ai, par rapport a la version standard python, séparé du script principal la création du fichier de configuration. Il se trouve ici /root/pygrenouille/setup_pygrenouille.py

Installation tag.gz

Nota : Utiliser de préférence la version IPKG

  • Connexion telnet en root et exécutez les commandes suivantes.
  • allez a la racine de votre syno
 cd /
  • chargement de l'archive
 wget http://pagesperso-orange.fr/cest-ici/pygmod.tar.gz
  • décompression
 tar zxvf pygmod.tar.gz
  • affectation des droits aux fichier
 chmod +x /root/pygrenouille/pygrenouille.py
 chmod +x /root/pygrenouille/setup_pygrenouille.py
 chmod +x /root/pygrenouille/contrib/linux2/trafic/trafic.py
 chmod +x /opt/etc/init.d/S99gre.sh
  • Configuration de Pygrenouille

lancer

 python /root/pygrenouille/setup_pygrenouille.py ou alors ./root/pygrenouille/setup_pygrenouille.py

pour remplir le fichier de configuration répondez simplement aux messages

  • Script de lancement

Pour lancer le script entrez la commande suivante :

 ./opt/etc/init.d/S99gre.sh start
  • Petit test pour savoir si le script est bien lancé :
 ps | grep -v grep | grep 'python'

Lors du prochain démarrage le script /opt/etc/init.d/S99gre.sh s'exécutera automatiquement au boot de votre Synology.


[Sommaire]


Récupérée de « http://wiki.grenouille.com/index.php/Pygrenouille »
Un article de Wiki Grenouille.
Powered by MediaWiki