Telemetry Service

FMADIO offers a remote telemetry service, where syslog traffic is sent to FMADIO monitoring infrastructure over a secure SSH tunnel. This allow FMADIO staff to monitor the system and get ahead of any issues the system may have.

To configure the service follow these steps

Configuration

Step 1) Generate unique SSH key

FMADIO devices by default have a pre-installed ssh key. To correctly secure and uniquely identify the system generate your own SSH key as follows.

ssh-keygen -t rsa -b 3072

Using a password less key ensures the automatic setup requires no manual intervention.

Example output per below

fmadio@fmadio100p3-539:~$ ssh-keygen -t rsa -b 3072
Generating public/private rsa key pair.
Enter file in which to save the key (/home/fmadio/.ssh/id_rsa):
/home/fmadio/.ssh/id_rsa already exists.
Overwrite (y/n)? y
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/fmadio/.ssh/id_rsa
Your public key has been saved in /home/fmadio/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:G/***************************** fmadio@fmadio100p3-539
The key's randomart image is:
+---[RSA 3072]----+
|  Eo.oo=Bo  .    |
|  o .o.. o.. +   |
| . ..+  +.o o o  |
|. .   =..+   . ..|
| .     +S o     o|
|    .  ..+ o   . |
|   ..+.oo.  o .  |
|  o. o= =  o   . |
|   oo..o .  .oo  |
+----[SHA256]-----+
fmadio@fmadio100p3-539:~$

Send the public key (below) to support@fmad.io

/opt/fmadio/etc/fmadio_id_rsa.pub

Step 2) Copy to persistent Storage

The SSH public/private keys are on the volatile file system. Copy the keys to the persistent storage.

cp .ssh/id_rsa /opt/fmadio/etc/fmadio_id_rsa

cp .ssh/id_rsa.pub /opt/fmadio/etc/fmadio_id_rsa.pub

NOTE: the key is renamed with an fmadio_* prefix. The system copies the keys from this location and renames them in the .ssh/id_rsa .ssh/id_rsa.pub directory during the boot process.

Step 3) Copy the reference boot script

There is a reference boot script located in

/opt/fmadio/etc_ro/boot.lua.telemetry_mon2

Copy this to to the /opt/fmadio/etc/boot.lua file to automatically establish ssh tunnel to the telemetry service.

cp /opt/fmadio/etc_ro/boot.lua.telemetry_mon2  /opt/fmadio/etc/boot.lua

After copying replace the "username" to the username provided by fmadio support and save the file.

Step 4) Copy the reference rsyslog config

In addition to ssh tunnel setup, rsyslog configuration to forward syslog messages to the SSH tunnel.

Copy the reference config to /opt/fmadio/etc/ directory as follows.

cp /opt/fmadio/etc_ro/syslogd.conf.tunnel /opt/fmadio/etc/syslogd.conf

No modifications are required.

Step 5) Reboot the system

Reboot the system to check all the above steps are executed correctly

Step 6) Validate

After rebooting log into the Grafana monitoring site with the assigned username and confirm data is being recevied.

Any problems please contact support@fmad.io

Debugging

Logfiles can usually be found in the syslog. There are usually some kind of error or warning messages on what the issue is

/mnt/store0/log/messages