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.

 

 

g3bSKYoMMJgXFMQ9tM28DC-hsiAbfXk9BA.png

 

 

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 

(Chapter 7)

4. The maximum number of IP addresses discovered is 66,000. We consider this is a sufficient 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


blob1477696485215.png


 

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.

 

 

blob1477696525918.png


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.

 

blob1477696556956.png

 

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.  


Status                                                                     Description

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 

option.

  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.

 

blob1477696793858.png

 

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.


 

blob1477696778939.png

 

 

 Figure  3.3.3: Specify the Version via the corresponding pull-down list.



blob1477696807723.png

 

 Figure  3.3.4: Enter  the IP address and the adapter.

blob1477696820466.png


Parameter                Description

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 

Excel.


 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.


Basic Search


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.


blob1477696856646.png

 


Advanced Search


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.


blob1477696874741.png


 

Names for each custom field may be different 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.


blob1477696898554.png


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

export.


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:


• <filename>.zip

 

–  <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.