Compiling DTN2

At the moment, DTN2 comes in source form only. Before you can install it and start using it, you need to compile it.

On Unix

First, unpack the release.

$ gunzip -c DTN2-X.Y.Z.tgz | tar xvf -

Next, configure and compile DTN2: (the -C argument to configure enables the cache which speeds up the process)

$ cd DTN2
$ sh configure -C
$ make

If you just want to play with DTN2 to learn how it works, you can stop here. You can use all the programs as a regular user, with them in the source code directories. There's no need to do a full install into the public part of the filesystem. However, if you are deploying DTN2, you'll want to take a look at the tools/install.sh script. You might want to customize it, as it currently puts the files into /usr, and some people prefer to put files in /usr/local.

Fetching the source code with CVS

We will try our best to propagate bug fixes to the current release of the software. In some cases, however, you may want to get the source code from the anonymous CVS repository instead. Please understand that you're using pre-alpha software if you use the copy from CVS. We try to keep what's in CVS working, but it is under active development, and you might see bugs. Before reporting them, please always use "cvs up" to get the newest copy, then recompile and reproduce the bug.

$ cvs -d :pserver:anonymous@code.dtnrg.org:/orig login
(password is "bundles")
$ cvs -d :pserver:anonymous@code.dtnrg.org:/orig checkout DTN2

On Windows

DTN2 does not yet work as a native Windows application. It does, however, work with the Cygwin environment.

Install Cygwin

The first step is to install Cygwin on your computer. The best way to do this is to download setup.exe from their website. We suggest storing it on your computer in a new directory you make named c:\cygwin\download.

Start setup.exe and choose "Install from Internet". (Always think carefully before running an executeable you downloaded from the Internet, even if a nice manual like this told you to do it! Is your virus checker running? Is it up to date? Did the file come from the website you think it did?) Use the default root directory, c:\cygwin. Make the "Local Package Directory" c:\cygwin\download. Cygwin will ask you to choose a mirror, so choose one that is close to you on the Internet. It will then ask you to "Select Packages". The defaults here are pretty good, but you need to make a few changes:

Continue with the installation. When it is done, you'll have a working Cygwin installation and be ready to proceed. If you are asked to reboot, please do so. This ensures the correct version of Cygwin will be used.

Compile using Cygwin

Once you have installed Cygwin, you'll have a new item in your Start -> All Programs menu called Cygwin, and inside that, one called Bash. When you select it, you get a bash shell, which is like a CMD window, only cooler. You start out in your home directory, which in Cygwin is /home/$user, but in Windows, it is c:\cygwin\home\$user. Now that you have a Unix-like window, follow the Unix instructions above. Cygwin comes with CVS, so you can even use CVS to fetch the source code, as described above.