temBoard installation from debian package (jessie)

Package repository setup

Add the temboard repository to the configuration of APT:

echo 'deb https://packages.temboard.io/apt/ jessie main' > /etc/apt/source.list.d/temboard.list

Ensure APT can handle HTTPS:

sudo apt-get install apt-transport-https

Add the GPG key of the repository and update the packages list:

sudo apt-get install wget ca-certificates
wget -q -O - https://packages.temboard.io/apt/265B525B.asc | sudo apt-key add -
sudo apt-get update

A database in a PostgreSQL 9.5 cluster is required to run temBoard, if you intend to host it on the same machine, add the definition of the repository of the PGPG, by following their howto.

In a nutshell, the following packages shall be installed, the "contribs" are needed by the monitoring plugin:

sudo apt-get install postgresql-9.5 postgresql-contrib-9.5

Installation

sudo apt-get install temboard

The database access must be set up otherwise the temboard service will not start. See doc/temboard-repository-setup.md.

Operations

Important files and directories

  • /etc/temboard: stores the temboard.conf configuration file and SSL certificates
  • /var/log/temboard: stores the logs
  • /var/run/temboard: stores the PID file

Start

sudo service temboard start

Status

sudo service temboard status

● temboard.service - LSB: Start temboard
   Loaded: loaded (/etc/init.d/temboard)
   Active: active (running) since Thu 2016-08-25 16:18:29 CEST; 16h ago
  Process: 6373 ExecStart=/etc/init.d/temboard start (code=exited, status=0/SUCCESS)
   CGroup: /system.slice/temboard.service
           └─6377 /usr/bin/python /usr/bin/temboard -c /etc/temboard/temboard.conf -d -p /var/run/temboard/temboard.pid

Aug 25 16:18:29 debian-tbd-ui temboard[6373]: Starting: temboard.

Reload configuration

sudo service temboard reload

Stop

sudo service temboard stop

Package building

To create a new debian package from temboard sources, the packages dpkg-dev, debhelper and dh-python have to be installed.

sudo apt-get install dpkg-dev debhelper dh-python

Then, you need to go in temboard/debian directory and execute the script make_deb.sh. Once the script executed, the .deb file can be found in ../.. directory.

A source package is also available for Debian Jessie in the packages.temboard.io repository.