Différences

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

--- kathara:installdecouverte [2020/10/06 15:23] – techer.charles_educ-valadon-limoges.fr
+++ kathara:installdecouverte [2021/09/08 21:50] (Version actuelle) – [Installation pour Debian] techer.charles_educ-valadon-limoges.fr
@@ Ligne 13: / Ligne 13: @@
 Il est nécessaire d’installer l’émulateur de terminal X appelé **xterm**. Le programme xterm est un émulateur de terminal pour X Window utilisé par les programmes qui ne peuvent pas utiliser directement le système de fenêtrage.
 <code shell>
-$ sudo apt-get install xterm
+$ sudo apt install xterm
 </code>
+<WRAP center round info>
+Si vous ne disposez pas d'un environnement de bureau voici les commandes pour le faire avec Gnome :
+<code shell>
+$ sudo apt install task-desktop
+$ sudo apt install gnome-core
+</code>
+</WRAP>
 ==== Installation pour Ubuntu ====
@@ Ligne 28: / Ligne 37: @@
 <code shell>
 $ sudo apt install kathara
+</code>
+==== Installation pour Debian ====
+  * Ajouter la clé publique du dépôt de Kathara
+<code shell>
+$ sudo apt-key adv --keyserver keyserver.ubuntu.com:80 --recv 21805A48E6CBBA6B991ABE76646193862B759810
+</code>
+  * Créer le fichier **kathara.list** dans le dossier **/etc/apt/sources.list.d** et y ajouter les lignes suivantes :
+<code>
+deb http://ppa.launchpad.net/katharaframework/kathara/ubuntu bionic main
+deb-src http://ppa.launchpad.net/katharaframework/kathara/ubuntu bionic main
+</code>
+  * Mettre à jour la liste des paquets disponibles
+<code shell>
+$ sudo apt update
+</code>
+  * Installer Kathara
+<code shell>
+$ sudo apt -y install kathara
 </code>
@@ Ligne 44: / Ligne 72: @@
-Cela va prendre également un peu de temps pour télécharger les images Docker nécessaires…
-  * Vous pouvez ensuite visualiser les deux conteneurs Docker (**alpine** et **kathara/netkit_base**) installés pour le fonctionnement de Kathara :
-<code shell>
-btssio@ubuntudocker:~$ sudo docker images
-REPOSITORY           TAG     IMAGE ID     CREATED       SIZE
-alpine               latest  cdf98d1859c1 3 weeks ago   5.53MB
-kathara/netkit_base  latest  90f86699ac62 3 months ago  824MB
-btssio@ubuntudocker:~$
-</code>
@@ Ligne 70: / Ligne 87: @@
 ^ Commande ^ Action ^
-|vstart|-> pour démarrer une machine
+|kathara vstart|-> pour démarrer une machine
-|vlist|-> donner la liste des VMs actives|
+|kathara list|-> donner la liste des VMs actives|
-|vconfig|-> configurer à la volée une VM comme par exemple affecter une interface à la volée.|
+|kathara vconfig|-> configurer à la volée une VM comme par exemple affecter une interface à la volée.|
-|vclean|-> arrêter une VM et nettoyer les processus, configurations et fichiers temporaires créés|
+|kathara vclean|-> arrêter une VM et nettoyer les processus, configurations et fichiers temporaires créés|
 === Gérer une VM ===
@@ Ligne 81: / Ligne 98: @@
 **Création d’une VM avec vstart**
 <code shell>
-btssio@ubuntudocker:~$ kathara vstart -n sta1 --eth=0:HubDCA --bridged
+btssio@ubuntudocker:~$ kathara vstart -n sta1 --eth 0:HubDCA --bridged
 </code>
 **Explications :**
@@ Ligne 87: / Ligne 104: @@
    * Le nom de la VM **sta1** est le paramètre suivant précédé de -n
    * **--eth** permet de définir le numéro de l’interface réseau **eth0** associée à au domaine de collision **HubDCA** (hub virtuel) ; Un domaine de collision correspond à un **concentrateur** pour Kathara. Il faudra définir manuellement une adresse IP avec ifconfig par exemple.
