OpenVZ Virtuozzo Containers Wiki - User contributions [en]

Using vzpkg and vzyum on x86 64

2011-01-30T18:20:48Z

Mcarreira:

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: [[User:Mcarreira|Mcarreira]] 18:07, 30 January 2011 (UTC)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has its own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.6.tar.gz setx86_64-0.6] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.6.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

{{ Note |In setx86_64 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.}}

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| 1) With these changes, vzyum won´t be able to use a common cache directory to all [[container]]s as it used to do. Each [[container]] will have its own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.

2) To set up a common cache directory, you can use the autofs/automounter daemon together with [[Bind_mounts]] as described in step 12. Using a shared cache may save a lot of network traffic when installing new VPSs.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64 script, line 334 to line 358, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 97:
{{Note| '''ve-vps.basic.conf-sample''' is now renamed '''ve-basic.conf-sample''' }}
(see [http://bugzilla.openvz.org/show_bug.cgi?id=1694 bug 1694] )

<pre>
change: VECFGSAMPLE=$VECFGDIR/ve-vps.basic.conf-sample
to: VECFGSAMPLE=$VECFGDIR/ve-basic.conf-sample
append: if ! [ -f "$VECFGSAMPLE" ]; then VECFGSAMPLE="$VECGFDIR/ve-vps.basic.conf-sample"; fi
</pre>

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 154:
<pre>
append: mkdir -p $VE_ROOT/var/lib/yum/ || abort "Can't create /var/lib/yum"
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 20:
<pre>
change: VZLIB_SCRIPTDIR=/usr/lib/vzctl/scripts
to: VZLIB_SCRIPTDIR=/usr/lib64/vzctl/scripts
</pre>

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

===== STEP 12 =====

To share the vzyum cache directory between various [[containers]], after all is set up, edit your /etc/auto.master to include the following:
:<code>/vz/root/{vpsid}/var/cache/yum-cache /etc/auto.vzyum</code>
Include one line for each installed or planned VPS, replacing {vpsid} with the adequate value.

Then, create a /etc/auto.vzyum file with only this line:
:<code>* -bind,ro,nosuid,nodev :/var/cache/yum-cache/&</code>
This file won´t need to be changed, even after you add more containers.
Restart the automounter daemon.

{{Note| Make sure these changes won´t interfere with other automounts you may already have set up. If you don´t already use autofs/automount, it is safe to comment out other settings in auto.master.}}

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2011-01-30T18:07:10Z

Mcarreira:

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: [[User:Mcarreira|Mcarreira]] 18:07, 30 January 2011 (UTC)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has its own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.6.tar.gz setx86_64-0.6] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.6.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

{{ Note |In setx86_64 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.}}

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| 1) With these changes, vzyum won´t be able to use a common cache directory to all [[container]]s as it used to do. Each [[container]] will have its own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.

