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 investigate 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
management tools (apt-get,rpm) are living in the host, while 'internalize'
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)