VSERVER(8) System Administration VSERVER(8)
NAME
vserver - The vserver utility enables you to manage the state of
vservers, including building, starting, stopping, etc.
SYNTAX
vserver [-s|--sync] [-v|--verbose] [--silent] [--] vserver command
[--help] args*
--sync - Perform synchronization with vshelper to ensure that the guest
has been stopped
--verbose - Makes things a lot louder.
--silent - Removes most informative messages.
vserver - The name of a vserver.
command - One of the commands listed below.
--help
provides additional help for provided command, for example:
vserver - build --help args are the arguments that are possible
for the different commands, see the arguments for each command
listed below
COMMANDS
start [--rescue [--rescue-init] program args]
Starts the specified vserver. The optional argument --rescue
starts the vserver in rescue mode, which runs program args* to
start the vserver instead of whatever is configured. The
optional argument --rescue-init makes the command appear as PID
1 in the vserver. This can be used to start /bin/bash to inves-
tigate why a vserver is not able to start correctly.
stop [--rescue-init]
Stops the specified vserver, and kills the remaining processes.
The optional argument --rescue-init can be used to stop a
vserver that was started with the option of the same name.
restart
Restarts the specified vserver. This is the subsequent execution
of a synchronized ’stop’ and a ’start’.
condrestart
Restarts a running vserver.
suexec user program args*
Executes program args* as the specified user in the vserver.
exec program args*
Executes program args* as the root user in the vserver.
enter
Executes the configured shell (default: /bin/bash if it exists)
in the vserver and allocates a pty.
chkconfig chkconfig-options*
Modifies the init-system; currently, only Red Hat’s chkconfig is
supported.
running
Returns an exit code of 0 iff the vserver is running, 1 if not.
status
Provides some human readable status information about the
vserver, and succeeds iff the vserver is running.
build buildopts*
Create a vserver from scratch, where the buildopts* are a set of
options and a build method. As this option calls vserver-build,
please see vserver-build(8) for a complete listing of possible
options and methods.
delete
Remove a vserver.
unify [-R] [vunify-opts*]
Unify or de-unify the vserver with its reference vserver(s).
pkg install pkg*
Installs package(s) pkg in the vserver.
apt-get,apt-config,apt-cache apt-opts*
Execute the apt-* command for the given vserver
rpm rpm-opts*
Execute the rpm command for the given vserver.
pkgmgmt externalize|internalize [-y]
Externalize or internalize the package-management for the given
vserver. ´Externalize’ means that package metadata and manage-
ment tools (apt-get,rpm) are living in the host, while ’inter-
nalize’ means that data and programs from the vserver will be
used.
hashify
Hashify the vserver.
FILES
/usr/sbin/vserver
/etc/vservers/*
/var/lib/vservers/*
EXAMPLES
Please contribute some, if you feel it’s important.
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-build(8) vserver-stat(8) vtop(8)
util-vserver October 24, 2007 VSERVER(8)
