Preparation

Warning

Log files produced by the 0.16 version of the RSBag tools cannot be processed using the older versions. However, the opposite direction should work.

Installation

There are currently three different ways to install the 0.16 version of the RSBag tools:

  • Binary downloads
  • Debian packages
  • From source

The client API for Python is available via PyPi.

Binary Downloads

  1. Download the bag binary from the appropriate location:

  2. After the download, the bag 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. If required, download scripts from the locations given above.

Debian Packages

Debian packages for several versions of Ubuntu GNU/Linux are available from the CoR-Lab package repository.

  1. The following repository source line has to be added to /etc/apt/sources.list

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

    where RELEASENAME is the appropriate Ubuntu release name.

  2. After that, packages can be installed via

    $ sudo apt-get install PACKAGENAME
    

    where PACKAGENAME is rsbag-bin-cl0.16 for this release of RSBag.

Note

This installation method only works with Ubuntu GNU/Linux. More information can be found here.

From Source

Note

Building and installing RSBag and the associated tools from source requires the SBCL Common Lisp implementation and additional projects which can be downloaded from TODO. All remaining dependencies should be installable via Quicklisp.

  1. The entire source code of RSBag (for version 0.16) along with associated support files and this manual is available at “0.16” branch of https://code.cor-lab.org/git/rsbag.git.

  2. Build and install RSBag

    $ mkdir -p build && cd build
    $ cmake ..
    $ make
    $ make install
    

Testing the Installation

The success of the installation can be tested as follows:

$ rsbag cat --version
rsbag cat version     0.15.6-g8be064f
SBCL version          1.3.3.debian
RSB version           0.15.2-g1c67d1e
RSBAG version         0.15.8-g228292e
RSBAG-TIDELOG version 0.15.8-g228292e

Python PyPI Packages

For the RSBag client API for Python, a platform-independent package called rsbag-python is pushed to the central repository server and can be installed with pip or easy_install.

Note

pip is the recommended way of installing Python packages since some time and preferred over easy_install. On Ubuntu GNU/Linux systems, pip can be installed via the package python-pip.

Note

The Python implementation of RSBag is currently only available for Python 2.X. If the default Python version on your system is Python 3, ensure that you call the respective easy_install or pip version. These usually contain the Python version as a suffix to the name, e.g.: easy_install-2.7.

  1. rsbag-python depends on rsb-python which is also installable via PyPI.

  2. The rsbag-python module can be installed by using one of the following functions:

    $ easy_install "rsbag-python<=VERSION.99999"
    
    $ pip install "rsbag-python<=VERSION.99999"
    

    where VERSION needs to be replaced with 0.16.

    Note

    Development versions of RSBag are not deployed on PyPI. These commands will revert to the latest stable version.