OpenVZ Virtuozzo Containers Wiki - User contributions [en]

Plesk in VE

2007-01-04T21:17:09Z

Thatha:

Below is an example transcript of installing Plesk into an OpenVZ VE (VE#11):

<pre>
# vzctl create 11 --ostemplate centos-4-i386-default
Creating VPS private area: /vz/private/11
Performing postcreate actions
VPS private area was created

# vzctl set 11 --quotaugidlimit 150 --save
Saved parameters for VPS 11

# vzctl set 11 --numproc 400:400 --save
Saved parameters for VPS 11

# vzctl set 11 --kmemsize 16384000:18022400 --save
Saved parameters for VPS 11

# vzctl set 11 --privvmpages 262144:292912 --save
Saved parameters for VPS 11

# vzctl set 11 --hostname=plesk.example.com --save
Saved parameters for VPS 11

# vzctl set 11 --diskspace 2000000:2000000 --save
Saved parameters for VPS 11

# vzctl set 11 --shmpages 16384:16384 --save
UB limits were set successefully

# vzctl set 11 --ipadd 127.1.2.3 --save
Saved parameters for VPS 11

# vzctl set 11 --userpasswd root:pass
Changing password for user root.
passwd: all authentication tokens updated successfully.

# vzctl set 11 --iptables "iptable_filter iptable_mangle ipt_limit ipt_multiport ipt_tos ipt_TOS ipt_REJECT ipt_TCPMSS ipt_tcpmss ipt_ttl ipt_LOG ipt_length ip_conntrack ip_conntrack_ftp ip_conntrack_irc ipt_conntrack ipt_state ipt_helper iptable_nat ip_nat_ftp ip_nat_irc" --save
Saved parameters for VPS 11

# vzctl start 11
Starting VPS ...
VPS is mounted
Adding IP address(es): 192.168.51.55
Setting CPU units: 1000
Set hostname: plesk.local
Setting quota ugidlimit: 150
VPS start in progress...
</pre>

If you want to run a VPN server inside the VE you need to [[VPN via the TUN/TAP device|TUN/TAP module]]. The following commands consolidate what needs to be done:
<pre>
# modprobe tun
# lsmod | grep tun
tun 6624 0
# vzctl set 11 --devices c:10:200:rw --save
Setting devices
Saved parameters for VPS 11
# vzctl exec 11 mkdir -p /dev/net
# vzctl exec 11 mknod /dev/net/tun c 10 200
# vzctl exec 11 chmod 600 /dev/net/tun
</pre>

Make sure that the VE's hostname (plesk.example.com) is resolving correctly to the VE's IP address (127.1.2.3). You can also add the corresponding record to /etc/hosts as a workaround.

Then, go to http://www.swsoft.com/download/plesk8/ and download the appropriate autoinstaller or the appropriate RPM. In this case, [[http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386|CentOS]] 4.3.

If you want to download the autoinstaller all you need to do is:
<pre>
# cp -f /etc/resolv.conf /vz/private/11/etc/resolv.conf
# vzctl enter 11
entered into VE 11
# cd
# wget http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
# chmod a+x psa*
# ./psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
</pre>

Proceed as you would if you were installing Plesk without OpenVZ.

When the installation over you will see something along the lines of:
<pre>
Congratulations!
Plesk has been successfully installed on your server.
To complete the system configuration, please proceed to URL:
https://plesk.local:8443/ or
https://127.0.0.1:8443/
Use the login name 'admin' and password 'setup'.

Further, use the following commands to start and stop Plesk:
"/etc/init.d/psa start" and
"/etc/init.d/psa stop" respectively.

All Plesk control panel documentation is available at
http://www.swsoft.com/en/products/plesk80/docs

*****************************************************************************
* *
* NOTE: You have a default key file with limited functionality *
* currently installed for Plesk, which allows *
* creating one client account, one domain, one mail name and *
* one web user. *
* To extend the limits of your license key and enable *
* additional features, please contact the SWsoft, Inc. sales *
* department: sales@swsoft.com *
* *
* Thank you for choosing our products! *
*****************************************************************************
</pre>
[[Plesk install full output]]

Done. You can create a [[Debian_template_creation#Preparing_for_and_packing_template_cache|prepackaged template]] from this VE for future installations.

[[category:HOWTO]]

Plesk in VE

2007-01-04T20:51:20Z

Thatha: Oops! Should've used preview.

Below is an example transcript of installing Plesk into an OpenVZ VE (VE#11):

<pre>
# vzctl create 11 --ostemplate centos-4-i386-default
Creating VPS private area: /vz/private/11
Performing postcreate actions
VPS private area was created

# vzctl set 11 --quotaugidlimit 150 --save
Saved parameters for VPS 11

# vzctl set 11 --numproc 400:400 --save
Saved parameters for VPS 11

# vzctl set 11 --kmemsize 16384000:18022400 --save
Saved parameters for VPS 11

# vzctl set 11 --privvmpages 262144:292912 --save
Saved parameters for VPS 11

# vzctl set 11 --hostname=plesk.example.com --save
Saved parameters for VPS 11

# vzctl set 11 --diskspace 2000000:2000000 --save
Saved parameters for VPS 11

# vzctl set 11 --shmpages 16384:16384 --save
UB limits were set successefully

# vzctl set 11 --ipadd 127.1.2.3 --save
Saved parameters for VPS 11

# vzctl set 11 --userpasswd root:pass
Changing password for user root.
passwd: all authentication tokens updated successfully.

# vzctl set 11 --iptables "iptable_filter iptable_mangle ipt_limit ipt_multiport ipt_tos ipt_TOS ipt_REJECT ipt_TCPMSS ipt_tcpmss ipt_ttl ipt_LOG ipt_length ip_conntrack ip_conntrack_ftp ip_conntrack_irc ipt_conntrack ipt_state ipt_helper iptable_nat ip_nat_ftp ip_nat_irc" --save
Saved parameters for VPS 11

# vzctl start 11
Starting VPS ...
VPS is mounted
Adding IP address(es): 192.168.51.55
Setting CPU units: 1000
Set hostname: plesk.local
Setting quota ugidlimit: 150
VPS start in progress...
</pre>

If you want to run a VPN server inside the VE you need to [[VPN via the TUN/TAP device|TUN/TAP module]]. The following commands consolidate what needs to be done:
<pre>
# modprobe tun
# lsmod | grep tun
tun 6624 0
# vzctl set 11 --devices c:10:200:rw --save
Setting devices
Saved parameters for VPS 11
# vzctl exec 11 mkdir -p /dev/net
# vzctl exec 11 mknod /dev/net/tun c 10 200
# vzctl exec 11 chmod 600 /dev/net/tun
</pre>

Make sure that the VE's hostname (plesk.example.com) is resolving correctly to the VE's IP address (127.1.2.3). You can also add the corresponding record to /etc/hosts as a workaround.

Then, go to http://www.swsoft.com/download/plesk8/ and download the appropriate autoinstaller or the appropriate RPM. In this case, [[http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386|CentOS]] 4.3.

If you want to download the autoinstaller all you need to do is:
<pre>
# wget http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
# mv psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386 /vz/private/11/root/
# vzctl exec 11 /root/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
</pre>

Proceed as you would if you were installing Plesk without OpenVZ.

When the installation over you will see something along the lines of:
<pre>
Congratulations!
Plesk has been successfully installed on your server.
To complete the system configuration, please proceed to URL:
https://plesk.local:8443/ or
https://127.0.0.1:8443/
Use the login name 'admin' and password 'setup'.

Further, use the following commands to start and stop Plesk:
"/etc/init.d/psa start" and
"/etc/init.d/psa stop" respectively.

All Plesk control panel documentation is available at
http://www.swsoft.com/en/products/plesk80/docs

*****************************************************************************
* *
* NOTE: You have a default key file with limited functionality *
* currently installed for Plesk, which allows *
* creating one client account, one domain, one mail name and *
* one web user. *
* To extend the limits of your license key and enable *
* additional features, please contact the SWsoft, Inc. sales *
* department: sales@swsoft.com *
* *
* Thank you for choosing our products! *
*****************************************************************************
</pre>
[[Plesk install full output]]

Done. You can create a [[Debian_template_creation#Preparing_for_and_packing_template_cache|prepackaged template]] from this VE for future installations.

[[category:HOWTO]]

Plesk in VE

2007-01-04T20:50:43Z

Thatha: Added link to Debian_template_creation#Preparing_for_and_packing_template_cache

Below is an example transcript of installing Plesk into an OpenVZ VE (VE#11):

<pre>
# vzctl create 11 --ostemplate centos-4-i386-default
Creating VPS private area: /vz/private/11
Performing postcreate actions
VPS private area was created

# vzctl set 11 --quotaugidlimit 150 --save
Saved parameters for VPS 11

# vzctl set 11 --numproc 400:400 --save
Saved parameters for VPS 11

# vzctl set 11 --kmemsize 16384000:18022400 --save
Saved parameters for VPS 11

# vzctl set 11 --privvmpages 262144:292912 --save
Saved parameters for VPS 11

# vzctl set 11 --hostname=plesk.example.com --save
Saved parameters for VPS 11

# vzctl set 11 --diskspace 2000000:2000000 --save
Saved parameters for VPS 11

# vzctl set 11 --shmpages 16384:16384 --save
UB limits were set successefully

# vzctl set 11 --ipadd 127.1.2.3 --save
Saved parameters for VPS 11

# vzctl set 11 --userpasswd root:pass
Changing password for user root.
passwd: all authentication tokens updated successfully.

# vzctl set 11 --iptables "iptable_filter iptable_mangle ipt_limit ipt_multiport ipt_tos ipt_TOS ipt_REJECT ipt_TCPMSS ipt_tcpmss ipt_ttl ipt_LOG ipt_length ip_conntrack ip_conntrack_ftp ip_conntrack_irc ipt_conntrack ipt_state ipt_helper iptable_nat ip_nat_ftp ip_nat_irc" --save
Saved parameters for VPS 11

# vzctl start 11
Starting VPS ...
VPS is mounted
Adding IP address(es): 192.168.51.55
Setting CPU units: 1000
Set hostname: plesk.local
Setting quota ugidlimit: 150
VPS start in progress...
</pre>

If you want to run a VPN server inside the VE you need to [[VPN via the TUN/TAP device|TUN/TAP module]]. The following commands consolidate what needs to be done:
<pre>
# modprobe tun
# lsmod | grep tun
tun 6624 0
# vzctl set 11 --devices c:10:200:rw --save
Setting devices
Saved parameters for VPS 11
# vzctl exec 11 mkdir -p /dev/net
# vzctl exec 11 mknod /dev/net/tun c 10 200
# vzctl exec 11 chmod 600 /dev/net/tun
</pre>

Make sure that the VE's hostname (plesk.example.com) is resolving correctly to the VE's IP address (127.1.2.3). You can also add the corresponding record to /etc/hosts as a workaround.

Then, go to http://www.swsoft.com/download/plesk8/ and download the appropriate autoinstaller or the appropriate RPM. In this case, [[http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386|CentOS]] 4.3.

If you want to download the autoinstaller all you need to do is:
<pre>
# wget http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
# mv psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386 /vz/private/11/root/
# vzctl exec 11 /root/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
</pre>

Proceed as you would if you were installing Plesk without OpenVZ.

When the installation over you will see something along the lines of:
<pre>
Congratulations!
Plesk has been successfully installed on your server.
To complete the system configuration, please proceed to URL:
https://plesk.local:8443/ or
https://127.0.0.1:8443/
Use the login name 'admin' and password 'setup'.

Further, use the following commands to start and stop Plesk:
"/etc/init.d/psa start" and
"/etc/init.d/psa stop" respectively.

All Plesk control panel documentation is available at
http://www.swsoft.com/en/products/plesk80/docs

*****************************************************************************
* *
* NOTE: You have a default key file with limited functionality *
* currently installed for Plesk, which allows *
* creating one client account, one domain, one mail name and *
* one web user. *
* To extend the limits of your license key and enable *
* additional features, please contact the SWsoft, Inc. sales *
* department: sales@swsoft.com *
* *
* Thank you for choosing our products! *
*****************************************************************************
</pre>
[[Plesk install full output]]

Done. You can create a [[Debian_template_creation#Preparing_for_and_packing_template_cache]]prepackaged template from this VE for future installations.

[[category:HOWTO]]

Plesk in VE

2007-01-04T20:45:28Z

Thatha: Various edits, fixes and updates.

Below is an example transcript of installing Plesk into an OpenVZ VE (VE#11):

<pre>
# vzctl create 11 --ostemplate centos-4-i386-default
Creating VPS private area: /vz/private/11
Performing postcreate actions
VPS private area was created

# vzctl set 11 --quotaugidlimit 150 --save
Saved parameters for VPS 11

# vzctl set 11 --numproc 400:400 --save
Saved parameters for VPS 11

# vzctl set 11 --kmemsize 16384000:18022400 --save
Saved parameters for VPS 11

# vzctl set 11 --privvmpages 262144:292912 --save
Saved parameters for VPS 11

# vzctl set 11 --hostname=plesk.example.com --save
Saved parameters for VPS 11

# vzctl set 11 --diskspace 2000000:2000000 --save
Saved parameters for VPS 11

# vzctl set 11 --shmpages 16384:16384 --save
UB limits were set successefully

# vzctl set 11 --ipadd 127.1.2.3 --save
Saved parameters for VPS 11

# vzctl set 11 --userpasswd root:pass
Changing password for user root.
passwd: all authentication tokens updated successfully.

# vzctl set 11 --iptables "iptable_filter iptable_mangle ipt_limit ipt_multiport ipt_tos ipt_TOS ipt_REJECT ipt_TCPMSS ipt_tcpmss ipt_ttl ipt_LOG ipt_length ip_conntrack ip_conntrack_ftp ip_conntrack_irc ipt_conntrack ipt_state ipt_helper iptable_nat ip_nat_ftp ip_nat_irc" --save
Saved parameters for VPS 11

# vzctl start 11
Starting VPS ...
VPS is mounted
Adding IP address(es): 192.168.51.55
Setting CPU units: 1000
Set hostname: plesk.local
Setting quota ugidlimit: 150
VPS start in progress...
</pre>

If you want to run a VPN server inside the VE you need to [[VPN via the TUN/TAP device|TUN/TAP module]]. The following commands consolidate what needs to be done:
<pre>
# modprobe tun
# lsmod | grep tun
tun 6624 0
# vzctl set 11 --devices c:10:200:rw --save
Setting devices
Saved parameters for VPS 11
# vzctl exec 11 mkdir -p /dev/net
# vzctl exec 11 mknod /dev/net/tun c 10 200
# vzctl exec 11 chmod 600 /dev/net/tun
</pre>

Make sure that the VE's hostname (plesk.example.com) is resolving correctly to the VE's IP address (127.1.2.3). You can also add the corresponding record to /etc/hosts as a workaround.

Then, go to http://www.swsoft.com/download/plesk8/ and download the appropriate autoinstaller or the appropriate RPM. In this case, [[http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386|CentOS]] 4.3.

If you want to download the autoinstaller all you need to do is:
<pre>
# wget http://download1.swsoft.com/Plesk/Plesk8.1/CentOS4.3/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
# mv psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386 /vz/private/11/root/
# vzctl exec 11 /root/psa_installer_v3.1.0_build061201.02_os_CentOS_4.3_i386
</pre>

Proceed as you would if you were installing Plesk without OpenVZ.

When the installation over you will see something along the lines of:
<pre>
Congratulations!
Plesk has been successfully installed on your server.
To complete the system configuration, please proceed to URL:
https://plesk.local:8443/ or
https://127.0.0.1:8443/
Use the login name 'admin' and password 'setup'.

Further, use the following commands to start and stop Plesk:
"/etc/init.d/psa start" and
"/etc/init.d/psa stop" respectively.

All Plesk control panel documentation is available at
http://www.swsoft.com/en/products/plesk80/docs

*****************************************************************************
* *
* NOTE: You have a default key file with limited functionality *
* currently installed for Plesk, which allows *
* creating one client account, one domain, one mail name and *
* one web user. *
* To extend the limits of your license key and enable *
* additional features, please contact the SWsoft, Inc. sales *
* department: sales@swsoft.com *
* *
* Thank you for choosing our products! *
*****************************************************************************
</pre>
[[Plesk install full output]]

Done. You can create a prepackaged template from this VE for further installations.

[[category:HOWTO]]

OS template cache preparation

2006-10-17T02:40:08Z

Thatha: Missed a tag

This article describes the procedure of an OS template cache creation. Is assumes you already have OpenVZ installed and running. The steps needed to achieve it are documented in the [[Quick installation]] document.

== Terminology ==

Please make sure you understand these terms:

* [[OS template]]
* [[OS template metadata]]
* [[OS template cache]]

== Creating an OS template cache ==
You can create an [[OS template cache]] using template utilities and [[OS template metadata]] right on your [[hardware node]]. The process it automated and will take from about 10 minutes to a few hours, depending on the network speed, and the result will be most up-to-date template cache.

=== Installing template utilities ===

You have to install a few packages in order to be able to create/update OS template cache(s).

==== Using yum ====
<pre>
# yum install vzpkg vzyum vzrpm43-python vzrpm44-python
</pre>

==== Using rpm ====
Packages are available from [http://openvz.org/download/template/utils/ Download » Templates » Utilities]. You need both <tt>vzpkg</tt> and <tt>vzyum</tt> packages, as well as one or both <tt>vzrpm43</tt>/<tt>vzrpm44</tt> (including their <tt>-python</tt> counterparts), depending on the OS templates being used.

Install these utilities using rpm:

<pre>
# rpm -ihv vzpkg*.rpm vzyum*.rpm vzrpm44*.rpm
</pre>

In Red Hat Enterprise Linux, to install <tt>vzyum</tt> you will need <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-elementtree&system=redhat python-elementtree]</tt>, <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-sqlite&system=redhat python-sqlite]</tt>, and <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-urlgrabber&system=redhat python-urlgrabber]</tt>. These packages might have dependencies of their own. For example, <tt>python-sqlite</tt> needs <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=sqlite&system=redhat sqlite]</tt>.

=== Installing OS template metadata ===

To create an [[OS template cache]], you need to get the [[OS template metadata|metadata]] for the chosen OS template(s).

==== Using yum ====
To see which templates are available, run
<pre>
# yum search vztmpl
</pre>

To install some of the templates, run
<pre>
# yum install vztmpl-XXX [...]
</pre>

==== Using rpm ====
Get the chosen <tt>vztmpl-*</tt> packages from [http://openvz.org/download/template/metadata/ Downloads » Templates » Metadata] (or directly from [http://download.openvz.org/template/metadata/ download.openvz.org/template/metadata] or one of the [[Download mirrors|mirrors]] and install them:

<pre>
# rpm -ihv vztmpl-*.rpm
</pre>

=== Installing repository cache (optional) ===

Optionally, you may want to get a snapshot of the local copy of the package repository for the chosen OS template(s). This is not required but might speed up the initial OS template cache creation considerably. The tarballs are available from [http://openvz.org/download/template/repocache/ Downloads » Templates » Repo Cache]; download and untar them to the <tt>/vz/template</tt> directory on your OpenVZ [[Hardware Node]]. If you choose to skip this step, all the needed files will be downloaded from the Internet automatically when needed.

=== Running <tt>vzpkgcache</tt> ===

Run the <tt>vzpkgcache</tt> utility; see the vzpkgcache(8) man page for details. It will create or update the caches of all the templates for which the corresponding metadata exist.

== Alternative: use precreated template cache ==

As an alternative to creating a cache using template metadata, you can use precreated template cache taken 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]].

However, this option is not recommended for production systems since without installing template metadata you will not be able to update your template cache.

In order to use precreated template cache files, download files for chosen OS distributions and place them as-is (no unpacking needed) to the <tt>/vz/template/cache</tt> directory.

== Next step ==

Follow on to the [[VE creation]] article.

[[Category: Installation]]
[[Category: Templates]]

OS template cache preparation

2006-10-17T02:34:42Z

Thatha: /* Using rpm */ Added reference to sqlite.

This article describes the procedure of an OS template cache creation. Is assumes you already have OpenVZ installed and running. The steps needed to achieve it are documented in the [[Quick installation]] document.

== Terminology ==

Please make sure you understand these terms:

* [[OS template]]
* [[OS template metadata]]
* [[OS template cache]]

== Creating an OS template cache ==
You can create an [[OS template cache]] using template utilities and [[OS template metadata]] right on your [[hardware node]]. The process it automated and will take from about 10 minutes to a few hours, depending on the network speed, and the result will be most up-to-date template cache.

=== Installing template utilities ===

You have to install a few packages in order to be able to create/update OS template cache(s).

==== Using yum ====
<pre>
# yum install vzpkg vzyum vzrpm43-python vzrpm44-python
</pre>

==== Using rpm ====
Packages are available from [http://openvz.org/download/template/utils/ Download » Templates » Utilities]. You need both <tt>vzpkg</tt> and <tt>vzyum</tt> packages, as well as one or both <tt>vzrpm43</tt>/<tt>vzrpm44</tt> (including their <tt>-python</tt> counterparts), depending on the OS templates being used.

Install these utilities using rpm:

<pre>
# rpm -ihv vzpkg*.rpm vzyum*.rpm vzrpm44*.rpm
</pre>

In Red Hat Enterprise Linux, to install <tt>vzyum</tt> you will need <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-elementtree&system=redhat python-elementtree]</tt>, <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-sqlite&system=redhat python-sqlite]</tt>, and <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-urlgrabber&system=redhat python-urlgrabber]</tt>. These packages might have dependencies of their own. For example, <tt>python-sqlite</tt> needs <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=sqlite&system=redhat sqlite].

=== Installing OS template metadata ===

To create an [[OS template cache]], you need to get the [[OS template metadata|metadata]] for the chosen OS template(s).

==== Using yum ====
To see which templates are available, run
<pre>
# yum search vztmpl
</pre>

To install some of the templates, run
<pre>
# yum install vztmpl-XXX [...]
</pre>

==== Using rpm ====
Get the chosen <tt>vztmpl-*</tt> packages from [http://openvz.org/download/template/metadata/ Downloads » Templates » Metadata] (or directly from [http://download.openvz.org/template/metadata/ download.openvz.org/template/metadata] or one of the [[Download mirrors|mirrors]] and install them:

<pre>
# rpm -ihv vztmpl-*.rpm
</pre>

=== Installing repository cache (optional) ===

Optionally, you may want to get a snapshot of the local copy of the package repository for the chosen OS template(s). This is not required but might speed up the initial OS template cache creation considerably. The tarballs are available from [http://openvz.org/download/template/repocache/ Downloads » Templates » Repo Cache]; download and untar them to the <tt>/vz/template</tt> directory on your OpenVZ [[Hardware Node]]. If you choose to skip this step, all the needed files will be downloaded from the Internet automatically when needed.

=== Running <tt>vzpkgcache</tt> ===

Run the <tt>vzpkgcache</tt> utility; see the vzpkgcache(8) man page for details. It will create or update the caches of all the templates for which the corresponding metadata exist.

== Alternative: use precreated template cache ==

As an alternative to creating a cache using template metadata, you can use precreated template cache taken 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]].

However, this option is not recommended for production systems since without installing template metadata you will not be able to update your template cache.

In order to use precreated template cache files, download files for chosen OS distributions and place them as-is (no unpacking needed) to the <tt>/vz/template/cache</tt> directory.

== Next step ==

Follow on to the [[VE creation]] article.

[[Category: Installation]]
[[Category: Templates]]

OS template cache preparation

2006-10-17T02:32:28Z

Thatha: Added reference to vzyum's prerequisites

This article describes the procedure of an OS template cache creation. Is assumes you already have OpenVZ installed and running. The steps needed to achieve it are documented in the [[Quick installation]] document.

== Terminology ==

Please make sure you understand these terms:

* [[OS template]]
* [[OS template metadata]]
* [[OS template cache]]

== Creating an OS template cache ==
You can create an [[OS template cache]] using template utilities and [[OS template metadata]] right on your [[hardware node]]. The process it automated and will take from about 10 minutes to a few hours, depending on the network speed, and the result will be most up-to-date template cache.

=== Installing template utilities ===

You have to install a few packages in order to be able to create/update OS template cache(s).

==== Using yum ====
<pre>
# yum install vzpkg vzyum vzrpm43-python vzrpm44-python
</pre>

==== Using rpm ====
Packages are available from [http://openvz.org/download/template/utils/ Download » Templates » Utilities]. You need both <tt>vzpkg</tt> and <tt>vzyum</tt> packages, as well as one or both <tt>vzrpm43</tt>/<tt>vzrpm44</tt> (including their <tt>-python</tt> counterparts), depending on the OS templates being used.

Install these utilities using rpm:

<pre>
# rpm -ihv vzpkg*.rpm vzyum*.rpm vzrpm44*.rpm
</pre>

In Red Hat Enterprise Linux, to install <tt>vzyum</tt> you will need <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-elementtree&system=redhat python-elementtree]</tt>, <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-sqlite&system=redhat python-sqlite]</tt>, and <tt>[http://rpmfind.net/linux/rpm2html/search.php?query=python-urlgrabber&system=redhat python-urlgrabber]</tt>.

=== Installing OS template metadata ===

To create an [[OS template cache]], you need to get the [[OS template metadata|metadata]] for the chosen OS template(s).

==== Using yum ====
To see which templates are available, run
<pre>
# yum search vztmpl
</pre>

To install some of the templates, run
<pre>
# yum install vztmpl-XXX [...]
</pre>

==== Using rpm ====
Get the chosen <tt>vztmpl-*</tt> packages from [http://openvz.org/download/template/metadata/ Downloads » Templates » Metadata] (or directly from [http://download.openvz.org/template/metadata/ download.openvz.org/template/metadata] or one of the [[Download mirrors|mirrors]] and install them:

<pre>
# rpm -ihv vztmpl-*.rpm
</pre>

=== Installing repository cache (optional) ===

Optionally, you may want to get a snapshot of the local copy of the package repository for the chosen OS template(s). This is not required but might speed up the initial OS template cache creation considerably. The tarballs are available from [http://openvz.org/download/template/repocache/ Downloads » Templates » Repo Cache]; download and untar them to the <tt>/vz/template</tt> directory on your OpenVZ [[Hardware Node]]. If you choose to skip this step, all the needed files will be downloaded from the Internet automatically when needed.

=== Running <tt>vzpkgcache</tt> ===

Run the <tt>vzpkgcache</tt> utility; see the vzpkgcache(8) man page for details. It will create or update the caches of all the templates for which the corresponding metadata exist.

== Alternative: use precreated template cache ==

As an alternative to creating a cache using template metadata, you can use precreated template cache taken 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]].

However, this option is not recommended for production systems since without installing template metadata you will not be able to update your template cache.

In order to use precreated template cache files, download files for chosen OS distributions and place them as-is (no unpacking needed) to the <tt>/vz/template/cache</tt> directory.

== Next step ==

Follow on to the [[VE creation]] article.

[[Category: Installation]]
[[Category: Templates]]