Persistence

Index

  1. Introduction
  2. Debian
  3. Not Debian

Introduction

If you installed Jool’s Debian package, chances are your distribution manages daemons by way of systemd or System V. Jool’s Debian package ships with systemd unit files and System V scripts you can use to enable Jool automatically after every boot.

If you did not install Jool’s Debian package, you’re in for a bit more trouble. You can download our Debian unit files or scripts and adapt them to your needs.

This document explains how to do both of these.

Debian

First, provide a configuration file in /etc/jool/. You can find some examples in /usr/share/doc/jool-tools/examples/:

SIIT NAT64
mkdir /etc/jool
cp /usr/share/doc/jool-tools/examples/jool_siit.conf /etc/jool
nano /etc/jool/jool_siit.conf
mkdir /etc/jool
cp /usr/share/doc/jool-tools/examples/jool.conf      /etc/jool
nano /etc/jool/jool.conf

Once you’re set, try your service out:

SIIT Debian NAT64 Debian SIIT Ubuntu NAT64 Ubuntu
systemctl start jool_siit
systemctl start jool
service jool_siit start
service jool      start

The service creates the instance in the global network namespace. It’s a perfectly average instance, so you can query or further tweak it normally:

SIIT NAT64
jool_siit instance display
jool_siit -i "init" global display
jool_siit -i "init" eamt display
# etc
jool      instance display
jool      -i "init" global display
jool      -i "init" pool4 display
# etc

(But any changes meant to be persistent need to be included in the configuration file.)

That’s all. If the service is configured correctly, it will start automatically on every boot.

Not Debian

First, figure out whether you’re using systemd or System V, and whether you need an SIIT or a NAT64.

  • This is Debian’s SIIT systemd unit file. (It probably needs to be renamed as /lib/systemd/system/jool_siit.service.)
  • This is Debian’s NAT64 systemd unit file. (It probably needs to be renamed as /lib/systemd/system/jool.service.)
  • This is Debian’s SIIT System V script. (It probably needs to be renamed as /etc/init.d/jool_siit.)
  • This is Debian’s NAT64 System V script. (It probably needs to be renamed as /etc/init.d/jool_siit.)

Grab the one you need and adapt it to your needs. To wit, the only thing you might need to modify is the path to the jool userspace client binary. In the files above it’s /usr/bin/jool_siit and /usr/bin/jool, but your installation might have likely placed them in /usr/local/bin instead.

Once that’s done, simply follow the Debian directions above. This is the sample SIIT sample configuration file, and this is the NAT64 sample configuration file.