2015-08-09 23:58:03 +02:00
|
|
|
# Setup
|
2014-07-14 11:01:34 +00:00
|
|
|
|
2014-07-16 09:34:04 +00:00
|
|
|
## Compilation
|
|
|
|
|
|
2014-08-31 17:42:15 +00:00
|
|
|
### Prerequisites
|
|
|
|
|
|
2016-02-10 19:58:05 +01:00
|
|
|
Install libraries and developement headers for:
|
|
|
|
|
|
|
|
|
|
- [libconfig](http://www.hyperrealm.com/libconfig/) for parsing the configuration file.
|
|
|
|
|
- [libnl3](http://www.infradead.org/~tgr/libnl/) for the network communication & emulation support of the `socket` node-type.
|
|
|
|
|
- libOpal{AsyncApi,Core,Utils} for running the S2SS server as an Asynchronous process inside your RT-LAB model.
|
|
|
|
|
- [pciuitils](http://mj.ucw.cz/sw/pciutils/) for enumerating PCI devices. Required by `gtfpga` node-type.
|
|
|
|
|
- [libjansson](http://www.digip.org/jansson/) JSON parser for `websocket` and `ngsi` node-types.
|
|
|
|
|
- [libwebsockets](http://libwebsockets.org) for the `websocket` node-type.
|
|
|
|
|
- [libcurl](https://curl.haxx.se/libcurl/) for HTTP REST requests by the `ngsi` node-type.
|
|
|
|
|
- [libuuid](http://sourceforge.net/projects/libuuid/) for generating random IDs. Required by the `ngsi` node-type.
|
2015-08-09 23:58:03 +02:00
|
|
|
|
|
|
|
|
Use the following command to install the dependencies under Debian-based distributions:
|
|
|
|
|
|
2015-09-27 18:03:41 +02:00
|
|
|
$ sudo apt-get install build-essential pkg-config libconfig-dev libnl-3-dev libnl-route-3-dev libpci-deb libjansson-dev libcurl4-openssl-dev uuid-dev
|
2014-08-31 17:42:15 +00:00
|
|
|
|
2015-08-09 23:58:03 +02:00
|
|
|
or the following line for Fedora / CentOS / Redhat systems:
|
2014-08-31 17:42:15 +00:00
|
|
|
|
2015-09-27 18:03:41 +02:00
|
|
|
$ sudo yum install pkgconfig gcc make libconfig-devel libnl3-devel pciutils-devel libcurl-devel jansson-devel libuuid-devel
|
2014-08-31 17:42:15 +00:00
|
|
|
|
|
|
|
|
### Compilation
|
|
|
|
|
|
2015-08-22 17:40:17 +02:00
|
|
|
Checkout the `Makefile` and `include/config.h` for some options which have to be specified at compile time.
|
2014-07-16 09:34:04 +00:00
|
|
|
|
2014-08-31 17:42:15 +00:00
|
|
|
Afterwards, start the compilation with:
|
2014-07-16 09:34:04 +00:00
|
|
|
|
|
|
|
|
$ make
|
|
|
|
|
|
2015-08-22 17:40:17 +02:00
|
|
|
Append `V=5` to `make` for a more verbose debugging output.
|
|
|
|
|
Append `DEBUG=1` to `make` to add debug symbols.
|
2016-02-10 19:58:05 +01:00
|
|
|
|
|
|
|
|
### Installation
|
|
|
|
|
|
|
|
|
|
Install the files to your search path:
|
|
|
|
|
|
|
|
|
|
$ make install
|
|
|
|
|
|
|
|
|
|
Append `PREFIX=/opt/local` to change the installation destination.
|
|
|
|
|
|
|
|
|
|
### Test
|
|
|
|
|
|
|
|
|
|
Verify everything is working and required node-types are compiled-in:
|
|
|
|
|
|
|
|
|
|
$ s2ss server
|
|
|
|
|
|
|
|
|
|
Will show you the current version of the server including a list of all supported node-types.
|
