File: newvserver.pod

package info (click to toggle)
vserver-debiantools 0.1.10
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 136 kB
  • ctags: 22
  • sloc: sh: 1,348; makefile: 90
file content (88 lines) | stat: -rw-r--r-- 3,013 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
=head1 NAME

newvserver - Creates a new Debian vserver by downloading packages via HTTP/FTP

=head1 SYNOPSIS

newvserver [OPTIONS] --hostname x --domain y.z --ip 1.2.3.4

=head1 DESCRIPTION

=head1 OPTIONS

Optional:
    -h, --help        this help
    -V, --version     copyright and version information
    --arch            set target architecture (eg. --arch "i386")
                      (autodetected on Debian host if dpkg available)
    --copy-vreboot    install "vreboot/vshutdown/vhalt" (default)
    --no-copy-vreboot don't install "vreboot/vshutdown/vhalt"
    --dist            defaults to "woody", passed to debootstrap.
    --fakeinit        use "/sbin/init" to boot vserver
    --conffile        extra configuration file to load.
    --post-install-script
                      script to run after the installation finishes.
    --interface       interface for IP addresses (default "eth0")
    --mirror          Debian HTTP/FTP mirror (including the /debian)
                      Default: http://ftp.uk.debian.org/debian
    --sshkeys         copy pub-keys to "/root/.ssh/authorized_keys"
    -v, --verbose     show extra output during setup
    --vsroot          location of "/vserver/" directory
Required:
    --hostname        hostname for new vserver (eg. "alpha")
    --domain          dns domain for new vserver (eg. "example.com")
    --ip              IPv4 address for new vserver

=head1 CONFIG FILE

The following variables can be set in a configuration file. The configuration
file is a normal shell file and is sourced to get the configuration variables.

The file /etc/vservers/newvserver-vars is always sourced so this configuration
file only override that file.

Packages to install in addition to the base defaults
MUST INCLUDE ALL DEPENDENCIES (seperated by "," commas)

INSTALL_PACKAGES="package1,package2"

Packages installed from within the vserver after it has
been setup (seperated by "," commas)
EXTRA_PACKAGES="package1,package2"

Packages to remove from the base defaults (seperated by "," commas)
REMOVE_PACKAGES="package1,package2"

Sysvinit services relating to hardware access to remove
REMOVE_LINKS="klogd hwclock.sh setserial urandom networking umountfs halt reboot"

Absolute path location of a script that you want to run after the
vserver installation.
POST_INSTALL_SCRIPT=""

Architecture: overide on non-Debian host such as Redhat
otherwise dpkg will detect whether we are i386/powerpc/sparc/etc
ARCH=""

Which debian distribution (Warning. unstable and testing distributions change
frequently so you can not expect it to work out of the box).
DIST="woody"

Local or nearest location of a debian mirror (must include the `/debian')
MIRROR="http://ftp.uk.debian.org/debian"

Default network interface for vservers:
INTERFACE="eth0"

Copy vreboot/vhalt/vshutdown utility into /usr/local/sbin/
COPY_VREBOOT="true"

=head1 AUTHOR

Author of the manual page is Ola Lundqvist <opal@debian.org>

=head1 SEE ALSO

util-vserver(1), dupvserver(1), stripserver(1)

=cut