Changes

← Older edit

Man/vzctl.8

9,620 bytes added, 18:21, 23 April 2015

Automated import of articles *** existing text overwritten ***

[flags] start CTID [--wait]

[--force] [--skip-fsck][--skip-remount] </td></tr>

[flags] restart CTID

[--wait] [--force] [--fast][--skip-fsck] [--skip-remount]</td></tr>

[flags] snapshot-switch CTID[--skip-resume |--must-resume][--skip-config] --id uuid</td></tr><tr valign="top" align="left"><td width="11%"></td><td width="7%"> vzctl</td><td width="2%"></td><td width="80%"> [flags] snapshot-delete CTID --iduuid </td></tr>

be referred to by either numeric CTID or by name (see

--name option). Note that CT ID <= 100 are

reserved for OpenVZ internal purposes. A numeric ID shouldnot be more than 2147483644.

== OPTIONS ==

[--name name]

[--description string]

[--ostemplate string]

[--stop-timeout seconds]

[--ipadd addr]

[--ipdel addr|all]

[--ram bytes]

[--swap bytes]

[--vm_overcommit float]

[--cpuunits num]

[--cpulimit num]

[--cpus num]

[--cpumask cpus|auto|all][--nodemask nodes|all]

[--meminfo none|mode:value]

[--iptables name[,...]]

[--netfilter disabled|stateless|stateful|full]

[--netdev_add ifname]

[--netdev_del ifname]

[--applyconfig name]

[--applyconfig_map group]

[--ioprio num][--iolimit mbps][--iopslimit iops] [--save]

[--force] [--reset_ub]

[--setmode restart|ignore] </td></tr>

Add a textual description for a

container.

--ostemplate

string

Sets a new value of

OSTEMPLATE parameter in container configuration file

[[Man/ctid.conf.5|ctid.conf(5)]]. Requires --save flag. Useful

after a change/upgrade of a distribution running inside

container, as vzctl uses the value of OSTEMPLATE to run

distribution-specific scripts.

--stop-timeout

seconds

Sets a time to wait for

container to stop on vzctl stop before forcibly

killing it, in seconds. Note this option can not be used

without --save flag.

Special value

of 0 means to use compiled-in default.

==== Networking ====

server values set in previous calls to vzctl are

overwritten.

A special value

of inherit can be used to auto-propagate nameserver

value(s) from the host system’s

/etc/resolv.conf file.

--searchdomain

search domain values set in previous calls to vzctl

are overwritten.

A special value

of inherit can be used to auto-propagate search

domain value(s) from the host system’s

/etc/resolv.conf file.

--netif_add

--swappages limit (the barrier is set to 0).

--vm_overcommitfloat Set VM overcommitment value tofloat. If set, it is used to calculateprivmmpages parameter in case it is not setexplicitly (see below). Default value is 0, meaningunlimited privvmpages. ~~Note that~~vzctl checks if running kernel is VSwap capable, andrefuses to use these parameters otherwise. This behavior canbebe overriden by using --force flag before

parameters.

In VSwap mode,

all beancounters other than RAM and swap become optional.

Note though that if some optional beancounters are not set,

they are calculated and set by vzctl implicitly, using the

following formulae:

•

lockedpages.barrier = oomguarpages.barrier = ram

•

lockedpages.limit = oomguarpages.limit = unlimited

•

vmguarpages.barrier = vmguarpages.limit = ram + swap

•

privvmpages.barrier = privvmpages.limit = (ram + swap) *

vm_overcommit

(if

vm_overcommit is 0 or not set,

privvmpages is set to "unlimited")

Here is an

--cpumask cpus |

auto | all

~~sets~~ Sets list of allowed CPUs for

the container. Input format is a comma-separated list of

decimal numbers and /or ranges. Consecutively set bits are shownas two hyphen-separated decimal numbers, the smallest andlargest bit numbers set in the range. For example, if youwant the container to execute on CPUs 0, 1, 2, 7, you shouldpass 0-2,7. Default value is all (thecontainer can execute on any CPU). If used with the--nodemask option, value of auto assigns allCPUs from the specified NUMA node to a container. --nodemask nodes| all Sets list of allowed NUMA nodesfor the container. Input format is the same as for--cpumask. Note that --nodemask must be usedwith the --cpumask option.

==== Memory output parameters ====

privvmpages:1.

==== Netfilter (iptables ) control parameters ==== --netfilter disabled|stateless|stateful|full Restrict access tonetfilter/iptables modules for a container. This optionreplaces obsoleted --iptables. Note thatchanging this parameter requires container restart, soconsider using --setmode option. The followingarguments can be used: • disabled no modules are allowed • stateless all modules except NAT andconntracks are allowed (i.e. filter and mangle); this is thedefault • stateful all modules except NAT areallowed <table width="100%" border="0" rules="none" frame="void" cellspacing="0" cellpadding="0"><tr valign="top" align="left"><td width="22%"></td><td width="9%"> • full</td><td width="1%"></td><td width="36%"> all modules are allowed</td><td width="32%"></td></tr></table>

--iptables

name[,...]

Note this option isobsoleted, --netfilter should be used instead. Allow to use the functionalityof name iptables module inside the container.Multiple comma-separated names can be specified.

The default

ploop image file to the new size. Since there is no

soft/hard limit concept in ploop, second num, if

