vserver-build(8)

1VSERVER-BUILD(8)             System Administration            VSERVER-BUILD(8)
2
3
4

NAME

6       vserver-build - initializes a vserver
7

SYNTAX

9       vserver-build  -m  method  -n  name  [--force] [--keep] [--rootdir dir]
10       [--pkgbase dir] config options* [--] method arguments*
11
12       -m method
13              Use build method; see below for possible values.
14
15       -n name
16              Name of vserver you are building.
17
18       --force
19              Remove/rename already existing vservers with the same name.
20
21       --keep Do not delete generated files and directories if  vserver  build
22              fails.
23
24       --rootdir dir
25              Root            vserver            directory           [default:
26              /etc/vservers/.defaults/vdirbase].
27
28       --pkgbase dir
29              Package base directory [default: /vservers/.pkg].
30

CONFIG OPTIONS

32       --context num
33
34              The static context of the vserver [default: none;  one  will  be
35              generated for you].  The valid range is 2 through 49151.
36
37       --confdir dir
38
39              The   vserver   configuration   directory   to   use   [default:
40              /etc/vservers/<name>].
41
42       --lockfile filename
43
44              The lockfile to use [default: /var/run/vservers/<name>].
45
46       --hostname hostname
47
48              Hostname of the vserver.
49
50       --netdev device
51
52              The default interface to use for --interface.
53
54       --netbcast broadcast
55
56              Broadcast address to associate with the vserver.
57
58       --netmask netmask|--netprefix prefixlen
59
60              Sets  the  default  netmask  (a.b.c.d  quadruple)  or  prefixlen
61              (length of the network).
62
63       --interface [name-suffix=][device:]ip[/mask|prefixlen]
64
65              Declares  a  network-interface  name  and associated IP/netmask;
66              this option can be specified multiple times.
67
68       --flags flags+
69
70              Sets comma-separated list of flags; see lib/cflags-v13.c  for  a
71              list.
72
73       --cpuset name
74
75              Declares the CPUSET this vserver will run in [default: none]
76
77       --cpusetcpus number[-number][:exclusive]
78
79              Sets which CPUs belong to the CPUSET, :exclusive is a flag (0|1)
80              prohibiting any other cpuset from using those CPUs.
81
82       --cpusetmems number[-number][:exclusive]
83
84              Sets which memory pools belong to the CPUSET,  :exclusive  is  a
85              flag  (0|1) prohibiting any other cpuset from using those memory
86              pools.
87
88       --cpusetvirt
89
90              Virtualize the cpuset (the vserver will see only CPUs defined in
91              the  cpuset).   Requires  kernel patch from http://www.bullopen‐
92              source.org/cpuset/
93
94       --initstyle style
95
96              Configures the initstyle (e.g. minit, sysv, plain, gentoo)
97

METHODS

99       apt-rpm
100
101               -- -d distribution
102
103              Installs the base-packages of the given  distribution  with  the
104              help of
105
106       yum
107
108              -- -d distribution
109
110              Installs  the  base-packages of the given distribution with help
111              of
112
113       rpm
114
115              -- [-d distribution] --empty|([--force] [--nodeps] manifest)+
116
117              Installs lists of rpm-packages
118
119       skeleton
120
121              -- [cmd args*]
122
123              Installs a minimal skeleton filesystem, creates  the  configura‐
124              tion file and calls an optional command
125
126       debootstrap
127
128              --   -d   distribution  [-m  mirror]  [-s  script]  [--  deboot‐
129              strap-options*]
130
131              Bootstraps the vserver with Debian's 'debootstrap' package
132
133       template
134
135              -- (-t tarball)+ [-d distribution]
136
137              Installs a vserver using tarball(s)
138
139       fai
140
141              -- [-f fai_vserver] [-n nfsroot] [-d fai_dir] [-a]
142
143              Bootstraps the vserver with the Debian Fully Automatic Installa‐
144              tion
145
146              -f means use the nfsroot and profile in the vserver fai_vserver
147
148              -n nfsroot specifies the 'NFS' root explicitly
149
150              -d fai_dir specifies the location of the FAI profile
151
152              the -f option implies -n and -d are relative to the fai_vserver
153
154       rsync
155
156              -- [-d distribution] --source source [-o rsync option]*
157
158              Installs a vserver by rsyncing from source to the guest root
159
160       clone
161
162              -- [-d distribution] --source source
163
164              Clones a vserver by linking unified files and copying the rest
165

EXAMPLES

167       # vserver kea build -m debootstrap --context 10 --hostname kea --inter‐
168       face eth0:192.168.0.44/32 -- -d etch
169

BUGS

171       Please report bugs to vserver@list.linux-vserver.org
172

AUTHORS

174       This man page was written  by  Micah  Anderson  <micah@debian.org>  and
175       based upon the helpful output from the program itself.
176