.TH vzsplit 8 "12 Sep 2006" "OpenVZ" "Virtual Environments"
.SH NAME
vzsplit \- generate a sample VE configuration file with a certain set of system resource control parameters.
.SH SYNOPSIS
vzsplit [\fB-n\fR \fInumve\fR] [\fB-f\fR \fIconf_name\fR] [\fB-s\fR \fIswapsize\fR]
.SH DESCRIPTION
The \fBvzsplit\fR utility is used to split the Hardware Node into equal parts.
It generates a full set of system resource control parameters for the
given number of Virtual Environments. The values are calculated from
the total physical memory of the Hardware Node the utility runs on, and
the number of Virtual Environments the Hardware Node shall be able
to run even if the given number of Virtual Environments consume all
the resources available.
Without any option given, \fBvzsplit\fR prompts for the desired number
of Virtual Environments and outputs the resulting resource control
parameters to stdout.
If there are not enough system resources to run the specified number of
VEs, an appropriate message is shown and the sample configuration file
is not generated.
.SH OPTIONS
.TP
\fB-n\fR \fInumve\fR
Specify the number of VEs.
.TP
\fB-f\fR \fIconf_name\fR
Specify the configuration file name. The program output is placed to
/etc/vz/conf/ve-\fIconf_name\fR.conf-sample.
.TP
\fB-s\fR \fIswapsize\fR
Specify the swap size in Kbytes. If not provided in the option, the swap size will be read from /proc/meminfo.
.SH DIAGNOSTICS
\fBvzsplit\fR returns 0 upon a sucessful execution. If anything goes wrong, it
returns 1.	
.SH SEE ALSO
.BR vps.conf (5).
.SH LICENSE
Copyright (C) 2000-2006, SWsoft. Licensed under GNU GPL.