Using URLs to Access NNMi Objects

Exclusive offer: get 50% off this eBook here
HP Network Node Manager 9: Getting Started

HP Network Node Manager 9: Getting Started — Save 50%

Manage your network effectively with this HP Network Node Manager book and eBook

$41.99    $21.00
by Marius Vilemaitis | December 2010 | Enterprise Articles

NNMi provides a list of URLs that can be used for accessing most NNMi console objects. This standardized list of URLs and their syntax helps us build the right URL, in order to get the right data object integrated in our selected third-party application.

In this article by Marius Vilemaitis, author of HP Network Node Manager 9: Getting Started, we will cover:

  • Generic URLs.
  • Workspace-related URLs.
  • Form-related URLs.
  • Menu item-related URLs.

 

HP Network Node Manager 9: Getting Started

HP Network Node Manager 9: Getting Started

Manage your network effectively with NNMi

  • Install, customize, and expand NNMi functionality by developing custom features
  • Integrate NNMi with other management tools, such as HP SW Operations Manager, Network Automation, Cisco Works, Business Availability center, UCMDB, and many others
  • Navigate between incidents and maps to reduce troubleshooting time
  • Screenshots and step-by-step instructions to customize NNMi in the way you want
  • Instructions in the book are valid for version 8 as well

Images

        Read more about this book      

HP Network Node Manager 9

URLs that are listed in this section can be grouped into a few groups (refer to the preceding screenshot):

  • Generic URLs.
  • Workspace-related URLs.
  • Form-related URLs.
  • Menu item-related URLs. As an example, we can provide a quick access to menu items for our team. For example, building a smart-phone application that displays critical events and allows user to run ping, trace route, or other commands for faster troubleshooting (refer to the next diagram).

HP Network Node Manager 9

The following section lists these URLs and provides tables of parameters, which can be used for building URLs.

Note: If our NNMi is configured to use the https protocol, we need to modify our URLs in this article accordingly, as URLs here are provided for http access.

Generic URLs

Generic URLs that can be used for obtaining information about NNMi are:

  • View launching URL: To launch the NNMi console, use the following URL:http://<server_name>:<port_number>/nnm/launch?cmd=showMain.
    If we are passing by using a username and password within the URL, we need to use the following syntax: http://<server_name>:<port_number>/nnm/launch?cmd=showMain&j_username=<account_name>&j_password=<account_password>.
  • To confirm whether NNMi is running: The following URL should be used: http:/<serverName>:<portNumber>/nnm/launch?cmd=isRunning.
    Using this URL, we will receive a confirmation response on whether or not NNMi is running.

    HP Network Node Manager 9

Otherwise, a browser error message will be sent saying that the URL is unreachable.

HP Network Node Manager 9

Workspace-related URLs

This URL group is related to NNMi views. Here is a list of available URLs.

Launching view

The following table presents the required attributes and their values for launching views.

Attributes Values Description
Use following URL to show general view:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&objtype=<x>
objtype

Incident

Node

Interface

IP Address

IP Subnet

NodeGroup

InterfaceGroup

Incidents workspace, All Incidents table view.

Inventory workspace, Nodes table view.

Inventory workspace, Interfaces table view.

Inventory workspace, IP Addresses table view.

Inventory workspace, IP Subnets table view.

Inventory workspace, Node Groups table view.

Inventory workspace, Interface Groups table view.

Use the following URL to show general view for a specific node group, filtered by node group name, id, or uuid:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&objtype= <x>&nodegroup=<Name>
nodegroup
  • nodegroup
  • nodegroupid

 

 

  • nodegroupuuid
  • The Name attribute value of Node Group*.
  • The ID number of node group. This ID is unique across all NNMi database. Use nnmconfigexport.ovpl tool to see ID number of node group.
  • Universally Unique Object ID of the node group. Use nnmconfigexport.ovpl tool to see ID number of node group.
Use following URL to show general view for a specific node group, filtered by interface group name or id:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&objtype=<x>&ifgroup=<Name>
ifgroup
  • ifgroup
  • ifgroupid

 

 

  • ifgroupduuid
  • The name attribute value of interface group*.
  • The ID number of interface group. This ID is unique across all NNMi database. Use nnmconfigexport.ovpl tool to see id number of interface group.
  • Universally Unique Object ID of the interface group. Use nnmconfigexport.ovpl tool to see id number of interface group.