2) To set up a common cache directory, you can use the autofs/automounter daemon together with [[Bind_mounts]] as described in step 12. Using a shared cache may save a lot of network traffic when installing new VPSs.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64 script, line 334 to line 358, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 97:
{{Note| '''ve-vps.basic.conf-sample''' is now renamed '''ve-basic.conf-sample''' (see bug:[[ http://bugzilla.openvz.org/show_bug.cgi?id=1694 ]]) }}

<pre>
change: VECFGSAMPLE=$VECFGDIR/ve-vps.basic.conf-sample
to: VECFGSAMPLE=$VECFGDIR/ve-basic.conf-sample
append: if ! [ -f "$VECFGSAMPLE" ]; then VECFGSAMPLE="$VECGFDIR/ve-vps.basic.conf-sample"; fi
</pre>

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 154:
<pre>
append: mkdir -p $VE_ROOT/var/lib/yum/ || abort "Can't create /var/lib/yum"
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 20:
<pre>
change: VZLIB_SCRIPTDIR=/usr/lib/vzctl/scripts
to: VZLIB_SCRIPTDIR=/usr/lib64/vzctl/scripts
</pre>

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

===== STEP 12 =====

To share the vzyum cache directory between various [[containers]], after all is set up, edit your /etc/auto.master to include the following:
:<code>/vz/root/{vpsid}/var/cache/yum-cache /etc/auto.vzyum</code>
Include one line for each installed or planned VPS, replacing {vpsid} with the adequate value.

Then, create a /etc/auto.vzyum file with only this line:
:<code>* -bind,ro,nosuid,nodev :/var/cache/yum-cache/&</code>
This file won´t need to be changed, even after you add more containers.
Restart the automounter daemon.

{{Note| Make sure these changes won´t interfere with other automounts you may already have set up. If you don´t already use autofs/automount, it is safe to comment out other settings in auto.master.}}

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2009-03-05T11:56:27Z

Mcarreira: new script setx86_64-0.5 with fedora-9. Some other corrections

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: 11:55, 5 Mar 2009 (EST)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.5.tar.gz setx86_64-0.5] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.5.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

Note: In setx86-0.3 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all [[container]]s as it was used to do. Each [[container]] will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64-0.3 script, line 320 to line 345, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 154:
<pre>
append: mkdir -p $VE_ROOT/var/lib/yum/ || abort "Can't create /var/lib/yum"
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 20:
<pre>
change: VZLIB_SCRIPTDIR=/usr/lib/vzctl/scripts
to: VZLIB_SCRIPTDIR=/usr/lib64/vzctl/scripts
</pre>

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2009-03-04T15:07:07Z

Mcarreira: Corrected LINE 154 of cache-os

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: 17:46, 1 Mar 2009 (EST)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.4-1.tar.gz setx86_64-0.4-1] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.4-1.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

Note: In setx86-0.3 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all [[container]]s as it was used to do. Each [[container]] will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64-0.3 script, line 320 to line 345, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 154:
<pre>
append: mkdir -p $VE_ROOT/var/lib/yum/ || abort "Can't create /var/lib/yum"
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2009-03-01T17:47:36Z

Mcarreira: new setx86_64-0.4-1 version

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: 17:46, 1 Mar 2009 (EST)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.4-1.tar.gz setx86_64-0.4-1] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.4-1.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

Note: In setx86-0.3 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all [[container]]s as it was used to do. Each [[container]] will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64-0.3 script, line 320 to line 345, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 154:
<pre>
append: mkdir -p $VE_ROOT/proc || abort "Can't create dir $VE_ROOT/proc"
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2009-02-28T04:01:04Z

Mcarreira:

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: 04:10, 28 Feb 2009 (EST)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.4.tar.gz setx86_64-0.4] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.4.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

Note: In setx86-0.3 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all [[container]]s as it was used to do. Each [[container]] will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64-0.3 script, line 320 to line 345, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 154:
<pre>
append: mkdir -p $VE_ROOT/proc || abort "Can't create dir $VE_ROOT/proc"
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2009-02-28T03:59:51Z

Mcarreira: new script setx86_64-0.4. Minor corrections

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: 08:10, 3 March 2008 (EST)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.4.tar.gz setx86_64-0.4] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.4.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

Note: In setx86-0.3 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all [[container]]s as it was used to do. Each [[container]] will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64-0.3 script, line 320 to line 345, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 154:
<pre>
append: mkdir -p $VE_ROOT/proc || abort "Can't create dir $VE_ROOT/proc"
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2008-03-03T13:10:52Z

Mcarreira:

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a host with Centos-4, Centos-5, Fedora Core 5, Fedora Core 6, RHEL 4 or any other RPM based based system with python 2.2, 2.3 or 2.4 version.

Last Revision: 08:10, 3 March 2008 (EST)

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each [[container]] using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - A host with x86_64 Centos, Fedora Core or RHEL, or other Redhat based systems with python 2.2, 2.3 or 2.4 version (vzrpm is unable to run with python 2.5 version)
* - Yum package installed.

== TESTED HOSTS ==

* - Centos 4
* - Centos 5
* - Fedora Core 5
* - Fedora Core 6

== HOSTS PROBABLY WORKING (not tested) ==

* - RHEL 4
* - RHEL 5

== HOSTS NOT WORKING ==

* - Older distros with yum version less then 2.4, python version less then 2.2, rpm version less then 4.3
* - Fedora 7
* - Fedora 8
* - Or any other system with python 2.5 or above.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all [[container]]s. Instead, each [[container]] has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM.
* This process uses a bash script which automates all the hard work made by hand in the manual install. It was successfully tested in several systems.
* If something goes wrong, or if you want to understand the way it works to install a diferent distribution, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.3.tar.gz setx86_64-0.3] and then untar and run the script:

