sentilo/sentilo-agent-historian repository overview

⁠Sentilo 2.0.0

⁠What is Sentilo?

The Barcelona City Council, through the Municipal Institute of Informatics (IMI), started in November 2012 a project conceived for define the strategy and the necessary actions in order to achieve global positioning Barcelona as a reference in the field of Smart Cities.

Sentilo is an open source sensor and actuator platform designed to fit in the Smart City architecture of any city who looks for openness and easy interoperability. It’s built, used, and supported by an active and diverse community of cities and companies that believe that using open standards and free software is the first smart decision a Smart City should take.

Sentilo is the piece of architecture that isolates the applications that are developed to exploit the information “generated by the city” and the layer of sensors deployed across the city to collect and broadcast this information.

In order to avoid vertical solutions, Sentilo is designed as a cross platorm with the objective of sharing information between heterogeneous systems and to easily integrate legacy applications.

⁠Where to get more info?

You can find all available information about Sentilo in our official webpage: https://www.sentilo.io⁠

⁠About this image

This is the official docker image of the core component of the Sentilo platform, the Agent Historian. It runs over a Java8 environment and offers the Sentilo Agent historian server module.

⁠How to use this image

This image is based in the OpenJDK docker official image⁠, using the 8 version.

⁠Configuration

It is possible to configure internal working directories, as well as mount some data volumes via ARG and ENV params.

⁠ARG

The only accepted ARG type parameter is OPENJDK_VERSION. This parameter is the one that defines the version of OpenJDK used by the image. Its default value is 8 (minimum java version required), and it is not recommended to change it, since it could cause stability errors on the platform.

⁠ENV

These are the parameters accepted by ENV:

⁠VOLUMES

There are two data volumes that can be mounted locally to be able to work easily with the image (they are also defined as configurable ENV variable):

NOTE: It is recommended to mount both volumes in order to more precisely control the configuration and output logs of the platform. The related ENV parameters can be modified as needed, as shown in the previous section.

⁠Run

Run a docker container using this image:

$ docker run -d \
  --name=sentilo-agent-historian \
  -v $PWD/conf:/etc/sentilo \
  -v $PWD/logs:/var/log/sentilo \
  --network sentilo-network \
  sentilo/sentilo-agent-historian:latest

IMPORTANT: Make sure you put your own .conf files in the config directory before booting this image, and have all the premises up and running (Redis, Mongo, etc...)

NOTE: you may receive an execution error on execute above docker run command if you don't create the newtork previously

⁠Networking

It is recommended to create a docker network to connect all containers to it and manage internal connections easily:

$ docker network create sentilo-network