Unimus supports syncing devices with NMS / DCIM systems of various vendors.
This approach allows you to automate adoption of new networks into Unimus as well as simplify device management.
After configuring NMS Sync, you only need to add devices into your NMS, and Unimus will pick them up automatically.
(You only need to manage devices on the NMS)
Unimus identifies and keeps track of existing local devices, which allows device adoption under a given Sync Preset.
Devices no longer provided by import source from an NMS become orphaned.
NMS Sync is configured via Sync Presets, which specify an NMS instance to import devices from, along with few other settings.
Steps to create NMS Sync Preset:
*Some NMS types require configuring Sync Rules. These specify which devices to import from an NMS.
Each Sync Rule requires a "container" identifier, specifying the group of devices on the NMS, and a target Zone where to import devices into. Container identifiers vary according to each NMS type.
With NMS types without Sync Rules all configuration of which devices to import is done on the NMS.
The NMS'es that don't have Sync Rules are tagged in the table of supported NMS types below.
Some NMS types provide UUIDs of devices, along with their addresses. (UUIDs are not visible to the users via GUI)
These enable more consistent device tracking between Unimus and NMS.
When a device is defined by UUID, on top of its address, its actual address change on the NMS will be reflected on Unimus upon Sync completion.
In the same scenario, when NMS doesn't support UUIDs, new devices would be imported.
The NMS'es that support UUIDs are tagged in the table of supported NMS types below.
Devices imported by a Sync Preset become adopted by this Sync Preset.
Existing local devices without adoption and orphaned devices can become adopted by a Sync Preset.
The scope of devices considered for adoption is influenced by Device Action policy setting.
In addition to no longer being present on NMS within a given identifier, devices can become orphaned by:
This policy control the syncing behavior in regards to existing local devices (on Unimus) that match devices provided by the NMS during a Sync. Three options exist:
During NMS Sync no devices will be moved between Zones.
A device provided by NMS will be imported into the target Zone, unless it already exists.
During NMS Sync, before a device is imported to the target Zone, the algorithm will check for a matching device in Preset Zones and if a match is found will attempt to move it to the target Zone.
Preset Zones are all target Zones specified by all Sync Rules under a given Sync Preset.
If no match is found the device provided by NMS will be imported into the target Zone.
Note: Multiple matching candidates found counts as a failed operation (multiple candidates for update found).
Same as "Move within Preset Zones" option, but all Unimus Zones are checked for a matching device.
Action taken on orphaned device under a given Sync Preset upon completion of a Sync is configured via Orphaning policy. Three options exist:
Device is retained in Unimus, though it is now eligible for adoption by any Sync Preset
Device becomes unmanaged in Unimus. No further jobs will run on it. Backups are kept. Device is eligible for adoption by any Sync Preset.
Device is deleted from Unimus, along with all its backups.
For more details on each NMS Sync connector, please see the appropriate articles:
NMS type | Supports UUIDs | Has Sync Rules |
---|---|---|
LibreNMS | yes | yes |
Nautobot | yes | yes |
NetBox | yes | yes |
NetXMS | yes | yes |
Observium | yes | yes |
Panopta | yes | no |
Powercode | no | no |
PRTG | no | yes |
Zabbix | no | yes |