Preparation

Installing RSB

There are currently two ways to install the 0.6 version of RSB:

• Binary downloads (only for tools)
• Debian packages
• From source

Binary Downloads of RSB Tools

1. Download the tools binary from the appropriate location:

   • Linux i686
   • Linux x86_64
   • MacOS x86_64

2. After the download, the tools file has to be made executable in most cases. This can be done for example by executing

   chmod +x bag
   

   in the download directory.

3. The various tools-* tools are provided as symbolic links to the single |main_binary| binary. When invoked, it prints a list of these links and offers to create them:

   $ ./tools
   [...]
   Create missing links now [yes/no]? y
   Creating symbolic link info -> tools
   [...]
   

   Note

   The links can also be created as follows:

   Non-interactively

   $ ./tools create-links
   

   Manually

   $ for alias in info logger call ; do ln -s tools ${alias} ; done
   

From Source

1. The whole source tree of RSB can be obtained from the repository located at https://code.cor-lab.org/svn/rsb/branches/0.6. URLs of individual implementations:

   Language	Repository URL
   C++	https://code.cor-lab.org/svn/rsb/branches/0.6/cpp
   Java	https://code.cor-lab.org/svn/rsb/branches/0.6/java
   Python	https://code.cor-lab.org/svn/rsb/branches/0.6/python
   Common Lisp	https://code.cor-lab.org/svn/rsb/branches/0.6/cl
   Matlab	https://code.cor-lab.org/svn/rsb/branches/0.6/matlab

2. Build and install an implementation

   TODO

Debian Packages

Debian packages for several versions of Ubuntu GNU/Linux are available from the CoR-Lab package repository. The following repository source line has to be added to /etc/apt/sources.list:

deb http://packages.cor-lab.de/ubuntu/ RELEASENAME testing

where RELEASENAME is the appropriate Ubuntu release name.

Warning

This installation method only works with Ubuntu GNU/Linux.

Note

More information can be found here.

Running the Examples

TODO

Troubleshooting

1. Problem

   Calling any of the tools, the following happens:

   $ logger socket://localhost:7777
   WARNING:
     Failed to load Spread library: Unable to load any of the alternatives:
     ("libspread-without-signal-blocking.so" "libspread.so" "libspread.so.2"
      "libspread.so.2.0" "libspread.so.1").
     Did you set LD_LIBRARY_PATH?
     Spread transport will now be disabled.
   [execution continues, but Spread transport does not work]
   

   Solution

   Place one of the mentioned Spread libraries on the system library search path or set LD_LIBRARY_PATH appropriately.