Penguin
Recent Changes
Note: You are viewing an old revision of this page. View the current version.

Prerequisites:

Kernel preparation

Vanilla Kernel/FreeS/WAN from source

Get the latest FreeS/WAN source package - the FreeS/WAN homepage recommends typing

ncftpget ftp://ftp.xs4all.nl/pub/crypto/freeswan/freeswan-\*

cd /usr/src/my-kernel-source-is-unpacked-here/ <configure your kernel here. this is important.> <compile your kernel here. this is important.>

If you're using the FreeS/WAN kernel installation method it seems you actually need to compile a kernel here, which is a bit odd.

cd /usr/src/ tar xzf /download/freeswan-2.02.tar.gz

The next stepinstalls the IPSec binaries in /usr/local/lib/ipsec. The "ipsec" command itself is put in /usr/local/sbin. If you later find you can't find "ipsec", check your path.

cd /usr/src/freeswan-1.99/ make oldgo

'oldgo' is the target for compiling statically against the kernel source. Alternatives are 'menugo' and `xgo' to get a normal kernel config menu up respectively. For the menus, IPSec related options are under 'Networking Options'. Always save the config when you leave, whether or not you have changed anything!

Now, install your kernel and reboot.

Debian

Note: if you want to do all the cool new things like OpportunisticEncryption, you should be using FreeS/WAN 2.01+. If you're running Debian Stable, you can get the a backport from backports.org's FreeS/WAN directory, by adding the following line to /etc/apt/sources.list
deb http://www.backports.org/debian woody freeswan

Now,

apt-get install kernel-source (or acquire the newest kernel source as you see fit) apt-get install kernel-patch-freeswan

export PATCH_THE_KERNEL=YES cd /usr/src/kernel-source-whatever make-kpkg --config=menuconfig --revision=whatever kernel_image

When make-kpkg runs, if PATCH_THE_KERNEL is set YES (It has to be in uppercase!) then it will unpatch (clean) and patch the kernel with the contents of /usr/src/kernel-patches/ that are correct for your architecture. The --config=menuconfig step is designed to let you configure all the flash new options that FreeS/WAN provides. Make sure you don't forget any.

The userspace tools can be installed with apt-get install freeswan.

Gentoo

gentoo-sources comes with FreeS/WAN support. Enable IPSec in your kernel config, recompile, and

emerge -u freeswan

Congratulations! You now have an IPSec enabled kernel in the directory where your newly compiled kernel normally lives (/usr/src/linux/arch/i386/boot/bzImage for me). You are probably going to want to copy it somewhere and either restart or rerun lilo and restart, depending on your preferences.

You may now wish to go to IPSecConfiguration to find out how to actually do something useful with all this!

IMPORTANT NOTE: FreeS/WAN 2.x ships with OpportunisticEncryption enabled out of the box. THIS WILL CAUSE YOU PROBLEMS IF YOU DON'T HAVE CORRECT DNS RECORDS! If you install FreeS/WAN (esp. on Debian) and want to set up tunnels, or learn about it, turn OE off quickly. If it's on, you'll have /1 routes and a default route out your ipsec0 interface, and you will no longer have a default gateway.

1?: X509 certificate support is required if you want to interoperate with Windows. You can either get X509 patch for vanilla FreeS/WAN or you can get Super FreeS/WAN, which has lots more patches, but tends to be a version or two behind the original FreeS/WAN release. If you don't know what you need, compile X509 in if you're going to interoperate with Windows, and don't bother otherwise.