Name

nnmtopodump.ovpl — Displays the contents of the NNMi topology database

SYNOPSIS

nnmtopodump.ovpl [-h] -u <username> -p <password> -type <type> [-legacy <format>] [-filter <filter>]

DESCRIPTION

nnmtopodump.ovpl displays the contents of the topology database. By default, NNMi displays the output in xml format unless you specify the -legacy option.

Parameters

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

EXAMPLES

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.

AUTHOR

nnmtopodump.ovpl was developed by Hewlett Packard Enterprise.

SEE ALSO

nnmnodedelete.ovpl(1M), nnm.properties(4).

Return to Reference Pages Index