Man pages sections > man8 > vserver-build

vserver-build - initializes a vserver

VSERVER-BUILD(8) System Administration VSERVER-BUILD(8)

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@list.linux-vserver.org

AUTHORS

This man page was written by Micah Anderson <micah@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)
 
October 27, 2007 vserver-build