3. Mobile IPv6 for Linux

3.1. Patching the kernel

The MIPL MIPv6 implementation requires a kernel patch. The implementation modifies the IPv6 kernel stack, so a kernel recompile is necessary. The installation process is well documented, but I will give a brief step-by-step howto.

Please note! The need for two different kernels, one for MN and one for HA, is obsolete. Just compile support for MN and HA in the same kernel. It is not possible to run as both an MN and an HA at the same time; which mode is chosen depends on which of the modules are loaded.

1. Download the latest Linux MIPv6 source code from http://www.mobile-ipv6.org/. The latest release today is: mipv6-1.0-v2.4.22. The last four numbers corresponds to the Linux kernel the patch should be applied to:

   # cd /usr/local/src # wget http://www.mobile-ipv6.org/download/mipv6-1.0-v2.4.22.tar.gz # tar zxfv mipv6-1.0-v2.4.22.tar.gz

2. Download and unpack the correspondent Linux kernel version from ftp.kernel.org:

   # cd /usr/src # wget ftp://ftp.kernel.org/pub/linux/kernel/v2.4/linux-2.4.22.tar.bz2 # tar jxvf linux-2.4.22.tar.bz2 # ln -s linux-2.4.22 linux # cd linux

3. Apply the MIPv6 patch:

   # patch -p1 --dry-run < /usr/local/src/mipv6-1.0-v2.4.22/mipv6-1.0-v2.4.22.patch

   The --dry-run option checks that the patch will apply correctly. If you get any failed hunks, you should not proceed. If everything went fine do:

   # patch -p1 < /usr/local/src/mipv6-1.0-v2.4.22/mipv6-1.0-v2.4.22.patch

4. Now your kernel tree is ready for configuration. Run your favorite make *config. The MIPv6 options are under "Networking Options". The following options should be present in ".config":

   CONFIG_EXPERIMENTAL=y CONFIG_SYSCTL=y CONFIG_PROC_FS=y CONFIG_MODULES=y CONFIG_NET=y CONFIG_NETFILTER=y CONFIG_UNIX=y CONFIG_INET=y CONFIG_IPV6=m CONFIG_IPV6_SUBTREES=y CONFIG_IPV6_IPV6_TUNNEL=m CONFIG_IPV6_MOBILITY=m CONFIG_IPV6_MOBILITY_MN=m CONFIG_IPV6_MOBILITY_HA=m

   Since MIPL is still a work-in-progress you might want to enable:

   CONFIG_IPV6_MOBILITY_DEBUG=y

   With debug messages it is easier to figure out what happened when something goes wrong. Also, when reporting a bug, debug messages are very helpful.

   To be sure you have all the correct options, you can run chkconf_kernel.sh, which is a small shell script included in the MIPL tarball.

5. Next you should compile and install your kernel.

   Hint: To easily distinguish this kernel from other kernels, you can change the "EXTRAVERSION" variable in the /usr/src/linux/Makefile to for example "-MIPv6-1".

Read the Linux Kernel HOWTO for detailed instruction on how to patch, compile and install your new kernel.

3.2. Userspace tools

The userspace tool mipdiag, config files and init scripts must be installed for the module to work correctly:

      # cd /usr/local/src/mipv6-1.0-v2.4.22
      # ./configure
      # make && make install
    

3.3. MIPv6 device node

The MIPv6 module also needs a new device node entry. Issue the command:

      # mknod /dev/mipv6_dev c 0xf9 0
    

3.4. Automatic startup

1. Red Hat:

   All init scripts are located in /etc/init.d/, which are sym-linked to the correct runlevel (/etc/rcX.d/). You can issue the command:

   # chkconfig --add mobile-ip6

   to enable MIPv6 at startup, or

   # chkconfig --del mobile-ip6

   to remove MIPv6 from startup.

2. Debian:

   If you are so lucky to be running Debian, you can issue the command:

   # update-rc.d -n mobile-ip6 start 75 3 4 5 . stop 05 1 2 6 .

   to set up all the necessary links.

3. Slackware:

   Slackware users have all their startup/runlevel scripts in /etc/rc.d. Since 'configure' doesn't check for "/etc/rc.d", you can add INIT_SLACK="/etc/rc.d", and then INIT_SLACK to INITDIRS in 'configure' (search for INITDIR in configure). Since you are running Slackware, you probably know this already. The following command should then do the trick:

   # echo '/etc/rc.d/mobile-ip6 start' >> /etc/rc.d/rc.local

   If you don't hack the Makefile, the mobile-ip6 script is installed at '/' (you may then move it to /etc/rc.d/).