Editing Using vzpkg and vzyum on x86 64

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 <b>vzpkg-2.7.0</b> and <b>vzyum-2.4.0</b> 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 <i>side effect</i> 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) ===

<b><u>General considerations</u></b>

* 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.


<b><u>Procedure</u></b>

* 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 <b>[[#STEP_10|STEP 10]]</b>.


=== 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 <b>Centos-4</b> distribution, but <b>Fedore Core</b> 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 <b>minimal.list</b> and <b>default.list</b> 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 <b>rpm-python</b> 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/<b>cache-os</b>

/usr/share/vzpkg/<b>functions</b>

/usr/bin/<b>vzyum</b>


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

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


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


<b> -Line 185:</b>
<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/<b>functions</b>
Change the next lines:


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


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


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


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


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

Edit the file /usr/bin/<b>vzyum</b>
Change the next line:


<b> -Line 51:</b>
<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/<b>vzrpm</b>
Change the next line:


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


<b> -Line 52:</b>
<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 <b>%_install_langs C</b>
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 <i>cron.daily</i>, but don't worry about it.
Now <b>minimal</b> and <b>default</b> 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 <i>locales</i>, 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]]