[Users] New kernel branches structure

[Kir Kolyshkin]

OpenVZ project has changed the directory structure of kernel downloads, 
and the structure of yum repositories holding different kernels. Read on 
for more information and actions you need to take.

== New yum repos structure ==

If you are using non-stable kernel with yum, you have to update your 
openvz.repo. Get a new one from here -- 
http://download.openvz.org/openvz.repo -- and put it to your 
/etc/yum.repos.d/ directory.

* NOTE THAT THE OLD openvz.repo MIGHT NOT WORK FOR YOU *

 From now on, the following yum repos are available:
[openvz-utils]
  Latest utilities. Note that now this does not include the kernel, so 
you have to enable one of the below repos.

[openvz-kernel-rhel5]
[openvz-kernel-2.6.18]
[openvz-kernel-rhel4]
  Stable kernel branches.

[openvz-kernel-2.6.16]
[openvz-kernel-2.6.20]
  Development kernel branches.

[openvz-kernel-2.6.8]
  Obsoleted kernel branches.


== New download.openvz.org/kernel structure ==

Now, instead of having a single stable and a single development branch, 
there are several from each category. So, the directory structure of 
http://download.openvz.org/kernel (and ftp://ftp.openvz.org/kernel) was 
changed appropriately.

The following branches are available from 
http://download.openvz.org/kernel/branches/:

 Stable, maintained branches:
  rhel5-2.6.18
  2.6.18
  rhel4-2.6.9

 Development branches (will eventually reach the stable status):
  2.6.20
  sles10-2.6.16

 Obsoleted (no more maintained) branches:
  fc5
  2.6.16
  2.6.15
  2.6.8 (reached stable)

In each kernel branch directory (e.g. kernel/branches/2.6.18) there is a 
'current' symlink, pointing to the latest/newest kernel from this 
branch. In addition, if this branch is considered stable, there is a 
'stable' symlink pointing to the same kernel.

In addition, the top level directory (e.g. kernel/) have the following 
symlinks for your convenience, pointing to the latest kernels in the 
appropriate branch:

 stable-2.6.18-rhel5 -> branches/rhel5-2.6.18/stable
 stable-2.6.18 -> branches/2.6.18/stable
 stable-2.6.9-rhel4 -> branches/rhel4-2.6.9/
 stable-2.6.8 -> branches/2.6.8/stable

 latest-2.6.20 -> branches/2.6.20/current
 latest-2.6.18 -> branches/2.6.18/current
 latest-2.6.16 -> branches/2.6.16/current
 latest-2.6.15 -> branches/2.6.15/current

Also, a few symlinks are provided in order to try to maintain backward 
compatibility with the old directory structure:
 debian -> branches/debian
 devel -> branches/2.6.20
 fc5 -> branches/fc5
 rhel5 -> branches/rhel5-2.6.18/
 suse10 -> branches/sles10-2.6.16/

== New download pages ==

Kernel download pages (those under http://openvz.org/download/) are 
being migrated to http://wiki.openvz.org. For now, 2.6.20 is served from 
http://wiki.openvz.org/Download_kernel_2.6.20, other branches will follow.

== Bugs ==

A backward-compatible symlinks are provided in 
http://download.openvz.org/kernel/, but they might be not sufficient. In 
case you have a problem downloading or finding OpenVZ kernel, please 
report to http://bugzilla.openvz.org/, or directly to me (kir at openvz.org).

== Mirrors ==

OpenVZ download mirrors (http://wiki.openvz.org/Download_mirrors) are 
catching the new changes slowly. It can take some time before they will 
be fully synchronized with the new layout. Please do not report bugs 
about mirrors for a week or so