Editing Vzctl for upstream kernel

Jump to: navigation, search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
{{DISPLAYTITLE: vzctl for upstream kernel}}
+
Since version 4.0, vzctl tool can be used with upstream (non-OpenVZ) Linux kernels (that essentially means any recent 3.x kernel). At the moment, it provides just basic functionality.
 +
It is currently possible to create and start a container with the same steps as one would use for a normal OpenVZ container. Other features may be present with limited functionality, while some are not present at all.
  
'''This article describes using OpenVZ tool vzctl as an alternative to LXC tools.'''
+
{{Warning|Running vzctl on upstream kernels is considered an experimental feature. See [[#Limitatons]] below.}}
 
 
Recent vzctl releases (starting from version 4.0) can be used with upstream (non-OpenVZ) Linux kernels (that essentially means any recent 3.x kernel). At the moment, it provides just basic functionality.
 
It is currently possible to create, start and stop a container with the same steps as one would use for a normal OpenVZ container. Other features may be present with limited functionality, while some are not present at all. We appreciate all bug reports, please file to [http://bugzilla.openvz.org/enter_bug.cgi?component=vzctl bugzilla].
 
 
 
Running vzctl on upstream kernels is considered an experimental feature. See [[#Limitations]] below.
 
  
 
== Installation ==
 
== Installation ==
Line 29: Line 25:
  
 
=== Networking ===
 
=== Networking ===
{{Note|IP mode networking (--ipadd / --ipdel) is currently not supported}}
+
{{Warn|IP mode networking (--ipadd / --ipdel) is currently not supported}}
  
 
Networking is available through the switches <code>--netdev_add</code>, <code>--netif_add</code>, and their respective deletion counterparts.
 
Networking is available through the switches <code>--netdev_add</code>, <code>--netif_add</code>, and their respective deletion counterparts.
Line 58: Line 54:
 
== Limitations ==
 
== Limitations ==
  
{{Note|We recommend using [[Download/kernel/rhel6|OpenVZ kernel]] for features, stability and security}}
+
The following vzctl commands are not working at all:
 
 
The following vzctl commands are not working at all with the non-OpenVZ kernel:
 
 
 
 
* <code>quotaon</code>/<code>quotaoff</code>/<code>quotainit</code> (vzquota-specific)
 
* <code>quotaon</code>/<code>quotaoff</code>/<code>quotainit</code> (vzquota-specific)
 
* <code>convert</code>, <code>compact</code>, <code>snapshot*</code> (ploop-specific)
 
* <code>convert</code>, <code>compact</code>, <code>snapshot*</code> (ploop-specific)
 
* <code>console</code> (needs a virtual /dev/console, /dev/ttyN device)
 
* <code>console</code> (needs a virtual /dev/console, /dev/ttyN device)
* <code>chkpnt</code>, <code>restore</code> (currently need OpenVZ-kernel-specific checkpointing, [http://criu.org/ CRIU] will be supported later)
+
* <code>enter</code>, <code>exec</code> and <code>runscript</code> (need pidns entering support)
 +
* <code>chkpnt</code>, <code>restore</code> (currently need OpenVZ-kernel-specific checkpointing, [http://crui.org/ CRIU] will be supported later)
 +
 
 +
The following commands have severe limitations:
 +
* <code>stop</code>. A container can be stopped from inside (say if one is connected to CT over ssh) in case the underlying kernel supports rebooting a PID namespace (> 3.4). Using vzctl, the "stop" command is not supported, unless accompanied by the --fast switch, which will simply forceably kill all processes in the container.
  
 
The following binaries are not ported to work on top of upstream kernel:
 
The following binaries are not ported to work on top of upstream kernel:
Line 84: Line 81:
 
=== Resource management ===
 
=== Resource management ===
  
With non-OpenVZ kernel, setting resources like <code>--ram</code> and <code>--cpuunits</code> works, but there their effect is dependent on what the current kernel supports, through the cgroups subsystem. When a particular cgroup file is present, it will be used. Currently, vzctl will search for the following files:
+
Setting resources like <code>--ram</code> and <code>--cpuunits</code> work, but there their effect is dependent on what the current kernel supports, through the cgroups subsystem. When a particular cgroup file is present, it will be used. Currently, vzctl will search for the following files:
 
* cpu.cfs_quota_us
 
* cpu.cfs_quota_us
 
* cpu.shares
 
* cpu.shares
Line 92: Line 89:
 
* memory.kmem.limit_in_bytes
 
* memory.kmem.limit_in_bytes
 
* memory.kmem.tcp.limit_in_bytes
 
* memory.kmem.tcp.limit_in_bytes
 +
  
 
== Building ==
 
== Building ==
 
In case you don't want to use packages provided by OpenVZ (available from [[Download/vzctl]]), but rather would like to compile vzctl from sources, read on.
 
  
 
=== Dependencies ===
 
=== Dependencies ===
Line 110: Line 106:
 
If you are living on the bleeding edge, get vzctl sources from git. Then run autogen.sh to recreate auto* files:
 
If you are living on the bleeding edge, get vzctl sources from git. Then run autogen.sh to recreate auto* files:
  
  git clone <nowiki>https://src.openvz.org/scm/ovzl/vzctl.git</nowiki>
+
  git clone git://git.openvz.org/pub/vzctl
 
  cd vzctl
 
  cd vzctl
 
  ./autogen.sh
 
  ./autogen.sh
Line 116: Line 112:
 
=== Compile ===
 
=== Compile ===
  
Usual <code>./configure && make</code> should do. But you probably want to specify more options. It makes sense to:
+
Usual ./confi
 
 
* enable cgroup support
 
* add <code>--without-ploop</code> (unless you want [[ploop]] compiled it) because otherwise you will need ploop lib headers (available from [[Download/ploop]]).
 
* enable bash completion support
 
* set prefix to /usr
 
 
 
See <code>./configure --help</code> output for more details and options available.
 
 
 
So, the command will look like:
 
 
 
$ ./configure --with-cgroup --without-ploop --enable-bashcomp --prefix=/usr
 
$ make -j4
 
 
 
=== Install ===
 
 
 
# make install
 
 
 
vzctl is also bundled in some Linux distributions, so you can install vzctl using native distro tools (i.e. your package manager):
 
 
 
* vzctl in [https://launchpad.net/ubuntu/+source/vzctl Ubuntu Linux] [https://help.ubuntu.com/community/OpenVZ Description]
 
* vzctl-core in [https://apps.fedoraproject.org/packages/vzctl-core Fedora Linux] [https://fedoraproject.org/wiki/QA:Testcase_vzctl_base Description]
 
* sys-cluster/vzctl in [http://packages.gentoo.org/package/sys-cluster/vzctl Gentoo Linux]
 
* vzctl in [https://packages.debian.org/search?keywords=vzctl Debian Linux]
 
* vzctl in [http://packages.altlinux.org/vzctl ALT Linux] ([http://altlinux.org/OpenVZ description])
 
 
 
== Known issues and workarounds ==
 
 
 
=== A container doesn't boot and udevd is in a process list ===
 
udev doesn't work, because <code>uevent</code>s are not virtualized yet. If you don't know how to disable it, you can remove the udev package.
 
 
 
=== <code>vzctl enter</code> doesn't work ===
 
 
 
You see this when trying to use <code>vzctl enter</code>:
 
 
 
Unable to open pty: No such file or directory
 
 
 
If a CT is executed in a user namespace, devpts must be mounted with the newinstance option. You can add this option in container's <code>/etc/fstab</code> file.
 
  
== See also ==
+
t makes sense to add <code>--without-ploop</code> (unless you want ploop compiled it) because otherwise you will need ploop lib headers.
  
* [[OpenVZ with upstream kernel]]
+
$ ./configure --with-cgroup --without-ploop

Please note that all contributions to OpenVZ Virtuozzo Containers Wiki may be edited, altered, or removed by other contributors. If you don't want your writing to be edited mercilessly, then don't submit it here.
If you are going to add external links to an article, read the External links policy first!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)

Templates used on this page: