Tango Station Control

Station Control software related to Tango devices.

Index

• Docker compose documentation
  • Timescaledb
  • Jupyter startup files
  • Tango Prometheus exporter
• ReadTheDocs (Sphinx / ReStructuredText) documentation
• Source code documentation
  • Attribute wrapper documentation
  • Archiver documentation
  • Adding a new tango device
  • HDF5 statistics
• Unit tests
• Integration tests

Installation

Prerequisites

After checking out this repo, be sure to also check out the submodules:

git submodule init
git submodule update

You will also need:

• docker
• docker-compose
• make
• bash

Bootstrap

The bootstrap procedure is needed only once. First we build all docker containers, and load the initial configuration. This may take a while:

cd docker-compose
make bootstrap

If you lack access to LOFAR station hardware, configure the devices to use their simulators instead:

for sim in ../CDB/*-sim-config.json; do
  ../sbin/update_ConfigDb.sh ../CDB${sim}-config.json
done

Now we can start all containers, and make sure everything is up:

make start
make status

If not, you can inspect why with docker logs <container>. The containers will automatically be restarted on reboot or failure. Stop them explicitly to bring them down (make stop <container>).

Most notably, you will have web interfaces available at http://localhost:8888 (Jupyter Notebook), and http://localhost:3000 (Grafana).