Use following URL to show general view with custom window settings:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&objtype=<x>&menus=<true|false>&newWindow=<true|false>&envattrs=<name1=value>;<name2=value>
menus [true|false]
  • True: Show the view menus.
  • False: Hide the view menus.

The default value is true.

newWindow [true|false]
  • True: To display view in new window.
  • False: To display view within same browser window.

Default value is false.

envattrs   This is session-specific attributes and they are stored by following syntax: <name=value>.

 

 

* If the node group name has spaces in it, use one of the following symbols to represent a "space" character (without brackets): "%20", "+", or " " (space symbol).

Consider the following example. To open a window with incidents, which are related to the node group Europe, run the following URL (assuming, that NNMi is installed on node "box1" and uses port number "8080"): http://box1:8080/nnm/launch?cmd=showView&objtype=Incident&nodegroup=Europe

Launching an Incident view

The following table presents the required attributes and their values for launching incident-specific views.

Attributes Values Description
Use following URL to show incident view, filtered by specific incident attributes:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>
view
  • allIncidentsTableView
  • allOpenIncidentsTableView
  • closedKeyIncidentsTableView
  • closedRCIncidentTableView
  • customIncidentTableView
  • incidentsByNatureTableView
  • incidentsByFamilyTableView
  • keyIncidentsByLifecycleStateTableView
  • myIncidentTableView
  • nnm6x7xIncidentTableView
  • nnm6x7xIncidentByCategoryTableView
  • openKeyIncidentsTableView
  • openKeyIncidentsByCategoryTableView
  • openKeyIncidentsByFamilyTableView
  • openKeyIncidentsByPriorityTableView
  • openKeyIncidentsBySeverityTableView
  • openRCIncidentsByCategoryTableView
  • openRCIncidentsByFamilyTableView
  • openRCIncidentsByPriorityTableView
  • openRCIncidentsBySeverityTableView
  • openRCIncidentTableView
  • allRCIncidentTableView
  • RCIncidentsByLifecycleStateTableView
  • serviceImpactIncidentTableView
  • snmpTrapsIncidentTableView
  • snmpTrapsIncidentByFamilyTableView
  • streamCorrelationIncidentTableView
  • unassignedKeyIncidentsTableView
  • unassignedIncidentTableView
  • All incidents
  • All open incidents
  • Closed Key Incidents
  • Closed Root Cause Incidents
  • Custom Incidents
  • Incidents by Correlation Nature
  • Incidents by Family
  • Key Incidents by Lifecycle State
  • My Open Incidents
  • NNM 6.x / 7.x Events
  • NNM 6.x/7.x Event by Category
  • Open Key Incidents
  • Open Key Incidents by Category
  • Open Key Incidents by Family
  • Open Key Incidents by Priority
  • Open Key Incidents by Severity
  • Open Root Cause by Category
  • Open Root Cause by Family
  • Open Root Cause by Priority
  • Open Root Cause by Severity
  • Open Root Cause Incidents
  • Root Cause Incidents
  • Root Cause by Lifecycle State
  • Service Impact Incidents
  • SNMP Traps
  • SNMP Traps by Family
  • Stream Correlation Incidents
  • Unassigned Open Key Incidents
  • Unassigned Root Cause Incidents
Use following URL to show Incident view, filtered for specific node group:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&nodegroup_var=<Name>

See the preceding table for attribute description.

Use following URL to show Incident view with custom window settings:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&menus_var=<true|false>&newWindow=<true|false>&envattrs=<name1=value>;<name2=value>

See the preceding table for attribute description.

 

Launching a Topology Maps Workspace view

Here is a list of Topology Maps that can be opened using the following URLs:

Consider the following example. Here are the links to open a few groups on NNMi server "box1" (port number 8080):

  • Open Routers node groups:
    http://box1:8080/nnm/launch?cmd=showNodeGroup&name=Routers
  • Open Networking Infrastructure devices:
    http://box1:8080/nnm/launch?cmd=showView&objtype= Node&nodegroup=Networking%20Infrastructure%20Devices

Launching a Monitoring Workspace view

The following table presents the required attributes and their values for launching Monitoring workspace-specific views.

