Man/vz.conf.5

Contents

NAME

vz.conf − global OpenVZ configuration file

SYNOPSIS

/etc/vz/vz.conf

DESCRIPTION

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 yes or no, and used by the vz init script. In case it is not set to yes, 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 cpuunits for CT0 (host system).

LOGGING=yes|no

Enables or disables logging. This parameter can be set to yes or no, default is yes.

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 the number makes 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 the vz initscript. 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 vz initscript 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, vz initscript called with start argument 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 suspend or not set at all, vz initscript called with stop argument 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 vz initscript.

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.

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 --ostemplate option of vzctl create.

CONFIGFILE=name

Default configuration file (/etc/vz/conf/ve-name.conf-sample) used to create a new container. Corresponds to --config option of vzctl create.

VE_LAYOUT=simfs|ploop[:{plain|expanded|raw}]

Default CT filesystem layout for a new container, can either be ploop or simfs. In case ploop is used, one can additionally specify ploop disk image format after a colon. Possible ploop formats are expanded, plain and raw. Default is expanded. Using raw is not recommended and is not supported.

Corresponds to --layout option 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.conf are 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.conf are 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.

SEE ALSO

vzctl(8), ctid.conf(5).

LICENSE

Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL.