vz.conf5
Global openvz configuration file
Usage
/etc/vz/vz.conf
Overview
This is the global configuration file for OpenVZ. It consists of lines in the form
PARAMETER="value"
All parameter names and values are case-sensitive. Quotes surrounding value are required if value contains spaces, and are optional otherwise. Extra spaces are not allowed. All unrecognized lines will be ignored.
Global parameters
- VIRTUOZZO=
yes|no -
This parameter can be set to
yesorno, and used by thevzinit script. In case it is not set toyes, nothing will be done to boot up OpenVZ on this node.
- LOCKDIR=directory
-
Set the directory to put lock files to.
VE0CPUUNITS=number-
Value of this parameter sets
cpuunitsfor CT0 (host system).
- LOGGING=
yes|no -
Enables or disables logging. This parameter can be set to
yesorno, default isyes.
- LOGFILE=file
-
Set location of log file.
LOG_LEVEL=number-
Set the logging level for the log file (does not affect console output). The greater the number is, the more information will be logged to the LOGFILE. Default is
0, which means to log normal messages and errors. If set to-1, only errors will be logged.
- VERBOSE=number
-
Set the logging level for console/terminal output (does not affect log file). Default is
0, which means to log normal messages and errors. Increasing thenumbermakes vzctl(8) more verbose.
MODULES_DISABLED=yes|no-
If the value of this parameter is set to
yes, no attempt to load kernel modules is made by thevzinitscript. This is helpful on systems which have OpenVZ-specific features compiled into the kernel (i. e. not as modules).
IPTABLES_MODULES="module module ..."-
List of iptables kernel modules to be loaded by
vzinitscript before loading OpenVZ modules (which is required for iptables to work inside containers).
- VZFASTBOOT=
yes|no -
If the value of this parameter is set to
yes,vzinitscript called withstartargument will start the containers with uncleanly shutdown quota state without performing quota reinitialization (which is usually a time-consuming process). After all the containers are started, the initscript when restarts those containers with unclean quota in a normal way (to recalculate/fix quotas).
VE_STOP_MODE=suspend|stop-
If the value of this parameter is set to
suspendor not set at all,vzinitscript called withstopargument will try to suspend the running containers, instead of stopping them. Suspended containers when will be restored on vz start. This feature usually helps to decrease the reboot time. If a container fails to suspend, it will be stopped anyway.
VE_PARALLEL=number-
A number of containers to be started or stopped simultaneously on node startup or shutdown. If not specified, the number is calculated based on amount of CPU cores. Used by the
vzinitscript.
- TEMPLATE=directory
-
Value of this parameter is a directory in which all container template data are stored.
SKIP_SYSCTL_SETUP=yes-
If this parameter is not present, init.d/vz start sets some sysctl.conf(5) parameters required or recommended by OpenVZ (with the help of vz-postinstall sysctl script), and then adds this parameter to
vz.conf.
Network interface parameters
VE_ROUTE_SRC_DEV="device"-
This parameter specifies the network device name which IP address will be used as the source IP. This is helpful in case more than one network interface is configured on HN and there is a need to specify the source IP address. Default is the first device in the network device list.
NEIGHBOUR_DEVS="all|detect|list:dev1 [dev2 ...]"-
Controls on which interfaces to add/remove ARP records for a container IP, also which interfaces to use to query/announce ARP.
If set to
all, an empty string, or unset, all possible network interfaces (i.e. the ones that are UP and doesn't have NOARP, SLAVE, or LOOPBACK flags) are used. This is the default mode.If set to
detect, the right network interface (i.e. the one which is in the same subnet as a container IP) will be chosen automatically.If the value starts with
list:prefix, the space-separated list of interfaces following the prefix is used.
ERROR_ON_ARPFAIL=yes|no-
In case the value of this parameter is set to
yes, vzctl will fail to start a container if there is another host with the same IP present in the network. Any other value makes vzctl to only print the warning (which is the default behavior).
SKIP_ARPDETECT=yes|no-
In case the value of this parameter is set to
yes, vzctl will not use ARP queries when starting a container in order to detect if there is another host with the same IP present in the network. Note that for each IP, vzctl sends ARP query and waits up to 1 second for response. Any other value means to do ARP detection.
FORCE_ROUTE=yes|no-
In case the value of this parameter is set to
yes, vzctl will attempt to change an existing route to point to a container when starting a container if new route setup fails. Any other value means to only attempt to add new routes (default behavior).
Defaults for vzctl create
These parameters are defaults for vzctl create and can be overwritten by its appropriate command line options.
DEF_OSTEMPLATE=name-
Default OS template to create a container from. Corresponds to
--ostemplateoption of vzctl create.
- CONFIGFILE=name
-
Default configuration file (
/etc/vz/conf/ve-name.conf-sample) used to create a new container. Corresponds to--configoption of vzctl create.
VE_LAYOUT=simfs|ploop[:{plain|expanded|raw}]-
Default CT filesystem layout for a new container, can either be
plooporsimfs. In caseploopis used, one can additionally specify ploop disk image format after a colon. Possible ploop formats areexpanded,plainandraw. Default isexpanded. Usingrawis not recommended and is not supported.Corresponds to
--layoutoption of vzctl create.
Defaults for containers
Below parameters are defaults for containers, and can be overwritten by parameters in ctid.conf(5) per-container configuration file.
DISK_QUOTA=yes|no-
In case the value of this parameter is set to
no, all disk quota operations are disabled.
VE_ROOT=directory-
Value of this parameter is the directory which serves as container root mount point. Value must contain literal string $VEID, which will be substituted with the actual numeric CT ID.
VE_PRIVATE=directory-
Value of this parameter is the directory in which all the files and directories specific to that container are stored. Value must contain literal string $VEID, which will be substituted with the actual numeric CT ID.
STOP_TIMEOUT="number"-
Time to wait for a container to shut down on vzctl stop, before forcibly killing it, in seconds. Hardcoded to 120 if not set.
- NAMESERVER="ip [ip ...]"
-
Default value for containers nameserver(s). Several name server addresses are divided by spaces. If set to
inherit, values from host system's/etc/resolv.confare used.
- SEARCHDOMAIN="domain [domain ...]"
-
Default value for containers search domains. Several search domains are divided by spaces. If set to
inherit, values from host system's/etc/resolv.confare used.
Most of the other parameters that appear in per-container configuration files ctid.conf(5) can be also set here. Still, it is recommended to keep TEMPLATE, VE_PRIVATE and VE_ROOT in this configuration file, and all the other container related parameters in per-container configuration files.
Releases
7 releases since Debian 4.0 (Etch); the text changed 5 times.