These notes only cover software installation. For details on configuration please examine the discussion and sample configuration files in the topologies section.
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/ sid main
deb-src http://www.ultramonkey.org/download/2.0.1 sid 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.
Ultra Monkey makes available new features of The Linux Virtual Server that are not included in the default kernel images provided by Debian Sid (Unstable/Testing). Because of this a modified kernel is required.
It is recommended that you install this kernel on the Linux Directors and Real Servers alike. In the case of the latter, this kernel provides the ability to hide interfaces so that they will not respond to arp packets, this is used in some of the topologies discussed.
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.
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
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.
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.
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.
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.
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
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.
Once the system comes back up you are ready to start configuring
your service. For details of sample configurations please see
the topologies section.
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.
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,
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.