Import initial strongswan 2.7.0 version into SVN.

1 files changed, 150 insertions, 0 deletions

diff --git a/testing/INSTALL b/testing/INSTALL
new file mode 100644
index 000000000..dfe21cc04
--- /dev/null
+++ b/testing/INSTALL
@@ -0,0 +1,150 @@
+
+                 -------------------------------
+	          strongSwan UML - Installation
+                 -------------------------------
+
+
+Contents
+--------
+
+   1. Making the host system UML-capable
+   2. Installing the required files
+   3. Creating the UML testing environment
+
+
+1. Making the host system UML-capable
+   ----------------------------------
+
+   UML instances can be run on both Linux 2.4 and Linux 2.6 kernels.
+   If you are using a vanilla kernel from kernel.org then you must first
+   apply the host SKAS patch available from
+
+    http://www.user-mode-linux.org/~blaisorblade/patches/
+
+   and recompile and reboot your host kernel. Some Linux distributions as e.g.
+   SuSE already include the SKAS patch in their kernels.
+
+   You will also need the UML utilities (uml_mconsole and uml_switch)
+   available from
+
+   http://prdownloads.sourceforge.net/user-mode-linux/uml_utilities_20040406.tar.bz2
+
+   Many Linux distributions offer the UML utilities as a package.
+
+
+2. Installing the required files
+   -----------------------------
+
+First create a directory where you want the strongSwan UML testing environment
+to be located.The default directory is "~/strongswan-testing". If you choose a
+different location, please adapt the UMLTESTDIR variable in "testing.conf"
+accordingly.
+
+    mkdir ~/strongswan-testing
+
+Now copy the "testing" subdirectory coming with the strongSwan distribution to
+the UML testing environment:
+
+    cp -r testing ~/strongswan-testing
+   
+Next you need to copy several files into the ~/strongswan-testing directory that
+are required for the strongSwan testing environment:
+
+    * A vanilla Linux kernel on which the UML kernel will be based on.
+      We recommend the use of
+
+      http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.16.9.tar.bz2
+
+    * Starting with Linux kernel 2.6.9 no patch must be applied any more in order
+      to make the vanilla kernel UML-capable. For older kernels you'll find
+      a matching UML patch at
+
+      http://prdownloads.sourceforge.net/user-mode-linux/
+
+    * The matching .config file required to compile the UML kernel:
+
+      http://download.strongswan.org/uml/.config-2.6.16
+
+    * A gentoo-based UML file system (compressed size 130 MBytes) found at
+
+      http://download.strongswan.org/uml/gentoo-fs-20060330.tar.bz2
+
+    * The latest strongSwan distribution
+
+      http://download.strongswan.org/strongswan-2.7.0.tar.gz
+
+
+3. Creating the environment
+   ------------------------
+
+Now change into the testing subdirectory
+
+    cd ~/strongswan-testing/testing
+
+and make the UML testing environment:
+
+    ./make-testing <hosts>
+
+The "make-testing" script calls a series of subscripts which can be
+enabled or disabled individually by setting the corresponding flags
+in "testing.conf":
+
+    if [ $ENABLE_BUILD_UMLKERNEL = "yes" ]
+    then
+        scripts/build-umlkernel
+    fi
+
+builds an UML kernel out of the vanilla Linux kernel and the corresponding
+UML kernel patch.
+
+    if [ $ENABLE_BUILD_HOSTCONFIG = "yes" ]
+    then
+        scripts/build-hostconfig
+    fi
+
+generates the default configurations for the UML hosts alice, venus, moon,
+carol, winnetou, dave, sun, and bob by replacing the wildcards PH_IP_ALICE,
+etc. by the actual IP addresses defined in "testing.conf".
+
+    if [ $ENABLE_BUILD_UMLROOTFS = "yes" ]
+    then
+        scripts/build-umlrootfs
+    fi
+
+takes the gentoo-based UML file system and compiles the latest strongSwan
+distribution into it.
+
+    if [ $ENABLE_BUILD_SSHKEYS = "yes" ]
+    then
+        scripts/build-sshkeys
+    fi
+
+adds the common RSA public key of the UML instances to your ~/.ssh/known_hosts
+directory so that you can log onto the UML instances using ssh without typing
+in a password. The "scripts/build-sshkeys" script should only be run once.
+
+    if [ $ENABLE_BUILD_UMLHOSTFS = "yes" ]
+    then
+        scripts/build-umlhostfs <hosts>
+    fi
+
+creates the customized UML file systems for the instances given as command line 
+arguments by adding the default host configurations to the UML root file system.
+If the "make-starting" scripts is called without any arguments then by default
+the UML file systems are created for the hosts alice, venus, moon, carol,
+winnetou, dave, sun, and bob. Each UML root file system has as size defined by
+the ROOTFSSIZE in testing.conf which by default is 544 MBytes. Thus all 8 UML
+hosts plus the master copy will require a total of 5 GBytes of disk space.
+
+    if [ $ENABLE_START_TESTING = "yes" ]
+    then
+       ./start-testing <hosts>
+    fi
+
+starts the automated testing. More details on the tests you'll find in the
+README document.
+
+-----------------------------------------------------------------------------
+
+This file is RCSID $Id: INSTALL,v 1.39 2006/04/24 16:58:03 as Exp $
+