Attributes Values Description
Use following URL to show monitoring view, filtered by specific attributes:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>
view
  • criticalComponentHealthTableView
  • criticalInterfaceTableView
  • criticalNodeTableView
  • nonNormalInterfaceTableView
  • nonNormalNodeTableView
  • notRespondingIPAddressTableView
  • nodesByStatusTableView
  • componentHealthByStatusTableView
  • interfacesByStatusTableView
  • interfacesByAdministrativeStateTableView
  • interfacesByOperationalStateTableView
  • IPAddressesByStateTableView
  • interfacePerformanceTableView
  • routerRedundancyGroupsTableView
  • nodeGroupsStatusTableView
  • Critical Component Health
  • Critical Interfaces
  • Critical Nodes
  • Non-Normal Interfaces
  • Non-Normal Nodes
  • Not Responding Addresses
  • Nodes by Status
  • Component Health by Status
  • Interfaces by Status
  • Interfaces by Administrative State
  • Interfaces by Operational State
  • IP Addresses by State
  • Interface Performance
  • Router Redundancy Groups
  • Node Groups
Use following URL to show monitoring view, filtered by node group:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&nodegroup=<Name>

Refer to the table under the Launching view section for attribute description.

Use following URL to show general view, filtered by interface group:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&ifgroup=<Name>

Refer to the table under the Launching view section for attribute description.

Use following URL to show monitoring view with custom window settings:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&menus=<true|false>&newWindow=<true|false>&envattrs=<name1=value>;<name2=value>

Refer to the table under the Launching view section for attribute description.

 

Launching a Troubleshooting Workspace view

Troubleshooting workspace contains the following four different views:

  • Layer 2 Neighbor view
  • Layer 3 Neighbor view
  • Path view
  • Node Group Map view

Use the following URL to show the Layer 2 Neighbor view:
http://<serverName>:<portNumber>/nnm/launch?cmd=showLayer2Neighbors.

Attributes

 

Values Description
Use following URL to show Layer 2 Neighbor view by specified number of hops:
http://<serverName>:<portNumber>/nnm/launch?cmd=showLayer2Neighbors&nodename=<x>&hops=<#>
nodename nodename The source node's name or IP address
hops 1 - 9 Number of hops
Use following URL to show Layer 2 Neighbor view with custom window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showLayer2Neighbors&menus=<true/false>&newWindow=<true/false>&envattrs=<name1=value>;<name2=value>

Refer to the table under the Launching view section for attribute description.

 

Use the following URL to show Layer 3 Neighbor view:
http://<serverName>:<portNumber>/nnm/launch?cmd= showLayer3Neighbors.

Attributes Values Description
Use following URL to show Layer 3 Neighbor view for specified node by specified number of hops:
http://<serverName>:<portNumber>/nnm/launch?cmd=showLayer3Neighbors&nodename=<x>&hops=<#>
nodename See the previous table for attribute description.
hops See the previous table for attribute description.
menus [true|false] Show (true) or hide (false) menu and window toolbar. Default value is "true".

 

Use the following URL to show Layer 3 Neighbor view with the specified window parameters:
http://<serverName>:<portNumber>/nnm/launch?cmd=showLayer3Neighbors&menus=<true/false>&newWindow=<true/false>&envattrs=<name1=value>;<name2=value>.

Use the following URL to show Path view: http://<serverName>:<portNumber>/nnm/launch?cmd=showPath.

Attributes Values Description
Use the following URL to show Path view by specified source and destination nodes: http://<serverName>:<portNumber>/nnm/launch?cmd=showPath&src='//dgdsbygo8mp3h.cloudfront.net/sites/default/files/blank.gif' data-original=<x>&dest=<y>
src src Source node's hostname or IPv4 address.
dest dest Destination node's hostname or IPv4 address.

Use the following URL to show Path view with custom window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showPath&menus=<true/false>&newWindow=<true/false>&envattrs=<name1=value>;<name2= value>

Attributes Values Description

 

Use following URL to list nodes belonging to a specified node group:
http://<serverName>:<portNumber>/nnm/launch?cmd=showNodeGroup&name=<x>
name name The Name attribute value from the Node Group form

 

Use the following URL to list nodes belonging to a specified node group with custom window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showNodeGroup&name=<x>&menus=<true/false>&newWindow=<true/false>&envattrs=<name1=value>;<name2=value>.

Launching an Inventory Workspace view

The following table presents the required attributes and their values for launching Inventory workspace-specific views.

