1. Home
  2. How To ...
  3. How to Add a Device to Netreo Using Device Import

How to Add a Device to Netreo Using Device Import

This procedure takes you through manually adding one or more devices to Netreo using the Device Import option. Use these steps if you don’t want to wait for Netreo’s normally scheduled autodiscovery scan to automatically discover a new device on your network, or if you have previously exported your list of devices and now wish to import them (for example, when reinstalling Netreo).

The Import/Export Devices page. Click the “More About File Format” panel to see explanations of the configuration fields included in the CSV import template.

Adding devices to Netreo using Device Import allows you to simultaneously add any number of devices using a CSV file. Device Import offers a large set of configuration settings for configuring your new devices as they are being added to Netreo. You may use as many, or as few, of the configuration settings as desired. Additionally, there is an optional checkbox in the UI to further configure the devices using Netreo’s customizable autoconfiguration rulesets.

The only requirements for importing devices are a (user-selected) name, an IP address or host name and an SNMP public string3 for each device. However, in order for a device to be successfully added to Netreo, Netreo must be able to authenticate with the device. This means that working authentication credentials must be supplied for each device within the import CSV file, or a set of pre-existing device templates containing usable credentials for the devices must be available in Netreo. (Obviously, the devices must also be connected to the network and powered on.) If Netreo cannot find credentials that allow it to authenticate with a device, that device will not be added.

Netreo Device Type

You cannot specify a device type when importing devices. Netreo will attempt to automatically determine the correct device type for each device similar to using Quick Add.

Procedure

To import one or more devices into Netreo: (if importing from a previously exported CSV, skip to step 5)

  1. Download the Netreo import template CSV at the bottom of this article.
    • The sample template that can be downloaded from within Netreo is functional, but incomplete. We recommend using the file attached to this article.
  2. Enter the names, IP addresses/host names and SNMP public strings for each device into the CSV template (required).
  3. In any remaining fields that you wish to use, enter the appropriate information or selections.
    • All remaining fields are optional. See below for a complete explanation of each field.
  4. Save your CSV file.
  5. From the main menu, select Administration > Add Device > Import.
  6. In the IMPORT section, click the Browse button.

    1. Locate your CSV file and click Open.
  7. Currently, the only option to deal with duplicate devices (devices included in the CSV that already exist in Netreo) is Update Data. This means the configurations of any existing devices will be overwritten and updated to match what’s included in the CSV file. Other options may be available in the future.
  8. If you would like Netreo to process the devices being imported using Netreo’s customizable autoconfiguration rulesets, check the Run Auto Configuration Rules setting.
  9. Click the Import Now button.

You’ll see a message from Netreo that the devices are being processed and should be added shortly.

Required Device Configuration Fields

When importing devices into Netreo using a CSV, some fields require the appropriate data to be present and some fields are optional. This section and the one that follows explain which fields are required and what data they should contain.

Name
The name of this device as it should appear in Netreo. No special characters are allowed, except underscore (_) and dash (-).

IP
The IP address or host name of this device. Use the FQDN when entering a host name.

SNMP Public String
The SNMP public string to use for this device.

Optional Device Configuration Fields

Username
The username to use when logging into the device if you are configuring a Windows device or using TACACS/RADIUS style authentication. This is required for Windows devices using WMI or WinRM polling, and on network devices for configuration management and Looking Glass functions if TACACS or RADIUS is in use. If a Windows domain is needed, add it to the username as follows: “domain/username”.

Password
The password to use in conjunction with the username specified for initial login to the device, or the first password to enter if no username is required. This is required for Windows devices using WMI or WinRM polling, and on network devices for configuration management and Looking Glass functions.

Enable
The enable-with password for network devices that use a second level of authentication to issue configuration commands. This is required for configuration management. Do not use this field when configuring Windows devices.

Category
The name of the category device group this device should be assigned to.

Host Alert Contacts
The name of the action group (that contains a contact method) that will receive alert notifications if this device becomes unreachable. The “blackhole” action group is a default notification action group that does not generate any notifications. Note: If you do not include an action group here or in a device template applied to this device, you will NOT receive alert notifications when this device goes down!

Site
The name of the site device group this device should be assigned to. (25 character maximum.)

Description
Enter a description to override the autodetected description for this device. (255 character maximum.)

Template
The name of the Netreo device template that you would like to assign to this device at the “device” hierarchy level.

Bandwidth Override
Enter a bandwidth speed to manually override the autodetected bandwidth speed value for this device.

Availability Alarming
Set this to 1 to enable monitoring for host and service outages on this device. Set to 0 to disable. You should generally leave this setting switched on, unless you have a specific reason to switch it off.

Parent Name
The name of the layer-3 parent for this device from the list of currently managed devices. If you didn’t allow Netreo to autodiscover the devices on your network and are manually adding them now, this field won’t apply to the very first device you add manually—so make sure the first device you add is the parent of all other devices. Additional devices can then be added with a parent device.

Performance Trending
Set this to 1 to enable the collecting of performance statistics for this device. Set to 0 to disable.

Enable Threshold Checking
Set this to 1 to enable threshold checks to be performed on collected performance data. Set to 0 to disable. You should generally leave this setting switched on, unless you have a specific reason to switch it off.

Include in Reports
Set to 1 to allow this device to be included in Netreo reports. Set to 0 to prevent its inclusion.

Use Template
Set this to 1 to enable device templates to be applied to this device. Set to 0 to disable. Switching this setting off means that any device template selected above will be applied once, then forgotten—which is not recommended, except when applying default device templates as a one-time operation.

Strategic Group
The name of the strategic group device group this device should be assigned to.

SNMP Version
The name of the version of SNMP you would like to use for this device. Options are: leave blank for system default, “v1”, “v2c” and “v3”. Be sure to include the required credentials in the CSV for the version you choose.

V3 Username
The SNMP v3 username to use for this device.

V3 Password
The SNMP v3 password to use for this device.

V3 Algorithm
The SNMP v3 algorithm to use for this device. Options are SHA or MD5.

V3 Engine ID
The SNMP v3 engine ID to use for this device.

V3 Private Key
The SNMP v3 private key to use for this device.

V3 Private Algorithm
The SNMP v3 private algorithm to use for this device. Options are AES, 3DES or AES128.

User Partition Profile
The name of the user partition profile this device should be assigned to.

Updated on October 14, 2020

Was this article helpful?

Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support

Leave a Reply