blob: 4093324c7a1866ca98fb25d08750d0d04464e9fc [file] [log] [blame] [view] [raw]
.\" $Id: vps.conf.5,v 1.1.2.12 2005/10/17 11:42:41 igor Exp $
.TH vps.conf 5 "10 Aug 2005" "OpenVZ" "Virtual Private Server"
.SH NAME
vps.conf \- configuration file for a Virtual Private Server.
.SH SYNOPSIS
/etc/vz/conf/XXX.conf
.SH DESCRIPTION
This is a configuration file for a VPS. It is stored as
\fB/etc/vz/conf/\fR\fIXXX\fB.conf\fR, where \fIXXX\fR
is the ID of the given VPS.
.PP
Configuration file consists of lines in the form
.PP
\fBPARAMETER\fR="\fIvalue\fR"
.PP
All parameter names and values are case-sensitive. Quotes surrounding a
\fIvalue\fR are required if value contains spaces, and are optional otherwise.
Extra spaces are not allowed. All unrecognized lines will be ignored.
.PP
Please note that the file is created/modified by the \fBvzctl(8)\fR command with the \fIset --save\fR arguments, therefore changes to this file made otherwise than by \fBvzctl(8)\fR can be lost during the next \fBvzctl\fR run.
.PP
The meaning of each parameter is described in \fBvzctl(8)\fR, so here only
the appropriate \fBvzctl set\fR option is given.
.SS Miscellaneous parameters
.IP \fBONBOOT\fR="\fByes\fR|\fBno\fR"
Specifies whether this VPS will be started during system bootup.
Default is \fBno\fR, meaning VPS will not be started
if \fBONBOOT\fR parameter is omitted.
Corresponds to the \fB--onboot\fR option.
.IP \fBOSTEMPLATE\fR="\fItmpl_name\fR"
Corresponds to the \fB--ostemplate\fR option.
.IP \fBVE_ROOT\fR="\fIdirectory\fR"
Corresponds to the \fB--root\fR option.
.IP \fBVE_PRIVATE\fR="\fIdirectory\fR"
Corresponds to the \fB--private\fR option.
.IP \fBDISABLED\fR="\fByes\fR|\fBno\fR"
Corresponds to the \fB--disabled\fR option.
.IP \fBORIGIN_SAMPLE\fR="\fIname\fR"
Name of VPS sample config VPS based on.
.IP \fBCONFIG_CUSTOMIZED\fR="\fByes\fR|\fBno\fR"
Set to \fByes\fR if VPS config was modified.
.SS Resource management parameters
.IP \fBNUMPROC\fR
Corresponds to the \fB--numproc\fR options.
.IP \fBNUMFILE\fR
Corresponds to the \fB--numfile\fR options.
.IP \fBNUMFLOCK\fR
Corresponds to the \fB--numflock\fR options.
.IP \fBNUMPTY\fR
Corresponds to the \fB--numpty\fR options.
.IP \fBNUMSIGINFO\fR
Corresponds to the \fB--numsiginfo\fR options.
.IP \fBNUMTCPSOCK\fR
Corresponds to the \fB--numtcpsock\fR options.
.IP \fBNUMOTHERSOCK\fR
Corresponds to the \fB--numothersock\fR options.
.IP \fBPRIVVMPAGES\fR
Corresponds to the \fB--privvmpages\fR options.
.IP \fBVMMGUARPAGES\fR
Corresponds to the \fB--vmguarpages\fR options.
.IP \fBOOMGUARPAGES\fR
Corresponds to the \fB--oomguarpages\fR options.
.IP \fBLOCKEDPAGES\fR
Corresponds to the \fB--lockedpages\fR options.
.IP \fBSHMPAGES\fR
Corresponds to the \fB--shmpages\fR options.
.IP \fBKMEMSIZE\fR
Corresponds to the \fB--kmemsize\fR options.
.IP \fBTCPSNDBUF\fR
Corresponds to the \fB--tcpsndbuf\fR options.
.IP \fBTCPRCVBUF\fR
Corresponds to the \fB--tcprcvbuf\fR options.
.IP \fBOTHERSOCKBUF\fR
Corresponds to the \fB--othersockbuf\fR options.
.IP \fBDGRAMRCVBUF\fR
Corresponds to the \fB--dgramrcvbuf\fR options.
.IP \fBDCACHESIZE\fR
Corresponds to the \fB--dcachesize\fR options.
.IP \fBNUMIPTENT\fR
Corresponds to the \fB--numiptent\fR options.
.IP \fBCPUUNITS\fR
Corresponds to the \fB--cpuunits\fR option.
.IP \fBDISKSPACE\fR="\fIsoftlimit\fR[:\fIhardlimit\fR]"
Corresponds to the \fB--diskspace\fR parameter.
.IP \fBDISKINODES\fR="\fIsoftlimit\fR[:\fIhardlimit\fR]"
Corresponds to the \fB--diskinodes\fR parameter.
.IP \fBQUOTATIME\fR="\fIseconds\fR"
Corresponds to the \fB--quotatime\fR parameter.
.IP \fBQUOTAUGIDLIMIT\fR="\fInum\fR"
Corresponds to the \fB--quotaugidlimit\fR parameter.
.IP \fBNOATIME\fR="\fByes\fR|\fBno\fR"
Corresponds to the \fB--noatime\fR option.
.IP \fBCAPABILITY\fR="\fIcapname\fR:\fBon\fR|\fBoff\fR\ [...]"
Corresponds to the \fB--capability\fR option
.SS Network related parameters
.IP \fBIP_ADDRESS\fR="\fIaddress\ [address]\fR"
Specifies the \fIaddress\fR the VPS will be assigned. Several addresses
are divided by spaces.
Corresponds to the \fB--ipadd\fR option.
.IP \fBHOSTNAME\fR="\fIname\fR"
Corresponds to the \fB--hostname\fR option.
.IP \fBNAMESERVER\fR="\fIip\fR\ [\fIip\fR]"
Corresponds to the \fB--nameserver\fR option. Several name server addresses
are divided by spaces.
.IP \fBSEARCHDOMAIN\fR="\fIdomain\fR\ [\fIdomain\fR]"
Corresponds to the \fB--searchdomain\fR option. Several search domains
are divided by spaces.
.SH SEE ALSO
.BR vzctl (8),
.BR vz (5).
.SH LICENSE
Copyright (C) 2001-2006 by SWsoft. Licensed under GNU GPL.