Previous page

Next page

Locate page in Contents

Print this page

Global Parallels Cloud Server Configuration File

Parallels Cloud Server keeps its system wide configuration parameters in the /etc/vz/vz.conf configuration file. This file is in shell format. Keep in mind that Parallels Cloud Server scripts source this file – thus, shell commands in this file will cause system to execute them under root account. Parameters in this file are presented in the form PARAMETER=”value” . Logically all the parameters belong to the following groups: global parameters, logging, disk quotas, template, network traffic, Containers, validation and overcommitment, supplementary parameters, and name-based hosting parameters. Below is the description of all the parameters defined in this version of Parallels Cloud Server.

Name

Description

Default value

VIRTUOZZO

This can be either “yes” or “no”. Parallels Cloud Server System V startup script checks this parameter. If set to “no”, then Parallels Cloud Server modules are not loaded. You might set it to “no” if you want to perform system maintenance and do not want to bring up all Containers on the server.

yes

HTTP_PROXY

Specifies either the hostname or the IP address of the HTTP proxy server. After setting this parameter and in case you use an HTTP proxy server for handling all HTTP requests, the Parallels Cloud Server utilities communicating with the outer world through HTTP will use this server for managing all your HTTP messages.

-

ACTIONLOGDIR

This is the directory where prlctl keeps a log of its actions in the format suitable for Parallels Cloud Server statistics daemon hwcoll .

/vz/actionlog

LOCKDIR

Actions on a Container should be serialized, since two simultaneous operations on the same Container may break its consistency. Parallels Cloud Server keeps lock files in this directory in order to serialize access to one Container.

/vz/lock

REMOVEMIGRATED

Specifies whether the private area and the configuration file of the Container moved to a new server with the pmigrate command should be destroyed on the Source Server (the value of the parameter is set to yes ) or renamed to have the .migrated suffix (the value of the parameter is set to no ). You may wish to leave the Container private area and the configuration file to make migration faster. This configuration value can be overridden by the pmigrate command-line options.

no

VE0CPUUNITS

CPU weight designated for the server itself.

1000

OFFLINE_MANAGEMENT

Specifies whether Containers can be managed by the Container administrator by means of the services indicated in the OFFLINE_SERVICE parameter.

yes

OFFLINE_SERVICE

These services correspond to the names of the files in the /etc/vzredirect.d directory, each file defining at what port the service will be accessible and to what Container the requests coming to this port will be redirected. These services will be accessible to those Containers which have the OFFLINE_MANAGEMENT parameter set to " yes ".

vzpp-plesk vzpp

BURST_CPU_AVG_USAGE

The CPU usage limit, in percent, set for the Container. This limit is calculated as the ratio of the current Container CPU usage to the CPU limit (i.e to the value of the CPULIMIT parameter) set for the Container in its configuration file. If the limit is not specified, the full CPU power of the server is considered as the CPU limit. Upon exceeding the BURST_CPU_AVG_USAGE limit, the BURST_CPULIMIT limit is applied to the given Container.

This parameter can be redefined by the BURST_CPU_AVG_USAGE parameter set in the Container configuration file.

disabled

BURST_CPULIMIT

The CPU power limit, in percent, the Container cannot exceed. The limitations set in this parameter are applied to any Container exceeding the limit specified in the BURST_CPU_AVG_USAGE parameter.

This parameter can be redefined by the BURST_CPULIMIT parameter set in the Container configuration file.

VEFSTYPE

File system to use when caching OS templates:

  • ext4 : Use to create Containers with the new layout.
  • vz4 : Use to create legacy Containers.

ext4

VZMOUNTS

Defines the partitions which will be automatically mounted by the /etc/init.d/vz script after the server boot. This script will check (by calling the fsck utility) and mount all the partitions specified as the value of this parameter, listed in /etc/fstab file on the server, and having the noauto flag set for them in this file.

/vz

IPV6

Defines whether the IPv6 support is enabled on the Parallels server.

yes

GOLDEN_IMAGE

Enables ( yes ) or disables ( no ) embedding application templates into OS EZ template cache prior to creating Containers based on this cache.

yes

PFCACHE

Path to the memory and IOPS deduplication cache with common Container files.

/vz/pfcache

PFCACHE_IMAGE

Path to the private area of the memory and IOPS deduplication cache.

/vz/pfcache.hdd

PFCACHE_IMAGE_SIZE

Image size (in 1-KB blocks) of the memory and IOPS deduplication cache.

10485760

PFCACHE_INCLUDES

Directories for which memory and IOPS deduplication is enabled by default.

bin lib lib64 opt sbin usr

VZ_TOOLS_MEMLIMIT

Limits the total memory consumption of all vz utilities, e.g., vzbackup , vzmigrate , etc. Set in bytes.

Logging parameters

Name

Description

Default value

LOGGING

This parameter defines whether prlctl should log its actions.

yes

LOGFILE

File where prlctl logs its actions.

/var/log/vzctl.log

LOG_LEVEL

There are three levels of logging defined in the current version of Parallels Cloud Server.

0

Possible values of the LOG_LEVEL parameter

Log level

Information to be logged

0

Actions of prlctl on Containers like start , stop , create , destroy , mount , umount .

1

Level 1 logs events, calls to prlctl helper scripts located in /etc/vz/conf (such as vz-start and vz-stop ) and situations when the init process of the Container is killed on Container stop after timeout.

2

Level 0 and level 1 logging events, plus template version used for Container creation and calls to mount and quota operations with parameters.

Disk quota parameters

Name

