1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
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.23.1.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.23
* A gentoo-based UML file system (compressed size 130 MBytes) found at
http://download.strongswan.org/uml/gentoo-fs-20070702.tar.bz2
* The latest strongSwan distribution
http://download.strongswan.org/strongswan-4.1.8.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 3308 2007-10-17 03:39:16Z andreas $
|
