Installation Notes: Ultra Monkey on Debian Woody (Stable 3.0)

These notes only cover software installation. For details on configuration please examine the discussion and sample configuration files in the topologies section.

• Set Apt Sources

  Ultra Monkey provides aditional and updated packages for Debian. The easiest way to obtain these packages is using apt-get. To do this add the following lines to the top of the /etc/apt/sources.list file:

  deb http://www.ultramonkey.org/download/2.0.1/ woody main
  deb-src http://www.ultramonkey.org/download/2.0.1 woody main

  And then running apt-get update to obtain the package lists. Note that the deb-src line is optional and is only used if you wish to download the source packages for Ultra Monkey. If you do not wish to use apt-get, then you can obtain the packages directly from the download directory.

• Upgrade initrd-tools

  In order to install the updated kernel supplied an updated version of initrd-tools is required. In particular you must have initrd-tools-0.1.32woody.3.um.3 in order to successfully install the kernels discussed below on a system that has an IDE boot disk. Your system may not boot if you do not upgrade this package.

  The updated initrd-tools package be obtained using apt-get.

  apt-get install initrd-tools
  

  Alternatively the packages may be obtained directly from the download directory.

• Upgrade Kernel

  The easiest way to do this is to install one of the supplied kernel image packages on your system. They may be obtained using apt-get. By running one of the following sets of commands. The second and third commands in each set, which install the headers and pcmcia-modules respectively are optional. Alternatively the packages may be obtained directly from the download directory.

  The current version of the kernel packages for Ultra Monkey 2.0.1 is 2.4.22-1-ipvs-i386, which are based on the 2.4.22-1-i386 kernels released by Debian. There is an older 2.4.20-1-ipvs-i386 release. It is recommended that you used the newer 2.4.22-1-ipvs-i386 kernels which fix a number of security issues.

  • 386 architecture:
    apt-get install kernel-image-2.4.22-1-ipvs-386
    apt-get install kernel-headers-2.4.22-1-ipvs-386
    apt-get install kernel-pcmcia-modules-2.4.22-1-ipvs-386

  • Pentium Classic architecture:
    apt-get install kernel-image-2.4.22-1-ipvs-586tsc
    apt-get install kernel-headers-2.4.22-1-ipvs-586tsc
    apt-get install kernel-pcmcia-modules-2.4.22-1-ipvs-586tsc

  • Pentium Pro, Celeron, Pentium II, Pentium II or Pentium IV architecture:
    apt-get install kernel-image-2.4.22-1-ipvs-686
    apt-get install kernel-headers-2.4.22-1-ipvs-686
    apt-get install kernel-pcmcia-modules-2.4.22-1-ipvs-686

  • SMP Pentium Pro, Celeron, Pentium II, Pentium II and Pentium IV architecture:
    apt-get install kernel-image-2.4.22-1-ipvs-686-smp
    apt-get install kernel-headers-2.4.22-1-ipvs-686-smp
    apt-get install kernel-pcmcia-modules-2.4.22-1-ipvs-686-smp

  • AMD K6, K6-II or K6-III architecture:
    apt-get install kernel-image-2.4.22-1-ipvs-k6
    apt-get install kernel-headers-2.4.22-1-ipvs-k6
    apt-get install kernel-pcmcia-modules-2.4.22-1-ipvs-k6

  • AMD Duron or Athlon architecture:
    apt-get install kernel-image-2.4.22-1-ipvs-k7
    apt-get install kernel-headers-2.4.22-1-ipvs-k7
    apt-get install kernel-pcmcia-modules-2.4.22-1-ipvs-k7

  • SMP AMD Duron or Athlon architecture:
    apt-get install kernel-image-2.4.22-1-ipvs-k7-smp
    apt-get install kernel-headers-2.4.22-1-ipvs-k7-smp
    apt-get install kernel-pcmcia-modules-2.4.22-1-ipvs-k7-smp

  If you wish to build your own kernel then please be advised that the IPVS and Hidden Interface patches are needed for Ultra Monkey. Debian packages for these may be installed using the following apt-get commands, downloaded from the download directory or obtained directly from http://www.linuxvirtualserver.org/software/ and http://www.linuxvirtualserver.org/~julian/ respectively.

  apt-get install kernel-patch-2.4-hidden-interface
  apt-get install kernel-patch-2.4-ipvs
  

