.. _preparation: ============= Preparation ============= .. warning:: :term:`Log files ` produced by the |version| version of the |project| tools cannot be processed using the older versions. However, the opposite direction should work. .. _install: Installation ============ There are currently three different ways to install the |version| version of the |project| tools: * Binary downloads * Debian packages * From source Binary Downloads ---------------- #. Download the :file:`bag` binary from the appropriate location: * `Linux i686 `_ * `Linux x86_64 `_ * `MacOS x86_64 `_ #. After the download, the :file:`bag` file has to be made executable in most cases. This can be done for example by executing .. code-block:: sh $ chmod +x bag in the download directory. #. If required, download scripts from the locations given above. Debian Packages --------------- Debian packages for several versions of |ubuntu| are available from the `CoR-Lab package repository `_. #. The following repository source line has to be added to :file:`/etc/apt/sources.list` .. parsed-literal:: deb http://packages.cor-lab.de/ubuntu/ :samp:`{RELEASENAME}` main where :samp:`{RELEASENAME}` is the appropriate Ubuntu release name. #. After that, packages can be installed via .. code-block:: sh $ sudo apt-get install PACKAGENAME where :samp:`{PACKAGENAME}` is |package_name| for this release of |project|. .. note:: This installation method only works with |ubuntu|. More information can be found `here `_. From Source ----------- .. note:: Building and installing |project| 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`_. #. The entire source code of |project| (for version |version|) along with associated support files and this manual is available at |repository_versioned|. #. Build and install |project| .. code-block:: sh $ mkdir -p build && cd build $ cmake .. $ make $ make install Testing the Installation ======================== The success of the installation can be tested as follows: .. code-block:: sh $ bag-cat --version bag-cat version 0.6.0 SBCL version 1.0.55 RSB version 0.6.0 RSBAG version 0.6.0 RSBAG-TIDELOG version 0.6.0