DamBOX has been tested with Ubuntu version 16.04.

• Add the OpenBACH repository :
  • Update sources.list with net4sat openbach repository

 echo "deb http://packages.net4sat.org/openbach xenial stable" | sudo tee /etc/apt/sources.list.d/dambox.list 

• Add Net4Sat repository GPG key

 wget -O - http://packages.net4sat.org/support_net4sat_org_pub.gpg.key |sudo apt-key add -

• Update the list of available packages:

  sudo apt-get update 

• Install Dambox

 sudo apt-get install dambox 

User Manual and OpenSAND Manual consider a package installation. If you want to proceed a manual installation, please replace

 dambox 

by

 ./dambox 

in the provided commands lines. Or simply edit the $PATH variable.

netfilter library MUST be installed on the computer where DamBOX will be deployed. To do this, simply execute the following command:

sudo apt-get install libnetfilter-queue-dev

The maximum size of the FIFO queuing system MUST be set to a high value to store the potential important number of packets that are intercepted and not yet released. This parameter is located in /proc/sys/fs. It is RECOMMENDED to set it as follows:

sudo sysctl fs.pipe-max-size=66781584

The source code of the software can be found here. It can be cloned as follows:

git clone https://forge.net4sat.org/dambox/dambox.git

To compile the source code, a C++11 version MUST be used. It MUST include the following libraries:

• lpthread
• lnfnetlink
• lnetfilter_queue

On Ubuntu 16.04, here are the requirements:

sudo apt install make g++ libnetfilter-queue-dev

A makefile is available. Run the following command in root directory to obtain the binary dambox:

make 

You can generate a debian package (Ubuntu 16.04 only) with the following procedure.

Install the following dependences:

sudo apt-get install build-essential fakeroot devscripts libnetfilter-queue-dev debhelper

Then by issuing the following command in the root folder:

dpkg-buildpackage -us -uc

The package will be generated in the root folder. You can install it by running:

sudo dpkg -i ../dambox_1.0_amd64.deb

You can remove the unnecessary files as follows:

rm ../dambox_1.0*