Docker

There’s also the possibility to run FROST-Server and the needed database inside one or multiple Docker containers. It is possible to use a non-dockerised database with a dockerised FROST-Server.

A Docker quick-start tutorial

If you have docker and docker-compose

1. Download our docker-compose file:

   wget https://raw.githubusercontent.com/FraunhoferIOSB/FROST-Server/v2.x/scripts/docker-compose.yaml

2. Start the server with docker: docker-compose up

3. Fetch a json file with some demo entities:

   wget https://gist.githubusercontent.com/hylkevds/4ffba774fe0128305047b7bcbcd2672e/raw/demoEntities.json

4. Post it to the server:

   curl -X POST -H "Content-Type: application/json" -d @demoEntities.json http://localhost:8080/FROST-Server/v1.1/Things

5. Browse to http://localhost:8080/FROST/DatabaseStatus
6. Click the upgrade button
7. Browse to http://localhost:8080/FROST-Server/v1.0
8. Enjoy!

Details

There are three docker images available:

• fraunhoferiosb/frost-server The all-in-one package
• fraunhoferiosb/frost-server-http The HTTP-only package
• fraunhoferiosb/frost-server-mqtt The MQTT-only package

To make deployment of these images easier, two example docker-compose files are provided. The docker-compose.yaml file uses the all-in-one server, and adds the required postgresql / postgis database. The docker-compose-separated.yaml file uses the separated HTTP and MQTT packages, adds the required postgresql / postgis database, and adds a mosquitto server as a message bus.

You can start the all-in-one docker image by running docker-compose up, or you can start the separated docker images using docker-compose -f docker-compose-separated.yaml up. This will download the latest version of the specified FROST-Server packages, and any dependencies, and starts it all. You can access the server by opening http://localhost:8080/FROST-Server/ in your browser.

If you want to build your own docker images, you can do this by calling:

mvn install
mvn dockerfile:build -pl FROST-Server.HTTP,FROST-Server.MQTT,FROST-Server.MQTTP

All data is stored inside the PostGIS database. To keep this state there’s a volume automatically mapped to the PostGIS container. For more information see the docker-compose.yaml file and the https://hub.docker.com/r/postgis/postgis/[PostGIS container documentation]

You can override all configuration settings by using environment variables in the docker-compose files.

Logging

The logging of FROST-Server components in the Docker container can be controlled in a limited way by the following environment variables. All take one of the values OFF, ERROR, WARN, INFO, DEBUG, TRACE.

• FROST_LL: The root logging level. Default: INFO.
• FROST_LL_parser: The logging level for the d.f.i.i.frostserver.parser package. Default: INFO.
• FROST_LL_settings: The logging level for the d.f.i.i.frostserver.settings package. Default: INFO.
• FROST_LL_queries: The logging level for the FROST query builder. Setting this to TRACE logs all queries before they are executed. Default: INFO.
• FROST_LL_io_moquette: The logging level for the io.moquette package. Default: WARN.
• FROST_LL_liquibase: The logging level for the liquibase package. Default: INFO.
• FROST_LL_org_jooq: The logging level for the org.jooq package. Default: INFO.