Attributes Values Description
Use the following URL to show a view, specified in the view list below in this table:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>
view
  • allNodesTableView
  • allInterfacesTableView
  • allIPAddressTableView
  • allIPSubnetsTableView
  • allVlansTableView
  • allLayer2ConnectionsTableView
  • nodesByDeviceCategoryTableView
  • interfacesByIfTypeTableView
  • customNodeTableView
  • customInterfaceTableView
  • customIPAddressTableView
  • routerRedundancyGroupsTableView
  • nodeGroupsTableView
  • interfaceGroupsTableView
  • allManagementStationsTableView
  • Nodes
  • Interfaces
  • IP Addresses
  • IP Subnets
  • VLANs
  • Layer 2 Connections
  • Nodes by Device Category
  • Interfaces by IfType
  • Custom Nodes
  • Custom Interfaces
  • Custom IP Addresses
  • Router Redundancy Groups
  • Node Groups
  • Interface Groups
  • Management Stations
Use the following URL to show a view, specified in the view list below in this table for specified node group: http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&nodegroup=<Name>.

Refer to the table under the Launching view section for attribute description.

nodegroup
  • nodegroup
  • nodegroupid
  • nodegroupuuid
Refer to the table under the Launching view section for attribute description.
Use the following URL to show a view, specified in the view list below in this table for specified interface group:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&interfacegroup=<Name>
interfacegroup
  • ifgroup
  • ifgroupid
  • ifgroupuuid
Refer to the table under the Launching view section for attribute description.

 

Use the following URL to show a view, specified in the view list above in a table with custom window settings: http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&menus= <true/false>&newWindow=<true/false>&envattrs=<name1=value>;<name2=value>.

Launching Management Mode Workspace views

The following table presents the required attributes and their values for launching Management Mode workspace-specific views:

Attributes Values Description
Use the following URL to show a view, specified in the view list below in this table:
http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>
view
  • allNodesTableView
  • allInterfacesTableView
  • allIPAddressTableView
  • allIPSubnetsTableView
  • allVlansTableView
  • allLayer2ConnectionsTableView
  • nodesByDeviceCategoryTableView
  • interfacesByIfTypeTableView
  • customNodeTableView
  • customInterfaceTableView
  • customIPAddressTableView
  • routerRedundancyGroupsTableView
  • nodeGroupsTableView
  • interfaceGroupsTableView
  • allManagementStationsTableView
  • Nodes
  • Interfaces
  • IP Addresses
  • IP Subnets
  • VLANs
  • Layer 2 Connections
  • Nodes by Device Category
  • Interfaces by IfType
  • Custom Nodes
  • Custom Interfaces
  • Custom IP Addresses
  • Router Redundancy Groups
  • Node Groups
  • Interface Groups
  • Management Stations
Use the following URL to show a view, specified in the view list below in this table for specified node group: http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&nodegroup=<Name>.

Refer to the table under the Launching view section for attribute description.

nodegroup
  • nodegroup
  • nodegroupid
  • nodegroupuuid

Refer to the table under the Launching view section for attribute description.

Use the following URL to show a view, specified in the view list below in this table for specified interface group:

http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view= <x>&interfacegroup=<Name>

interfacegroup
  • ifgroup
  • ifgroupid
  • ifgroupuuid
Refer to the table under the Launching view section for attribute description.

Use the following URL to show a view, from the Management Mode workspace, with specified window settings: http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&menus=<true/false>&newWindow=<true/false>&envattrs=<name1=value>;<name2=value>.

Launching a Configuration Workspace view

The following table presents the required attributes and their values for launching the Configuration workspace-specific views:

Attributes Values Description
Use the following URL to show a view from Configuration workspace for a view specified below: http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>.
view
  • nodeGroupsTableView
  • allNodeGroupMapSettingsTableView
  • interfaceGroupsTableView
  • allManagementStationsTableView
  • ramsServerTableView
  • allURLActionInfosTableView
  • allAccountsTableView
  • allIfTypesTableView
  • allDeviceProfilesTableView
  • Node Groups
  • Node Group Map Settings
  • Interface Groups
  • Management Stations
  • RAMS Servers
  • URL Actions
  • User Accounts and Roles
  • IfTypes
  • Device Profiles

 

Use the following URL to show a view, from Configuration workspace, with specified window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showView&view=<x>&menus=<true/false>&newWindow=<true/false>&envattrs=<name1=value>;<name2=value>.

 

HP Network Node Manager 9: Getting Started Manage your network effectively with this HP Network Node Manager book and eBook
Published: January 2011
eBook Price: $41.99
Book Price: $69.99
See more
Select your format and quantity:
        Read more about this book      

Form-related URLs

This URL group is related to NNMi forms. This form should be used to obtain information about a particular node, interface, incident, address, or subnet.