• Controling Automatic Kernel Updates

  From time to time updated packages are released for Ultra Monkey. Typically these are a result of security bugs. If you are using apt-get and add the apt source listed above then your system will be updated with these packages when you run "apt-get update;apt-get upgrade" or similar. However, as the kernel is the core part of the operating system, and a reboot is required to effect an upgrade, it may be desirable to exclude the kernel packages from such updates. This can be done by adding the conntents of to um.apt.preferences to /etc/apt/preferences.

  If you do wish to upgrade the kernel, then change the version number befor running apt-get, or just manually download the packaes from then download directory and install them using dpkg.

  Note: It is quite harmless to have entries in /etc/apt/preferences for packages that are not installed.

• Update Boot Loader

  The kernel images provided make use of an initrd image to provide modules at boot time. Because of this you should make sure that your /etc/lilo.conf has an initrd line and is updated for the installed kernel image. A sample lilo.conf follows.

  lba32
  boot=/dev/sda
  root=/dev/sda3
  install=/boot/boot-menu.b
  map=/boot/map
  delay=20
  vga=normal
  
  default=Linux
  
  image=/boot/vmlinuz-2.4.22-1-ipvs-686
          label=Linux
          read-only
          initrd=/boot/initrd.img-2.4.22-1-ipvs-686
  
  image=/vmlinuz
          label=LinuxOLD
          read-only
          optional
  

  Once you have updated the lilo.conf run lilo.

• Upgrade Module Configuration

  As the supplied kernel makes heavy use of modules you may need to specify various modules to be loaded at boot time. Typically this includes drivers for network cards. To do this you should add the names of the modules that are required for your system to correctly function to /etc/modules. For example, the following is may be used on a system that has an eepro100 network card.

  unix
  af_packet
  eepro100
  

  To avoid warings about ipvs not being installed you should also add the following to /etc/modules.

  ip_vs
  

• Reboot

  As a new kernel has been installed you will need to reboot the system for changes to take effect. This can be effected using the reboot command.

  /usr/bin/reboot

  If your system fails to boot, complaining about not being able to mount the root device, this is most likely because the correct modules are not being loaded from the initrd image. This can be fixed by editing /etc/mkinitrd/modules and regenerating the initrd image. See man mkinitrd for more details. If this occurs please contact the ultramonkey-user's list.

• Install Other Packages

  Ultra Monkey comes with a number of additional packages.

  These packages are only required on the Linux Directors or hosts that will run heartbeat. They can be obtained using apt-get using the following command or from the download directory.

  apt-get install ultramonkey

  During the instalation of the ipvsadm package you may be asked to configure /etc/ipvsadm.rules. You should select <No> as this conflicts with the way that Ultra Monkey configures ipvsadm.

  

  During the instalation of the ipvsadm package you may be also asked to configure the IPVS synchronisation daemon. It is recommended thhat you select none as configuration of the synchronisation daemon is not covered in the Ultra Monkey documentation and in some cases conflicts with the way that conflicts with the way that Ultra Monkey runs LVS.

  

• Configure the System

  Once the system comes back up you are ready to start configuring your service. For details of sample configurations please see the topologies section.

Copyright © 2000-2005, Horms
Last Updated: Tue May 17 17:37:24 2005 +0900

Debian is a registered trademark of Software in the Public Interest, Inc.
Red Hat, the Red Hat Shadowman logo and Fedora are registered trademarks of Red Hat, Inc.
Red Hat may also be refered to as RedHat on this site.
Linux is a registered trademark of Linus Torvalds.
All other trademarks are the property of their respective owners.