-   * Le nom de la VM **sta1** est le dernier paramètre
+   * --bridged permet de créer une 2ème interface eth1 qui relie la VM en NAT à l'hôte sur le bridge (pont)  Docker.
-   * --bridged permet de créer une 2ème interface eth1 qui relie la VM en NAT à l'hôte.
 Voici votre première VM Netkit avec la session root automatiquement ouverte :
@@ Ligne 94: / Ligne 110: @@
 {{ :kathara:kathara_02.png |}}
-Pour cette VM sta1, aucune adresse IP n’a été définie. C’est le bridge Docker créé par Kathara qui a fourni la configuration IP 172.20.0.2/16 dans le réseau 172.20.0.0/16. La passerelle est 172.20.0.1/16 et la VM accède à Internet
+Pour cette VM sta1, aucune adresse IP n’a été définie pour eth0. Mais l'adresse IP 172.17.0.2/16 est définie pour **eth1** dans le réseau du bridge Docker. La passerelle est 172.20.0.1/16 (carte virtuelle Docker sur l'hôte) et la VM accède à Internet grâce au NAT défini sur cette interface Docker de l'hôte.
 {{ :kathara:kathara_03.png |}}
-Pour visualiser le bridge créé par Kathara, tapez la commande suivante dans le terminal de votre serveur Debian/Ubuntu :
-<code shell>
-btssio@ubuntudocker:~$ ip a
-: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
-	link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
-	inet 127.0.0.1/8 scope host lo
-   	valid_lft forever preferred_lft forever
-	inet6 ::1/128 scope host
-   	valid_lft forever preferred_lft forever
-: enp0s3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
-	link/ether 08:00:27:af:88:bf brd ff:ff:ff:ff:ff:ff
-	inet 192.168.1.199/24 brd 192.168.1.255 scope global dynamic enp0s3
-   	valid_lft 82586sec preferred_lft 82586sec
-	inet6 fe80::a00:27ff:feaf:88bf/64 scope link
-   	valid_lft forever preferred_lft forever
-: br-8edf20a49895: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc no-queue state DOWN group default
-	link/ether 02:42:64:3d:be:51 brd ff:ff:ff:ff:ff:ff
-	inet 172.20.0.1/16 brd 172.20.255.255 scope global br-8edf20a49895
-   	valid_lft forever preferred_lft forever
-: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN group default
-	link/ether 02:42:1d:98:0e:31 brd ff:ff:ff:ff:ff:ff
-	inet 172.17.0.1/16 brd 172.17.255.255 scope global docker0
-   	valid_lft forever preferred_lft forever
-btssio@ubuntudocker:~$
-</code>
-<WRAP center round info>
-**INFORMATION**\\
-Le sous-réseau 172.0.0.0/8 est réservé pour l’utilisation de Kathara. Il ne faut donc pas l’utiliser pour définir des plans d’adressage de vos sous-réseaux. Lors de la création de VMs autonomes ou dans des labs comme vous le verrez ensuite, Kathara va créer autant de bridges que vous définissez de domaine de collision en leur associant un sous-réseau différent basé sur ce sous-réseau 172.0.0.0/8. Le premier de ces sous-réseaux est 172.19.0.0/16, le dernier est 172.255.0.0/16.
-</WRAP>
+**Visualisation de la VM créée avec list**
+<code shell>
+btssio@ubuntudocker:~$ kathara list
+TIMESTAMP: 2020-11-01 15:10:35.932897
-**Visualisation de la VM créée avec vlist**
+╔════════════════════════╦════════╦══════════════╦═════════╦═══════╦═══════════════════╦═══════╦═══════════════╗
-<code shell>
+║ LAB HASH               ║ USER   ║ MACHINE NAME ║ STATUS  ║ CPU % ║ MEM USAGE / LIMIT ║ MEM % ║ NET I/O       ║
-btssio@ubuntudocker:~$ vlist
+╠════════════════════════╬════════╬══════════════╬═════════╬═══════╬═══════════════════╬═══════╬═══════════════╣
-CONTAINER ID NAME             CPU % MEM USAGE / LIMIT MEM %  NET I/O BLOCK I/O PIDS
+║ BquVk2860DTFrej8slHuVg ║ btssio ║ sta1         ║ running ║ 0.00% ║ 2.37 MB / 1.95 GB ║ 0.12% ║ 9.94 KB / 0 B ║
-ceba73bfb3f netkit_1000_sta1	0.00%  2.16MiB/1.419GiB  0.15%  6.58kB/0B  12.2MB/0B 2
+╚════════════════════════╩════════╩══════════════╩═════════╩═══════╩═══════════════════╩═══════╩═══════════════╝
-NETWORK ID      	NAME            	DRIVER          	SCOPE
+btssio@ubuntudocker:~$
-f332c80a9dbd    	bridge          	bridge          	local
-c28efeb7848e    	host            	host            	local
-cae4fa72    	netkit_1000_H   	bridge          	local
-e85954    	none            	null            	local
-btssio@ubuntudocker:~$
 </code>
 Vous pouvez visualiser :
