Changes

{{Warning|This document briefly article describes the steps needed to install legacy version of OpenVZ on your (RPM based) machine. For '''Debian''' based systems current version, see [[Installation on DebianQuick installation]].}}

<!--T:1-->This document is also available in briefly describes the following languages: [http://forum.openvz.org/index.php?t=tree&amp;goto=35&amp;#msg_35 French], [http://forum.openvz.org/index.php?t=tree&amp;goto=1805&amp;#msg_1805 German],[http://wiki.openvz.jp Japanese]steps needed to install '''legacy''' OpenVZ on your '''RHEL 6''' (CentOS 6,[[Quick_installation_(SpanishScientific Linux 6)|Spanish]]machine.

{{Out|A commercial version of OpenVZ for hosters called Parallels Server Bare Metal is available, which simplifies installation with a single disk as well as supports networked installation using PXE boot. To learn more about Parallels Server Bare Metal and request a free trial<!--T:2-->For '''Debian''' based systems, please see http://www.parallels[[Installation on Debian]].com/products/server/baremetal/sp/}}

<!--T:3-->{{Out|A commercial version of OpenVZ consists of is available, which simplifies installation with a kernel, user-level tools, and container templatessingle disk as well as supports networked installation using PXE boot. This guide tells how to install the kernel To learn more about Virtuozzo and the toolsrequest a free trial, please see https://virtuozzo.com/openvz/}}

== Requirements ==This guide assumes you are running recent release of Fedora Core (like FC5) or RHEL/CentOS 4. Currently, OpenVZ kernel tries to support the same hardware that Red Hat kernels support. For full hardware compatibility list, see [http<!--T://www.swsoft.com/en/products/virtuozzo/hcl/ Virtuozzo HCL].5-->

=== Filesystems ===<!--T:6-->It is recommended to use a separate partition for containerThis guide assumes you are running '''s private directories RHEL (by default /vz/private/<veid>CentOS, Scientific Linux). The reason why you should do so is that if you wish to use OpenVZ per-container disk quota, you won6'''t be able to use usual Linux disk quotas on the same partitionyour system. Bear in mindCurrently, that per-container quota in this context includes not only pure per-container quota, but also usual Linux disk quota used in containers, not is a recommended platform to run OpenVZ on [[HN]].

At least try to avoid using the root partition for containers, because the root user of a container will be able to overcome the 5% disk space barrier in some situations. This way the HN root partition can be completely filled and it will break the === /vz file system.=== <!--T:7-->

OpenVZ per<!-container disk quota -T:8-->It is supported only recommended to use a separate partition for ext2containers (by default '''/ext3 filesystems. So use one of these filesystems (ext3 is recommendedvz''') if you need per-container disk quotaand format it to '''ext4'''.

=== rpm or yum? pre-setup ===<!--T:9-->

In case you have yum utility available on your system, you may want to use <!--T:10-->Download [https://download.openvz.org/openvz.repo openvz.repo] file and put it effectively to install and update OpenVZ packages. In case you don't have your <code>/etc/yum, or don't want to use it, you can use plain old rpm. Instructions for both rpm and yum are provided belowrepos.d/</code> repository:

=== yum <!--T:11--><pre><nowiki>wget -setup ===If you want to use P /etc/yum, you should set up OpenVZ yum repository first.repos.d/ https://download.openvz.org/openvz.repo</nowiki></pre>

Download [http<!--T://download.openvz.org/openvz.repo openvz.repo] file and put it to your <code>/etc/yum.repos.d/</code12--> repository,and import Import OpenVZ GPG key used for signing RPM packages. This can be achieved by the following commands, as root:<pre><nowiki>wget -P /etc/yum.repos.d/ http://download.openvz.org/openvz.reporpm --import http://download.openvz.org/RPM-GPG-Key-OpenVZ</nowiki></pre>

In case you can not cd to <!--T:13--><pre><nowiki>rpm --import http:/etc/yumdownload.repos.d, it means either yum is not installed on your system, or yum version is too old. In that case, just stick to rpm installation methodopenvz.org/RPM-GPG-Key-OpenVZ</nowiki></pre>

First, <!--T:15-->Limited OpenVZ functionality is supported when you need to choose what “flavor” of the run a recent 3.x kernel you want to install. Please refer to (check [[Kernel flavorsvzctl for upstream kernel]] for more information, so OpenVZ kernel installation is optional but still recommended.

=== Using yum ===Run the following command <pre># yum install [o]vzkernel[!-flavor]</pre> For RHEL6 kernel branch, use '''vzkernel''', for other branches use '''ovzkernel'''. Note that <code>[-flavor]</code> is optional, and can be <code>T:16-smp</code> or <code>-enterprise</code>. Refer to [[kernel flavors]] for more info. {{Note|if you need to install <code>x86_64</code> kernel and # yum offers to install both <code>x86_64</code> and <code>i686</code> kernels, answer <code>No</code> and specify architecture manually, like this: <code>yum install ovzkernel.x86_64</code>. This is fixed in newer yum versions.}} === Using rpm ===Get the kernel binary RPM from the [[Download/kernel]] page. You only need one kernel RPM so please [[Kernel flavors|choose the appropriate one]] depending on your hardware. Next, install the kernel RPM you chose: <pre># rpm -ihv ovzkernel[-flavor]*.rpm</pre> Here <code>[-flavor]</code> is optional, and can be <code>-smp</code> or <code>-enterprise</code>. Refer to [[kernel flavors]] for more info. {{Note|<tt>rpm -U</tt> (where <tt>-U</tt> stands for ''upgrade'') should '''not''' be used, otherwise all currently installed kernels will be uninstalled.}} == Configuring the bootloader == In case GRUB is used as the boot loader, it will be configured automatically: lines similar to these will be added to the <tt>/boot/grub/grub.conf</tt> file: <pre>title Fedora Core (2.6.8-022stab029.1) root (hd0,0) kernel /vmlinuz-2.6.8-022stab029.1 ro root=/dev/sda5 quiet rhgb vga=0x31B initrd /initrd-2.6.8-022stab029.1.img</pre>Change <tt>Fedora Core</tt> to <tt>OpenVZ</tt> (just for clarity reasons, so the OpenVZ kernels will not be mixed up with non-OpenVZ ones). Remove extra arguments from the kernel line, leaving only the <tt>root=...</tt> parameter. The modifed portion of <tt>/etc/grub.conf</tt> should look like this:vzkernel

== System configuration == <pre>title OpenVZ (2.6.8!-022stab029.1) root (hd0,0) kernel /vmlinuz-2.6.8T:17-022stab029.1 ro root=/dev/sda5 initrd /initrd-2.6.8-022stab029.1.img</pre>

=== sysctl ===<!--T:20-->

=== SELinux === SELinux should be disabled. To that effect, put the following line to <code>/etc/sysconfig/selinux</code>!--T:<pre>SELINUX=disabled</pre26-->

<!--T:27-->SELinux should be disabled. Put <code>SELINUX=== Conntracks ===disabled</code> to <code>/etc/sysconfig/selinux</code>:

In the old (2.6.8== Tools installation == <!-based) OpenVZ kernels netfilter connection tracking for [[CT0]] is disabled by default. If you have a stateful firewall enabled on the host node (it is there by default on some distributions) you should either disable it, or enable connection tracking for [[CT0]].-T:29-->

To enable conntracks for CT0, add the following line to <code>/etc/modprobe.conf</code> file!--T:<pre30-->options ip_conntrack ip_conntrack_enable_ve0=1</pre>{{Out|Before installing tools, please read about [[vzstats]] and opt-out if you don't want to help the project.}}

== Rebooting into <!--T:31-->OpenVZ kernel ==needs some user-level tools installed:

Now reboot the machine and choose "OpenVZ" on the boot loader menu. If the OpenVZ kernel has been booted successfully, proceed to installing the user <!-level tools for OpenVZ. == Installing the utilities == OpenVZ needs some user-level tools installed. Those areT: ; vzctl: A utility to control OpenVZ containers (create, destroy, start, stop, set parameters etc.); vzquota: A utility to manage quotas for containers. Mostly used indirectly (by vzctl). === Using yum === <pre32--># yum install vzctl vzquota</pre> If on the x86_64 platform you would probably want to: <pre># yum install vzctl.x86_64 vzquota.x86_64</pre> === Using rpm === Download the binary RPMs of these utilities from [[Download/utils]]. Install them: <pre># rpm -Uhv vzctl*.rpm vzquota*.rpm</pre> If rpm complains about unresolved dependencies, you'll have to satisfy them first, then repeat the installation. When all the tools are installed, start the OpenVZ subsystem. == Starting OpenVZ == As root, execute the following command: <pre># /sbin/service vz start</pre>ploop

This will load all the needed == Reboot into OpenVZ kernel modules. This script should also start all the containers marked to be auto== <!-started on machine boot (there aren't any yet).-T:33-->

During <!--T:34-->Now reboot the next reboot, this script machine and choose "OpenVZ" on the boot loader menu (it should be executed automaticallydefault choice).

== Installing Download OS template caches templates ==<!--T:35-->

<!--T:36-->An OS template cache is a Linux distribution installed into a container

can be created in a matter of minutesminute.

<!--T:37-->Download precreated template caches from [http://openvz.org/download/template/cache Downloads » Templates » Precreated], or directly from [http://download.openvz.org/template/precreated/ download.openvz.org/template/precreated], or from one of the [[Download mirrors|mirrors]]. Put those tarballs '''as-is (no unpacking needed)''' to the <tt>/vz/template/cache/</tt> directory(for Debain, this is <tt>/var/lib/vz/template/cache/</tt>).

== Next steps ==<!--T:38-->

<!--T:39-->OpenVZ is now set up on your machine. To load OpenVZ kernel by default, edit the default line Follow on to [[basic operations in the /boot/grub/grub.conf file to point to the OpenVZ kernel. For example, if the OpenVZ kernel is the first kernel mentioned in the file, put it as default 0. See man grub.conf for more detailsenvironment]] document.