This is an old revision of the document!
Table of Contents
UML at HOME
HOW TO INSTALL UML AT HOME?
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:
- a linux kernel: linux (default)
- a root filesystem: root_fs.tgz (default)
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/aguermou/UMLHOME/linux . $ scp mylogin@jaguar.emi.u-bordeaux.fr:/net/stockage/aguermou/images/root_fs_AR.tgz 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!