Description

Default value

DISK_QUOTA

Enables or disables disk quotas for Containers. If set to “no” then disk space accounting will be disabled.

yes

SLM parameters

Note: In Parallels Containers for Windows 6.0, the SLM system was superseded by the new VSwap memory management scheme, and the SLM parameters are left for compatibility reasons only.

Name

Description

Default value

SLM

If set to "yes", the SLM modules are loaded to the server. It means that the slmmemorylimit parameter is supported and can be used to manage the amount of memory consumed by every Container on the server.

Note: After changing this parameter, restart the Parallels Cloud Server service for the changes to take effect.

yes

SLMPATTERN

Defines the SLM pattern rules for grouping the processes running inside Containers on the server. The default rules are set in the /etc/vzslm.d/default.conf file on the server.

default

Network traffic parameters

Name

Description

Default value

TRAFFIC_SHAPING

Traffic shaping allows you to limit the bandwidth consumed by Containers for outgoing traffic. If it is set to “yes”, then limitations will be turned on. If you want to use this feature, TRAFFIC_ACCOUNTING should be set to “yes” as well.

no

BANDWIDTH

This is the list of network interfaces on which we want to shape the traffic and their speed in the form of “dev:rate”. The rate is measured in Kbps. If you want to shape traffic on more than one interface, set this parameter to “dev1:rate1 dev2:rate2”. For example, for two 100 Mbps Ethernet cards, set it to “eth0:102400 eth1:102400”.

eth0:102400

TOTALRATE

This parameter sets the size of the bandwidth pool for all Containers. It is the upper limit for the bandwidth available to all your Containers and is specified in the form of “dev:class:rate”. The rate is measured in Kbps. Containers can consume bandwidth up to this limit in addition to the limit specified by the RATE parameter. Default value corresponds to 4 Mbps limit for the Class 1 Containers.

eth0:1:4096

RATE

This parameter is the default bandwidth guaranteed to a Container for outgoing traffic if the Container configuration file does not explicitly specify a different value. This value is in the same format as TOTALRATE and its default value is “eth0:1:8”. The rate is measured in Kbps. Note that 8 Kbps, offered by the default configuration, is the guarantee and the Container cannot consume less than this value and more than the sum of this value and TOTALRATE .

eth0:1:8

VZ_TOOLS_BCID

Enables limits for pbackup , prestore , and pmigrate operations. Make sure that the value of this parameter does not coincide with the ID assigned to some of your Containers. For example, if you leave the default value 2, ensure that no Container with ID 2 exists on the Node.

VZ_TOOLS_IOLIMIT

Sets the disk I/O limit for the backup, restore, and migration operations, in bytes per second. Not set by default.

Template parameters

Name

Description

Default value

TEMPLATE

This is the directory where to find templates. It is not recommended to redefine this option since all the templates built by Parallels use the default directory.

/vz/template

Container default parameters

Name

Description

Default value

VE_ROOT

Path to the Container root directory where the private area is mounted to.

/vz/root/ CT_ID

VE_PRIVATE

Path to the Container private area. Must reside within a single physical partition.

/vz/private/ CT_ID

CONFIGFILE

The default configuration file sample to be used for the Container creation; it may be overridden with the --config option of the prlctl create command.

basic

DEF_OSTEMPLATE

The default OS template to be used for the Container creation; it may be overridden with the --pkgset command-line option for prlctl create .

centos-6-x86_64

VE_ENVIRONMENT

Additional environment variables to be passed to the Container init process. Should be provided as any number of name = value pairs separated by spaces.

Container validation and overcommitment parameters

Name

Description

Default value

VE_VALIDATE_ACTION

Defines whether the Container configuration should be validated when a Container is started. If this parameter is set to “warning”, a warning is displayed in case of misconfiguration. If set to “error”, the Container is not started in case of misconfiguration. If set to “fix”, the configuration is automatically corrected.

none

OVERCOMMITMENT_ACTION

Defines whether the server should be checked for the overcommitment of resources when a Container is started. If this parameter is set to “warning”, a warning is displayed in case of overcommitment. If set to “error”, the Container that would cause overcommitment is not started. When checking for overcommitment, the following five parameters are checked.

none

OVERCOMMITMENT_LEVEL_LOWMEM

The percentage of committed memory residing at lower addresses and directly accessed by the kernel.

120

OVERCOMMITMENT_LEVEL_MEMSWAP

The percentage of committed memory available for applications including both RAM and swap space.

90

OVERCOMMITMENT_LEVEL_ALLOCMEM

The allocation memory commitment level is the ratio of the memory size guaranteed to be available for allocation to the capacity of the system.

100

OVERCOMMITMENT_LEVEL_ALLOCMEM_TOT

The number shows how much memory the applications are allowed to allocate in comparison with the capacity of the system.

1000

OVERCOMMITMENT_LEVEL_ALLOCMEM_MAX

This allocation memory commitment level is the ratio of the maximal (among all running Containers) amount of allocated memory to the capacity of the system.

60

Supplementary parameters

Name

Description

Default value

VZWDOG

Defines whether the vzwdog module is loaded on Parallels Cloud Server startup. This module is responsible for catching messages from the kernel. It is needed if you configure the serial Monitor Server for Parallels Cloud Server.

no

VZPRIVRANGE

Defines the ID range for the Containers that are allowed to access the <servere> ID stored in the /proc/vz/hwid file.

1 100

DUMPDIR

The directory where the Container dump file created by means of the prlctl suspend command is to be stored.

/vz/private/ CT_ID /dump