====== 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.//

===Comment installer UML à la maison ?===

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 :  

  * le script de démarrage : /net/stockage/auesnard/UMLHOME/launch.sh
  * le kernel : /net/stockage/auesnard/UMLHOME/AR/linux
  * le root filesystem : /net/stockage/auesnard/UMLHOME/AR/root_fs.tgz

En remplaçant <mylogin> par votre login au CREMI, tapez :

  $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/auesnard/UMLHOME/launch.sh .
  $ 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 ===

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 : 

  $ 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

Vous pouvez maintenant lancer le script de démarrage comme ceci : 

  $ ./launch.sh tp1.txt tp1.tgz

Les fichier root_fs.tgz et tp1.tgz vont être décompressés dans votre /tmp. Attention : il vous environ 2G d'espace disque ! 

Enjoy :-)

===Documentation===

To start the UML network, type:

  $ launch.sh TP_CONFIG TP_ARCHIVE [ROOT_FS_ARCHIVE LINUX UML_COW_TMP]

with:

   * 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:

  $ cd ${UML_COW_TMP} 
  $ tar cvzSf  tp-saved.tgz *.cow

Then, you can relaunch UML with this archive to continue your work.

__Remarques__

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: 

  $ df -h /dev/shm

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.