3.3 Tools for Devices
3.3.1 Adding Devices
Devices can be added, modified, deleted, backed-up, tagged and searched for, but the most important feature among these is adding the devices. Just as you have done in the tutorial, there are two ways to add devices to netLD inventory:
• The Automatic Discovery feature
• Adding devices manually
In order to discover the devices automatically, you have to configure both netLD and the device itself. If you encounter any trouble, first check Fig. 3.3.1.
Both menus for adding the devices are placed under Inventory → Add section in the Tools Menu. Add new device is for the manual process and
Discover new devices is for the automated discovery.
Figure 3.3.1: Requirements for Device Discovery.
1. your device is SNMP-compatible, and its SNMP feature is turned on,
2. you have registered all necessary information in the previous section, and
3. you have resolved any port-conflicts between netLD and other firewall/anti- virus software in your network. The port usage is listed in the Data section
4. The maximum number of IP addresses discovered is 66,000. We consider this is a suﬃcient number because it is clearly a vast IP space for this
enterprise- class software. For instance, 10.2.x.x already contains 65,025 addresses.
Figure 3.3.2: Inventory → Add
3.3.2 Discover New Devices
Device Discovery is a wonderful tool as long as your devices follow the conditions described in Fig. 3.3.1.
During the discovery, netLD first asks each device in the given IP address range if they made their ports open to netLD so that netLD can make a
connection. If the answer was positive, it makes the device send an SNMP packet to the netLD host server. The device is then added to the Device View
with the SNMP information.
To run the Discovery, open Discover new devices and follow the instruction below:
Specify all IP addresses or ranges to discover. Enter the IP/ranges in corresponding menu and click on . Added elements are listed in the box
located at the bottom of the menu.
Menu Items Example and Description
IP Address/CIDR Enter IP address/CIDR of the network to discover. (e.g.192.168.0.1/24).
IP Address Range Enter 2 IP addresses to specify the address range to discover. (e.g. 10.0.0.1-10.0.0.100).
Single IP Address Enter an IP address of the single device to discover. (e.g.192.168.0.1).
You can also import the range data from a text file (CSV). Write the discovering addresses or networks in each line.
Descriptions of the other options follows:
Boundary Networks Enter the boundary network addresses to limit the range of discovery. 10.0.0.0/8, 172.16.0.0/16 and 192.168.0.0/16, FD00::/8 are set
by default, and if you want to extend the search range, add a new address range in this field.
Crawl the network from the specified addresses Enable this checkbox to re- cursively crawl and add the neighboring devices to the inventory.
Include existing inventory in addresses to crawl Enable this checkbox to en- able crawling on the neighbors of the devices that already exist in the inventory.
Additional SNMP Community String Enter a community string to give prior use for discovery.
Finally, click on the Run button to start discovery, and the devices are added to the inventory. Discovery status is going to be show up in the status pane.
Device added. The device has been successfully discovered and added to the device inventory.
There was no SNMP response. The device has responded to Telnet, SSH or ping but did not respond to SNMP request.
No adapter matches. The device has responded to SNMP request but netLD does not have the adapter for the device.
Server protocol settings for SNMP
for this device are disabled. SNMPprotocol inInventory→ Protocolssettings isdisabledforthenetworkgroup.
There was no ICMP ping response. The device did not respond to ICMP ping request. (only in Single IP Address discovery)
Unable to establish
TCP connection on port
22(Telnet) or 23 (SSH). netLD failed to connect neither to port 22 nor 23 of the device (only in Single IP Address discovery)
During the discovery, netLD uses SNMP version 1 by default. To change the setting, use Inventory → Protocols menu and select the proper SNMP
The discovery result only shows the devices which have responded to the Telnet/SSH/ping. Details for discovery status follows:
3.3.3 Adding Devices Manually
You can also add the devices manually. Go to Inventory → Add New Device and you can add each device manually.
Menu Items Description
IP Address Specify an IP address of the device to add.
Adapter Select adapter ID from the drop down list of the device to add.
Alternatively, you can do the same thing by importing a handwritten or the exported spreadsheet. This is described in Sec. 3.3.6.
We also provide a template spreadsheet to fill in the IP addresses etc. This is available in Inventory → Save inventory import Excel template.
Open the Inventory sub menu and save the template.
Open and edit the exported Excel file. When you finish editing the file, import it with the Import/Update inventory from XLS file. . . menu and confirm all
devices are added in inventory list.
Figure 3.3.3: Specify the Version via the corresponding pull-down list.
Figure 3.3.4: Enter the IP address and the adapter.
IP Address (Required) Specify an IP address of the device to add.
Network (Required) Enter an existing network group to assign the device.
Adapter ID (Required) Enter the device adapter ID of the device.
Custom 1˜5 Optional text for the custom field.
Finally,click on the Inventory → Import/update inventory from Excel file. The same feature can also be accessed from Run Startup Wizard → Import from
3.3.4 Editing and Deleting the Devices
Although it is not a common practice, when you want to edit the IP Address, Hostname, Adapter ID, Network and Custom Fields of the specific device,
click on the row of the device to edit and go to Device → Edit Device properties.
When you delete a set of devices, select the devices and go to Inventory → Delete device.
3.3.5 Searching Devices
In Device View, netLD provides a flexible search and filter function of the devices. There are two modes of the search function, Basic and Advanced
Search, where the former is set as the default method. Note that the Filtering is done only within a same network. To change the current Network, select it
in the drop down box in the global menu.
You can filter devices by just entering an IP address or a hostname in the search pane. It supports an incremental search feature, so the elements are
gradually filtered as you type.
Figure 3.3.5: Simple-search pane. If you click on a label advanced search, the
advanced search pane will show up.
Compared to the Basic Search, Advanced Search supports plenty of filters. Turn on the Advanced Search mode via ”advanced search” button in the Device
View. The search can be done as you type.
Figure 3.3.6: Advanced Search panes.
Names for each custom field may be diﬀerent if they were changed in Setting
→ Server Settings → Custom Device Fields menu.
IP/CIDR Enter an IP address/CIDR (e.g. 10.0.0.1 or 192.168.0.1/24)
Admin IP Enter an IP address. Note that only the devices already added in the Inventory are subject to the search.
Hostname Enter a hostname (e.g. J2320 or J23*). Status Select a backup status from the dropdown list. Changed Select the time that the last backup was done.
Custom 1 to 5 Enter any text. It matches the custom field of each device (e.g. lvi, netLD, net, etc.)
Device with tags Select a device tag name from the list. You can use and/or
radio buttons to toggle how queries are combined.
Vendor Select a device vendor name from the dropdown list.
Model Enter a model name to filter devices by model name (e.g. J2320, J23*, etc.)
• This optional filter is available when the Vendor filter is used.
Version Enter a version number of the devices’ Operation Systems and select an operator from the dropdown list. (e.g. > 9.2)
• This optional filter is available when the Vendor filter is used.
Serial# Enter a serial number in this field to filter devices by serial numbers. (e.g. 01621220*)
MAC Enter a MAC address (e.g. 000CCEC6EAE0). Only the full match is available and partial match is not supported right now.
Config Text Config Text search runs a full-text search in the device configura- tions. For example, if you want to search the configurations that contain
”version” and ”12.1”, enter ”version AND 12.1” in Search field and click on button. For details about the search query, refer to Query Syntax located in the right of the query field.
3.3.6 Exporting and Importing the Inventory
You can import and export the current Inventory status in a spreadsheet. These operations are available in Inventory→ Import/Export section. The form
includes the IP address, the host name and so on.
Figure 3.3.7: Inventory sub menu.
Exporting Inventory in a Spreadsheet.
Select some of your devices and click on the Export inventory as Excel file entry,
then you can save the sheet into a .xls file such as netLD-inventory (2014-03-25).xls.
If you export all devices in the inventory, empty the selection and then run the
Similarly, you may also export a ZIP archive containing the data if the sheet gets too large. This option is available in Export inventory with
configurations as ZIP style file. The output file is named such as ”netLD-configs (date of ex- port).zip”. The files in the archive are organized into
sub directories as follows:
– <network name>
∗ 10.0.0.1 (1812J-B)
∗ 10.0.0.201 (cisco2500b.intra.dar.co.jp)
∗ 10.0.0.203 (cisco2600a.intra.dar.co.jp)
∗ 10.0.0.208 (C2801)
∗ . . .
Importing the Exported File
Also, you can then import(=add) and update(=overwrite) the exported spread- sheets. Click on the Import/update inventory from Excel file entry. It
allows you to add a number of devices at once.