Chapter 2. Distribution specific installation

To use eurephia, you need to install eurephia and an OpenVPN version with the eurephia patch included. Both eurephia and the patched OpenVPN version are already available in a few distributions. If your distribution is not listed here, you will need to compile it manually as described in the next chapter.

Why is a special OpenVPN version needed?

The current official stable releases of OpenVPN do not provide unique enough certificate information via the plug-in interface. A patch to OpenVPN was written to provide this information. This patch has been accepted for the OpenVPN 2.2 release cycle.

To check if you have OpenVPN installed with the proper eurephia patch, run openvpn with --version. Verify that the version string contains the [eurephia] extension. this indicates that the openvpn binary contains the eurephia patch.

root@host:~ # openvpn --version
OpenVPN 2.1.3 i686-pc-linux-gnu [SSL] [LZO2] [EPOLL] [eurephia] built on Aug 27 2010
Originally developed by James Yonan
Copyright (C) 2002-2010 OpenVPN Technologies, Inc. <sales@openvpn.net>

Distribution support

At the moment, eurephia is not available directly via many distributions. This is an on-going work. Stay tuned and check http://www.eurephia.net/ for updates on this matter.

2.1. Arch Linux

There are two ways to do the installation on Arch Linux. One is using AUR helpers, the other one is to download the Arch Linux package files and build them manually.

2.1.1. Using AUR helpers

Using clyde:

root@host: ~ # clyde -S openvpn-eurephia eurephia

Using yaourt:

root@host: ~ # yaourt -S openvpn-eurephia eurephia

2.1.2. Doing it manually

First install the eurephia enabled OpenVPN version:

root@host: ~ # wget http://aur.archlinux.org/packages/openvpn-eurephia/openvpn-eurephia.tar.gz
root@host: ~ # tar xzvpf openvpn-eurephia.tar.gz
root@host: ~ # cd openvpn-eurephia
root@host: ~/openvpn-eurephia # makepkg -s
root@host: ~/openvpn-eurephia # pacman -U openvpn-eurephia-2.1.3-2-{your_arch}.pkg.tar.xz
root@host: ~/openvpn-eurephia # cd ..

Replace {your_arch} with the OS architecture corresponding to your system installation. Valid values are i686 and x86_64

It is a similar approach to install the eurephia package:

root@host: ~ # wget http://aur.archlinux.org/packages/eurephia/eurephia.tar.gz
root@host: ~ # tar xzvpf eurephia.tar.gz
root@host: ~ # cd eurephia
root@host: ~/eurephia # makepkg -s
root@host: ~/eurephia # pacman -U eurephia-1.0.1-1-{your_arch}.pkg.tar.xz

Again you will need to replace {your_arch} with the OS architecture corresponding to your system installation. It should be the same value as the one you used for installing OpenVPN.

Remove eurephia_init after usage

After you have used initialised the eurephia database, it is advisable to remove the eurephia_init binary. This binary is typically run only once during the initialisation of eurephia. Remove it from a shell using the rm command:

[root@host ~]# rm -f /usr/bin/eurephia_init