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)