Get OpenNMS
Get Involved
Get to Know Us
From OpenNMS
Contents |
Intro
The search page provides several options for locating nodes and interfaces in the opennms database which match the specified search criteria. Each search option will be described in more detail below.
Name
Searching by name returns a list of nodes and their IP interfaces where the node label matches the search string. It is a case-insensitive, inclusive search. For example, searching on serv would find any of serv, Service, Reserved, NTSERV, UserVortex, etc. The underscore character acts as a wildcard.
IP Address
Searching by TCP/IP address returns a list of nodes and their IP interfaces where at least one of the interfaces on the node matches the search string. It uses a very flexible search format, allowing you to separate the four octets (fields) of a TCP/IP address into specific searches. An asterisk (*) in place of any octet matches any value for that octet. Ranges are indicated by two numbers separated by a dash (-), and commas are used for list demarcation. For example, the following search fields are all valid and would each create the same result set--all TCP/IP addresses from 192.168.0.0 through 192.168.255.255:
- 192.168.*.*
- 192.168.0-255.0-255
- 192.168.0,1,2,3-255.*
IfAlias
A search by ifAlias will find nodes with interfaces having SNMP ifAliases that match the given search string. This is a case-insensitive inclusive search, and the underscore character acts as a wildcard. A list of nodes and their matching interfaces will be displayed along with the matched ifAliases.
Service
To search by Service, click the down arrow and select the service you would like to search for. This search returns a list of nodes and their IP interfaces where the selected service is supported on at least one of the node's interfaces.
Mac Address
Searching by Mac Address allows you to find interfaces with hardware (mac) addresses matching the search string. This is a case-insensitive partial string match. For example, you can find all interfaces with a specified manufacturer's code by entering the first 6 characters of the mac address. Octet separators (dash or colon) are optional. Nodes and their matching interfaces are displayed, along with the matched mac addresses. Results are obtained by searching the database for both SNMP and ARP data. Displayed results are from SNMP unless otherwise noted.
Assets
Searching for assets allows you to search for all assets which have been associated with a particular category, as well as to select a specific asset field (with all available fields listed in the drop-down list box) and search for text which matches its current value. The latter search is very similar to the text search for node names described above.
Also note that you can quickly search for all nodes which have asset information assigned by clicking the List all nodes with asset info link.
All Nodes
In the lower left corner of the Search for Nodes box you will find two additional links. These will show all nodes in the database either displaying all IP interfaces, or just displaying the node names only. (The All Nodes link is equivalent to the Node List link in the opennms main navigation bar.)
Display of Results
The image above shows the results for searching for TCP/IP Address like: 10.195.0.51-57. Each node is a link to the corresponding node page and each interface is a link to the corresponding interface page. By clicking the Hide interfaces link in the lower left of the display, only the node names will be displayed.
The results of an asset search are slightly different. A list of nodes with matching asset strings is displayed. In this case the node links to the asset page for the node rather than the node page.
