DamBOX has been tested with Ubuntu version 16.04.
echo "deb http://packages.net4sat.org/openbach xenial stable" | sudo tee /etc/apt/sources.list.d/dambox.list
wget -O - http://packages.net4sat.org/support_net4sat_org_pub.gpg.key |sudo apt-key add -
sudo apt-get update
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*