Installation of C++ Implementation¶

The information on this page has been superseded by the RSB Manual.

• Installation of C++ Implementation
  • Prerequisites
    • Supported Operating Systems and Compilers
    • Required Dependencies
    • Optional Dependencies
    • Installation of Dependencies on Debian-based Systems
  • Installation of RSC, RSBProtocol and RSB
• Windows Notes

Prerequisites¶

Supported Operating Systems and Compilers¶

• Linux (GCC 4.x)
• Windows (MS Visual Studio 9 2008)

Other combinations may be possible but are currently untested.

Required Dependencies¶

• Boost >= 1.38 (for hardy available in the gar-installer, 1.34.1 untested)
• Boost.UUID (header-only, officially included in Boost since 1.42, headers from this version can be used with all older versions of boost, gar-installer package available)
• Google Protocol Buffers
  • Ubuntu Lucid packages are ok (libprotobuf-dev, protobuf-compiler)
  • can also be installed from GAR installer via contrib/protobuf
• Spread Toolkit >= 4.0
  • Ubuntu Lucid package does not work, due to outdated version 3
  • Can be installed through GAR installer via contrib/spread or from source
• CMake (tested with 2.8)

Optional Dependencies¶

The C++ implementation can be built without these, but some features will be missing.

• Doxygen for API generation
• Lcov for code coverage analysis
• cppcheck for static code analysis

Installation of Dependencies on Debian-based Systems¶

Example for Ubuntu 10.04:

$ sudo apt-get install libprotobuf-dev protobuf-compiler build-essential libboost-dev

Installation of RSC, RSBProtocol and RSB¶

• Checkout RSB and its immediate dependencies from the Subversion repository:
  • RSC: https://code.cor-lab.org/svn/rsc/trunk/rsc
  • RSB Protocol: https://code.cor-lab.org/svn/rsb/trunk/protocol
  • RSB C++: https://code.cor-lab.org/svn/rsb/trunk/cpp/core
• CMake is required to configure the projects.
• Build and install the RSB C++ core and its dependencies (in the order given below):
  1. Build and install RSC Library:
     

     cd rsc/build && cmake .. -DCMAKE_INSTALL_PREFIX=$prefix && make && make install
     

  2. Install RSB Protocol Definitions
     

     cd protocol/build && cmake .. -DCMAKE_INSTALL_PREFIX=$prefix && make && make install
     

     
     Note: these protocol definitions are shared across programming languages.
  3. Build and install RSB C++ Core
     

     cd core/build && cmake .. -DCMAKE_INSTALL_PREFIX=$prefix -DRSC_DIR=$prefix/share/rsc && make && make install
     

Windows Notes¶

• Precondition: GIT client must be installed, e.g. GIT Shell, CMake also required
• Simplest installation: installation into a single SDK prefix recommendable
• Boost Pro installer (only 32-bit, 64-bit installer currently broken)
  • select matching visual studio version
  • dynamic plus threading with and witout debug symbols
• Spread install (pretty much standard)
  • Spread 4.1 (using the visual studio solution)
  • Only libspread required and the daemon exectuable
  • Manual installation required (copy dlls and excecs to bin folder of prefix, lib to libs, header to includes)
• Protocol buffers
  • Install as described in the README which can be found in the windows sub-folder of the package
• RSX as described above
  • cmake generates Visual Studio solutions
  • Install from visual studio should work
• nmake is probably also possible but has not been fully tested