/ 
umlmgr-0.10
River stage zero No dependents
/ umlmgr

NAME

umlmgr - A user mode linux manager

SYNOPSIS

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

DESCRIPTION

umlmgr is a tools to start/stop a set User Mode Linux virtuals machines.

CONFIGURATION

All configurations files are Ini file like.

An ini file is composed of sections, value are setup per section in the form:

var=value

umlmgr

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

env section

Envirronement related values to run everythings

user    the user account vm should be run as

machines section

dir     the directory where vm configuration files are located

network section

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

each vm

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).

Example:

[env]
kernel=/tmp/usr/bin/kernel-uml-2.6.25

[uml]
ubda=/tmp/mdv
con=pts
eth0=daemon

env section

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)

uml

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.

AUTHOR

Olivier Thauvin <nanardon@nanardon.zarb.org>

LICENSE

WTFPL !