Man/vz.conf.5

From OpenVZ Virtuozzo Containers Wiki
< Man
Revision as of 01:51, 3 May 2013 by Botinki Kira (talk | contribs) (Automated import of articles *** existing text overwritten ***)
Jump to: navigation, search

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, default is /var/log/vzctl.log.

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). If not set, value of IPTABLES is used.

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.

TEMPLATE=directory

Value of this parameter is a directory in which all container template data are stored.

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="detect"

Controls on which interfaces to add/remove ARP records for a container IP, also which interfaces to use to query/announce ARP. If this is set to detect, the right network interface (the one which is in the same subnet as a CT IP) will be chosen automatically. Any other value restores old (as of vzctl 3.0.19 or older) behavior, when all the possible interfaces were 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 in the subnet. The value of no makes vzctl to only print the warning.

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.

IPTABLES="module module ..."

List of iptables modules to be enabled for containers, corresponds to --iptables option.

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.