Installing t6

t6 Installation

Install node (if needed): https://nodejs.org/en/
Install npm (if needed): https://github.com/npm/npm

Do not use sudo/root to install t6, this is not necessary and not recommended.

$ git clone https://github.com/mathcoll/t6.git ./t6 & cd ./t6
$ npm install
$ rename "settings-hostname.js" according to your server _hostname_ and edit the file.
$ rename "rules-hostname.js" according to your server _hostname_.
$ rename "sensors-hostname.js" according to your server _hostname_.
$ rename "db-hostname.json" according to your server _hostname_.

✨ On linux, to identify your hostname, you can run the following command:

$ hostname

Please have a look at the options in settings-hostname.js, there are some secrets to be customized.

t6 as a startup service (Linux)

You can add the server running as a service, tested with Ubuntu and Debian:

• First: install the server as service:

$ sudo ln -s /var/www/t6/etc/init.d/t6 /etc/init.d/t6

• And then, start t6 using:

$ sudo /etc/init.d/t6 (re)start|stop|status

• Finally, set the service to run at startup:

$ sudo update-rc.d t6 defaults

t6 timeseries settings

Once the setting are done, you can initialize the influxDb databases:

CREATE DATABASE "t6"

Database will contains the following measurements:

• data: All timeseries for measures;
• events: events happening in t6 Api; not really used, except for few logs;
• requests: Allows to manage quotas and limits;

t6 Troobleshooting after installation

Q: sudo /etc/init.d/t6 start does not return any output, what should I do?

A: Try to set chmod +x to file /var/www/t6/bin/www

Q: Do I need to install sqlite3?

A: sqlite3 is not required and can be disabled in the settings. sqlite3 library to store data is not maintained and become obsolete. You should avoid activating sqlite3.

Q: I got an error trying to install sqlite3, what should I do?

A: Ubuntu and Debian usually have a dedicated nodejs version, try removing "node" and install sudo apt-get install nodejs-legacy instead, then sudo npm install sqlite3@3.0.5.