Robotics Service Bus

h1. Installation

h2. External Dependencies

* Boost (mostly dependencies of RSC library), in particular
** boost::uuid (can be installed from GAR installer via contrib/boost.uuid, maverick: libboost1.42-dev)
** libboost-thread-dev
** libboost-filesystem-dev
** libboost-signals-dev

* Google Protocol Buffers (can also be installed from GAR installer via contrib/protobuf), in particular
** libprotobuf-java
** libprotobuf-dev
** protobuf-compiler

Up to this step, in Maverick installing the dependencies should be as simple as:
<pre>
sudo apt-get install libprotobuf-java libprotobuf-dev protobuf-compiler libboost-thread-dev libboost-filesystem-dev libboost-signals-dev libboost1.42-dev
</pre>

* Spread Toolkit for Spread multicast transport extension (lucid ubuntu package does *not* work, due to outdated version 3)
** Can be installed through GAR installer via contrib/spread or from source

h3. RSBProtocol, RSC, RSB

* Check out sources from SVN, see landing page of this and the RSC project
* RSC SVN URL: https://code.cor-lab.org/svn/rsc/trunk/rsc/
* CMake is required to configure the projects, however then it shoud be as simple as:

<pre>
cd RSBProtocol/build && cmake .. -DCMAKE_INSTALL_PREFIX=/vol/cit && make && make install
</pre>

h3. RSBPython

* spread-python (e.g. via GAR installer, sources can be downloaded here: http://www.spread.org/files/SpreadModule-1.5spread4.tgz
* spread-protobuf (via ubuntu package python-protobuf or protobuf sources)
* extract sources, edit setup.cfg and replace protocolroot with the path to the RSBPRobotocol files ( protocolroot=${prefix}/share/rsbprotocol)

<pre>
export PYTHONPATH=${prefix}/lib/python2.6/site-packages
python setup.py build
python setup.py install --prefix=${prefix}
</pre>

After that check with _import rsb_ in a python shell.

h3. RSBJava

* Download src from SVN (see front page)
* cd src and edit build.properties according to your installation
* ant dist
* install jars to prefix of your choice, e.g., ${prefix}/share/java ProtoBuf.jar

h2. Optional

* Doxygen for documentation generation (ubuntu package)
* lcov for coverage report (ubuntu package)