SYNTAX

vserver-build -m method -n name [--force] [--keep] [--rootdir dir] [--pkgbase dir] config options* [--] method arguments*

-m method

Use build method; see below for possible values.

-n name

Name of vserver you are building.

--force

Remove/rename already existing vservers with the same name.

--keep

Do not delete generated files and directories if vserver build fails.

--rootdir dir

Root vserver directory [default: /etc/vservers/.defaults/vdirbase].

--pkgbase dir

Package base directory [default: /var/lib/vservers/.pkg].

CONFIG OPTIONS

--context num

  • The static context of the vserver [default: none; one will be generated for you]. The valid range is 2 through 49151.

--confdir dir

  • The vserver configuration directory to use [default: /etc/vservers/<name>].

--lockfile filename

  • The lockfile to use [default: /var/run/vservers/<name>].

--hostname hostname

  • Hostname of the vserver.

--netdev device

  • The default interface to use for --interface.

--netbcast broadcast

  • Broadcast address to associate with the vserver.

--netmask netmask|--netprefix prefixlen

  • Sets the default netmask (a.b.c.d quadruple) or prefixlen (length of the network).

--interface [name-suffix=][device:]ip[/mask|prefixlen]

  • Declares a network-interface name and associated IP/netmask; this option can be specified multiple times.

--flags flags+

  • Sets comma-separated list of flags; see lib/cflags-v13.c for a list.

--cpuset name

  • Declares the CPUSET this vserver will run in [default: none]

--cpusetcpus number[-number][:exclusive]

  • Sets which CPUs belong to the CPUSET, :exclusive is a flag (0|1) prohibiting any other cpuset from using those CPUs.

--cpusetmems number[-number][:exclusive]

  • Sets which memory pools belong to the CPUSET, :exclusive is a flag (0|1) prohibiting any other cpuset from using those memory pools.

--cpusetvirt

  • Virtualize the cpuset (the vserver will see only CPUs defined in the cpuset). Requires kernel patch from http://www.bullopensource.org/cpuset/

--initstyle style

  • Configures the initstyle (e.g. minit, sysv, plain, gentoo)

METHODS

apt-rpm

  • -- -d distribution

    Installs the base-packages of the given distribution with the help of vapt-get

yum

  • -- -d distribution

    Installs the base-packages of the given distribution with help of vyum

rpm

  • -- [-d distribution] --empty|([--force] [--nodeps] manifest)+

    Installs lists of rpm-packages

skeleton

  • -- [cmd args*]

    Installs a minimal skeleton filesystem, creates the configuration file and calls an optional command

debootstrap

  • -- -d distribution [-m mirror] [-s script] [-- debootstrap-options*]

    Bootstraps the vserver with Debian's 'debootstrap' package

template

  • -- (-t tarball)+ [-d distribution]

    Installs a vserver using tarball(s)

fai

  • -- [-f fai_vserver] [-n nfsroot] [-d fai_dir] [-a]

    Bootstraps the vserver with the Debian Fully Automatic Installation

    -f means use the nfsroot and profile in the vserver fai_vserver

    -n nfsroot specifies the 'NFS' root explicitly

    -d fai_dir specifies the location of the FAI profile

    the -f option implies -n and -d are relative to the fai_vserver

rsync

  • -- [-d distribution] --source source [-o rsync option]*

    Installs a vserver by rsyncing from source to the guest root

clone

  • -- [-d distribution] --source source

    Clones a vserver by linking unified files and copying the rest

EXAMPLES

# vserver kea build -m debootstrap --context 10 --hostname kea --interface eth0:192.168.0.44/32 -- -d etch

BUGS

Please report bugs to [email protected]

AUTHORS

This man page was written by Micah Anderson <[email protected]> and based upon the helpful output from the program itself.

RELATED TO vserver-build…