-  * Les caractéristiques de la VM **sta1** : son **ID Docker 8ceba73bfb3f** ainsi que les ressources consommées ;
+  * Les caractéristiques de la VM **sta1** : son **LAB HASH BquVk2860DTFrej8slHuVg** ainsi que les ressources consommées ;
-  * La liste des interface réseaux du serveur Debian/Ubuntu qui montre le bridge **netkit_1000_H** créé par Kathara et qui est associé au domaine de collision **HubDCA**.
-Le commande Docker montre le conteneur **8ceba73bfb3f** qui correspond à **sta1** et l’image **kathara/netkit_base**  qui a été utilisée.
+La commande Docker montre le conteneur **kathara_btssio_sta1_BquVk2860DTFrej8slHuVg** qui correspond à **sta1** et l’image **kathara/quagga**  qui a été utilisée.
 <code shell>
-btssio@ubuntudocker:~$ docker ps -a
+btssio@ubuntudocker:~$ docker ps
-CONTAINER ID  IMAGE                COMMAND     CREATED  STATUS PORTS NAMES
+CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
-ceba73bfb3f kathara/netkit_base  "/bin/bash" 3 m…  Up 3 m…         netkit_1000_sta1
+c0e2f9e0e068        kathara/quagga      "bash"              8 minutes ago       Up 8 minutes                            kathara_btssio_sta1_BquVk2860DTFrej8slHuVg
-…
+btssio@ubuntudocker:~$
 </code>
-Cette autre commande permet également de visualiser le container Docker créé et vous pouvez le visualiser avec la commande suivante :
-<code shell>
-btssio@ubuntudocker:~$ docker container ls
-CONTAINER ID IMAGE               COMMAND     CREATED STATUS  PORTS  NAMES
-ceba73bfb3f kathara/netkit_base "/bin/bash" 4 m…    Up 4 m…        netkit_1000_sta1
-btssio@ubuntudocker:~$
-</code>
-Pour arrêter la VM avec une commande Kathara ; le container est alors supprimé :
-<WRAP center round info>
-**INFORMATION**\\
-La commande **vconfig** semble actuellement ne pas fonctionner convenablement
-</WRAP>
 **Arrêter une VM avec vclean**
@@ Ligne 173: / Ligne 143: @@
 <code shell>
 btssio@ubuntudocker:~$ kathara vclean -n sta1
-Any network still in use by another machine will not be deleted (and will raise an error instead)
+Deleting machines... |################################| 1/1
-Containers will be deleted
+Deleting links... |################################| 1/1
-netkit_1000_sta1
+INFO - Machine `sta1` deleted successfully!
-netkit_1000_H
-btssio@ubuntudocker:~$ docker container ls
-CONTAINER ID    	IMAGE           	COMMAND         	CREATED         	STATUS          	PORTS           	NAMES
 btssio@ubuntudocker:~$
 </code>
