Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

ubuntu-vm-builder

NAME

ubuntu-vm-builder - build ubuntu based virtual machines

SYNOPSIS

ubuntu-vm-builder <vm> <suite> [OPTIONS]...

DESCRIPTION

This manual page documents the ubuntu-vm-builder command. ubuntu-vm-builder is a program that builds virtual machines based on Ubuntu.

OPTIONS

NOTE!!! There are many more options than this. See ubuntu-vm-builder --help for more information

--addpkg PKG

Install PKG into the guest (can be specfied multiple times)

-a, --arch ARCH

Specify the target architecture. Valid options: i386 amd64 (amd64 only on amd64 hosts). Defaults to the same as the running system.

-d, --dest

Specify the destination directory. Default: ubuntu-vm-$SUITE-$ARCH

--domain DOMAIN

Set DOMAIN as the domain name of the guest. Default: The domain of the machine running this script.

-h, --help

Self-explanatory.

--hostname NAME

Set NAME as the hostname of the guest. Default: ubuntu

--mem NN

Assign NN megabytes of memory to the guest vm. Default: 128

--mirror URL

Use Ubuntu mirror at URL. Default: http://archive.ubuntu.com/ubuntu

--removepkg PKG

Remove PKG from the guest (can be specfied multiple times)

-s, --suite SUITE

Use the specified Ubuntu suite. Valid options: hardy*, gutsy, feisty, dapper

-t, --tmp TMPDIR

Use TMPDIR as temporary working area for the image generation. Defaults to $TMPDIR if set, or /tmp if not.

--vm VM

Generate image for specified virtualisation software. Valid choices are: vmw6 vmserver vbox qemu kvm*

--user username

Set the name of the user to be added. Default: ubuntu.

--name fullname

Set the full name of the user to be added. Default: Ubuntu.

--pass password

Set the password for the user. Default: ubuntu.

--no-opt

Do not build the /opt partition

--part partfile

Allows to specify a partition table in partfile each line of partfile should specify (root first):

mountpoint size

where size is in megabytes. You can have up to 4 virtual disks, a new disk starts on a line with '---'. ie :

 root 1000
 /opt 1000
 swap 256
 ---
 /var 2000
 /log 1500

The following three options are not used if --part is specified:

--rootsize size
 The size in MB of the root filesystem (default 1000)

--optsize size

The size in MB of the /opt filesystem (default 4000)

--swapsize size

The size in MB of the swap partition (default 1000)

--kernel-flavour

The kernel image flavour to install (default: virtual for versions >= gutsy on i386, server otherwise)

--components

A comma seperaed list of distro components to include (e.g. main,universe). This defaults to "main"

--ssh-key

Add the given ssh public key file (absolute path)to root's authorized keys and install openssh-server (WARNING: this has strong security implications)

--exec script

Run the given script file. You can use 'chroot root <cmd>' to execute code in the guest.

--libvirt <uri>

Add resulting VM to the libvirt hypervisor at uri.

--templates <dir>

Specify where libvirt.tmpl and vmware.tmpl are stored. Uses script directory by default.

--ip address

Ip address in dotted form (defaults to dhcp if not specified)

Options below are discarded if --ip is not specified

--mask value IP mask in dotted form (default: 255.255.255.0)

--net value

IP net address (default: X.X.X.0)

--bcast value

IP broadcast (default: X.X.X.255)

--gw address

Gateway address (default: X.X.X.1)

--dns address

Name server address (default: X.X.X.1)

AUTHOR

ubuntu-vm-builder and this man page was written by Soren Hansen <soren@canonical.com> and is copyright 2007-2008 Canonical Ltd.