nnmtopodump.ovpl — Displays the contents of the NNMi topology database
nnmtopodump.ovpl
[-h] -u <username
> -p
<password
> -type
<type
>
[-legacy <format
>]
[-filter <filter
>]
nnmtopodump.ovpl
displays the contents of the topology database.
By default, NNMi displays the output in xml format unless you specify the -legacy option.
The nnmtopodump.ovpl
script supports the following options:
-h
Displays the usage statement.
-u <username
>
Supply the NNMi administrator username to run the script. This script requires
the NNMi administrator username unless you use an nnm.properties
file.
See the nnm.properties.4
reference page for more information.
-p <password
>
Supply the NNMi administrator password to run the script. This script requires
the NNMi administrator password unless you use an nnm.properties
file.
See the nnm.properties.4
reference page for more information.
-http.host <host
>
The server host; default is localhost.
-http.port <port
>
The server port; default is 8004.
-type <type
>
The type of the objects available to be printed. Use one of the following types: node|interface|incident|ip|subnet|rrp|vlan|nodeSensor|interfaceAggregation|card|l2connection|physcomp|physSensor
-legacy [short|long]
If you use the legacy option, NNMi displays the data in text output. If you do not specify this option, then NNMi displays the output in xml form. Use the legacy option with the following type values only: node, interface, ip, l2connection and interfaceAggregation. For -legacy short, this is only valid for the type values node, interface, and l2connection.
-filter <filter
>
Filters the output by property. The nnmtopodump.ovpl
script supports the following filters:
node - node.name | node.shortname | node.id | node.uuid | node.status | node.snmpaddress | node.managementMode | node.deviceCategory | node.deviceDescription | node.deviceFamily | node.deviceVendor
interface - node.name | node.shortname | node.id | node.snmpaddress | node.deviceCategory | node.deviceDescription | node.deviceFamily | node.deviceVendor | node.managementMode | interface.ifType | interface.id | interface.uuid | interface.managementMode | interface.managementState
ip - interface.id | node.id | ip.value | ip.id
vlan - node.name | node.id | vlan.id | vlan.name | vlan.value
nodeSensor - node.name | node.hostname | node.id | nodeSensor.id | nodeSensor.name | nodeSensor.type
physSensor - node.name | node.hostname | node.id | physcomp.name | physcomp.id | physSensor.id | physSensor.name | physSensor.type
card - node.name | node.hostname | node.id | card.id |card.name
l2connection - connection.name | connection.id | connection.uuid
interfaceAggregation - master.id | master.uuid | master.index | master.alias | slave.id | slave.uuid | slave.index | slave.alias
nnmtopodump.ovpl -u username -p password -type node
Displays all of the nodes in the topology database in xml format. (You must provide an NNMi administrator username and password.)
nnmtopodump.ovpl -u username -p password -legacy long -type
node
To display the nodes in text format, you must use the legacy option. When you use the legacy option with -type node, NNMi displays the nodes and their interfaces.
Equivalent command in NNM 6.x/7.x: ovtopodump
-l
nnmtopodump.ovpl -u username -p password -type node -filter
node.name=foo.hp.com
Display information about node foo.hp.com in xml format.
nnmtopodump.ovpl -u username -p password -legacy long -type node
-filter node.name=foo.hp.com
Display information about node foo.hp.com in text format. When you use the legacy option with -type node, it displays the nodes with the interfaces attached to the node.
Equivalent command in NNM 6.x/7.x: ovtopodump -lr
foo.hp.com
nnmtopodump.ovpl -u username -p password -legacy long -type node
-filter node.id=2345
Display information about the node having nodeid as 2345 in text format. NNMi also displays all interfaces of the node.
Equivalent command in NNM 6.x/7.x: ovtopodump -lr
2345
nnmtopodump.ovpl -u username -p password -type interface
-filter interface.managementState=MANAGED
Display information about all interfaces that are managed. Filter values can be MANAGED, INHERITED, NOTMANAGED, and OUTOFSERVICE.