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).
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 optional configuration settings for configuring your new devices as they are being added to Netreo. You may use as many or as few of these 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-supplied) name and an IP address or host name 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 either 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. If Netreo cannot find credentials that allow it to authenticate with a device, that device will not be added.
To import one or more devices into Netreo: (if importing from a previously exported CSV, skip to step 5)
- 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.
- Enter the names, IP addresses/host names and SNMP public strings for each device into the CSV template (required).
- 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.
- Save your CSV file.
- From the main menu, select Administration > Add Device > Import.
- In the IMPORT section select Browse.
- Locate your CSV file and select Open.
- 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.
- If you would like Netreo to process the devices being imported using Netreo’s customizable autoconfiguration rulesets, check the Run Auto Configuration Rules setting.
- Select Import Now.
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.
The name of this device as it should appear in Netreo. No special characters are allowed, except underscore (_) and dash (-).
The IP address or host name of this device. Use the FQDN when entering a host name.
Optional Device Configuration Fields
The following fields are optional. They may be set as desired or left empty.
- SNMP Public String
The SNMP public string to use for this device. Limit 32 characters. Netreo device import does not support device template interrogation for any device template other than “Default.” If you do not include an SNMP string in the import CSV for the device you are trying to add and your Default device template does not include credentials for the device you are trying to add, the device may not be added to Netreo or may be added incorrectly.
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”.
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.
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.
The name of the category device group to place the device in. If no category is specified the device is placed in the “New Devices” category.
- 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!
The name of the site device group to place the device in (25 character maximum). If no site is specified the device is placed in the “Unknown” site.
Enter a description to override the autodetected description for this device. (255 character maximum.)
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 set this to enabled, 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 collection of performance statistics for this device. Set to 0 to disable.
- Enable Threshold Checking
Set this to 1 to enable threshold checks to monitor collected performance data for problems. Set to 0 to disable. You should generally set this to enabled, 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 (recommended). Set to 0 to disable. Switching this setting to off means that any device template supplied in the Template field 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 a strategic group device group to place this device in (only one group may be specified). If no strategic group is specified here the device is not placed in any strategic groups.
- SNMP Version
The name of the version of SNMP you would like to use for communication with 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
(Required if using SNMPv3) The SNMPv3 username to use for this device.
- V3 Password
(Required if using SNMPv3) The SNMPv3 password to use for this device.
- V3 Algorithm
(Required if using SNMPv3) The SNMPv3 algorithm to use for this device. Options are SHA or MD5.
- V3 Engine ID
(Required if using SNMPv3) The SNMPv3 engine ID to use for this device.
- V3 Private Key
(Required if using SNMPv3) The SNMPv3 private key to use for this device.
- V3 Private Algorithm
(Required if using SNMPv3) The SNMPv3 private algorithm to use for this device. Options are AES, 3DES or AES128.
- User Partition Profile
The name of a user partition to place this device in (255 character maximum). If no user partition is specified the device is not placed in a user partition.