| .TH vzsplit 8 "18 Mar 2012" "OpenVZ" "Containers" |
| .SH NAME |
| vzsplit \- generate a sample container configuration file |
| .SH SYNOPSIS |
| .SY vzsplit |
| .OP -n numve |
| .OP -f conf_name |
| .OP -s swapsize |
| .RB [ -v\ yes | no ] |
| .YS |
| .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 containers. The values are calculated from |
| the total physical memory of the Hardware Node the utility runs on, and |
| the number of containers the Hardware Node shall be able |
| to run even if the given number of containers consume all |
| the resources available. |
| .P |
| Without any option given, \fBvzsplit\fR prompts for the desired number |
| of containers and outputs the resulting resource control |
| parameters to stdout. |
| .P |
| If there are not enough system resources to run the specified number of |
| containers, an appropriate message is shown and the sample configuration file |
| is not generated. |
| .SH OPTIONS |
| .TP |
| .BI -n \ numve |
| Specify the number of containers. |
| .TP |
| .BI -f \ conf_name |
| Specify the configuration sample name to write configuration to, instead of |
| standard output. The file created will be named |
| @VPSCONFDIR@/ve-\fIconf_name\fR.conf-sample. |
| .TP |
| .BI -s \ swapsize |
| Specify the swap size in Kbytes. If this option is not given, |
| the swap size is read from \fB/proc/meminfo\fR. |
| .TP |
| .BR -v\ yes | no |
| Whether to generate VSwap enabled configuration. Default is auto-detect by |
| checking if running kernel is VSwap capable; this option overrides |
| auto-detection. |
| .SH EXIT STATUS |
| \fBvzsplit\fR returns 0 upon a successful execution. If anything goes wrong, it |
| returns 1. |
| .SH SEE ALSO |
| .BR ctid.conf (5). |
| .SH LICENSE |
| Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL. |