Note: If attributes provided in the URL find more than one object, the first object found in the database is displayed.

Multiple attributes should be separated by the semicolon symbol.

Here is a URL to launch a particular form:
http://<serverName>:<portNumber>/nnm/launch?cmd=showForm....

Launching a Node Form

The following table presents the required attributes and their values for launching views related to the Node Form:

Attributes Values Description
Use the following URL to show Node Form for a specified node:
http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Node&nodename=<x>
nodename nodename IP address: FQDN or short name of the host. Short name should be used if one is working in the same DNS zone as the target. Also, short name should be resolvable by the server receiving the request.
Use the following URL to show Node Form for a specified node and object attribute name: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Node&objattrs=name=<x>
Objattrs name The Name attribute value from the Node Form.
Use the following URL to show Node Form for a specified node and hostname's object attribute: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Node&objattrs=hostname=<x>.
hostname hostname Hostname of the node is selected by following rules:

  • FQDN name in lowercase characters.
  • If more than one address is associated with a name, loopback address is selected.
  • If multiple loopback addresses are associated, lowest IP number address is selected.
  • If no loopback address is associated, NNMi tries to associate name provided by SNMP.
  • If no response using SNMP is received, the IP address is associated, unless DNS name is found during rediscovery cycle.
Use the following URL to show Node Form for a specified node and specified management address: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Node&objattrs=snmpAgent.agentSettings.managementAddress=<x>. snmpAgent.agentSettings.managementAddress
  • snmpAgent.agentSettings.
  • managementAddress
The IP address received by SNMP from SNMP agent form assigned to a specified node. Use the following URL to show Node Form for a specified node and system name: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Node&objattrs=systemName=<x>. systemName systemName System name attribute value.

Use the following URL to show Node Form for a specified node with specified window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Node&nodename=<x>&menus=<true/false>&envattrs=<name1=value>;<name2=value>.

Launching an Interface Form

The following table presents the required attributes and their values for launching views related to Interface Form:

Attributes Values Description
Use the following URL to show Interface Form hosted on specified node: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Interface&objattrs=hostedOn.hostname=<x>;name=<y>.

hostedOn.hostname

 

name

  • Hostname of the host where interface resides
  • The Name attribute value
Value is taken from Node Form

 

Use the following URL to show Interface Form for specified interface name, hosted on specified node: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype= Interface&objattrs=hostedOn.hostname=<x>;ifName=<y>.

 

ifName

 

ifName attribute value Value is taken from Interface Form
Use the following URL to show Interface Form for specified interface alias, hosted on specified node: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Interface&objattrs=hostedOn.hostname=<x>;ifAlias=<y>.
ifAlias ifAlias attribute value Value is taken from Interface Form
Use the following URL to show Interface Form for specified interface index, hosted on specified node: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Interface&objattrs=hostedOn.hostname=<x>;ifIndex=<y>.
ifIndex ifIndex attribute value Value is taken from Interface Form

 

Use the following URL to show Interface Form for specified interface name, hosted on specified node, with custom window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype= Interface&objattrs=hostedOn.hostname=<x>;name=<y>&menus=<true/false>&envattrs=<name1=value>;<name2=value>.

Launching an IP address form

The following table presents the required attributes and their values for launching views related to the IP address form:

Attributes Values Description
Use following URL to show IP address form for IP address value: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=IPAddress&objattrs=value=<y>.
value IP address attribute value Value is taken from IP address form

 

Use the following URL to show IP address form for IP address value with custom window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=IPAddress&objattrs=value=<y>&menus=<true/false>&envattrs=<name1=value>;<name2=value>.

Launching a Subnet form

The following table presents the required attributes and their values for launching views related to the Subnet form:

Attributes Values Description
Use the following URL to show a subnet form for specified subnet name: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=IPSubnet&objattrs=name=<x>.
name The name attribute value Value is taken from IP Subnet form
Use the following URL to show a subnet form for specified subnet prefix: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=IPSubnet&objattrs=prefix=<x>.
prefix The prefix attribute value Value is taken from IP Subnet form
Use the following URL to show a subnet form for specified subnet prefix length: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=IPSubnet&objattrs=prefix=<x>;prefixLength=<y>.
prefixLength The prefix length attribute value Value is taken from IP Subnet form

 

Use the following URL to show a Subnet form for specified Subnet name with custom window attributes: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype= IPSubnet&objattrs=name=<x>&menus=<true/false>&envattrs= <name1=value>;<name2=value>.

