Administer > Integrate NNMi Elsewhere with URLs > Launch a Form (showForm/showConfigForm) > Node Form

Launch a Node Form

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Node&nodename= <x>

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Node&objattrs= name= <x>

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Node&objattrs= hostname= <x>

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Node&objattrs= snmpAgent.agentSettings.managementAddress= <x>

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Node&objattrs= systemName= <x>

Note If the NNMi Web server uses the https protocol, use https instead of http.

<serverName> = the fully-qualified domain name of the NNMi management server (values allowed here are determined by the Enable URL Redirect setting in User Interface Configuration, see Configure the NNMi User Interface)

<portNumber> = the NNMi HTTP port number

For a quick-reference list of all URL choices for launching NNMi, see Help → Documentation Library → Integrate NNMi Elsewhere with URLs. The Integrate NNMi Elsewhere with URLs page also contains a link to a list of sample URLs that you can copy/paste as a starting point.

Note: If you are using Mozilla Firefox or Google Chrome, Closedclick here for more information.

Due to the Mozilla Firefox security implementation, launching an NNMi form with a URL has the following limitations:

  • The Close button does not work.
  • The File → Close menu item does not work.
  • The Save and Close button saves data, but does not close the window.
  • The File → Save and Close menu item saves data, but does not close the window.

Use the browser buttons to close the form.

Node Form Attributes
Attribute Values
nodename

Provide the node's DNS hostname (full or short) or IP address. 

If you use this attribute, NNMi tries to match the string you provide by following this procedure:

  • Check the value of the Hostname (case-sensitive) on the Node form.
  • Check the values in the Address column of the table on the Node form, Addresses tab,
  • Check the value of the System Name field on the in the Node form, General tab.
  • Check the value in the Name field on the Node form.
name The Name attribute value from the Node form.
hostname

The case-sensitive Hostname attribute value from the Node form of the discovered node must match what is entered here.

NNMi follows a set of rules to dynamically generate the value stored in the NNMi database for each Node's Hostname. Click here for details.

  • If the Node supports SNMP, NNMi requests the Hostname using the IP Address of the associated SNMP agent (the Management Address attribute value on the Node form).

    When the NNMi administrator chooses Enable SNMP Address Rediscovery  in the Communication Configuration:

    • If the SNMP Agent does not respond, NNMi checks for another Management Address to request the Hostname, and the Hostname could change.
    • If the SNMP Agent associated with the node changes, the Management Address and Hostname could change.

    When the NNMi administrator disables Enable SNMP Address Rediscovery  in the Communication Configuration, when the current management address (SNMP agent) becomes unreachable, NNMi does not check for other potential management addresses.

  • If the Node does not support SNMP, no Management Address is available. NNMi requests a Hostname starting with the lowest IP Address associated with the node (a Discovery Seed value or an IP address value gathered from a neighboring device). NNMi uses the first Hostname provided. The Hostname might change during a future discovery cycle.

NNMi administrators can use NNMi property file settings to change the way NNMi determines Hostname values:

  • nms-topology.properties file settings:
    If DNS is the source of the Node's Hostname, there are three choices. By default NNMi uses the exact Hostname from your network configuration. It is possible to change NNMi behavior to convert Hostnames to all uppercase or all lowercase.
  • nms-disco.properties file settings:
    The Hostname is either requested from the Node's lowest loopback interface IP address that resolves to a Hostname or requested from the Node's designated Management Address (SNMP agent address). With either choice, when no IP address resolves to a Hostname, the IP address itself becomes the Hostname.
snmpAgent.agentSettings. managementAddress The Management Address attribute value from the SNMP Agent form of the agent assigned to the specified node. The value is an IP address.
systemName System Name attribute value from the Node form, General tab.

The following are optional filter parameters: 

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Node&nodename= <x>&menus= <true/false>&envattrs= <name1= value>;<name2= value>

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

Attributes for Launched Forms
Attribute Values
menus

true = Show the view menus and the Close button. If not specified, the default is true.

false = Hide the view menus and the Close button to save space in the view.
envattrs

Use Environment Attributes (envattrs) to pass <name=value> pairs from an external application to NNMi. Environment Attributes are session-specific and stored in memory (not in the NNMi database). The name-value pairs can be any arbitrary string (as required by the external program).

For example, let’s assume that NNMi was launched from an application that wants to preserve a session ID (123) and object attribute (node25) as follows:

http://<yourServerName/nnm?cmd= showView&objtype= Node&envattrs= com.my.sessionId= 123;com.my.objectName= node25

Note See Pass Environment Attributes for information about how to retrieve these Environment Attributes (envattrs) <name=value> pairs from NNMi, and pass them back to the originating external application.

Send Help Center feedback