User-Mode-Linux Testing guide

User mode linux is a way to compile a linux kernel such that it can run as a process in another linux system (potentially as a *BSD or Windows process later). See http://user-mode-linux.sourceforge.net/

You'll need about 500Mb of disk space for a full sunrise-east-west-sunset setup. You can possibly get this down by 130Mb if you remove the sunrise/sunset kernel build. If you just want to run, then you can even remove the east/west kernel build.

  1. Get the following files:
  2. Pick a suitable place, and extract the following files:
  3. cd to /c2/freeswan/sandbox/testing/utils
  4. copy umlsetup-sample.sh to ../../umlsetup.sh cp umlsetup-sample.sh ../../umlsetup.sh
  5. open up ../../umlsetup.sh in your favorite editor.
  6. change POOLSPACE= to point to the place with at least 500Mb of disk. Best if it is on the same partition as the "umlfreeroot" extraction, as it will attempt to use hard links if possible to save disk space.
  7. Set TESTINGROOT if you intend to run the script outside of the sandbox/snapshot/release directory. Otherwise, it will configure itself.
  8. KERNPOOL should point to the directory with your 2.4.9 kernel tree. This tree should be unconfigured! This is the directory you used in step 2a.
  9. UMLPATCH should point at the bz2 file you downloaded at 1g.
  10. FREESWANDIR should point at the directory where you unpacked the snapshot/release. Include the "freeswan-snap2001sep16b" or whatever in it. If you are running from CVS, then you point at the directory where top, klips, etc. are. The script will fix up the directory so that it can be used.
  11. BASICROOT should be set to the directory used in 2b, or to the directory that you created with RPMs.
  12. SHAREDIR should be set to the directory used in 2c, to /usr/share for Debian potato users, or to $BASICROOT/usr/share.
  13. 
    cd $TESTINGROOT/utils
    sh make-uml.sh
    
    
        It will grind for awhile. If there are errors it will bail.
        If so, run it under "script" and send the output to bugs@lists.freeswan.org.  
    
    
  14. You will have a bunch of stuff under $POOLSPACE. Open four xterms:
    
        for i in sunrise sunset east west
        do
            xterm -name $i -e $POOLSPACE/$i/start.sh
        done
    
    
  15. Login as root. Password is "root" (Note, these virtual machines are networked together, but are not configured to talk to the rest of the world.)
  16. verify that pluto started on east/west, run "ipsec look"
  17. login to sunrise. run "ping sunset"
  18. login to west. run "tcpdump -p -i eth1 -n" (note that this is tcpdump.org tcpdump)