Launching an Incident Form

The following table presents the required attributes and their values for launching views related to the Incident Form:

Attributes Values Description
Use the following URL to show an Incident Form for specified incident ID: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Incident&objid=<x>.
objid Object ID The unique value across NNMi database.
Use the following URL to show an Incident Form for specified incident uuid: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=Incident&objuuid=<x>.
objuuid The Universally Unique Object ID The unique value across all NNMi databases. Use nnmconfigexport.ovpl to find this value.

 

Use the following URL to show an Incident Form for specified incident ID with custom window settings: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&showForm&objtype=Incident&objid=<x>&menus=<true/false>&envattrs=<name1=value>;<name2=value>.

Launching a Node Group form

The following table presents required attributes and their values for launching views related to Node Group form:

Attributes Values Description
Use the following URL to show node group form for specified group name: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=NodeGroup&name=<y>.
name Name

Name attribute value in Node Group form.

Note: Is spaces need to be used, replace with "%20" symbols. For some browsers "+" or "space" symbol may work as well.

Use the following URL to show node group form for specified group ID: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=NodeGroup&nodegroupid=<y>.
nodegroupid nodegroupid Refer to the table under the Launching view section for attribute description.
Use the following URL to show node group form for specified group uuid:
http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype=NodeGroup&nodegroupuuid=<y>.
nodegroupid nodegroupuuid Refer to the table under the Launching view section for attribute description.

Use the following URL to show Node Group form for specified group name with custom window parameters: http://<serverName>:<portNumber>/nnm/launch?cmd=showForm&objtype= NodeGroup&name=<y>&menus=<true/false>&envattrs= <name1=value>;<name2= value>.

Launching a Configuration form

The following table presents the required attributes and their values for launching Configuration workspace-related views:

Attributes Values Description
Use the following URL to show Configuration form views, listed below in this table: http://<serverName>:<portNumber>/nnm/launch?cmd=showConfigForm&name=<y>.
name
  • communication
  • custompoller
  • discovery
  • monitoring
  • incident
  • status
  • ui
  • Communication Configuration Form
  • Custom Poller Configuration Form
  • Discovery Configuration Form
  • Monitoring Configuration Form
  • Incident Configuration Form
  • Status Configuration Form
  • User Interface Configuration Form

 

Use the following URL to show Configuration form views with specified window settings: http://<serverName>:<portNumber>/nnm/launch?cmd=showConfigForm&name= <y>&menus=<true/false>&envattrs=<name1=value>;<name2=value>.

Menu item-related URLs

This URL group is related to the NNMi menu. Here is the available URL:
http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=<x>

Consider the following example. To open the Communication Configuration of node 10.10.1.11, enter following URL: http://box1:8080/nnm/launch?cmd=runTool&tool=commconf&nodename=10.10.1.11.

Launching the Ping command

The same action we used in NNMi console, Tools | Ping (from server), can be initiated using the URL in two ways:

  • To run a URL, which opens a window and asks for the node name or IP address of the object you want to ping:
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=ping
  • Run a URL, which opens a window with ping to node results, follow the table given here:
    Attributes Values Description
    Use the following URL to run ping tool with specified ping parameters listed below in this table: http://<serverName>:<portNumber>/nnm/launch?cmd=run-Tool&tool=ping&timeoutSecs=<x>&numPings=<x>&nodename=<x>.
    nodename DNS resolvable name, or IP address  
    timeoutSecs seconds The number of seconds which command is waiting for response before it times out
    numPings number The number of retries

Launching the Trace Route command

The same action we used in NNMi console, Tools | Trace Route (from server), can be initiated using a URL in two ways:

  • To run a URL, which opens a window and asks you to enter the node name or IP address of the object you want to make a trace route:
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=traceroute
  • To run a URL, which opens a window with trace route results to node, follow the table given here:
    Attributes Values Description
    Use following URL to run trace route tool with specified destination node name:
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=traceroute&nodename=<x>
    nodename DNS resolvable name, or IP address  

Launching the Communication Configuration command

The same action we used in NNMi console, Tools | Communication Settings, can be initiated using the URL in two ways:

  • To run a URL, which opens the Communication Settings window:
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=commconf
  • To run a URL, which opens the Communication Settings window for a specified node, follow this table:
    Attributes Values Description
    Use following URL to run "Communication configuration" tool for specified node name: http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=commconf&nodename=<x>.
    nodename DNS resolvable name, or IP address  

