This is an old revision of the document!
Table of Contents
UML at HOME
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/linux
- le root filesystem : /net/stockage/auesnard/UMLHOME/root_fs.tgz
DOWNLOAD
First, you have to download several files from the CREMI via SSH with your own account.
$ mkdir UML ; cd UML $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/auesnard/UMLHOME/launch.sh . $ chmod +x launch.sh $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/auesnard/UMLHOME/linux . $ scp <mylogin>@jaguar.emi.u-bordeaux.fr:/net/stockage/auesnard/UMLHOME/root_fs.tgz .
SYNOPSIS
To start the UML network, type:
$ launch.sh TP_CONFIG TP_ARCHIVE [ROOT_FS_ARCHIVE LINUX UML_COW_TMP]
with:
* Mandatory arguments.
- TP_CONFIG: config file (ex. demo.txt)
- TP_ARCHIVE: archive file with COWS (ex. demo.tgz)
* Optional arguments.
- 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
In the same directory where you have previously download files (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 $ 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
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.
WARNING
Each 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.
Enjoy!