User Tools

Site Tools


Sidebar

dambox:installation_manual

Installation Manual

Requirements

DamBOX has been tested with Ubuntu version 16.04.

Package installation

  • 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 

Manual installation

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.

The netfilter Library

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

Size of system pipe FIFO

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

Compile DamBOX

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 

Generate .deb package

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*
dambox/installation_manual.txt ยท Last modified: 2020/04/27 08:14 by kuhnn