The network topology within eNMS originates from the Device and Link inventory that gets loaded. There are several ways below to add this information into eNMS. Having accurate device and link inventory data available to the various processing features of eNMS is critically important to device security and automation accuracy.
From the UI Manually (One at a Time)
Users can manually create each Device and Link in the inventory by
filling a form in
Inventory -> Devices and
Inventory -> Links using the
+ button in the top menu.
Some properties are mandatory:
- Name: objects are uniquely defined by their name.
- Source and destination: a link needs a source and a destination to be created.
- In order to visualize the network topology on a map, devices must have geographical coordinates (longitude and latitude).
Manual topology changes (editing a Device or Link) might be overwritten by any topology import. If topology information is updated from an external source of truth, make sure to edit the external source system first.
From an Excel Spreadsheet
The inventory can be imported-from and exported-to an Excel spreadsheet in
Inventory section of the Administration (Admin) panel.
Examples of such spreadsheets can be found in
files/spreadsheets. It is important
that the proper column heading names match the examples in order to import
Importing an object that has already been created updates its properties.
Querying an external API
Another way to create the network topology is to query an external API. The following are supported:
This is accomplished by creating and running a
Topology Import service from
Automation -> Services page. Step 2 of the service allows you to select
Import Type the user wishes to connect with and filling the
corresponding section of the form.
Externally driving the REST API
Inventory can also be created by using an external script or program to call the REST API to add Devices and Links. This is particularly useful if another system is used to maintain the network source of truth. It can audit and add/delete Devices and Links on demand from the inventory. See the documentation section on the REST API for more information.