Exareme-Docker

Exareme with Docker

Docker Installation

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

• Mac
• Windows
• Linux

Linux only: Use docker without sudo

Exareme Installation

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

$ sudo service docker start

4. Navigate to the Exareme Docker Directory:

$ cd <path to Exareme-Docker>

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

$ docker build -t exareme .

Run Exareme container

1. If you are planning to use Exareme with the Stream Server
2. Run the Stream Server Container
3. Run Exareme container (and link to streamserver):

$ docker run -i -t --rm -p 9090:9090  --link streamserver --name exareme exareme

![Alt text](/Exareme-Docker/screenshots/run_exareme.png?raw=true "Run Exareme container and link to Stream Server")

2. To run Exareme only:

$ docker run -i -t --rm -p 9090:9090  --name exareme exareme

3. Leave this console open while you are working and then stop the container.
4. Find your docker machine IP
5. On Linux is: localhost
6. 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)**.

Run Stream Queries on Exareme

Register a Stream Query

1. Select your favorite REST client. The following screenshots are from Andvanced REST client addon from chrome.
2. Open your REST client.
3. To query the Stream Server, as shown below, via Exareme you may register the following query:

select * from (file dialect:json 'http://streamserver:8989/measurements');

via a post request at: http://docker-machine-ip:9090/streamqueryregister/stream1 with paramter key: register_query and value the query. "stream1" is the name of the query you are registering.

###Get Query Results Get the results of the last 10 seconds by making a GET request at:

http://**docker-machine-ip**:9090/streamqueryresult/stream1?last=10

Exit Exareme container

To gracefully stop your docker container:

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