Setup on Debian¶
This part of the documentation covers the installation of Kotori and other software components it relies on. The first step to using any software package is getting it properly installed. Please read this section carefully. After successfully installing the software, you might want to follow up with its configuration at Getting started.
This document describes the installation of the whole software stack for telemetry data acquisition, processing and visualization on a Debian-based system. It is currently made of these free and open source software components:
- Kotori, a data acquisition, graphing and telemetry toolkit
- Grafana, a graph and dashboard builder for visualizing time series metrics
- InfluxDB, a time-series database
- Mosquitto, a MQTT message broker
- MongoDB, a document store (optional) ¹²
The package repository supports both architectures
Some effort has been done to make the installation process of Kotori and associated software components as easy and straight forward as possible.
However, things are complicated sometimes so there might still be rough
edges we would love to learn about. So, don’t hesitate to drop us a note
by opening an issue on GitHub
or reaching out to
firstname.lastname@example.org. Thanks already.
We are going to do telemetry data acquisition, sometimes coming from measurement systems which do not send appropriate timestamps. Thus, the timekeeping of your data acquisition system itself should be accurate.
So, you either might want to enable the NTP feature of
timedatectl set-ntp true
apt install chrony
or implement any other valid equivalent to keep the system time sound.
Register with package repository¶
Add https addon for apt:
apt install apt-transport-https software-properties-common
Add source for “testing” distribution (will append to /etc/apt/sources.list):
apt-add-repository 'deb https://packages.elmyra.de/elmyra/foss/debian/ testing main foundation'
Add GPG key for checking package signatures:
wget -qO - https://packages.elmyra.de/elmyra/foss/debian/pubkey.txt | apt-key add -
Reindex package database:
Setup the whole software stack¶
Install Kotori as well as recommended and suggested packages:
apt install --install-recommends --install-suggests kotori
InfluxDB and Grafana are not always started automatically, so ensure they are running by executing:
systemctl start influxdb grafana-server
Watching the system¶
These are the log files at a glance where system messages might appear:
tail -F /var/log/kotori/*.log /var/log/grafana/*.log /var/log/influxdb/*.log /var/log/mosquitto/*.log journalctl -f -u influxdb