specified, is ignored. By default,ploop resize is done online, i.e. on a mounted ploop. Thisis a preferred way of doing resize. Although, in a rare casea container was using lots of disk space and should now beresized to a much smaller size, an offline resize might bemore appropriate. In this case, make sure the container isstopped and unmounted and use additional--offline-resize option Note that ~~such~~ ploopresize is NOTperformed on container start, so for consistency--diskspace must be used together with --saveflag.

Suffixes

configuration file.

==== I/O ~~priority management~~ scheduling ====

--ioprio

priority

Assigns disk I/O priority to

container. Priority range is 0-7. The greater

priority is, the more time for I/O activity container

has. By default each container has priority of

4.

--iolimit

limit[B|K|M|G]

Assigns disk I/O bandwidth

limit for a container. Value is either a number with an

optional suffix, or a literal string unlimited. Value

of 0 means "unlimited". By default a

container has no I/O limit. Maximum allowed limit is 2

gigabytes per second; values exceeding the limit are

truncated.

If no suffix is

provided, the limit is assumed to be in megabytes per

second. Available suffixes are:

• b, B -- bytes per second;

• k, K -- kilobytes per second;

• m, M -- megabytes per second (default);

• g, G -- gigabytes per second;

--iopslimit

iops

Assigns IOPS limit for a

container, in number of input/output operations per second.

Value is a number or a literal string unlimited.

Value of 0 means "unlimited". By default a

container has no IOPS limit.

=== Suspending and resuming ===

snapshot-switch

CTID [--skip-resume | --must-resume][--skip-config] --id uuid

Switches the container to a

snapshot identified by uuid, restoring its filesystem state, configuration (if available) and its runningstate (if available). Note that the currentstate of a container (including its file system~~container~~ state and its configuration file ~~system state~~ ) is lost! Option--skip-resume is used to ignore a CT memory dump filein a snapshot, as a result the container will end up beingin a stopped state (same as if a snapshot has been takenwith --skip-suspend). If ~~given~~option~~snapshot contains CT~~ --must-resume is set, absense of a memory dumpistreated as an error, it and the inability to restore from thememory dump is ~~restored~~treated as an error rather than warning. Option option--skip-config is used to ignore the CT configurationfile in a snapshot, ~~otherwise~~i.e. the current configuration file will~~container~~ be left as is ~~stopped~~.

snapshot-delete

[--layout simfs|ploop[:{expanded|plain|raw}]]

[--diskspace kbytes]

[--diskinodes num]

[--private path]

[--root path]

[--ipadd addr]

[--hostname name]

[--name name][--local_uid uid][--local_gid gid] </td></tr>

</table>

You can use

--diskspace ~~option~~ and --diskinodes options to specify container file systemsize. Note that for~~size~~ploop layout, you will not be able to change inodesvalue later. If DISKSPACE is not specified either in the sampleconfiguration file used for creation or in global configuration file[[Man/vz.conf.5|vz.conf(5)]], ~~this~~ --diskspaceparameter is required forploop layout.

Suffixes

--hostname name option to set a host name for

a container.

When running

with an upstream Linux Kernel that supports user namespaces

(>= 3.8), the parameters --local_uid and

--local_gid can be used to select which uid

and gid respectively will be used as a base user in

the host system. Note that user namespaces provide a 1:1

mapping between container users and host users. If these

options are not specified, the values LOCAL_UID and

LOCAL_GID from global configuration file

[[Man/vz.conf.5|vz.conf(5)]] are used. An explicit --local_uid

value of 0 will disable user namespace support, and run the

container as a privileged user. In this case,

--local_gid is ignored.

Warning:

use --local_uid and --local_gid with care,

specially when migrating containers. In all situations, the

container’s files in the filesystem needs to be

correctly owned by the host-side users.

destroy | delete

start CTID

[--wait] [--force] [--skip-fsck][--skip-remount]

Mounts (if necessary) and

--force if you want to start a container which is

disabled (see --disabled).

Specify

--skip-fsck to skip fsck for ploop-based container

filesystem (this option is used by vz initscript).

By default, if

a container to be started happens to be already mounted, it

is unmounted and mounted again. This behavior can be turned

off by using --skip-remount flag.

Note that this

syscall instead which is faster but can lead to unclean

container shutdown.

Note that

vzctl stop is not asyncronous, in other words vzctl

waits for container’s init to exit (unless

--fast is given), which can take up to a few minutes.

Default wait timeout is 120 seconds; it can be changed

globally, by setting STOP_TIMEOUT in

[[Man/vz.conf.5|vz.conf(5)]], or per container (STOP_TIMEOUT in

[[Man/ctid.conf.5|ctid.conf(5)]], see --stop-timeout).

Note that this

restart CTID

[--wait] [--force] [--fast][--skip-fsck]

Restarts a container, i.e.

global and per-CT scripts. Global scripts have a literal

prefix of vps. and are executed for all containers.

Per-CT scripts have a CTID. numeric prefix and areexecuted for the given container only.

Please note

<pre style="margin-left:11%; margin-top: 1em"> # If one of these files does not exist then something

# is really broken

[ -f /etc/~~sysconfig~~vz/vz .conf ] || exit 1

[ -f $VE_CONFFILE ] || exit 1

# Source both files. Note the order is important.

Parameter DISKSPACE not set ~~(or set too high)~~</td></tr>

Botinki Kira

Bots

2,253

edits

Changes

Man/vzctl.8

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Services

Donate

Tools