You need to install the package 'uml-utilities' (required by UML). 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:

1. a linux kernel: linux (default)
2. a root filesystem: root_fs.tgz (default)

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 .

To start the UML network, type:

$ launch.sh TP_CONFIG TP_ARCHIVE [ROOT_FS_ARCHIVE LINUX UML_COW_TMP]

with:

* Mandatory arguments.

1. TP_CONFIG: config file (ex. demo.txt)
2. TP_ARCHIVE: archive file with COWS (ex. demo.tgz)

* Optional arguments.

1. LINUX: a linux kernel (default, linux)
2. ROOT_FS_ARCHIVE: a root filesystem (default, root_fs.tgz)
3. UML_COW_TMP: a temporary directory (default, /tmp/UML)

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

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.

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!