Difference between revisions of "Quick installation (legacy)"

From OpenVZ Virtuozzo Containers Wiki
Jump to: navigation, search
(no need for system configuration with vzctl 4.4)
(rm translate tags)
 
(22 intermediate revisions by 7 users not shown)
Line 1: Line 1:
This document briefly describes the steps needed to install OpenVZ on your RHEL (CentOS, Scientific Linux) '''6''' machine. For '''Debian''' based systems see [[Installation on Debian]].
+
{{Warning|This article describes legacy version of OpenVZ. For current version, see [[Quick installation]].}}
  
{{Out|A commercial version of OpenVZ is available, which simplifies installation with a single disk as well as supports networked installation using PXE boot. To learn more about Parallels Cloud Server and request a free trial, please see http://www.parallels.com/products/pcs/}}
+
<!--T:1-->
 +
This document briefly describes the steps needed to install '''legacy''' OpenVZ on your '''RHEL 6''' (CentOS 6, Scientific Linux 6) machine.
  
== Requirements ==
+
<!--T:2-->
 +
For '''Debian''' based systems, please see [[Installation on Debian]].
  
 +
<!--T:3-->
 +
{{Out|A commercial version of OpenVZ is available, which simplifies installation with a single disk as well as supports networked installation using PXE boot. To learn more about Virtuozzo and request a free trial, please see https://virtuozzo.com/openvz/}}
 +
 +
== Requirements == <!--T:5-->
 +
 +
<!--T:6-->
 
This guide assumes you are running '''RHEL (CentOS, Scientific Linux) 6''' on your system. Currently, this is a recommended platform to run OpenVZ on.
 
This guide assumes you are running '''RHEL (CentOS, Scientific Linux) 6''' on your system. Currently, this is a recommended platform to run OpenVZ on.
  
=== /vz file system ===
+
=== /vz file system === <!--T:7-->
  
 +
<!--T:8-->
 
It is recommended to use a separate partition for containers (by default '''/vz''') and format it to '''ext4'''.
 
It is recommended to use a separate partition for containers (by default '''/vz''') and format it to '''ext4'''.
  
=== yum pre-setup ===
+
=== yum pre-setup === <!--T:9-->
  
Download [http://ftp.openvz.org/openvz.repo openvz.repo] file and put it to your <code>/etc/yum.repos.d/</code> repository:
+
<!--T:10-->
 +
Download [https://download.openvz.org/openvz.repo openvz.repo] file and put it to your <code>/etc/yum.repos.d/</code> repository:
  
<pre><nowiki>wget -P /etc/yum.repos.d/ http://ftp.openvz.org/openvz.repo</nowiki></pre>
+
<!--T:11-->
 +
<pre><nowiki>wget -P /etc/yum.repos.d/ https://download.openvz.org/openvz.repo</nowiki></pre>
  
 +
<!--T:12-->
 
Import OpenVZ GPG key used for signing RPM packages:
 
Import OpenVZ GPG key used for signing RPM packages:
  
<pre><nowiki>rpm --import http://ftp.openvz.org/RPM-GPG-Key-OpenVZ</nowiki></pre>
+
<!--T:13-->
 +
<pre><nowiki>rpm --import http://download.openvz.org/RPM-GPG-Key-OpenVZ</nowiki></pre>
 +
 
 +
To make sure that you are downloading tamper free versions of the signed packages you should verify the fingerprint of the key you imported into the rpm key database as described on the [[Package signatures]] page.
 +
 
 +
== Kernel installation == <!--T:14-->
  
== Kernel installation ==
+
<!--T:15-->
 +
Limited OpenVZ functionality is supported when you run a recent 3.x kernel (check [[vzctl for upstream kernel]], so OpenVZ kernel installation is optional but still recommended.
  
  # yum install vzkernel
+
  <!--T:16-->
 +
# yum install vzkernel
  
== System configuration ==
+
== System configuration == <!--T:17-->
  
 +
<!--T:18-->
 
{{Note|With vzctl 4.4 or newer there is no need to do manual configuration. Skip to [[#Tools_installation]].}}
 
{{Note|With vzctl 4.4 or newer there is no need to do manual configuration. Skip to [[#Tools_installation]].}}
  
 +
<!--T:19-->
 
Please make sure the following steps are performed before rebooting into OpenVZ kernel.
 
Please make sure the following steps are performed before rebooting into OpenVZ kernel.
  
=== sysctl ===
+
=== sysctl === <!--T:20-->
  
 +
<!--T:21-->
 
There are a number of kernel parameters that should be set for OpenVZ to work correctly. These parameters are stored in <tt>/etc/sysctl.conf</tt> file. Here are the relevant portions of the file; please edit accordingly.
 
There are a number of kernel parameters that should be set for OpenVZ to work correctly. These parameters are stored in <tt>/etc/sysctl.conf</tt> file. Here are the relevant portions of the file; please edit accordingly.
  
 +
<!--T:22-->
 
<pre>
 
<pre>
 
# On Hardware Node we generally need
 
# On Hardware Node we generally need
Line 43: Line 66:
 
net.ipv4.conf.default.proxy_arp = 0
 
net.ipv4.conf.default.proxy_arp = 0
  
 +
<!--T:23-->
 
# Enables source route verification
 
# Enables source route verification
 
net.ipv4.conf.all.rp_filter = 1
 
net.ipv4.conf.all.rp_filter = 1
  
 +
<!--T:24-->
 
# Enables the magic-sysrq key
 
# Enables the magic-sysrq key
 
kernel.sysrq = 1
 
kernel.sysrq = 1
  
 +
<!--T:25-->
 
# We do not want all our interfaces to send redirects
 
# We do not want all our interfaces to send redirects
 
net.ipv4.conf.default.send_redirects = 1
 
net.ipv4.conf.default.send_redirects = 1
Line 54: Line 80:
 
</pre>
 
</pre>
  
=== SELinux ===
+
=== SELinux === <!--T:26-->
  
 +
<!--T:27-->
 
SELinux should be disabled. Put <code>SELINUX=disabled</code> to <code>/etc/sysconfig/selinux</code>:
 
SELinux should be disabled. Put <code>SELINUX=disabled</code> to <code>/etc/sysconfig/selinux</code>:
  
  echo "SELINUX=disabled" > /etc/sysconfig/selinux
+
  <!--T:28-->
 +
echo "SELINUX=disabled" > /etc/sysconfig/selinux
  
== Tools installation ==
+
== Tools installation == <!--T:29-->
  
 +
<!--T:30-->
 
{{Out|Before installing tools, please read about [[vzstats]] and opt-out if you don't want to help the project.}}
 
{{Out|Before installing tools, please read about [[vzstats]] and opt-out if you don't want to help the project.}}
  
 +
<!--T:31-->
 
OpenVZ needs some user-level tools installed:
 
OpenVZ needs some user-level tools installed:
  
  # yum install vzctl vzquota ploop
+
  <!--T:32-->
 +
# yum install vzctl vzquota ploop
  
== Reboot into OpenVZ ==
+
== Reboot into OpenVZ == <!--T:33-->
  
 +
<!--T:34-->
 
Now reboot the machine and choose "OpenVZ" on the boot loader menu (it should be default choice).
 
Now reboot the machine and choose "OpenVZ" on the boot loader menu (it should be default choice).
  
== Download OS templates ==
+
== Download OS templates == <!--T:35-->
  
 +
<!--T:36-->
 
An OS template is a Linux distribution installed into a container
 
An OS template is a Linux distribution installed into a container
 
and then packed into a gzipped tarball. Using such a cache, a new container
 
and then packed into a gzipped tarball. Using such a cache, a new container
 
can be created in a minute.
 
can be created in a minute.
  
 +
<!--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.
 
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.
  
== Next steps ==
+
== Next steps == <!--T:38-->
  
 +
<!--T:39-->
 
OpenVZ is now set up on your machine. Follow on to [[basic operations in OpenVZ environment]] document.
 
OpenVZ is now set up on your machine. Follow on to [[basic operations in OpenVZ environment]] document.
  
 
[[Category: Installation]]
 
[[Category: Installation]]
 
[[Category: HOWTO]]
 
[[Category: HOWTO]]

Latest revision as of 02:58, 27 November 2018

Warning.svg Warning: This article describes legacy version of OpenVZ. For current version, see Quick installation.

This document briefly describes the steps needed to install legacy OpenVZ on your RHEL 6 (CentOS 6, Scientific Linux 6) machine.

For Debian based systems, please see Installation on Debian.

A commercial version of OpenVZ is available, which simplifies installation with a single disk as well as supports networked installation using PXE boot. To learn more about Virtuozzo and request a free trial, please see https://virtuozzo.com/openvz/

Requirements[edit]

This guide assumes you are running RHEL (CentOS, Scientific Linux) 6 on your system. Currently, this is a recommended platform to run OpenVZ on.

/vz file system[edit]

It is recommended to use a separate partition for containers (by default /vz) and format it to ext4.

yum pre-setup[edit]

Download openvz.repo file and put it to your /etc/yum.repos.d/ repository:

wget -P /etc/yum.repos.d/ https://download.openvz.org/openvz.repo

Import OpenVZ GPG key used for signing RPM packages:

rpm --import http://download.openvz.org/RPM-GPG-Key-OpenVZ

To make sure that you are downloading tamper free versions of the signed packages you should verify the fingerprint of the key you imported into the rpm key database as described on the Package signatures page.

Kernel installation[edit]

Limited OpenVZ functionality is supported when you run a recent 3.x kernel (check vzctl for upstream kernel, so OpenVZ kernel installation is optional but still recommended.

  1. yum install vzkernel

System configuration[edit]

Yellowpin.svg Note: With vzctl 4.4 or newer there is no need to do manual configuration. Skip to #Tools_installation.

Please make sure the following steps are performed before rebooting into OpenVZ kernel.

sysctl[edit]

There are a number of kernel parameters that should be set for OpenVZ to work correctly. These parameters are stored in /etc/sysctl.conf file. Here are the relevant portions of the file; please edit accordingly.

# On Hardware Node we generally need
# packet forwarding enabled and proxy arp disabled
net.ipv4.ip_forward = 1
net.ipv6.conf.default.forwarding = 1
net.ipv6.conf.all.forwarding = 1
net.ipv4.conf.default.proxy_arp = 0

<!--T:23-->
# Enables source route verification
net.ipv4.conf.all.rp_filter = 1

<!--T:24-->
# Enables the magic-sysrq key
kernel.sysrq = 1

<!--T:25-->
# We do not want all our interfaces to send redirects
net.ipv4.conf.default.send_redirects = 1
net.ipv4.conf.all.send_redirects = 0

SELinux[edit]

SELinux should be disabled. Put SELINUX=disabled to /etc/sysconfig/selinux:

echo "SELINUX=disabled" > /etc/sysconfig/selinux

Tools installation[edit]

Before installing tools, please read about vzstats and opt-out if you don't want to help the project.

OpenVZ needs some user-level tools installed:

  1. yum install vzctl vzquota ploop

Reboot into OpenVZ[edit]

Now reboot the machine and choose "OpenVZ" on the boot loader menu (it should be default choice).

Download OS templates[edit]

An OS template is a Linux distribution installed into a container and then packed into a gzipped tarball. Using such a cache, a new container can be created in a minute.

Download precreated template caches from Downloads » Templates » Precreated, or directly from download.openvz.org/template/precreated, or from one of the mirrors. Put those tarballs as-is (no unpacking needed) to the /vz/template/cache/ directory.

Next steps[edit]

OpenVZ is now set up on your machine. Follow on to basic operations in OpenVZ environment document.