Differences

This shows you the differences between two versions of the page.

--- admin:uml [2014/01/30 15:47] – created orel
+++ admin:uml [2024/03/18 15:06] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== UML at HOME ======
-====HOW TO INSTALL UML AT HOME?====
+//Tutoriel valide à la fois pour Administration des Réseaux (AR) et Sécurité des Réseaux (SR). Veillez à remplacer AR ou SR selon le cas.//
-You need to install the package 'uml-utilities' (required by UML).
+===Comment installer UML à la maison ?===
-You can check you have already installed it, if you find the file
-'/usr/lib/uml/port-helper' and '/usr/bin/uml_switch' on your computer.
-Before, to launch the UML script at home, you need extra stuffs:
+Vous devez tout d'abord installer le package Debian 'uml-utilities'. Vérifiez que vous disposez maintenant des commandes '/usr/lib/uml/port-helper' et '/usr/bin/uml_switch' sur votre ordinateur. Vous devez ensuite récupérer les fichiers suivant au CREMI :
-   - a linux kernel: linux                    (default)
+  * le script de démarrage : /net/stockage/auesnard/UMLHOME/launch.sh
-   - a root filesystem: root_fs.tgz           (default)
+  * le kernel : /net/stockage/auesnard/UMLHOME/AR/linux
+  * le root filesystem : /net/stockage/auesnard/UMLHOME/AR/root_fs.tgz
-====DOWNLOAD====
+En remplaçant <mylogin> par votre login au CREMI, tapez :
-First, you have to download several files from the CREMI via SSH with
+  $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/auesnard/UMLHOME/launch.sh .
-your own account.
+  $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/auesnard/UMLHOME/AR/linux .
+  $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/auesnard/UMLHOME/AR/root_fs.tgz .
+  $ chmod +x launch.sh
+Attention, le fichier 'root_fs.tgz' fait environ 1Go ! Il faut une bonne connexion réseau ou une clé USB ;-)
+===Démarrons le TP1 ===
-  $ wget "http://www.labri.fr/perso/esnard/Teaching/UML/AR/launch.sh"
+Placez vous dans le répertoire où se trouve les trois fichiers précédents (launch.sh, root_fs.tgz et linux), puis récupérez les fichiers du TP1 (archive_tp1.tgz et config) que vous renommez en tp1.tgz et tp1.txt :
-  $ chmod +x launch.sh
-  $ scp mylogin@jaguar.emi.u-bordeaux.fr:/net/stockage/aguermou/uml/linux-3.0.0-nfs linux
-  $ scp mylogin@jaguar.emi.u-bordeaux.fr:/net/stockage/aguermou/images/root_fs_AR.tgz root_fs.tgz
-====SYNOPSIS====
+  $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/aguermou/AR/images/archive_tp1.tgz tp1.tgz
+  $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/aguermou/AR/TP/1/config tp1.txt
-To start the UML network, type:
+Vous pouvez maintenant lancer le script de démarrage comme ceci :
-  $ launch.sh TP_CONFIG TP_ARCHIVE [ROOT_FS_ARCHIVE LINUX UML_COW_TMP]
+  $ ./launch.sh tp1.txt tp1.tgz
-with:
+Les fichier root_fs.tgz et tp1.tgz vont être décompressés dans votre /tmp. Attention : il vous environ 2G d'espace disque !
- * Mandatory arguments.
+Enjoy :-)
-   - TP_CONFIG: config file (ex. demo.txt)
-   - TP_ARCHIVE: archive file with COWS (ex. demo.tgz)
- * Optional arguments.
+===Documentation===
-   - LINUX: a linux kernel (default, linux)
-   - ROOT_FS_ARCHIVE: a root filesystem  (default, root_fs.tgz)
-   - UML_COW_TMP: a temporary directory (default, /tmp/UML)
-====EXAMPLE====
+To start the UML network, type:
-In the same directory where you have previously download files
+  $ launch.sh TP_CONFIG TP_ARCHIVE [ROOT_FS_ARCHIVE LINUX UML_COW_TMP]
-(launch.sh, root_fs.tgz and linux), you can start any TP like
-that:
-  $ scp mylogin@jaguar.emi.u-bordeaux.fr:/net/stockage/aguermou/AR/images/archive_tp1.tgz tp1.tgz
+with:
-  $ scp mylogin@jaguar.emi.u-bordeaux.fr:/net/stockage/aguermou/AR/TP/1/config tp1.txt
-  $ ./launch.sh tp1.txt tp1.tgz
-====SAVE YOUR WORK====
+   * TP_CONFIG: config file (ex. demo.txt)
+   * TP_ARCHIVE: archive file with COWS (ex. demo.tgz)
+   * LINUX: a linux kernel (default, linux) [optional]
+   * ROOT_FS_ARCHIVE: a root filesystem  (default, root_fs.tgz) [optional]
+   * UML_COW_TMP: a temporary directory (default, /tmp/UML) [optional]
+__Sauvegarde__
 If you have properly halted UMLs, you can save your works like this:
@@ Line 58: / Line 59: @@
 Then, you can relaunch UML with this archive to continue your work.
-====WARNING====
+__Remarques__
-Each UML host requires about 100MB of shared memory (/dev/shm) in your
+UML host requires about 100MB of shared memory (/dev/shm) in your Linux. The amount of memory required by each UML id defined by the the UML_MEM variable of the launch.sh script. One can check the available shared memory of your host with the following command:
-Linux. The amount of memory required by each UML id defined by the the
-UML_MEM variable of the launch.sh script. One can check the available
-shared memory of your host with the following command:
   $ df -h /dev/shm
-This size must be greater than the amount of memory required for all
+This size must be greater than the amount of memory required for all UMLs. For instance, if you have 4 UMLs with UML_MEM fixed at 100M. You need 400M in /dev/shm.
-UMLs. For instance, if you have 4 UMLs with UML_MEM fixed at 100M. You
-need 400M in /dev/shm.
-Enjoy!