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. Device Search filters the items displayed in the device view to match your selected criteria. Incremental search is used, so the results are narrowed each time you enter a character. This allows you to find the search target quickly.

 

The search will be limited to devices that belong to the displayed netLD managed network.

 

Searching IP Address / Host Name

At the top of the device list, "Search IP/ Hostname" is displayed by default. In "Search IP/ Hostname", you can narrow down the devices displayed by entering IP address or host name data.

 

Adding Search Criteria

If you want to search using additional criteria other than the default "Search IP/ Hostname", or if you want to search for devices that meet multiple criteria, you can add search criteria.

Click the “Add Criteria” button and to add additional search conditions. The “Status” criterion is used in the example below. 

 

Click the “Add Criteria” button and specify the additional search conditions.

 

The available search criteria options are as follows.

Menu Items

Description

Interface IP

Search for device interface IP address in the device configurations.

Admin IP

Search the managed “IP Address” column in the device view.

Hostname

Search the “Hostname” column in the device view.

Status

Search by backup and compliance status.

Custom 1-5

Search from the “Custom” columns.

Tag

Search from tags assigned to devices. AND / OR conditions can be combined.

Vendor/Model/OS

Search for the device's hardware vendor, model, or OS.

Serial#

Search by serial number.

MAC

Searches by MAC address but is displayed only when there is an exact match.

Config Text

Perform a full-text search on the device configuration. Click  on the right for details.

 

Deleting Search Criteria

To delete a search criterion, click the [x] mark displayed to the right of the search condition.

 

 

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.


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.


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.