How do I collect from Ubiquity EdgeOS

[Available since Nanitor 1.6.2 - ca. July 2018].

Nanitor supports EdgeOS devices through the Nanitor Collector.

Prerequisites

  1. You need to have a Nanitor Collector up and running. A single collector can collect from multiple network devices, servers and databases.
  2. You need to have the IP address of the EdgeOS devices and the collector needs to have network access to connect to the device via SSH.
  3. You need to have a user with sufficient privileges

Example of creating a user for collecting required data (with minimum privileges):

The user must have the admin level because EdgeOS only has admin and operator roles. The operator role is meant to be read-only, but it does not allow accessing over SSH. The nanitor user must therefore be admin even though it only needs to run show version and show configuration.

Here is an example how to create a nanitor user on the EdgeOS device:

edit
system login user nanitor
set level admin
set authentication plaintext-password mypassword 
commit

Adding the device to Nanitor

Run this command to avoid putting the passwords in .bash_history:
unset HISTFILE

Now we add the credentials (the passwords are stored locally in an encrypted format).

The credentials are created as follows

$ sudo /usr/lib/nanitor-collector/bin/nanitor-collector-ctl credential_add --title edgeos-nanitor --access_method ssh --username nanitor --password mypass

Now we add the device and start collection from the EdgeOS device (here with IP address 172.9.3.5):

$ sudo /usr/lib/nanitor-collector/bin/nanitor-collector-ctl device_add --title edgeos1 --device_type edgeos --address 172.9.3.1 --credential_title edgeos-nanitor

This can take a few seconds as it will complete authenticating and fully collecting the first results.  Once completed, the results will be immediately available in the Nanitor UI.  The collector will continue collecting results once every 24 hours.

If the results do not appear in the Nanitor UI, ensure that the benchmarks are selected (EdgeOS) and in scope for the organization (Administration - Organization Management - Settings - Benchmarks tab). 

Still need help? Contact Us Contact Us