Manpages

NAME

vserver-build − initializes a vserver

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 vserver [AT] list.linux−vserver.org

AUTHORS

This man page was written by Micah Anderson <micah [AT] debian.org> and based upon the helpful output from the program itself.

SEE ALSO

chbind(8) chcontext(8)
rebootmgr(8) reducecap(8)
vps(8) vpstree(8)
vrpm(8)
vserver−stat(8)
vtop(8)