Launching Monitoring Settings command

The same action of opening the Monitoring Settings screen that you perform in NNMi console (Tools | Monitoring Settings), can be initiated using a URL. There are a few views, which can be shown in Monitoring Settings:

  • On node
  • On interface
  • On IP Address
  • On Router Redundancy Group
  • On Tracked Object
  • On Node component

To run the Monitoring Settings report on a selected node, use one of the following URLs:

Attributes Values Description
Use the following URL to Monitoring Setting window for specified node name: http://<serverName>:<portNumber>/nnm/launch?cmd=run-ool&tool=monitoringconf&objtype=SnmpAgent&nodename=<x>.
nodename DNS resolvable name or IP address

 

 

 

To run the Monitoring Settings report on a selected interface, use one of the following URLs:

Attributes Values Description
Use the following URL to run Monitoring Setting window for specified interface name, with specified node name where interface is hosted on: http://<serverName>:<portNumber>/nnm/launch?cmd=run-Tool&tool=monitoringconf&objtype=Interface&objattrs=hostedOn.hostname=<x>;name=<x>.
  • hostedOn.hostname

 

 

  • name
  • The hostname of Node on which interface resides
  • The Name attribute value
  • Value from Node Form

 

 

  • Value from Interface Form
Use the following URL to run Monitoring Setting window for specified interface name, with specified node name where interface is hosted on: http://<serverName>:<portNumber>/nnm/launch?cmd-=runTool&tool=monitoringconf&objtype=Interface&objattrs=hostedOn.hostname=<x>;ifName=<x>.
ifName The ifName attribute value Value from Interface Form
Use the following URL to run Monitoring Setting window for specified interface name, with specified node name where interface is hosted on: http://<serverName>:<portNumber>/nnm/launch?cmd-=runTool&tool=monitoringconf&objtype=Interface&objattrs=hostedOn.hostname=<x>;ifAlias=<x>.
ifAlias The ifAlias attribute value Value from Interface Form
Use the following URL to run Monitoring Setting window for specified interface number, with specified node name where interface is hosted on http://<serverName>:<portNumber>/nnm/launch?cmd- runTool&tool=monitoringconf&objtype=Interface&objattrs=hostedOn.hostname=<x>;ifIndex=<x>.
ifIndex The ifIndex attribute value Value from Interface Form

 

Use the following URL to run the Monitoring Settings report for the selected IP address:

Attributes Values Description
http://<serverName>:<portNumber>/nnm/launch?cmd=run-Tool&tool=monitoringconf&objtype=IPAddress&objattrs=value=<x>
value The IP address Value is taken from IP Address form

 

Use the following URL to run the Monitoring Settings report on the Router Redundancy Member:

Attributes Values Description
http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=monitoringconf&objtype=RouterRedundancyInstance&objid=<x>
objid Object ID The unique Object ID across the NNMi database
objuuid

 

The Universally Unique Object ID The unique value across all NNMi databases. Use nnmconfigexport.ovpl to find this value

 

Use the following URL to run the Monitoring Settings report on a Tracked Object:

Attributes Values Description
http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=monitoringconf&objtype=TrackedObject&objid=<x>
objid Object ID The unique Object ID across the NNMi database.
objuuid The Universally Unique Object ID

The unique value across all NNMi databases.

Use nnmconfigexport.ovpl to find this value

 

Use the following URL to run the Monitoring Settings report on a Node Component:

Attributes Values Description
http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=monitoringconf&objtype=ComponentHealth&objid=<x>
objid Object ID Unique Object ID across the NNMi database
objuuid Universally Unique Object ID Unique value across all NNMi databases. Use nnmconfigexport.ovpl to find this value.

 

Launching Status Poll command

The same action we used to open the Status Poll window in NNMi console (Tools | Status Poll), can be initiated using URL in two ways:

  • Launch the Status Poll report, where you are prompted to specify a node in a window:
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=statuspoll
  • To launch the Status Poll report for a particular node, which is provided within the URL, follow the next table:

    Attributes Values Description
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=statuspoll&nodename=<x>
    nodename DNS resolvable name or IP address

     

    Following sequence for checking a nodename value is used:
    • Hostname field on the Node Form.
    • Address column in IP Address Tab of Node Form.
    • System Name field on General Tab of the Node Form.
    • Name field of the Node Form.

Launching Configuration Poll command