<pre>
tar xzvf setx86_64-0.3.tar.gz
sh setx86_64
</pre>

Press Enter and some tests are made to know if you can go on with the installation.
If you choose to go on with it, the script will download and patch everything for you.
All the vztemplates metadata available in openvz.org site are also installed and fixed for x86_64 system.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_11|STEP 11]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error: 
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedora or other distribution with yum, rpm and python (version 2.2, 2.3 or 2.4) installed, may be tried. You only have to change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

Install "vztmpl-centos-4":

<code>
yum install vztmpl-centos-4
</code>

Note: In setx86-0.3 script, all the vztemplates available in openvz.org site are downloaded and used to build x86_64 templates, ready to be used.

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.
We only have to replace i386 references with x86_64 in all files.

<code>
cd /vz/template/centos/4/
cp -a i386 x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed. 
You can do the same procedure to other distro templates.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

:<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

:to

:<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all [[container]]s as it was used to do. Each [[container]] will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each [[container]], it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

Verify the host rpm version:

:<code>rpm --version</code>

In Centos-4 rpm is version 4.3.

Edit this file /vz/template/centos/4/x86_64/config/rpm, and
you will see the number 43.

When the host distro is the same of the template guest, everything would be correct, and we don't need doing anything. 
But if we have a different guest template, we might have to correct the values.

We have to change the number inside /vz/template/distro/version/x86_64/config/rpm
according to the rpm version of the host system. 
If rpm version is 4.4 the number would be 44. 
If rpm version is 4.3 the number would be 43.

===== STEP 5 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>
This avoids the undesirable update of special MAKEDEV-swsoft to the real MAKEDEV from the distro yum repository during a vzyum action.

===== STEP 6 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

In Centos-4 version python is 2.3. So, we must replace rpmmodule.so from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides.

<pre>

cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

In other Operating Systems or other versions, you must verify which python version is installed in the host system.
Depending on that, the 32 bit files to be replaced are different (read the setx86_64-0.3 script, line 320 to line 345, to understand how it is done).

<blockquote style="background: white; border: 1px solid rgb(153, 153, 153); padding: 1em;">
Note: 
Someone reported the note below, but the tests I made, didn't confirm it was really needed. Everything worked flawless without it. 
Nevertheless, if you find some problems, try the workaround described below: 

For CentOS-5, you will need to do something a bit different. "rpmmodule.so" is provided in your sitewide python distribution, so instead of copying it across, you need to:
:rm /usr/share/vzpkgtools/vzrpm43/lib/python2.4/site-packages/rpmmodule.so

</blockquote>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 7 =====

Edit the file /usr/share/vzpkg/cache-os 
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 8 =====

Edit the file /usr/share/vzpkg/functions 
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 9 =====

Edit the file /usr/bin/vzyum 
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

The next piece of code fixed the vzyum bug described in [http://bugzilla.openvz.org/show_bug.cgi?id=488#c0 bugzilla #488]. 
It was impossible to install a package group with spaces in his name. 
Now we can use e.g. vzyum groupinstall \"GNOME Desktop Environment\",
or other group name listed in vzyum grouplist. 
(Don't forget the backslash before each doublequote)

 -Line 56:
<pre>
comment the line 56:
#exec $YUM $YUM_ARGS $USER_ARGS
</pre>

 -Last Line (57): 

<pre>
add this code:

TMPVZY=/tmp/tmpvzy.$$
echo $YUM $YUM_ARGS $USER_ARGS > $TMPVZY
sh $TMPVZY
exec rm -f $TMPVZY
</pre>

===== STEP 10 =====

Edit file /usr/bin/vzrpm
Change next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 11 =====

If you want your [[container]]s to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own template caches from your own templates.
Let's test it!

List all x86_64 templates available:

vzpkgls | grep x86_64

Choose one of them to create the first cache template (this can be time consuming):

vzpkgcache -f centos-4-x86_64-minimal

It finishes with complaints about cron.daily, but don't worry about it.
Now minimal cache is created. Confirm if they were created:

vzpkgls -c

If you see it in the cache list, then you can create your first [[container]]:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start [[container]] 200 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in [[container]] 200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2007-04-20T12:17:36Z

Mcarreira: new script version. only installs centos-4 template

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a Centos-4 (tested) or a Fedora Core distribution (not tested).

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each VE using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - Centos-4 distribution (or Fedora Core 3, 4 or 5 - not tested).
* - Yum package installed.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all VE's. Instead, each VE has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM, and if you want to install a Centos-4 cache template.
* This process uses a bash script that automatizes all the hard work made by hand in the manual install.
* If something goes wrong, or if you want to install a diferent cache template, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64-0.2.tar.gz setx86_64] and then untar and run the script:

<pre>
tar xzvf setx86_64.tar.gz
./setx86_64
</pre>

Press Enter and let the script to do all the job for you.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_10|STEP 10]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error:
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vztmpl-centos-4 vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution (tested), but Fedore Core or other distribution with yum and rpm installed, may be tried, if you change the reference name and version in STEPS 1 to 4 (this was not tested).

