Configure LibreNMS for CENTAURI

Overview

This article describes the process for configuring LibreNMS to work with CENTAURI devices. While LibreNMS will work with CENTAURI via SNMP out of the box, with no additional configuration required, CENTAURI will appear to LibreNMS as a generic Linux server.

Below we cover the basics of how to allow LibreNMS to discover and identify CENTAURI devices natively, as well as how to enable health graphs for link and laser Received (Rx) and Transmit (Tx) power.

Before You Start

While we do assume that you have LibreNMS installed, the application does not need to be started or restarted for the setup of CENTAURI monitoring to be successful.

Install CENTAURI Configuration Files

The installation process involves copying the required configuration files to the appropriate location for your LibreNMS installation, so that the next time a CENTAURI device is discovered (or re-discovered for existing CENTAURI devices), it will. be recognised as a CENTAURI (and not a generic Linux server).

The installation procedure and configuration steps below. have been tested with LibreNMS Version 21.11.0.  Your mileage may vary with regard to other versions of LibreNMS.

1. Download and save the librenms-centauri.tar file to your LibreNMS server's /tmp directory
   The file is attached to this article, below.
2. Extract the .tar file contents

   cd /tmp
   
   tar xvf librenms-centauri.tar

3. Run the installation script

   sudo ./install.sh

   The install.sh script assumes that LibreNMS is installed in the default directory, which is /opt/librenms

   
   If your installation is in a different directory, you may run the script as follows:
   
   

   sudo ./install.sh -i <libre_install_dir>

   Where <libre_install_dir> is your chosen installation directory.

Post-Installation

After installation and upon logging into LibreNMS, existing CENTAURI devices should be re-discovered, picking up the new configuration.

Once identified as CENTAURI, the Device Health page for each device will show the Laser Tx/Rx Power Graph on the ‘Signal’ tab for each device.

Navigate to the ‘Signal’ tab by going to the ‘Devices’ top-level menu, selecting ‘All Devices’, and then. select a CENTAURI device from the list.

Creating CENTAURI 'Groups'

You may create a device group just for CENTAURI in LibreNMS.

To do so, navigate to ‘Devices’ in the top-level menu, then select ‘Manage Groups’, and then select ‘+ New Device Group’.

Choose a name for the new group (we like ‘CENTAURI’!). 

For the Type option, select ‘Dynamic’.

The entry for ‘Define Rules’ should be:

‘devices.sysName’ ‘regex’ ‘^CEN0[012][105]-20[0-9]+’

When entering the values for 'Define Rules', do not enter the single quotes as indicated above.

Save the newly created group.

Once saved, the CENTAURI device group can be viewed by selecting the ‘Devices’ top-level menu, then selecting ‘Device Groups’ and finally, selecting ‘CENTAURI’ (or whatever you might have named it).

Questions? Need help? You can reach us via our support portal at https://support.transcelestial.com.