Installation¶

See the BASIS guide on software installation for a complete list of build tools and detailed installation instructions.

Prerequisites¶

Dependency	Version	Description
BASIS	3.0.0	Utility to automate and standardize creating, documenting, and sharing software.
Sunrise Connectivity	>= 3.0	Java Provided by KUKA, Eclipse based Java platform
Fast Robot Int. SDK	>= 3.0	C++ Provided by KUKA, drivers for fast robot control
[Boost][4]	>= 1.54.	C++ Collection of general use C++ libraries.
[ZeroMQ][6]	>= 4.0	C++ High Performance Network Communication Library
[AZMQ][7]	>= 1.0	C++ [Boost.asio][5] based official ZeroMQ C++ Networking Library Interface
[JeroMQ][8]	>= 3.0	Java Official Pure Java implementation of ZeroMQ
[Google Flatbuf][9]	>= 1.0	Java/C++ High Performance Message Serialization Library
[V-REP][10]	>= 3.2	C++ Recommended robot simulation library (Optional)

Configure¶

Extract source files:
```
tar -xzf grl-1.0.0-source.tar.gz
```
Create build directory:
```
mkdir grl-1.0.0-build
```
Change to build directory:
```
cd grl-1.0.0-build
```
Run CMake to configure the build tree:
```
ccmake -DBASIS_DIR:PATH=/path/to/basis ../grl-1.0.0-source
```
- Press c to configure the build system and e to ignore warnings.
- Set CMAKE_INSTALL_PREFIX and other CMake variables and options.
- Continue pressing c until the option g is available.
- Then press g to generate the GNU Make configuration files.

Build¶

After the configuration of the build tree, the software can be build using GNU Make:

make

Test¶

After the build of the software, optionally run the tests using the command:

make test

In case of failing tests, re-run the tests, but this time by executing CTest directly with the -V option to enable verbose output and redirect the output to a text file:

ctest -V >& grl-test.log

and attach the file grl-test.log to the issue report.

Install¶

The final installation copies the built files and additional data and documentation files to the installation directory specified using the CMAKE_INSTALL_PREFIX option during the configuration of the build tree:

make install

After the successful installation, the build directory can be removed again.

Navigation