temBoard installation from debian package (jessie)

Package repository setup

Add the temboard repository to the configuration of APT. Create /etc/apt/source.list.d/temboard.list with the following contents :

deb https://packages.temboard.io/apt/ jessie main

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]](https://wiki.postgresql.org/wiki/Apt).

In a nutshell, the following packages shall be installed, the "contribs" are needed by the supervision 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.