Administer > Integrate NNMi Elsewhere with URLs > Launch a View (showView) > Troubleshooting Workspace Views

Launch a Troubleshooting Workspace View

There are four types of views in the Troubleshooting workspace. The URL syntax required for each one is unique.

Tip This technique launches views independent of the NNMi console. When using this URL method, do not launch the view into a browser window where the NNMi console is currently running. The view automatically updates every 30 seconds. This is useful if your network operation center (NOC) continuously displays a map of the most important nodes. See Configure Maps.

ClosedClick here to show examples of URLs that open a Layer 2 Neighbor View (cmd=showLayer2Neighbors).

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= showLayer2Neighbors

http://<serverName>:<portNumber>/nnm/launch?cmd= showLayer2Neighbors&nodename= <x>&hops= <#>

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 view with a URL has the following limitations:

  • The Close button does not work.
  • The File → Close menu item does not work.

Use the browser buttons to close the view.

Layer 2 Neighbor View Attributes
Attribute Value
nodename

The source 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.
hops 1 - 9

The following are optional parameters:

http://<serverName>:<portNumber>/nnm/launch?cmd= showLayer2Neighbors&menus= <true|false>&newWindow= <true|false>&readonly= <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 Views
Attribute Values
menus

true = Show the view's button bar. If not specified, the default is true.

false = Hide the view's button bar to save space in the view.
newWindow

true = Display the view in a new browser window. This new window does not display the browser-specific menu bars. The browser-specific menu bars are hidden to provide the maximum amount of room for the requested view.

false = Display the view within the current browser window (if not specified, the default is false).
readonly

true = Prevents the user from doing either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)

false = Enables the user to do either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)
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.
ClosedClick here to show examples of URLs that open a Layer 3 Neighbor View (cmd=showLayer3Neighbors).

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

http://<serverName>:<portNumber>/nnm/launch?cmd= showLayer3Neighbors 

http://<serverName>:<portNumber>/nnm/launch?cmd= showLayer3Neighbors&nodename= <x>&hops= <#>

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

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 view with a URL has the following limitations:

  • The Close button does not work.
  • The File → Close menu item does not work.

Use the browser buttons to close the view.

Layer 3 Neighbor View Attributes
Attribute Value
nodename

The source 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.
hops 1 - 9
menus

true = Show the menus and window toolbar in the form. If not specified, the default is true.

false = Hide the menus and window toolbar in the view.

The following are optional parameters:

http://<serverName>:<portNumber>/nnm/launch?cmd= showLayer3Neighbors&menus= <true|false>&newWindow= <true|false>&readonly= <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 Views
Attribute Values
menus

true = Show the view's button bar. If not specified, the default is true.

false = Hide the view's button bar to save space in the view.
newWindow

true = Display the view in a new browser window. This new window does not display the browser-specific menu bars. The browser-specific menu bars are hidden to provide the maximum amount of room for the requested view.

false = Display the view within the current browser window (if not specified, the default is false).
readonly

true = Prevents the user from doing either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)

false = Enables the user to do either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)
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.
ClosedClick here to show examples of URLs that open a Path View (cmd=showPath).

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

http://<serverName>:<portNumber>/nnm/launch?cmd= showPath

http://<serverName>:<portNumber>/nnm/launch?cmd= showPath&src= <x>&dest= <y>

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

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 view with a URL has the following limitations:

  • The Close button does not work.
  • The File → Close menu item does not work.

Use the browser buttons to close the view.

Note (NNMi Advanced) Path View works only with IPv4 addresses. The NNMi Advanced IPv6 address values are not valid choices for Path View. Any devices in your network that are configured with IPv6 addresses cannot be displayed on Path View maps.

Path View Attributes
Attribute Value
src

The source node's DNS hostname (full or short) or IP address. 

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.
dest

The destination node's DNS hostname (full or short) or IP address.

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.

The following are optional parameters:

http://<serverName>:<portNumber>/nnm/launch?cmd= showPath&menus= <true|false>&newWindow= <true|false>&readonly= <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 Views
Attribute Values
menus

true = Show the view's button bar. If not specified, the default is true.

false = Hide the view's button bar to save space in the view.
newWindow

true = Display the view in a new browser window. This new window does not display the browser-specific menu bars. The browser-specific menu bars are hidden to provide the maximum amount of room for the requested view.

false = Display the view within the current browser window (if not specified, the default is false).
readonly

true = Prevents the user from doing either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)

false = Enables the user to do either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)
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.
ClosedClick here to show examples of URLs that open a Node Group Map View (cmd=showNodeGroup).

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

http://<serverName>:<portNumber>/nnm/launch?cmd= showNodeGroup&name= <x>

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 view with a URL has the following limitations:

  • The Close button does not work.
  • The File → Close menu item does not work.

Use the browser buttons to close the view.

Node Group Map View Attributes
Attribute Value
name

The case-sensitive Name attribute value from the Node Group form.

Note The Node Group name is translated. If your team shares NNMi within multiple locales, use nodegroupid or nodegroupuuid.

If the Name value includes space characters, consider replacing the space character in your URL statement.
objid

The id is the Unique Object Identifier (unique per object type in the NNMi database). Provide the id of the Node Group to use as a filter for this view.

NNMi displays the id attribute value on the object form's Registration tab.
objuuid

The uuid is the Universally Unique Object Identifier (unique across all databases). Provide the uuid of the Node Group to use as a filter for this view.

NNMi displays the uuid attribute value on the object form's Registration tab.

The following are optional parameters:

http://<serverName>:<portNumber>/nnm/launch?cmd= showNodeGroup&name= <x>&menus= <true|false>&newWindow= <true|false>&readonly= <true|false>&readonlygroupselector= <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 Views
Attribute Values
menus

true = Show the view's button bar. If not specified, the default is true.

false = Hide the view's button bar to save space in the view.
newWindow

true = Display the view in a new browser window. This new window does not display the browser-specific menu bars. The browser-specific menu bars are hidden to provide the maximum amount of room for the requested view.

false = Display the view within the current browser window (if not specified, the default is false).
readonly

Caution The readonly setting overrides the readonlygroupselector setting. This means that when readonly is set to true and readonlygroupselector is set to false, users are able to change the Node Group filter.

true = Prevents the user from doing either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)

false = Enables the user to do either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)
readonlygroupselector

Caution The readonly setting overrides the readonlygroupselector setting. This means that when readonly is set to true and readonlygroupselector is set to false, users are able to change the Node Group filter.

true = Prevents the user from selecting a Node Group.

Note When readonlygroupselector is set to true, the Node Group filter selection box appears disabled.

false = Enables the user to select a Node Group.
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