===== STEP 1 =====

If you didn't instal yet "vztmpl-centos-4", do it now:

<code>
yum install vztmpl-centos-4
</code>

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.

<code>
cd /vz/template/centos/4/
mkdir x86_64
cp -a /vz/template/centos/4/i386/* /vz/template/centos/4/x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

to

<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all VE's as it was used to do. Each VE will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each VE, it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>

===== STEP 5 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

Substitute 32 bit module "rpmmodule.so" from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides, using this method:

<pre>
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 6 =====

Edit the file /usr/share/vzpkg/cache-os
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 7 =====

Edit the file /usr/share/vzpkg/functions
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 8 =====

Edit the file /usr/bin/vzyum
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

===== STEP 9 =====

Edit file /usr/bin/vzrpm
Change the next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 10 =====

If you want your VE's to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own cache your own cache templates
Let's test it!

Make my first two cache templates:

vzpkgcache -f centos-4-x86_64-default
vzpkgcache -f centos-4-x86_64-minimal

They finish with complaints about cron.daily, but don't worry about it.
Now minimal and default cache are created. Confirm if they are created:

vzpkgls -c

If you see the cache list, then you can create your first VE:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start VE 20 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in VE200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2007-04-16T18:21:05Z

Mcarreira: Use only Centos-4. Fedora was not tested successpully

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a Centos-4 (tested) or a Fedora Core distribution (not tested).

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each VE using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - Centos-4 distribution (or Fedora Core 3, 4 or 5 - not tested).
* - Yum package installed.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all VE's. Instead, each VE has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM, and if you want to install a Centos-4 cache template.
* This process uses a bash script that automatizes all the hard work made by hand in the manual install.
* If something goes wrong, or if you want to install a diferent cache template, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64.tar.gz setx86_64] and then untar and run the script:

<pre>
tar xzvf setx86_64.tar.gz
./setx86_64
</pre>

Press Enter and let the script to do all the job for you.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_10|STEP 10]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error:
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vztmpl-centos-4 vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution (tested), but Fedore Core or other distribution with yum and rpm installed, may be tried, if you change the reference name and version in STEPS 1 to 4 (this was not tested).

===== STEP 1 =====

If you didn't instal yet "vztmpl-centos-4", do it now:

<code>
yum install vztmpl-centos-4
</code>

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.

<code>
cd /vz/template/centos/4/
mkdir x86_64
cp -a /vz/template/centos/4/i386/* /vz/template/centos/4/x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

to

<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all VE's as it was used to do. Each VE will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each VE, it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>

===== STEP 5 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

Substitute 32 bit module "rpmmodule.so" from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides, using this method:

<pre>
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 6 =====

Edit the file /usr/share/vzpkg/cache-os
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 7 =====

Edit the file /usr/share/vzpkg/functions
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 8 =====

Edit the file /usr/bin/vzyum
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

===== STEP 9 =====

Edit file /usr/bin/vzrpm
Change the next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 10 =====

If you want your VE's to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own cache your own cache templates
Let's test it!

Make my first two cache templates:

vzpkgcache -f centos-4-x86_64-default
vzpkgcache -f centos-4-x86_64-minimal

They finish with complaints about cron.daily, but don't worry about it.
Now minimal and default cache are created. Confirm if they are created:

vzpkgls -c

If you see the cache list, then you can create your first VE:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start VE 20 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in VE200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Using vzpkg and vzyum on x86 64

2007-04-06T18:07:20Z

Mcarreira: Install openvz on a x86 64 system centos moved to Install OpenVZ on a x86 64 system Centos-Fedora

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a Centos-4 or a Fedora Core distribution.

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each VE using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - Centos-4 or Fedora Core 3, 4 or 5 linux distribution.
* - Yum package installed.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all VE's. Instead, each VE has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM, and if you want to install a Centos-4, or Fedora Core (3,4,5) cache template.
* This process uses a bash script that automatizes all the hard work made by hand in the manual install.
* If something goes wrong, or if you want to install a diferent cache template, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64.tar.gz setx86_64] and then untar and run the script:

<pre>
tar xzvf setx86_64.tar.gz
./setx86_64
</pre>

When you run the script, it asks first which OS Template do you want to install: Fedora or Centos.
Answer the question and enter the letter corresponding to you wish.
Let the script to do all the job for you.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned [[#STEP_10|STEP 10]].

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error:
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vztmpl-centos-4 vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedore Core or other distribution with yum and rpm installed, can be used, if you change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

If you didn't instal yet "vztmpl-centos-4", do it now:

<code>
yum install vztmpl-centos-4
</code>

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.

<code>
cd /vz/template/centos/4/
mkdir x86_64
cp -a /vz/template/centos/4/i386/* /vz/template/centos/4/x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

to

<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all VE's as it was used to do. Each VE will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each VE, it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>

===== STEP 5 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

Substitute 32 bit module "rpmmodule.so" from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides, using this method:

<pre>
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 6 =====

Edit the file /usr/share/vzpkg/cache-os
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 7 =====

Edit the file /usr/share/vzpkg/functions
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 8 =====

Edit the file /usr/bin/vzyum
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

===== STEP 9 =====

Edit file /usr/bin/vzrpm
Change the next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 10 =====

If you want your VE's to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own cache your own cache templates
Let's test it!

Make my first two cache templates:

vzpkgcache -f centos-4-x86_64-default
vzpkgcache -f centos-4-x86_64-minimal

They finish with complaints about cron.daily, but don't worry about it.
Now minimal and default cache are created. Confirm if they are created:

vzpkgls -c

If you see the cache list, then you can create your first VE:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start VE 20 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in VE200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]

Install openvz on a x86 64 system centos

2007-04-06T18:07:20Z

Mcarreira: Install openvz on a x86 64 system centos moved to Install OpenVZ on a x86 64 system Centos-Fedora

#REDIRECT [[Install OpenVZ on a x86 64 system Centos-Fedora]]

Using vzpkg and vzyum on x86 64

2007-04-06T17:45:00Z

Mcarreira: minimal change

Using vzpkg and vzyum on x86 64

2007-04-06T17:31:59Z

Mcarreira: create page

This document describes a way to install OpenVZ in a x86_64 computer, so that it can create cache templates, use vzyum and vzrpm.
This is intended to work in a Centos-4 or a Fedora Core distribution.

== THE PROBLEM ==

There is a known problem with vzpkg-2.7.0 and vzyum-2.4.0 in x86_64 computers:
Vzyum, vzpkgcache and vzrpm are broken in 64 bit systems, so we are unable to create new cache templates in a x86_64 computer or update each VE using vzyum or vzrpm.
This text describes a work around and a few hacks to get it work flawless.

{{Note| The basic idea is to change the code in such a way that vzyum and vzrpm use the real yum and rpm to do the job, and also create new x86_64 paths required by the system.}}

== REQUIREMENTS ==

* - A x86_64 computer
* - Centos-4 or Fedora Core 3, 4 or 5 linux distribution.
* - Yum package installed.

== SIDE EFFECTS ==

Until now there is only one side effect detected in this solution:
* The yum cache is not common to all VE's. Instead, each VE has it's own yum cache in the directory <code>/var/cache/yum-cache</code>.
This is a consequence from using the modified vzyum.

== INSTALL Openvz ==

There are two ways to install it:

* A - AUTOMATIC INSTALL (FASTEST)
* B - MANUAL INSTALL - STEP BY STEP

=== A - AUTOMATIC INSTALL (FASTEST) ===

General considerations

* This is a fastest way to install openvz utilities, and template utilities, ready to use in a x86_64 system.
* You can only use the automatic install IF YOU HAVE YUM AND RPM PACKAGES INSTALLED IN YOUR SYSTEM, and if you want to install a Centos-4, or Fedora Core (3,4,5) cache template.
* This process uses a bash script that automatizes all the hard work made by hand in the manual install.
* If something goes wrong, or if you want to install a diferent cache template, it's better to do the manual install, and try to adapt it to your needs.

Procedure

* Read carefully the [[Quick installation]] page and install the openvz kernel, configure the bootloader, change sysctl.conf, and finally reboot your system the way it is described there.
* Download the file [http://linux.carreira.com.pt/ovzutils/setx86_64.tar.gz setx86_64] and then untar and run the script:

<pre>
tar xzvf setx86_64.tar.gz
./setx86_64
</pre>

When you run the script, it asks first which OS Template do you want to install: Fedora or Centos.
Answer the question and enter the letter corresponding to you wish.
Let the script to do all the job for you.

When it finishes with the message "END INSTALL", you can go on reading this document jumping to the undermentioned STEP 10.

=== B - MANUAL INSTALL -STEP BY STEP ===

If for any reason you prefer manual installation, you may start your install process the same way as described in [[Quick installation]].
In x86_64, the packages vzpkg, vzyum and vztmpl-* are broken. So, let's install them this way, to avoid problems:

<code>
yum install vzrpm*
</code>

We can't "yum install vzyum" because it breaks with an error:
Error: Missing Dependency: cElementTree.so is needed by package vzyum

So we must download it first and then install it.

<code>
wget -c http://download.openvz.org/template/utils/vzyum/2.4.0-11/vzyum-2.4.0-11.noarch.rpm
rpm --nodeps -Uvh vzyum*.rpm
yum install vztmpl-centos-4 vzpkg*
</code>

==== TWEAKING THE CODE ====

Now let's tweak the code doing it step by step.
You can do a copy-paste from the next command lines to your system.
The example is using Centos-4 distribution, but Fedore Core or other distribution with yum and rpm installed, can be used, if you change the reference name and version in STEPS 1 to 4.

===== STEP 1 =====

If you didn't instal yet "vztmpl-centos-4", do it now:

<code>
yum install vztmpl-centos-4
</code>

===== STEP 2 =====

The template installed is a i386 template. So, we need to create a x86_64 template from the i386.

<code>
cd /vz/template/centos/4/
mkdir x86_64
cp -a /vz/template/centos/4/i386/* /vz/template/centos/4/x86_64
cd /vz/template/centos/4/x86_64/config
sed -i.tmp 's/i386/x86_64/g' yum.conf
rm -f yum.conf.tmp
</code>

Now we have a x86_64 centos template installed.

===== STEP 3 =====

Edit the file <code>/vz/template/centos/4/x86_64/config/yum.conf</code> with your editor.
Change the line:

<code>cachedir=/vz/template/centos/4/x86_64/yum-cache</code>

to

<code>cachedir=/var/cache/yum-cache</code>

{{Note| With this changes, vzyum is not going to be able to use a common cache directory to all VE's as it was used to do. Each VE will have it's own cache directory.
To avoid to have a directory named /vz/template/centos/4/x86_64/yum-cache in each VE, it is preferable to use the correct cache directory /var/cache/yum-cache.}}

===== STEP 4 =====

If you list the directory vz-addons like this:

ls -l /vz/template/centos/4/x86_64/vz-addons

probably you will see the file MAKEDEV-3.3.13-1.3.swsoft.i386.rpm.
This "ls" allows us to confirm which MAKEDEV version we need to use in this step.

Edit the files minimal.list and default.list in /vz/template/centos/4/x86_64/config directory, and change the line:

<pre>
MAKEDEV

to

MAKEDEV-3.3.13 (or the version you saw in the "ls")
</pre>

===== STEP 5 =====

Verify if you have rpm-python installed in your system, because it has 64 bit module needed:

<pre>
rpm -q rpm-python
rpm-python-4.3.3-18_nonptl
</pre>

Install it if you didn't do it already:
yum install rpm-python

Substitute 32 bit module "rpmmodule.so" from vzrpm43-python to the 64 bit module that rpm-python-x86_64 provides, using this method:

<pre>
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/
cp /usr/lib64/python2.3/site-packages/rpmmodule.so .
cp: overwrite `./rpmmodule.so'? y
cd /usr/share/vzpkgtools/vzrpm43/lib/python2.3/site-packages/rpmdb
cp /usr/lib64/python2.3/site-packages/rpmdb/_rpmdb.so .
cp: overwrite `./_rpmdb.so'? y
</pre>

Now we must edit and change these 3 files described in the next steps:

/usr/share/vzpkg/cache-os

/usr/share/vzpkg/functions

/usr/bin/vzyum

===== STEP 6 =====

Edit the file /usr/share/vzpkg/cache-os
Change the next lines:

 -Line 136:
<pre>
change: --vps=$VEID check-update
to: check-update
</pre>

 -Line 185:
<pre>
change: YUM_CMD="--installroot=$VE_ROOT --vps=$VEID $YUM_CONF_FILE -y $YUM_CMD"
to: YUM_CMD="--installroot=$VE_ROOT $YUM_CONF_FILE -y $YUM_CMD"
</pre>

===== STEP 7 =====

Edit the file /usr/share/vzpkg/functions
Change the next lines:

 -Line 21:
<pre>
change: YUM=/usr/share/vzyum/bin/yum
to: YUM=`which yum`
</pre>

 -Line 22:
<pre>
change: ARCHES="x86 i386 x86_64 ia64"
to: ARCHES="i386 x86_64 ia64 x86"
</pre>

 -Line 111:
<pre>
change: export RPM=`get_rpm $tdir`
to: export RPM=`which rpm`
</pre>

 -Line 450:
<pre>
change: rpm=`get_rpm $tdir`
to: rpm=`which rpm`
</pre>

===== STEP 8 =====

Edit the file /usr/bin/vzyum
Change the next line:

 -Line 51:
<pre>
change: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT --vps=$VEID"
to: YUM_ARGS="$YUM_ARGS --installroot $VE_ROOT"
</pre>

===== STEP 9 =====

Edit file /usr/bin/vzrpm
Change the next line:

 -Line 40:
<pre>
change: RPM_ARGS="--root $VE_ROOT --veid $VEID"
to: RPM_ARGS="--root $VE_ROOT"
</pre>

 -Line 52:
<pre>
change: RPM=`get_rpm $TDIR`
to: RPM=`which rpm`
</pre>

===== STEP 10 =====

If you want your VE's to have other country locales
edit <code>/vz/template/centos/4/x86_64/config/.rpmmacros</code> and change the line %_install_langs C
to the language you want, for example:

%_install_langs C:pt_PT:pt_PT.UTF-8:en_US:en_US.UTF-8

== TESTING THE NEW CODE ==

Now you can create your own cache your own cache templates
Let's test it!

Make my first two cache templates:

vzpkgcache -f centos-4-x86_64-default
vzpkgcache -f centos-4-x86_64-minimal

They finish with complaints about cron.daily, but don't worry about it.
Now minimal and default cache are created. Confirm if they are created:

vzpkgls -c

If you see the cache list, then you can create your first VE:

vzctl create 200 --ostemplate centos-4-x86_64-minimal

To change the locales, copy <code>/etc/sysconfig/i18n</code> to <code>/vz/private/200/etc/sysconfig</code>, if you wish to use another language and have done STEP 10 previously.

Now start VE 20 previously created:

vzctl start 200

Then test also "vzyum" and see if it works. Try to install "nano editor":

vzyum 200 install nano

Try to use vzrpm, to list all rpm's installed in VE200:

vzrpm 200 -qa

If you didn't have any errors, the changes are fine.

If something went wrong, probably you made a mistake in those previous steps.
Carefully verify if you did it well, step by step.

[[Category: Templates]]
[[Category: HOWTO]]
[[Category: Troubleshooting]]