Documentation

OS Support

Contact us via email to get a copy of the current release (2012). The current release has been fully tested on Ubuntu 10.04 32-bit. Support for Ubuntu 12.04 64-bit has been planned. If any bugs or problems, please contact us.

Compilation

To compile Cologne, please first install the following pre-requisites:

You can install them using one command in Ubuntu:

sudo apt-get install build-essential flex bison libssl-dev libgmp3-dev libboost-all-dev

You also need Gecode constraint solving library. To install Gecode, you need to download Gecode version 3.7.1, untar it and run:

./configure
./make
./sudo make install

(Note: if you have already installed an older version of Gecode, e.g., the default one provided by Ubuntu repository, please uninstall it before installing the newer one.)

./waf

If you see “build finished succesfully”, congratulations! You are ready to go.

Usage examples

There are a bunch of test cases in the folder examples/. For quick compiling, initially all those test cases are commented out. Here is one example showing how to run the use case Tcloud.

First, Enter the Cologne foler. edit src/wscript, find the ine ‘application/tcloud’ and uncomment it. (Note: since this is Python code, redundent spaces or tabs may cause compilation error, be careful.)

Second, edit examples/wscript, find the two lines contains ‘tcloud-test’, obj = bld.create_ns3_program(‘tcloud-test’) obj.source = ‘tcloud-test.cc’, and uncomment them.

Finally, edit examples/rapidnet-applications.h, find all lines containing ‘tcloud’ or ‘TCLOUD’, and uncomment them.

Now you are ready to run the Tcloud application. To execute a Cologne application:

./waf --run "examples/<application-name> <input-file-name>"

In this case, tcloud-test can run without input:

./waf --run examples/tcloud-test

A successful execution will return information including runtime, number of solutions found, goal value of the found solution.