|
|
# System-Specific Install Notes
|
|
|
|
|
|
2018-03-30: This page documents Kea installation on Ubuntu 17.10 Server.
|
|
|
|
|
|
## Install required tools and dependencies
|
|
|
|
|
|
Install necessary tools first:
|
|
|
```
|
|
|
apt-get install libtool autoconf g++ libssl-dev liblog4cplus-dev libboost-system-dev
|
|
|
```
|
|
|
|
|
|
## Compilation from git
|
|
|
|
|
|
If downloading from git:
|
|
|
|
|
|
```
|
|
|
git clone https://github.com/isc-projects/kea
|
|
|
cd kea
|
|
|
autoreconf -i
|
|
|
./configure
|
|
|
make
|
|
|
sudo make install
|
|
|
```
|
|
|
|
|
|
That's it. You're done.
|
|
|
|
|
|
## Compilation from tarball
|
|
|
If using a tarball:
|
|
|
|
|
|
```
|
|
|
tar zxvf kea-1.3.0.tar.gz
|
|
|
cd kea-1.3.0
|
|
|
./configure
|
|
|
make
|
|
|
sudo make install
|
|
|
```
|
|
|
|
|
|
That's it. You're done.
|
|
|
|
|
|
## Installing with optional features
|
|
|
|
|
|
The following sections explain how to compile Kea with additional features.
|
|
|
|
|
|
### Installing with MySQL (optional)
|
|
|
|
|
|
This is an optional dependency. You need it only if you want Kea to be able to store its information in MySQL:
|
|
|
|
|
|
```
|
|
|
sudo apt-get install libmysqlclient-dev
|
|
|
./configure --with-mysql
|
|
|
...
|
|
|
```
|
|
|
|
|
|
### Installing with PostgreSQL (optional)
|
|
|
|
|
|
This is an optional dependency. You need it only if you want Kea to be able to store its information in PostgreSQL:
|
|
|
|
|
|
```
|
|
|
sudo apt-get install libpq-dev postgresql-server-dev-all
|
|
|
./configure --with-pgsql
|
|
|
...
|
|
|
```
|
|
|
|
|
|
### Installing Cassandra (optional)
|
|
|
|
|
|
...
|
|
|
|
|
|
### Installing dependencies for developers (optional)
|
|
|
|
|
|
Compile google-test framework, needed for running unit-tests:
|
|
|
```
|
|
|
sudo apt-get install googletest
|
|
|
```
|
|
|
|
|
|
Then compile Kea with:
|
|
|
```
|
|
|
./configure --with-gtest-source=/usr/src/googletest
|
|
|
```
|
|
|
|
|
|
### Installing dependencies for generating documentation (optional)
|
|
|
If you want to generate the documentation:
|
|
|
|
|
|
```
|
|
|
sudo apt-get install elinks docbook-xsl doxygen xsltproc
|
|
|
./configure --enable-generate-docs
|
|
|
make
|
|
|
cd doc
|
|
|
make devel
|
|
|
```
|
|
|
|
|
|
### Installing with FreeRADIUS (optional)
|
|
|
|
|
|
You need to have subscription package to make this work.
|
|
|
|
|
|
Install FreeRADIUS client first.
|
|
|
```
|
|
|
wget -nd https://github.com/FreeRADIUS/freeradius-client/archive/release_1_1_7.tar.gz
|
|
|
tar zxvf release_1_1_7.tar.gz
|
|
|
cd freeradius-client-release_1_1_7
|
|
|
./configure --prefix=/usr/local
|
|
|
make
|
|
|
sudo make install
|
|
|
```
|
|
|
|
|
|
Extract kea with subscription package to premium/ dir:
|
|
|
|
|
|
```
|
|
|
tar zxvf kea-subscription-1.4.0.tar.gz
|
|
|
./configure --with-tier2=yes --with-freeradius=/usr/local
|
|
|
```
|
|
|
|
|
|
Make sure the following entries are printed after configure is done:
|
|
|
|
|
|
```
|
|
|
Package:
|
|
|
Name: kea
|
|
|
Version: 1.3.0-git
|
|
|
Extended version: 1.3.0-git (git b41502a0e4ce7dcf114c8b50549d27c1f4d731b0)
|
|
|
OS Family: Linux
|
|
|
Using GNU sed: yes
|
|
|
Premium package: yes
|
|
|
Tier1 Packages: host_cmds flex_id legal_log
|
|
|
Tier2 Packages: high_availability subnet_cmds radius
|
|
|
Included Packages: host_cmds flex_id legal_log high_availability subnet_cmds radius
|
|
|
|
|
|
...
|
|
|
|
|
|
FreeRADIUS client:
|
|
|
FREERADIUS_INCLUDE: -I/usr/local/include
|
|
|
FREERADIUS_LIB: -L/usr/local/lib -lfreeradius-client
|
|
|
FREERADIUS_DICTIONARY: /usr/local/etc/radiusclient/dictionary
|
|
|
```
|
|
|
|
|
|
then compile as usual. |
|
|
\ No newline at end of file |