A.1. How to produce openMosix's Kernel RPM files

A step-by-step guide for the dumb release manager and the adventurous "do it yourself" RPM packager , by Mirko Caserta

1. Install a RedHat 8 (psyche) on your machine. This is so far the platform used to produce the rpms and it's known to do its job well

2. Get an updated copy of the "linux-openmosix" module from oM's CVS repository - details can be found at http://sourceforge.net/cvs/?group_id=46729

3. Get the tarball for the Linux Kernel sources which we are going to patch and put it in /usr/src/redhat/SOURCES - supposing we're talking about a 2.4.20 Kernel, get the linux-2.4.20.tar.bz2 file from one of the many http://www.kernel.org/ mirrors worldwide

4. Unpack the kernel tarball under /usr/src, ie:

   # cd /usr/src # tar vxjf redhat/SOURCES/linux-2.4.20.tar.bz2

5. Make a symbolic link to the directory where you've checked out the linux-openmosix module, for instance:

   # ln -s /home/mcaserta/src/linux-openmosix/linux-openmosix \ /usr/src/linux-openmosix

6. copy the .spec file and all the .config files which are found in this directory under /usr/src/redhat/SOURCES, ie:

   # cp /usr/src/linux-openmosix/configs/openmosix-kernel.spec \ /usr/src/redhat/SOURCES # cp /usr/src/linux-openmosix/configs/*.config \ /usr/src/redhat/SOURCES

7. Now it's time to check the version numbers before we make the patch file: make sure the very first lines in

   /usr/src/linux-openmosix/Makefile and /usr/src/redhat/SOURCES/openmosix-kernel.spec have the correct

   kernel version and openMosix revision number

8. Good, time to make the patch (suppose we're releasing a patch for the 2.4.20 Linux Kernel and the 3rd release of openMosix):

   # cd /usr/src # diff -Naur --exclude=CVS --exclude=configs \ linux-2.4.20 linux-openmosix > \ /usr/src/redhat/SOURCES/openMosix-2.4.20-3 # bzip2 /usr/src/redhat/SOURCES/openMosix-2.4.20-3

9. At this point your /usr/src/redhat/SOURCES directory should look like:

   # ls /usr/src/redhat/SOURCES kernel-2.4.20-athlon.config kernel-2.4.20-i686-smp.config kernel-2.4.20-athlon-smp.config linux-2.4.20.tar.bz2 kernel-2.4.20-i386.config openMosix-2.4.20-3.bz2 kernel-2.4.20-i686.config openmosix-kernel.spec

10. Now you only need to rpmbuild the whole thing - what I usually do is:

    # cd /usr/src/redhat/SOURCES # rpmbuild -ba --target i386 openmosix-kernel.spec # rpmbuild -bb --target i686 openmosix-kernel.spec # rpmbuild -bb --target athlon openmosix-kernel.spec

    but you can easily build all rpms by calling:

    # rpmbuild -ba --target all_x86 openmosix-kernel.spec

11. After rpmbuild has done its job, you should have the following files under the /usr/src/redhat directory:

    a) RPMS/i386/openmosix-kernel-2.4.20-openmosix3.i386.rpm b) RPMS/i686/openmosix-kernel-2.4.20-openmosix3.i686.rpm c) RPMS/i686/openmosix-kernel-smp-2.4.20-openmosix3.i686.rpm d) RPMS/athlon/openmosix-kernel-2.4.20-openmosix3.athlon.rpm e) RPMS/athlon/openmosix-kernel-smp-2.4.20-openmosix3.athlon.rpm f) RPMS/i386/openmosix-kernel-source-2.4.20-openmosix3.i386.rpm g) SRPMS/openmosix-kernel-2.4.20-openmosix3.src.rpm h) SOURCES/openMosix-2.4.20-3.gz

    where:

    a) binary kernel package for i386 UP* machines b) binary kernel package for i686 UP* machines c) binary kernel package for i686 SMP** machines d) binary kernel package for athlon UP* machines e) binary kernel package for athlon SMP** machines f) source kernel package for any x86 machine (basically this is useful if you need to have the openMosix kernel headers) g) source kernel package (see point 11) h) kernel patch file compressed with gzip

12. The magic spell to obtain all the files back from the .src.rpm file is: # rpm2cpio openmosix-kernel-....src.rpm | cpio -di

Special thanks to Martin Høy for the help while I was trying to get the whole thing together.

I hope you find this document useful. At least it is for me since I tend to forget things a few minutes after I've accomplished them :)

* UP = UniProcessor (i.e. one CPU) ** SMP = Symmetric Multi Processing (i.e. more than one CPU)