Différences

Ci-dessous, les différences entre deux révisions de la page.

--- gitso [Le 28/01/2013, 17:32]
loicmarot [Liens] Modification du lien qui était cassé.
+++ gitso [Le 13/04/2021, 00:53] (Version actuelle)
mohican [Utilisation côté serveur]
@@ Ligne 5: / Ligne 5: @@
 ====== Visionneur de bureaux distants Gitso ======
-Comme d'autres visionneurs de [[bureau_a_distance|bureau à distance]], **Gitso** est un logiciel permettant de se connecter à distance, à travers une interface graphique, à un serveur d'affichage. De cette manière, vous affichez sur votre propre écran ce que vous verriez à l'écran d'un autre ordinateur.
+<note important>Ce logiciel n'est plus maintenu et ne semble plus fonctionner avec Ubuntu 20.04.</note>
+Comme d'autres visionneurs de [[:bureau_a_distance|bureau à distance]], **Gitso** est un logiciel permettant de se connecter à distance, à travers une interface graphique, à un serveur d'affichage. De cette manière, vous affichez sur votre propre écran ce que vous verriez à l'écran d'un autre ordinateur.
-Contrairement à la plupart des autres solutions, Gitso exempte le serveur (l'ordinateur qui est vu) d'ouvrir le port TCP de la connexion d'accès. Seul le client (l'ordinateur qui prend la main) devra ouvrir le port TCP 5500 correspondant au protocole VNC. Ceci permet à un utilisateur confirmé (client) d'aider un utilisateur parfaitement novice (serveur). Le serveur aura pour mission d'installer Gitso (si cela n'a pas été fait en amont), de le lancer (généralement dans le menu "internet") et de saisir l'adresse IP du client.
+Contrairement à la plupart des autres solutions, Gitso utilise le reverse VNC, c'est à dire que le serveur est la machine de la personne qui aide et le client - qui va se connecter au serveur - est la machine de la personne aidée.
+C'est donc le **serveur** (l'ordinateur qui prend la main) qui devra ouvrir le port TCP 5500 correspondant au [[:vnc|protocole VNC]]. Ceci permet à un utilisateur confirmé ("serveur", le dépanneur) d'aider un utilisateur parfaitement novice ("client", ordinateur dépanné). Le "client" (le dépanné) aura pour seule mission d'[[:tutoriel:comment_installer_un_paquet|installer]] **Gitso** (si cela n'a pas été fait en amont), de le lancer et de saisir l'adresse IP du "serveur" (le dépanneur).
-Gitso utilise le protocole VNC. C'est un logiciel libre, multi-plateforme, sous licence GNU GPL v3.
+**Gitso** utilise le protocole VNC. C'est un logiciel libre, multi-plateforme, sous licence [[wpfr>GPL|GNU GPL v3]].
+En 2020, le logiciel n'est plus développé depuis plusieurs années, mais il est toujours fonctionnel (?), et toujours présent dans les dépôts officiels Ubuntu (version 20.04).
+<note tip>Il est conseillé de lire la page [[:VNC]] ainsi que celle sur le [[:Bureau_a_distance|Bureau à distance]] pour avoir une vue globale du principe de la connexion à distance.</note>
+===== Pré-requis =====
+  * Disposer des [[:sudo|droits d'administration]].
+  * Disposer d'une connexion à Internet configurée et activée.
 ===== Installation =====
-Gitso est disponible pour différentes plateformes sur la [[http://code.google.com/p/gitso/|page google code de gitso]]. La version [[Ubuntu]] est un .deb qu'il suffit de (faire) exécuter sur le poste serveur ET le poste client : Ubuntu comportant un gestionnaire de paquet intégré, celui-ci devrait faire son travail.
+Il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]]  **[[apt>gitso]]** sur les 2 PC (le dépanneur et le dépanné).
+===== Utilisation côté serveur (aidant) =====
+Lancer l'application par votre menu des applications (ou en tapant son nom dans un terminal).
-===== Utilisation côté client =====
+Le PC qui veut prendre la main (le "serveur"), doit d'abord [[[:ufw|ouvrir son port TCP 5500]] correspondant au port par défaut du protocole VNC. Ceci se configure au niveau du [[:ufw|pare-feu]].
-Le client, qui veut prendre la main, doit d'abord ouvrir son port TCP 5500 correspondant au port par défaut du protocole VNC. Ceci se configure au niveau du pare-feu, c'est-à-dire le plus souvent dans l'interface de configuration de la "box" pour un particulier.
+Le serveur cochera la case //Give Support// (venir en aide) puis //Start// (commencer) pour lancer le serveur qui va écouter sur le port 5500.
-Gitso peut être exécuté à l'aide de son raccourci //Applications -> Internet -> **Gitso**//. Le client cochera la case "give support" (venir en aide) puis "start" (commencer).
+{{ :applications:gitso-support_trusty.png?300 |}}
-Il lui faut ensuite **communiquer son adresse IP à l'utilisateur côté "serveur"** (par téléphone, mail, irc, fax, signaux de fumée...).
+Il lui faut ensuite **communiquer son adresse IP à l'utilisateur côté "client"** (par téléphone, mail, irc, fax, signaux de fumée...).
-Pour connaître l'adresse IP du poste client : naviguer sur un site tel que [[http://mon-ip.com/]].
+Depuis un terminal, avec curl :
+  curl ifconfig.me
+ou avec [[:wget]] :
+  wget http://checkip.dyndns.org/ -O - -o /dev/null | cut -d: -f 2 | cut -d' ' -f 2 | cut -d\< -f 1
-===== Utilisation côté serveur =====
+Autre solution, pour connaître l'adresse IP du poste serveur : naviguer sur un site tel que [[http://www.anonymat.org/vostraces/index.php|anonymat.org]] ou [[http://mon-ip.com|mon-ip.com]] ou [[https://mon-ip-addresse.com|mon-ip-addresse.com]].
-Le serveur, qui veut être aidé, n'a __aucune intervention à faire sur la configuration de son pare-feu__. Il n'a qu'à exécuter Gitso à l'aide de son raccourci //Applications -> Internet -> **Gitso**// , laisser cochée la case "get help" (obtenir de l'aide, cochée par défaut), **saisir l'IP du client qui va l'aider** et enfin "start" (commencer).
+===== Utilisation côté client (aidé) =====
-Après quelques secondes, une fenêtre contenant le bureau du serveur va apparaître sur le poste client : c'est à lui de jouer !
+Le client, qui veut être aidé, n'a __aucune intervention à faire sur la configuration de son pare-feu__. Il n'a qu'à exécuter **Gitso**, laisser cochée la case //Get Help// (obtenir de l'aide, cochée par défaut), **saisir l'IP du serveur qui va l'aider** et enfin //Start// (commencer).
-===== Désinstallation =====
+{{ :applications:gisto-client_trusty.png?300 |}}
-En ligne de commande :
-<code>sudo apt-get remove gitso
+Après quelques secondes, une fenêtre contenant le bureau du **client** va apparaître sur le poste **serveur** : c'est à lui de jouer !
-sudo apt-get autoremove</code>
+=====Problème connu=====
+====Pas de bouton Start====
+Si la fenêtre de connexion ne comporte aucun bouton "Start", il suffit de valider en tapant sur la touche "Entrée" du clavier.
+{{ :gitso:ma_capture.png?nolink&200 |}}
+Le fait que les boutons "Start" et "Stop" n'apparaissent pas est lié au fait que la taille de la fenêtre de Gitso est définie en valeur absolue, l'unité étant le pixel. Il en résulte que, selon votre résolution d'écran, cette taille ne sera pas assez importante pour faire tenir tous les éléments de la fenêtre. En effet, la taille de ces éléments est relative à la résolution.
+Avec des résolutions d'écran élevées, ce ne sont donc pas seulement les boutons "Start" et "Stop" qui sont manquants mais ce peut être aussi l'option "Give support" qui sera partiellement ou en totalité masquée, ce qui est plus problématique.
+Une solution pour remédier à ce problème et récupérer l'affichage de l'intégralité des éléments constitutifs de la fenêtre de Gitso, c'est d'éditer le fichier [[:tutoriel:comment_modifier_un_fichier|/usr/share/gitso/ConnectionWindow.py]] qui définit la taille de sa fenêtre.
+On prendra donc d'abord soin d'effectuer une copie de sauvegarde de ce fichier, en ouvrant un terminal puis en y entrant la commande suivante :
+  sudo cp /usr/share/gitso/ConnectionWindow.py /usr/share/gitso/ConnectionWindow.py.BKP
+On pourra ensuite éditer le fichier qui nous intéresse. Par exemple, en mode graphique, avec l'éditeur de texte gedit comme ceci :
+  sudo -H gedit /usr/share/gitso/ConnectionWindow.py
+Repérer alors le bloc suivant du fichier qui débute à la ligne n°53 :
+  		if re.match('(?:open|free|net)bsd|linux',sys.platform):
+  			width = 165
+  			height = 350
+  			xval1 = 155
+  			xval2 = 250
+  		else:
+  			height = 175
+  			width = 350
+  			xval1 = 180
+  			xval2 = 265
+Ce bloc indique que si le système d'exploitation est une variante de BSD ou de GNU+Linux, alors la fenêtre adopte une certaine taille et position, sinon elle en adopte une autre.
+Il s'agit donc ici (puisque nous utilisons un système GNU+Linux) de modifier la valeur de la première ligne commençant par width (qui signifie largeur) et qui correspond à la ligne n°54 du fichier, ainsi que celle de la ligne suivante qui commence par height (pour hauteur) et qui correspond à la ligne n°55.
+Voici, par exemple, le bloc ainsi modifié en utilisant des valeurs adaptées pour un écran dont la résolution est de 1680x1050 pixels :
+                  if re.match('(?:open|free|net)bsd|linux',sys.platform):
+                          width = 220
+                          height = 400
+                          xval1 = 155
+                          xval2 = 250
+                  else:
+                          height = 175
+                          width = 350
+                          xval1 = 180
+                          xval2 = 265
+Une fois les modifications voulues effectuées, enregistrer le fichier puis relancer Gitso qui doit alors afficher l'intégralité de ses options et boutons. Si ce n'est toujours pas le cas, éditer à nouveau le fichier pour ajuster les valeurs des lignes 54 et 55.
+Notons également que les valeurs "xval1" (ligne 56 du fichier) et "xval2" (ligne 57) correspondent respectivement, sous GNU+Linux, à l'alignement horizontal du bouton "Start" et à celui du bouton "Stop". On pourra donc également ajuster ces valeurs si, par exemple, le bouton "Start" empiète sur le texte de l'option "Use low colors".
+Enfin, il est également possible de paramétrer la position et la taille de la liste déroulante située en face de l'option "Get Help", notamment si elle empiète sur l'intitulé de ce bouton ou qu'elle est trop petite. Ceci est géré au niveau de la ligne 331 du fichier qui est par défaut la suivante :
+                   self.hostField = wx.ComboBox(self, 30, "", wx.Point(105, 12), wx.Size(230, -1), list, wx.CB_DROPDOWN)
+Pour régler la position horizontale de la liste en question, il faudra adapter la valeur située juste après le paramètre "wx.Point(", tandis que pour régler sa largeur on ajustera la valeur située juste après le paramètre "wx.Size(".
+Voici par exemple la ligne ainsi modifiée pour un écran de résolution 1680x1050 pixels, suite à l'adaptation des dimensions de la fenêtre déjà indiquée plus haut :
+                   self.hostField = wx.ComboBox(self, 30, "", wx.Point(108, 12), wx.Size(270, -1), list, wx.CB_DROPDOWN)
+===== Désinstallation =====
+Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
 ===== Liens =====
-* [[http://web.archive.org/liveweb/http://fonctionerd.free.fr/index.php?post/2011/08/23/D%C3%A9panner-%C3%A0-distance-avec-Gitso|Dépanner à distance avec Gitso]]\\
+* [[http://fonctionerd.free.fr/index.php?post/2011/08/23/D%C3%A9panner-%C3%A0-distance-avec-Gitso|Dépanner à distance avec Gitso]]\\
 * [[http://code.google.com/p/gitso/|page google code de gitso]]