@@ Ligne 202: / Ligne 169: @@
 ^ Commande ^ Action ^
-|lstart|-> pour lancer un lab.|
+|kathara lstart|-> pour lancer un lab.|
-|lclean|-> arrêter les VMs et nettoyer les processus, configurations et fi-chiers temporaires créés|
+|kathara lclean|-> arrêter les VMs et nettoyer les processus, configurations et fi-chiers temporaires créés|
-|linfo|-> information sur le laboratoire.|
+|kathara linfo|-> information sur le laboratoire.|
-|ltest|-> vérification du bon fonctionnement du laboratoire.|
+|kathara ltest|-> vérification du bon fonctionnement du laboratoire.|
-|lwipe|-> arrêter les VMs des labs de Kathara et arrêter une VM et nettoyer les processus, configurations et fichiers temporaires créés.|
+|kathara wipe|-> arrêter les VMs des labs de Kathara et arrêter une VM et nettoyer les processus, configurations et fichiers temporaires créés.|
@@ Ligne 263: / Ligne 230: @@
 btssio@ubuntudocker:~$ docker commit kathara_btssio kathara/netkit_btssio
 </code>
+<WRAP center round info>
+A ne pas faire car changement dans l'utilisation du logiciel Kathara -> mise à jour à faire
   * **Utiliser** la nouvelle image pour tous les conteneurs Kathara:
@@ Ligne 270: / Ligne 240: @@
 btssio@ubuntudocker:~$ nano /opt/Kathara/bin/python/netkit_commons.py
 </code>
+</WRAP>
   * **Utiliser** la nouvelle image pour une seule VM d’un lab :
 Il suffit d’indiquer dans le fichier lab.conf un paramètre supplémentaire précisant l’image à utiliser :
@@ Ligne 280: / Ligne 250: @@
   * L’image de base **kathara/netkit_base**,
   * Et une image personnalisée **kathara/netkit_btssio**.
-===== ne plus utiliser=====
-  * **Téléchargez** les fichiers de Kathara et l’interface graphique GUI dans le dossier **/opt** :
-<code shell>
-$ cd /opt
-$ sudo git clone --recursive https://github.com/KatharaFramework/Kathara.git
-</code>
-  * **Exportez** les **variables d’environnement** :
-<code shell>
-btssio@ubuntudocker:~$ export NETKIT_HOME=/opt/Kathara/bin
-btssio@ubuntudocker:~$ export PATH=$PATH:$NETKIT_HOME
-</code>
-<WRAP center round important >
-**ATTENTION** \\
-Le dossier **/opt/Kathara** s’écrit avec un **K majuscule** !
-</WRAP>
-Vous devrez réaliser cela à chaque fois que vous lancerez la VM Ubuntu ou que vous ouvrirez une nouvelle ses-sion avec le compte BTSSIO. Pour éviter cela, ajouter ces deux lignes à la fin du fichier **.bashrc** qui est dans votre répertoire /home/btssio/. Puis fermez et réouvrez votre session.
-<code shell>
-btssio@ubuntudocker:~$ nano .bashrc
-</code>
-  * **Ajoutez** les variables d’environnement :
-<code shell>
-…
-export NETKIT_HOME=/opt/Kathara/bin
-export PATH=$PATH:$NETKIT_HOME
-</code>
-  * **Fermer** puis **ouvrez à nouveau ** votre session BTSSIO :
-  * **Lancez** l’installation de Kathara :
-<code shell>
-btssio@ubuntudocker:~$ $NETKIT_HOME/install
-</code>
-====== Retour Accueil SISR3 ======
+====== Retour Accueil Kathara ======
-  * [[sisr3:accueil|SISR3]]
+  * [[kathara:accueil|Kathara]]