StreamServer with Docker

Docker Installation

Install Docker (on linux) or Docker-toolbox (on Windows/Mac)

• Mac
• Windows
• Linux

Linux only: Use docker without sudo

Stream Server Installation

1. Open a terminal (Docker Quickstart Terminal on Windows/Mac or standard terminal on Linux).
2. Download zip and unzip or “git clone” from Stream Server repository

$ git clone https://github.com/madgik/Docker-StreamServer.git

3. Linux only:

$ sudo service docker start

4. Navigate to the Stream Server Directory:

$ cd <path to Docker-StreamServer>

5. Build Stream Server image (this may take a few minutes the first time):

$ docker build -t streamserver .

Run Stream Server container

1. Execute:

$ docker run -i -t --rm -p 8989:8989 --name streamserver streamserver

2. Leave this console open while you are working and then stop the container. 3. Find your docker machine IP

1. On Linux is: localhost
2. On Windows/Mac open a new Docker Quickstart Terminal and run:

```
$ docker-machine ip
```
It will return your docker-machine ip **(from now on use this instead of localhost if you are on Windows or Mac)**.

Test the Stream Server

Test the Stream Server by calling curl on http://docker-machine-ip:8989/measurements

$ curl http://docker-machine-ip:8989/measurements
{"schema":[["timestamp",null],["assembly",null],["sensor",null],["value",null]]}
["2016-03-07T20:13:55+00:00",1.127384714E9,"TC255",58.7]
["2016-03-07T20:13:56+00:00",1.127384715E9,"TC255",58.099]
["2016-03-07T20:13:57+00:00",1.127384716E9,"TC255",57.5]
["2016-03-07T20:13:58+00:00",1.127384717E9,"TC255",56.9]
["2016-03-07T20:13:59+00:00",1.127384718E9,"TC255",56.2]
["2016-03-07T20:14:00+00:00",1.127384719E9,"TC255",55.799]
["2016-03-07T20:14:01+00:00",1.12738472E9,"TC255",55.2]
["2016-03-07T20:14:02+00:00",1.127384721E9,"TC255",54.7]
["2016-03-07T20:14:03+00:00",1.127384722E9,"TC255",54.099]
["2016-03-07T20:14:04+00:00",1.127384723E9,"TC255",53.7]

or open http://docker-machine-ip:8989/measurements on Chrome

Exit Stream Server container

To gracefully stop your docker container:

1. Select your Stream Server docker console.
2. Press Ctrl+C.
3. Close the console.

Run multiple Stream Servers

You can run multiple stream servers, concurently, on different docker containers. Just choose a different container name and forward 8989 port to a different port on your local machine.

1. Open a terminal (Docker Quickstart Terminal on Windows/Mac or standard terminal on Linux).
2. Execute the following command to start a streamserver named second_streamserver that produces a stream accesible by your docker machine IP:8990

docker run -i -t --rm -p 8990:8989 --name second_streamserver streamserver

3. Test the Stream Server by opening http://docker-machine-ip:8990/measurements on your browser

Add datasets

To load your own dataset into the stream server you must place your csv file into the "dataset" folder. The name of the fiule must hasve a ".csv" suffix. The filename determines the uri address, i.e. the "measurements.csv" dataset is available at the "/measurements" URI.

The csv files must have the following format:

HEADER : The first row must contain the name of the columns for example (timestamp, sensor, value). The first column must be always the timestamp.
VALUES : The timestamp must be in the RCF3339 format. For example 2016-03-07T20:13:55+00:00 is a valid timestamp.

Streamserver use the files in the "dataset" directory to produce infinite stream data. The timetstamps must be orderedchronogically from older to newer. Streamserver use the timestamps only to simulate the intervals between two different tuples of the stream. The streamserver replaces the timestamps with current timestamps.

After this you must re-built and re-run the docker container.

##Troubleshoot

• If you are getting an error like:

  docker: Error response from daemon: Conflict. The name "/streamserver" is already in use by container b13022c72864ad6e7651c1681764ec6ed1554f247e11a1070675b952041fbc78. You have to remove (or rename)

  Run:

  docker stop streamserver

  or

  docker kill streamserver