The same action of opening the Configuration Poll window in NNMi console (Tools | Configuration Poll), can be initiated using URL in two ways:

  • Launch the Configuration Poll report, where you are prompted to specify a node in a window:
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=configurationpoll
  • Launch the Configuration Poll report for a particular node, which is provided within the URL:
    Attributes Values Description
    http://<serverName>:<portNumber>/nnm/launch?cmd=run-Tool&tool=configurationpoll&nodename=<x>
    nodename

     

    DNS resolvable name or IP address Following sequence for checking a nodename value is used:
    • Hostname field on the Node Form.
    • Address column in IP Address Tab of Node Form
    • System Name field on General Tab of the Node Form
    • Name field of the Node Form

Launching Status Details command

The same action we used to open the Status Details window in NNMi console (Tools | Status Details), can be initiated using URL in two ways:

  • Launch the Status Details report, where we are prompted to specify a node group name in a window:
    http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=nodegroupstatus
  • Launch the Status Details report for a particular node group, which is provided within the URL:
    Attributes Values Description

     

    http://<serverName>:<portNumber>/nnm/launch?cmd=run-Tool&tool=nodegroupstatus&nodegroup=<x>
    nodegroup
    • nodegroup
    • nodegroupid
    • nodegroupuuid
    Refer to the table under the Launching view section for attribute description.

Launching NNMi Status command

The same action we used to open the NNMi Status window in NNMi console (Tools | NNMi Status), can be initiated using URL: http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=nnmstatus.

Launching Sign In/Out Audit Log command

The same action as we used in NNMi console (Tools | Sign In/Out Audit Log) can be initiated using URL: http://<serverName>:<portNumber>/nnm/launch?cmd=runTool&tool=signinaudit.

This URL displays the output of the Sign In/Out Audit Log file.

Launching Sign Out command

The same action as we used in NNMi console (Tools | Sign Out), can be initiated using URL: http://<serverName>:<portNumber>/nnm/launch?cmd=signOut.

This URL closes the user session and frees up memory associated with the session.

Summary

In this article we saw how we can expand system capabilities using URLs.

HP Network Node Manager 9: Getting Started Manage your network effectively with this HP Network Node Manager book and eBook
Published: January 2011
eBook Price: $41.99
Book Price: $69.99
See more
Select your format and quantity:

About the Author :


Marius Vilemaitis

Marius Vilemaitis started his career with network management systems in the year 2000, when he was invited to join a network operations center team as a systems engineer in an ISP and telecom company. In 2005 he joined an IT service delivery company as systems engineer/consultant. He focused on IT infrastructure monitoring and management tools. His role was pre-sales consultant and delivery engineer, designing and implementing monitoring tools for network operations centers and IT departments in large and mid-size companies. In 2009, he was invited to join a long term project for implementing and improving the main network operations center for one of the US federal agencies. His experience covers companies with different sizes, requirements, and approaches. His approach is "Every situation has a solution". Also, during the past few years he has provided technical training for HP OpenView and Microsoft System Center products.

Books From Packt


Least Privilege Security for Windows 7, Vista and XP
Least Privilege Security for Windows 7, Vista and XP

Amazon SimpleDB Developer Guide
Amazon SimpleDB Developer Guide

Troux Enterprise Architecture Solutions
Troux Enterprise Architecture Solutions

Nginx HTTP Server
Nginx HTTP Server

Microsoft SQL Azure Enterprise Application Development
Microsoft SQL Azure Enterprise Application Development

Oracle GoldenGate 11g Implementer's guide
Oracle GoldenGate 11g Implementer's guide

Web 2.0 Solutions with Oracle WebCenter 11g
Web 2.0 Solutions with Oracle WebCenter 11g

Software Testing using Visual Studio 2010
Software Testing using Visual Studio 2010


No votes yet

Post new comment

CAPTCHA
This question is for testing whether you are a human visitor and to prevent automated spam submissions.
x
9
D
u
r
8
Enter the code without spaces and pay attention to upper/lower case.
Code Download and Errata
Packt Anytime, Anywhere
Register Books
Print Upgrades
eBook Downloads
Video Support
Contact Us
Awards Voting Nominations Previous Winners
Judges Open Source CMS Hall Of Fame CMS Most Promising Open Source Project Open Source E-Commerce Applications Open Source JavaScript Library Open Source Graphics Software
Resources
Open Source CMS Hall Of Fame CMS Most Promising Open Source Project Open Source E-Commerce Applications Open Source JavaScript Library Open Source Graphics Software