umlmgr - A user mode linux manager
umlmgr <command> umlmgr --help
Availlable commandes:
list list vm configuration startnet start network related things start start all onboot vitual machine stop stop all running virtual machine boot start listed virtual machine status list running machines
umlmgr is a tools to start/stop a set User Mode Linux virtuals machines.
All configurations files are Ini file like.
An ini file is composed of sections, value are setup per section in the form:
var=value
As root, the configuration default configuration file is /etc/umlmgr.cfg. As a standard user it is $HOME/.umlmgr/config. This file is not mandatory as normal user, espcially since most of settings need root privilege to be achieve (network related things on the host).
The default location for vm configs is $HOME/.umlmgr.
Example:
[env] user=vmuser [machines] dir=/vm [network] tap=tap0 addr=192.168.0.254 # switch=yes hub=yes
Envirronement related values to run everythings
user the user account vm should be run as
dir the directory where vm configuration files are located
tap the tap device to setup addr the ip address to setup switch if set, will start uml_switch, using tap device if set hub make uml_switch acting as a hub
Virtual machines files should be name in from ID.uml. The first part of the file name is used as uml identifier (used by uml_mconsole).
[env] kernel=/tmp/usr/bin/kernel-uml-2.6.25 [uml] ubda=/tmp/mdv con=pts eth0=daemon
kernel the excutable name to use as kernel onboot if set, the machine is started by 'start' function (otherwise should be start explicitly with 'boot' function)
Each value in this will be passed as argument to the kernel.
Umlmgr will automatically add as argument:
con0=fd:0,fd:1 con=pts
The first force log output to go to STDIN/STDERR, umlmgr fetch the output and push it to syslog.
The second one will bind all console to /dev/pts device. This setup make hard to wonder which device has to be used to access to vm console. umlmgr come with umltty tools to find it.
Olivier Thauvin <nanardon@nanardon.zarb.org>
WTFPL !
To install Umlmgr, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Umlmgr
CPAN shell
perl -MCPAN -e shell install Umlmgr
For more information on module installation, please visit the detailed CPAN module installation guide.