• NAME
• SYNOPSIS
• DESCRIPTION
• CONFIGURATION
  • umlmgr
    • env section
    • machines section
    • network section
  • each vm
    • env section
    • uml
• AUTHOR
• LICENSE

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 !