IBR-DTN Software

Version 1.0.1

Required libraries

Have a look at ibrdtn/README for a more user-friendly list of the libraries (apt-get).

Configuration

An example configuration is contained in the ibrdtnd package.

Quick start

Once the daemon is installed, it can started by calling "dtnd".

user@host:~$ dtnd 
Sun Jan  4 15:15:45 2015 INFO NativeDaemon: IBR-DTN daemon 1.0.0
Sun Jan  4 15:15:45 2015 INFO Configuration: Using default settings. Call with --help for options.
Sun Jan  4 15:15:45 2015 INFO NativeDaemon: Parallel event processing enabled using 4 processes.
Sun Jan  4 15:15:45 2015 INFO BundleCore: Local node name: dtn://hostname
Sun Jan  4 15:15:45 2015 INFO BundleCore: Forwarding of bundles enabled.
Sun Jan  4 15:15:45 2015 INFO NativeDaemon: using bundle storage in memory-only mode
Sun Jan  4 15:15:45 2015 INFO NativeDaemon: API initialized using tcp socket: loopback:4550
Sun Jan  4 15:15:45 2015 INFO DiscoveryAgent: listen to [ff02::142]:4551
Sun Jan  4 15:15:45 2015 INFO DiscoveryAgent: listen to [224.0.0.142]:4551
Sun Jan  4 15:15:45 2015 INFO NativeDaemon: Using default routing extensions

As you can see the daemon startup with some default values and give a hint to use the "-c" parameter to specify a config file. The default setup does not add any convergence layer, this has to be done by a configuration or the "-i" parameter to specify an interface to bind on. To customize the setup take a look at the ibrdtnd.conf example configuration in the "etc" directory of the daemon. And run the daemon with the customized configuration.

user@host:~$ dtnd -c etc/ibrdtnd.conf 

OpenWRT repositories

If you like to try out IBR-DTN on OpenWRT, we provide package repositories for the x86 and ar71xx (mips) architectures. Just open "/etc/opkg.conf" and add an additional line like this for a x86 architecture with OpenWRT attitude adjustment release. For other architectures or releases use the links below.

src/gz ibrdtn http://jenkins.ibr.cs.tu-bs.de/download/openwrt/repository/attitude_adjustment/x86/packages

Then call "opkg update" and "opkg install ibrdtnd" and the daemon gets installed on your host. The daemon is configured and managed in an OpenWRT-like fashion with the uci tool and the "/etc/init.d/ibrdtn" script.

Debian/Ubuntu? Repository

To provide different packages for several distributions, we are using opensuse.org build service. Thus, the first thing you need to do is open the list of repositories and pickup the right one for your distribution. As next you should add the corresponding PGP key to your apt keyring.

wget -O - http://download.opensuse.org/repositories/home:/j_morgenroth/[distribution]/Release.key | \
  sudo apt-key add -

Then add the URL to the list of repositories (/etc/apt/sources.list).

deb http://download.opensuse.org/repositories/home:/j_morgenroth/[distribution] ./

Update your packages list:

sudo apt-get update

Install IBR-DTN:

sudo apt-get install ibrdtnd ibrdtn-tools

MacPorts? Installation

To install IBR-DTN on a Mac you need to install macports first. As long as the recipes for IBR-DTN are not included in the official repository, some manual work is to do.

Then open the configuration "sources.conf" file of MacPorts? (should be located at /opt/local/etc/macports/sources.conf) and add the IBR DTN port repository line. Your sources.conf should look something like this example:

rsync://macports.ibr.cs.tu-bs.de/ibrdtn/
rsync://rsync.macports.org/release/ports/ [default]

Before you can use the new repository it must be synced by MacPorts?. This can be done by executing

sudo port selfupdate

Now it is time to install the IBR-DTN daemon (ibrdtnd) and the DTN tools (ibrdtn-tools).

sudo port install ibrdtnd ibrdtn-tools

If you feel adventurous you can try the Macports nightly repository, by using this URL instead

 rsync://macports.ibr.cs.tu-bs.de/ibrdtn-nightly/

Disclaimer: The nightly macports are generated from the GIT automatically, so expect IBR-DTN as well as the ports to be broken at any time.

Gentoo Linux Installation

On github a third-party portage overlay for Gentoo Linux is available. Visit the project page and follow the instructions to install IBR-DTN.

Windows Installation

The installation in Windows is done using an installer. It allows to install the daemon as service and provides the DTN tools as shell commands.

WRTNode Packages

The OpenWRT repository for the WRTNode (http://wrtnode.com) does not yet contain the IBR-DTN packages. This can easily be rectified by building your own OpenWRT, or just download this archive

https://www.ibr.cs.tu-bs.de/users/schildt/wrtnode.tar.bz2

and install all .ipk packages on the node. These packages work with the factory image already preinstalled when your WRTNode is delivered (as of Sept. 19th ours are based on BARRIER BREAKER (Bleeding Edge, r41508)

Last modified 4 years ago Last modified on 24.02.2015 09:02:21