Difference between revisions of "Man/vzsplit.8"

From OpenVZ Virtuozzo Containers Wiki
< Man
Jump to: navigation, search
(Automated import of articles)
 
(Automated import of articles *** existing text overwritten ***)
 
(3 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
<p style="margin-left:11%; margin-top: 1em">vzsplit &minus;
 
<p style="margin-left:11%; margin-top: 1em">vzsplit &minus;
generate a sample container configuration file with a
+
generate a sample container configuration file</p>
certain set of system resource control parameters.</p>
 
  
 
== SYNOPSIS ==
 
== SYNOPSIS ==
  
<p style="margin-left:11%; margin-top: 1em">vzsplit
+
<table width="100%" border="0" rules="none" frame="void"
[<b>-n</b> <i>numve</i>] [<b>-f</b> <i>conf_name</i>]
+
      cellspacing="0" cellpadding="0">
[<b>-s</b> <i>swapsize</i>]</p>
+
<tr valign="top" align="left">
 +
<td width="11%"></td>
 +
<td width="11%">
 +
 
 +
<p style="margin-top: 1em"><b>vzsplit</b></p></td>
 +
<td width="1%"></td>
 +
<td width="77%">
 +
 
 +
<p style="margin-top: 1em">[<b>-n&nbsp;</b><i>numve</i>]
 +
[<b>-f&nbsp;</b><i>conf_name</i>]
 +
[<b>-s&nbsp;</b><i>swapsize</i>]
 +
[<b>-v&nbsp;yes</b>|<b>no</b>]</p> </td></tr>
 +
</table>
  
 
== DESCRIPTION ==
 
== DESCRIPTION ==
Line 21: Line 32:
 
containers the Hardware Node shall be able to run even if
 
containers the Hardware Node shall be able to run even if
 
the given number of containers consume all the resources
 
the given number of containers consume all the resources
available. Without any option given, <b>vzsplit</b> prompts
+
available.</p>
for the desired number of containers and outputs the
+
 
resulting resource control parameters to stdout. If there
+
<p style="margin-left:11%; margin-top: 1em">Without any
are not enough system resources to run the specified number
+
option given, <b>vzsplit</b> prompts for the desired number
of containers, an appropriate message is shown and the
+
of containers and outputs the resulting resource control
sample configuration file is not generated.</p>
+
parameters to stdout.</p>
 +
 
 +
<p style="margin-left:11%; margin-top: 1em">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.</p>
  
 
== OPTIONS ==
 
== OPTIONS ==
  
<p style="margin-left:11%; margin-top: 1em"><b>-n</b>
+
<p style="margin-left:11%; margin-top: 1em"><b>-n&nbsp;</b><i>numve</i></p>
<i>numve</i></p>
 
  
 
<p style="margin-left:22%;">Specify the number of
 
<p style="margin-left:22%;">Specify the number of
 
containers.</p>
 
containers.</p>
  
<p style="margin-left:11%;"><b>-f</b> <i>conf_name</i></p>
+
<p style="margin-left:11%;"><b>-f&nbsp;</b><i>conf_name</i></p>
  
<p style="margin-left:22%;">Specify the configuration file
+
<p style="margin-left:22%;">Specify the configuration
name. The program output is placed to
+
sample name to write configuration to, instead of standard
 +
output. The file created will be named
 
/etc/vz/conf/ve-<i>conf_name</i>.conf-sample.</p>
 
/etc/vz/conf/ve-<i>conf_name</i>.conf-sample.</p>
  
<p style="margin-left:11%;"><b>-s</b> <i>swapsize</i></p>
+
<p style="margin-left:11%;"><b>-s&nbsp;</b><i>swapsize</i></p>
  
 
<p style="margin-left:22%;">Specify the swap size in
 
<p style="margin-left:22%;">Specify the swap size in
Kbytes. If not provided in the option, the swap size will be
+
Kbytes. If this option is not given, the swap size is read
read from /proc/meminfo.</p>
+
from <b>/proc/meminfo</b>.</p>
 +
 
 +
<p style="margin-left:11%;"><b>-v&nbsp;yes</b>|<b>no</b></p>
 +
 
 +
<p style="margin-left:22%;">Whether to generate VSwap
 +
enabled configuration. Default is auto-detect by checking if
 +
running kernel is VSwap capable; this option overrides
 +
auto-detection.</p>
  
== DIAGNOSTICS ==
+
== EXIT STATUS ==
  
 
<p style="margin-left:11%; margin-top: 1em"><b>vzsplit</b>
 
<p style="margin-left:11%; margin-top: 1em"><b>vzsplit</b>
Line 61: Line 84:
  
 
<p style="margin-left:11%; margin-top: 1em">Copyright (C)
 
<p style="margin-left:11%; margin-top: 1em">Copyright (C)
2000-2010, Parallels, Inc. Licensed under GNU GPL.</p>
+
2000-2011, Parallels, Inc. Licensed under GNU GPL.</p>

Latest revision as of 12:41, 27 June 2011

NAME[edit]

vzsplit − generate a sample container configuration file

SYNOPSIS[edit]

vzsplit

[-n numve] [-f conf_name] [-s swapsize] [-v yes|no]

DESCRIPTION[edit]

The vzsplit 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.

Without any option given, vzsplit prompts for the desired number of containers and outputs the resulting resource control parameters to stdout.

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.

OPTIONS[edit]

-n numve

Specify the number of containers.

-f conf_name

Specify the configuration sample name to write configuration to, instead of standard output. The file created will be named /etc/vz/conf/ve-conf_name.conf-sample.

-s swapsize

Specify the swap size in Kbytes. If this option is not given, the swap size is read from /proc/meminfo.

-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.

EXIT STATUS[edit]

vzsplit returns 0 upon a successful execution. If anything goes wrong, it returns 1.

SEE ALSO[edit]

ctid.conf(5).

LICENSE[edit]

Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL.