Documentation > Installation > Userspace Applications

Userspace Applications Installation

Index

  1. Introduction
  2. Requirements
  3. Downloading the Code
  4. Compilation and Installation

Introduction

Jool is five things:

  1. Two kernel modules you can hook up to Linux. One of them is the SIIT implementation and the other one is the Stateful NAT64. They have their own installation document.
  2. Two userspace applications which can be used to configure each module.
  3. One userspace daemon used to synchronize sessions between different Jool kernel modules.

This document explains how to obtain the binaries of the userspace applications and the daemon.

Requirements

Build Essentials

You don’t need pkg-config if you know what you’re doing.

# apt-get install gcc make pkg-config

libnl-genl-3

# apt-get install libnl-genl-3-dev

Autoconf

You only need this if you downloaded the Github version of Jool.

Ubuntu CentOS
# apt-get install autoconf
# yum install automake

Downloading the Code

Pick either:

  1. The Official Releases’ Download page.
  2. The Git repository. Either
    • hit the “Clone or download” button and then “Download ZIP”,
    • or execute git clone https://github.com/NICMx/Jool.git.

Note! The Git repository was recently renamed from “NAT64” to “Jool”. Links to the old name should be automatically redirected to the new one so this shouldn’t be too confusing.

Compilation and Installation

Note! Add LIBNLGENL3_CFLAGS and LIBNLGENL3_LIBS to configure if you chose not to install pkg-config.

Official release Git version
$ unzip Jool-<version>.zip
$ cd Jool-<version>/usr
$
$ ./configure
$ make
# make install
$ unzip master.zip
$ cd Jool-master/usr
$ ./autogen.sh
$ ./configure
$ make
# make install

Note! If you only want to compile the SIIT binary, you can speed things up by running the make commands in the usr/stateless folder. If you want the NAT64 client instead, do so in usr/stateful. If you want the daemon, go to usr/joold.