IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2...

40
Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7, 2014 SC27-6551-00

Transcript of IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2...

Page 1: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Netcool/OMNIbus Probe for HP Network Node Manager-iversion 9.2Version 1.0

Reference GuideNovember 7, 2014

SC27-6551-00

���

Page 2: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00
Page 3: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Netcool/OMNIbus Probe for HP Network Node Manager-iversion 9.2Version 1.0

Reference GuideNovember 7, 2014

SC27-6551-00

���

Page 4: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

NoteBefore using this information and the product it supports, read the information in “Notices and Trademarks,” on page 27.

Edition notice

This edition (SC27-6551-00) applies to version 1.0 of the Probe for HP NNM-i 9.2 and to all subsequent releases andmodifications until otherwise indicated in new editions.

© Copyright IBM Corporation 2014.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Page 5: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Contents

About this guide . . . . . . . . . . . vDocument control page . . . . . . . . . . . vConventions used in this guide . . . . . . . . v

IBM Tivoli Netcool/OMNIbus Probe forHP Network Node Manager-i version 9.2 . 1Summary . . . . . . . . . . . . . . . 1Getting started. . . . . . . . . . . . . . 2Installing probes . . . . . . . . . . . . . 3Configuring the probe . . . . . . . . . . . 3Data acquisition . . . . . . . . . . . . . 5

ObjectServer information . . . . . . . . . 6Connecting to the HP NNM-i 9.2 system . . . . 6Authentication. . . . . . . . . . . . . 7Event retrieval . . . . . . . . . . . . . 8Subscription checking and renewal . . . . . . 8

Event synchronization . . . . . . . . . . 10Reconnection and backoff strategy . . . . . . 12Inactivity . . . . . . . . . . . . . . 13Support for Unicode and non-Unicode characters 13Peer-to-peer failover functionality . . . . . . 14

Running the probe . . . . . . . . . . . . 15Running multiple probes . . . . . . . . . 15Running the probe as a Windows service . . . 16

Properties and command line options . . . . . 17Elements . . . . . . . . . . . . . . . 21Error messages . . . . . . . . . . . . . 22ProbeWatch messages . . . . . . . . . . . 25

Appendix. Notices and Trademarks . . 27Notices . . . . . . . . . . . . . . . . 27Trademarks . . . . . . . . . . . . . . 29

© Copyright IBM Corp. 2014 iii

Page 6: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

iv IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 7: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

About this guide

The following sections contain important information about using this guide.

Document control pageUse this information to track changes between versions of this guide.

The IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version9.2 documentation is provided in softcopy format only. To obtain the most recentversion, visit the IBM® Tivoli® Knowledge Center:

http://www-01.ibm.com/support/knowledgecenter/?lang=en#!/SSSHTQ/omnibus/probes/common/Probes.html

Table 1. Document modification history

Documentversion

Publicationdate

Comments

SC27-6551-00 November 7,2014

First IBM publication.

Conventions used in this guideAll probe guides use standard conventions for operating system-dependentenvironment variables and directory paths.

Operating system-dependent variables and paths

All probe guides use standard conventions for specifying environment variablesand describing directory paths, depending on what operating systems the probe issupported on.

For probes supported on UNIX and Linux operating systems, probe guides use thestandard UNIX conventions such as $variable for environment variables andforward slashes (/) in directory paths. For example:

$OMNIHOME/probes

For probes supported only on Windows operating systems, probe guides use thestandard Windows conventions such as %variable% for environment variables andbackward slashes (\) in directory paths. For example:

%OMNIHOME%\probes

For probes supported on UNIX, Linux, and Windows operating systems, probeguides use the standard UNIX conventions for specifying environment variablesand describing directory paths. When using the Windows command line withthese probes, replace the UNIX conventions used in the guide with Windowsconventions. If you are using the bash shell on a Windows system, you can use theUNIX conventions.

© Copyright IBM Corp. 2014 v

Page 8: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Note: The names of environment variables are not always the same in Windowsand UNIX environments. For example, %TEMP% in Windows environments isequivalent to $TMPDIR in UNIX and Linux environments. Where such variables aredescribed in the guide, both the UNIX and Windows conventions will be used.

Operating system-specific directory names

Where Tivoli Netcool/OMNIbus files are identified as located within an archdirectory under NCHOME or OMNIHOME, arch is a variable that represents youroperating system directory. For example:

$OMNIHOME/probes/arch

The following table lists the directory names used for each operating system.

Note: This probe may not support all of the operating systems specified in thetable.

Table 2. Directory names for the arch variable

Operating system Directory name represented by arch

AIX® systems aix5

HP-UX PA-RISC-based systems hpux11

HP-UX Integrity-based systems hpux11hpia

Red Hat Linux and SUSE systems linux2x86

Linux for System z® linux2s390

Solaris systems solaris2

Windows systems win32

OMNIHOME location

Probes and older versions of Tivoli Netcool/OMNIbus use the OMNIHOMEenvironment variable in many configuration files. Set the value of OMNIHOME asfollows:v On UNIX and Linux, set $OMNIHOME to $NCHOME/omnibus.v On Windows, set %OMNIHOME% to %NCHOME%\omnibus.

vi IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 9: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

IBM Tivoli Netcool/OMNIbus Probe for HP Network NodeManager-i version 9.2

The HP Network Node Manager-i 9.2 (the NNM-i 9.2 system) is a networkmanagement system that discovers network devices and provides a map of thenetwork's topology. The system identifies the source of network problems andassists network managers in planning for network growth and designing networkchanges.

The Probe for HP NNM-i 9.2 subscribes to the HP NNM system for eventinformation and reports these as incidents to Netcool/OMNIbus. The probe canalso synchronize its event information with the HP NNM system at regularintervals. Both the subscription and resynchronization streams can be filtered. Theprobe can also be subscribe to the XML event descriptions that the HP NNM APImakes available.

This guide contains the following sections:v “Summary”v “Getting started” on page 2v “Installing probes” on page 3v “Configuring the probe” on page 3v “Data acquisition” on page 5v “Running the probe” on page 15v “Properties and command line options” on page 17v “Elements” on page 21v “Error messages” on page 22v “ProbeWatch messages” on page 25

SummaryEach probe works in a different way to acquire event data from its source, andtherefore has specific features, default values, and changeable properties. Use thissummary information to learn about this probe.

The following table provides a summary of the Probe for HP NNM-i 9.2.

Table 3. Summary

Probe target Network Node Manager-i 9.2

Probe executable name nco_p_hp_nnm

Patch number 1.0

Probe supported on For details of supported operating systems, see thefollowing Release Notice on the IBM Software Supportwebsite: https://www-304.ibm.com/support/docview.wss?uid=swg21687619

Properties file $OMNIHOME/probes/arch/hp_nnm.props

Rules file $OMNIHOME/probes/arch/hp_nnm.rules

© Copyright IBM Corp. 2014 1

Page 10: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 3. Summary (continued)

Requirements For details of any additional software that this proberequires, refer to the description.txt file that issupplied in its download package.

Connection method HTTP/SOAP

Multicultural support Available

For information about configuring multiculturalsupport, including language options, see the IBM TivoliNetcool/OMNIbus Installation and Deployment Guide.

Peer-to-peer failover functionality Available

IP environment IPv4 and IPv6

Federal Information ProcessingStandards (FIPS)

IBM Tivoli Netcool/OMNIbus V7.3.0, 7.3.1, 7.4.0, and8.1 use the FIPS 140-2 approved cryptographicprovider: IBM Crypto for C (ICC) certificate 384 forcryptography. This certificate is listed on the NISTwebsite at http://csrc.nist.gov/groups/STM/cmvp/documents/140-1/1401val2004.htm For details aboutconfiguring Netcool/OMNIbus for FIPS 140-2 mode,see IBM Tivoli Netcool/OMNIbus Installation andDeployment Guide.

Getting startedThis section shows how to start the probe with the minimum requiredconfiguration. The procedure assumes that you have a version ofNetcool/OMNIbus installed and running.

Use the following procedure to start the probe with a minimal configuration:

Note: The commands shown in this example are for a Linux system. Adapt thesecommands as necessary for the operating system that your probe server runs.1. Download the probe's installation package following the instructions in

http://www-01.ibm.com/support/knowledgecenter/SSSHTQ/omnibus/probes/all_probes/wip/reference/install_download_intro.html.

2. Edit the probe's properties file and set values for the following: [insert nestedlist of properties and the values they need]

3. Ensure that $NCHOME/etc/omni.dat includes information on the ObjectServer.4. Obtain a listing of the probe's command line options to check the probe is

installed correctly:Check that the output from this command begins as follows:

5. Start the probe as follows:6. Check the probe's log file to ensure the probe started correctly and is ready to

receive, process, and dispatch events.The probe's MessageLog property provides the name and location of the probe'slog file.

7. Where possible, use a test tool to send events to the probe and so check theyare processed correctly.For example, [put your probe's preferred test tool in here]

The probe is now successfully installed and operational. You can now configure theprobe to suit your operating environment.

2 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 11: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Installing probesAll probes are installed in a similar way. The process involves downloading theappropriate installation package for your operating system, installing theappropriate files for the version of Netcool/OMNIbus that you are running, andconfiguring the probe to suit your environment.

The installation process consists of the following steps:1. Downloading the installation package for the probe from the Passport

Advantage Online website.Each probe has a single installation package for each operating systemsupported. For details about how to locate and download the installationpackage for your operating system, visit the following page on the IBM TivoliKnowledge Center:http://www-01.ibm.com/support/knowledgecenter/SSSHTQ/omnibus/probes/all_probes/wip/reference/install_download_intro.html

2. Installing the probe using the installation package.The installation package contains the appropriate files for all supportedversions of Netcool/OMNIbus. For details about how to install the probe torun with your version of Netcool/OMNIbus, visit the following page on theIBM Tivoli Knowledge Center:http://www-01.ibm.com/support/knowledgecenter/SSSHTQ/omnibus/probes/all_probes/wip/reference/install_install_intro.html

3. Configuring the probe.This guide contains details of the essential configuration required to run thisprobe. It combines topics that are common to all probes and topics that arepeculiar to this probe. For details about additional configuration that iscommon to all probes, see the IBM Tivoli Netcool/OMNIbus Probe and GatewayGuide.

Configuring the probeAfter installing the probe you need to make various configuration settings to suityour environment. You also need to install HP NNM-i 9.2 utilities.

The following table outlines how to use the probe's properties to configure theproduct's features. Configuration of some features is mandatory for allinstallations. For those features set the properties to the correct values or verifythat their default values are suitable for your environment. Further configuration isoptional depending on which features of the probe you want to use.

Table 4. Configuring the probe

Feature Properties See

Mandatory features:

HP NNM systemconnection information

The method that the probeobtains the reference to theobject needed to connect tothe CORBA interface.

NnmAddressNnmPortProbeReceiverPortSubscriptionFilter

“Connecting to the HPNNM-i 9.2 system” on page6

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 3

Page 12: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 4. Configuring the probe (continued)

Feature Properties See

Authentication

Credentials forauthenticating with the TMFendpoint.

NnmPasswordNnmUserId

“Authentication” on page 7

ObjectServer host name Server “ObjectServer information”on page 6

Optional features:

Event synchronizationpolicy

Specifies whether the probesynchronizes with the HPNNM system at startup andon regular occasions.

InitialResyncResyncIntervalResyncBatchSizeResyncFilterNameResyncFilterOperationResyncFilterValue

“Event synchronization” onpage 10

Reconnection policy

Specifies whether the probeattempts to reconnect to theHP NNM system followinga communications failure.

RetryCountRetryInterval

“Reconnection and backoffstrategy” on page 12

Inactivity policy

Specifies whether the probedisconnects from the HPNNM system following aperiod of inactivity.

Inactivity “Inactivity” on page 13

Support for Unicode andnon-Unicode characters

Enables the probe to processalarms that containcharacters encoded inUTF-8, such as Asianlanguages.

None “Support for Unicode andnon-Unicode characters” onpage 13

Peer-to-peer failover pair

Allows you to set up twoprobes to act as a failoverpair to improve availability.If the master probe shouldstop working, the slaveprobes takes over until themaster is available oncemore.

MessageFileModePeerHostPeerPortPidFilePropsFileRulesFile

“Peer-to-peer failoverfunctionality” on page 14

Running multiple instancesof the probe

Allows you to run two ormore instances of the probeon a single host machine.

DataBackupFileNameMessageLogPidFileProbeReceiverPortPropsFileRulesFile

“Running multiple probes”on page 15

Running the probe as aWindows service

None “Running the probe as aWindows service” on page16

4 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 13: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Installing HP NNM-i 9.2 utilities

The configuring of the Probe for HP NNM-i 9.2 requires that you install the HPNNM-i 9.2 utilities. To install these utilities, follow these steps:1. Manually create the following directory:

$OMNIHOME/probes/java/nco_p_hp_nnm

2. Copy the nms-sdk.jar file from the /$NNM_HOME/OV/NNM/lib directory to the$OMNIHOME/probes/java/nco_p_hp_nnm directory.

Note: The $NNM_HOME variable specifies the location where HP NNM-i 9.2 isinstalled.

3. Ensure that the default location setting for the utility JAR file exists on therespective operating system platforms:v On Windows:

File:%OMNIHOME\probes\win32\nco_p_hp_nnm.bat

Where the default configuration is:set PROBE_CLASSPATH=%CLASS_DIR%\nco_p_hp_nnm.jar;%OMNIHOME%\probes\java\nco_p_hp_nnm\nms-sdk.jar

v On Unix:

File:$OMNIHOME/probes/java/nco_p_hp_nnm.env

Where the default configuration is:CLASSPATH_SETTING=${OMNIHOME}/probes/java/nco_p_hp_nnm/nms-sdk.jar

Data acquisitionEach probe uses a different method to acquire data. Which method the probe usesdepends on the target system from which it receives data.

The Probe for HP NNM-i 9.2 acquires data from HP NNM-i 9.2 .

Data acquisition is described in the following topics:v “ObjectServer information” on page 6v “Connecting to the HP NNM-i 9.2 system” on page 6v “Authentication” on page 7v “Event retrieval” on page 8v “Subscription checking and renewal” on page 8v “Event synchronization” on page 10v “Reconnection and backoff strategy” on page 12v “Inactivity” on page 13v “Support for Unicode and non-Unicode characters” on page 13v “Peer-to-peer failover functionality” on page 14

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 5

Page 14: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

ObjectServer informationThe probe sends processed events to an ObjectServer resource. This can be a singleserver or a failover pair of ObjectServers.

The probe sends processed events to an ObjectServer resource. This can be a singleserver or a failover pair of ObjectServers.

Single ObjectServer

Configure the probe to communicate with an ObjectServer by setting the Serverproperty to the name of the ObjectServer.

Failover pair

Optionally, you can define a failover pair of ObjectServers. One of them acts as theprimary ObjectServer that the probe communicates with initially. Should thatObjectServer become unreachable, the probe communicates with the other, backupObjectServer. To define a failover pair set the following probe properties:

Table 5. Properties that define a failover pair of ObjectServers

Property Value

Server Set this property to the name of the primary ObjectServer.

ServerBackup Set this property to the name of the backup ObjectServer.

NetworkTimeout Set this property to the timeout period, in seconds, for the primaryObjectServer. If the probe does not receive a response from the primaryObjectServer within that time, it connects to the backup ObjectServer.

PollServer Set this property to the time period, in seconds, when the probe tries toreconnect to the primary ObjectServer.

Note: Ensure that the value of NetworkTimeout is less than the value of PollServer.

Connecting to the HP NNM-i 9.2 systemThe probe connects to the HP NNM-i 9.2 system and subscribes to the notificationevent service to receive new events as they are generated.

When it starts, the probe connects to the HP NNM-i 9.2 system over HTTP usingthe following properties:v NNMAddress: This property contains the address of the HP NNM-i 9.2 system in

IPv4 or IPv6 format, as appropriate for your network.v NNMPort: The probe uses this property to connect to the port on the HP NNM-i

9.2 system where it receives subscription requests.

The administrator of the HP NNM-i 9.2 system can provide the values to use forthese properties.

Once the connection is active, the probe sends a SOAP message that creates asubscription for receiving events from the HP NNM-i 9.2 system. This messageincludes the identity of the port on the host that runs the probe where it receivesevents. The ProbeReceiverPort identifies this port. Set this to a suitable value foryour environment.

In this configuration, the probe acts as the client to the HP NNM-i 9.2 system'sserver.

6 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 15: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

The subscription filterThe SOAP message that creates the event subscription can include a subscriptionfilter. The filter defines the events that the probe wishes to receive from the HPNNM-i 9.2 system. For example, the probe can specify that it wants to receiveevents with a severity of critical only.

Use the SubscriptionFilter property to define subscription filter. The property'svalue is an XPath expression that identifies the events that the probe wants toreceive. The following are some examples of the subscription filter:

Table 6. Examples of the subscription filter

Value of the SubscriptionFilter property Description

"arg0[severity=’CRITICAL’]" The probe receives events that have aseverity of critical only.

"arg0[origin=’MANAGEMENTSOFTWARE’]" The probe receives events that originatefrom the MANAGEMENTSOFTWARE componentonly.

By default, the subscription filter is empty, and so the probe receives all events thatthe HP NNM-i 9.2 system generates.

Firewall considerationsThe ProbeReceiverPort property defines the port where the probe receivesmessages from the HP NNM-i 9.2 system. Ensure that port is open to receivemessages on the system that runs the probe.

The NnmPort property defines the port on the HP NNM-i 9.2 system that the probecommunicates with. Ensure that port is open on the HP NNM-i 9.2 system.

AuthenticationWhen subscribing to events from the HP NNM-i 9.2 system, the probe providesauthentication information in the form of a username and password.

Use the NNMUserID and NNMPassword properties to contain the credentials for theaccount on the HP NNM-i 9.2 system that the probe uses for event notification.The values of both properties can be plain text or AES encrypted text. However,for improved security encrypt both the user name and password.

To encrypt the username or password, use the nco_keygen utility to create a keyfile and then use the nco_aes_crypt utility to encrypt the text using the key file.

Detailed instructions on how to encrypt a property value, such as NNMUserID andNNMPassword are in the IBM Tivoli Netcool/OMNIbus Installation and DeploymentGuide. The following example summarizes the procedure for encrypting thepassword:1. Use nco_keygen to create a key file; for example:

$NCHOME/omnibus/bin/nco_keygen -o $NCHOME/omnibus/probes/key_file

2. Set the value of the probe's ConfigKeyFile property to the file path of the keyfile; for example:ConfigKeyFile: "$NCHOME/omnibus/probes/key_file"

3. Set the value of the probe's ConfigCryptoAlg property to AES:ConfigCryptoAlg: "AES"

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 7

Page 16: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

4. Use nco_aes_crypt to encrypt the password; for example:$NCHOME/omnibus/bin/nco_aes_crypt -c AES -k key_file password

5. Set the value of the probe's NNMPassword property to the encrypted stringgenerated by nco_aes_crypt; for example:Password: "@44:U/ccVZ0K+ftc7gZTV33Yx2fODe5v46RZzEbvqpE=@"

Event retrievalWhen the probe is running, it receives events from the HP NNM-i 9.2 system asthey are generated. The probe receives details of new incident events and updatesto existing events that match the criteria in the SubscriptionFilter property.

Each message from the HP NNM-i 9.2 system contains a $Resent, $Identifier and$UpdateTime element. These elements indicate whether the message is new, anupdate to a previous message, or if the message has previously been processed bythe probe.

For existing events, the probe receives notification only if either the$LifecycleState or $RcaState element of the incident is updated.

The probe maintains an internal cache of events it has received. The probe usesthis cache to avoid sending false duplicate events to the OMNIbus event list.

The HP NNM-i 9.2 system can detect if a message has not been sent, and makesthree attempts to resend the message before it is discarded.

Subscription checking and renewalThe probe periodically checks the status of and renews its subscription with theHP NNM-i 9.2 system.

Checking the subscriptionThe probe regularly checks whether the subscription with the HP NNM-i 9.2 serveris active. The value of the HeartbeatInterval property determines the frequency(in seconds) of this check.

The default value of HeartbeatInterval is 60. Change this, if necessary, to suityour local environment. The value of the property can be in the range 1 to 299.Note that the value of this property also affects how often the probe renews thesubscription (see “Renewing the subscription” on page 9). Take that into accountwhen determining the value of the property that is suitable for your site.

8 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 17: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Renewing the subscriptionIn addition to checking the subscription, the probe also renews it. The value of theHeartbeatInterval property has a role in determining the expiry time of thesubscription:

Table 7. Determining the subscription expiry time

Value ofHeartbeatInterval Subscription expiry time

<=240 The probe sets the subscription expiry time to 5 minutes (300seconds).

>240 The probe sets the subscription expiry time to the value ofHeartbeatInterval plus one minute (60 seconds).

For example, if the value of HeartbeatInterval is 270, the probesets the subscription expiry time to:

270 + 60 = 330 seconds = 5 minutes 30 seconds

The initial subscription expiry timeThe probe creates the initial subscription when it connects to the HP NNM-i 9.2system. The expiry time of this subscription is always 5 minutes, which is thedefault expiry time of the HP NNM-i 9.2 system.

Error handlingThere are two error conditions that can occur when checking and renewing thesubscription:v The subscription check failsv The value of HeatbeatInterval is out of range

Failure of the subscription check:The subscription check can fail for a number of reasons, including:v The HP NNM-i 9.2 system is not runningv The HP NNM-i 9.2 system has become unreachablev The network connection to the HP NNM-i 9.2 system has failed or is unavailable

If the subscription check fails, the probe does one of the following:v Shuts downv Attempts to reconnect to the HP NNM-i 9.2 system

The value of the RetryCount property determines which action the probe takes.When the property value is 0, the probe shuts down. When the property has apositive value, the probe attempts to reconnect to the HP NNM-i 9.2 system asshown in “Reconnection and backoff strategy” on page 12.

The value of HeartbeatInterval is out of range:If the value of HeartbeatInterval is outside the range 1 to 299, the probe logs anerror and sends a ProbeWatch message to the ObjectServer. The probe then doesone of the following:v Shuts downv Attempts to reconnect to the HP NNM-i 9.2 system

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 9

Page 18: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

The value of the RetryCount property determines which action the probe takes inthe same way as when the subscription check fails. See “Failure of the subscriptioncheck” on page 9.

Should the probe's log file contain a message indicating that the value ofHeartbeatInterval is incorrect:1. Shut down the probe.2. Correct the value of HeartbeatInterval.3. Restart the probe.

Event synchronizationSynchronization enables the probe to collect any events that the HP NNM-i 9.2system generated while the probe was disconnected. In addition, the probe canresynchronize with the HP NNM-i 9.2 system at regular intervals. You can use anycombination of these synchronization features.

Initial synchronizationEach time the probe starts it can synchronize with the HP NNM-i 9.2 system toacquire all the events that the HP NNM-i 9.2 system holds. Use the InitialResyncproperty to control whether the probe carries out an initial synchronization.

When the value of the property is true, the probe carries out an initialsynchronization. When the value of the property is false, the probe does not carryout an initial synchronization.

By default, the probe does not synchronize with the HP NNM-i 9.2 system atstartup.

Synchronization at intervalsIn addition to synchronizing with the HP NNM-i 9.2 system at startup, the probecan also resynchronize with the HP NNM-i 9.2 system at regular intervals. Use theResyncInterval property to define whether the probe synchronizes with the HPNNM-i 9.2 system at intervals and how frequently.

When the value of the property is 0 or less, the probe does not resynchronize withthe HP NNM-i 9.2 system at regular intervals. When the value of the property is apositive number, the probe resynchronizes with the HP NNM-i 9.2 systemregularly. The value of the property specifies the number of seconds between eachresynchronization operation.

By default, the probe does not regularly resynchronize with the HP NNM-i 9.2system.

10 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 19: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Synchronization in batchesYou can use the ResyncBatchSize property to limit the number of events that theHP NNM-i 9.2 system sends in any resynchronization. This helps to prevent theprobe from being overloaded in an event storm. If there are more events to sendthan specified in this property, the HP NNM-i 9.2 system sends the remainder inthe next regular synchronization operation.

The default value of this property is 100.

Defining a resynchronization filterBy default, a synchronization operation retrieves all the events that the HP NNM-i9.2 server currently holds. You can use a resynchronization filter to limit thenumber of events that the event retrieves. Three properties contain theresynchronization filter:

ResyncFilterName

ResyncFilterOperation

ResyncFilterValue

ResyncFilterName

ResyncFilterName identifies a field in the event that you want to filter on. You canspecify the following:v assignedTov categoryv ciasv createdv duplicateCountv familyv firstOccurrenceTimev formattedMessagev idv lastOccurrenceTimev lifecycleStatev modifiedv naturev namev notesv originv originOccurrenceTimev priorityv rcaActivev severityv sourceNamev sourceNodeNamev sourceNodeUuidv sourceTypev sourceUuidv uuid

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 11

Page 20: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

ResyncFilterOperation

ResyncFilterOperation defines a condition to use in the filter. You can use thefollowing operators:v =v !=v <v <=v >v >=v LIKEv NOT IN

ResyncFilterValue

ResyncFilterValue defines the value of the field identified in ResyncFilterName tobe compared against the corresponding field in each event using the operation inResyncFilterOperation.

Example

To retrieve only those events that have a severity of Error or greater, use thefollowing property values:ResyncFilterName: "severity"ResyncFilterOperation: ">="ResyncFiltervalue: "ERROR"

Optimized SynchronizationDuring a resynchronization operation, the probe tries to optimize the process byonly retrieving events that it has not retrieved previously. The probe does thisusing the time stamp associated with each event.

Reconnection and backoff strategyUse the RetryCount and RetryInterval properties to specify how the probe reactsif the connection to the HP NNM-i 9.2 system is lost or cannot be established.

Use the RetryCount property to specify whether the probe attempts to reconnect tothe HP NNM-i 9.2 system. Setting the property to 0, the default value, means thatthe probe does not try to reconnect and simply shuts down. Any other, positivevalue specifies the number of times the probe tries to reconnect before shuttingdown.

Use the RetryInterval property to specify the number of seconds between eachattempt to reconnect to the HP NNM-i 9.2 system.

Setting the RetryInterval property to 0 means that the probe uses anexponentially increasing interval between connection attempts. First the probewaits 1 second, then 2 seconds, then 4 seconds, and so on up to a maximum of4095 seconds. If this limit, or the number of connection attempts is reached, theprobe shuts down.

12 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 21: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

InactivityThe probe can disconnect from the target system and shut down if there is noevent activity for a predefined amount of time.

The Inactivity property specifies the maximum time (in seconds) that the probeswaits, without receiving any messages from the HP NNM-i 9.2 system. If thatamount of time passes by, the probe shuts down.

To ensure that the probe never shuts down because of inactivity, set the propertyto 0.

Support for Unicode and non-Unicode charactersThe probe can process multibyte characters such as Unicode UTF-8, GB, Big5, orShift-JIS.

Use the following procedure to set up the probe to process multibyte characters:1. Ensure that the HP NNM-i 9.2 system is configured to send data in the

required format (for example, UTF-8).2. Set the required locale on the system that runs the probe:

Table 8. Setting the locale for multibyte characters

Operatingsystem Procedure to set the locale

Linux and Unix Set the locale by changing the values of the LANG and LC_ALLenvironment variables. For example, to set the locale to simplifiedChinese in UTF-8, use the following commands:

export LANG=zh_CN.UTF-8export LC_ALL=zh_CN.UTF-8

Windows 1. Open the Control Panel and double click on Regional andLanguage.

2. On the Formats tab, select the language from the list in Format.

3. On the Administrative tab, click Change system locale.

4. Select the language from the list in Current System Locale.

5. Click OK.

6. Click OK.

3. Configure the ObjectServer to enable the insertion of data that uses the requiredcharacter set. The IBM Tivoli Netcool/OMNIbus Administration Guide shows howto create, configure, and run an ObjectServer in UTF-8 mode or using anothercharacter set.

4. Run the probe or, if it is already running, restart the probe.When running the probe on a Windows system using a UTF-8 character set,always specify the -utf8enabled command line option. For all other charactersets, do not use the -utf8enabled command line option.

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 13

Page 22: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Peer-to-peer failover functionalityThe probe supports failover configurations where two probes run simultaneously.One probe acts as the master probe, sending events to the ObjectServer; the otheracts as the slave probe on standby. If the master probe fails, the slave probeactivates.

While the slave probe receives heartbeats from the master probe, it does notforward events to the ObjectServer. If the master shuts down, the slave probe stopsreceiving heartbeats from the master and any events it receives thereafter areforwarded to the ObjectServer on behalf of the master probe. When the master isrunning again, the slave continues to receive events, but no longer sends them tothe ObjectServer.

Example property file settings for peer-to-peer failover

You set the peer-to-peer failover mode in the properties files of the master andslave probes. The settings differ for a master probe and slave probe.

Note: In the examples, make sure to use the full path for the property value. Inother words replace $OMNIHOME with the full path. For example:/opt/IBM/tivoli/netcool.

The following example shows the peer-to-peer settings from the properties file of amaster probe:Server : "NCOMS"RulesFile : "master_rules_file"MessageLog : "master_log_file"PeerHost : "slave_hostname"PeerPort : 5555 # [communication port between master and slave probe]Mode : "master"PidFile : "$OMNIHOME/var/opc_ua"

The following example shows the peer-to-peer settings from the properties file ofthe corresponding slave probe:Server : "NCOMS"RulesFile : "slave_rules_file"MessageLog : "slave_log_file"PeerHost : "master_hostname"PeerPort : 5555 # [communication port between master and slave probe]Mode : "slave"PidFile : "$OMNIHOME/var/opc_ua2"

14 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 23: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Running the probeYou can run a single instance of the probe or multiple instances on a single host. Inaddition, you can run the probe as a service on the Windows operating system.

To start the probe, use the following command:

UNIX Linux $NCHOME/omnibus/probes/nco_p_hp_nnm

Windows %NCHOME%\omnibus\probes\nco_p_hp_nnm

Running multiple probesYou can run multiple, concurrent instances on a single host machine.

Preparation

For each instance of the probe that you want to run, do the following:1. Create a uniquely-named copy of the probe's properties file, for example:

$NCHOME/omnibus/probes/arch/nco_p_hp_nnm_n.props

For each copy of the properties file, replace n with a unique number.2. Optionally, create a uniquely-named copy of the probe's rules file.3. In the properties file for each instance, define a unique value for the following

properties:DataBackupFile

Name

MessageLog

PidFile

ProbeReceiverPort

4. In the properties file for each instance, set the values of the PropsFile andRulesFile properties to the names of the files you created in steps 1 and 2.

5. Customize the values of other properties as required.

Running the probes

To run each instance of the probe, specify the -propsfile command line option torefer to the appropriate properties file, for example on UNIX:$NCHOME/omnibus/probes/nco_p_hp_nnm-propsfile $NCHOME/props/aix5/nco_p_hp_nnm_1.props

$NCHOME/omnibus/probes/nco_p_hp_nnm-propsfile $NCHOME/props/aix5/nco_p_hp_nnm_2.props

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 15

Page 24: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Running the probe as a Windows serviceThe Windows version of the probe can run as a Windows service.

Registering and running the Windows service

To run a single instance of the probe as a Windows service:1. Open a Command Prompt.2. Register the probe as a Windows service:

%OMNIHOME%\probes\win32\nco_p_hp_nnm.bat /INSTALL /INSTANCE instance-name/CMDLINE "command-line-options"

Replace instance-name with a unique name for the service andcommand-line-options with any command line options that you want to usewhen running the probe. Always enclose the command line options in quotes.If you do not want to use any command line options, exclude the /CMDLINEswitch.

Note: If you exclude the /INSTANCE switch, the name of the service isNCOMcoPHpnnmProbe.Example:%OMNIHOME%\probes\win32\nco_p_hp_nnm.bat /INSTALL /INSTANCE HpNnmProbe1/CMDLINE "-utf8enabled"

Note: Ensure that the %OMNIHOME% environment variable is defined as asystem variable.

3. Run the service:a. Open the Windows Control Panel and double click Administrative Tools.b. Double click Services.c. Click on the entry for the probe service and click Start.

Removing the service

To remove the service, if required:1. Stop the service, if it is running:

a. Open the Windows Control Panel and double click Administrative Tools.b. Double click Services.c. Click on the entry for the probe service and click Stop.

2. Open a Command Prompt and enter the following command to remove theprobe service from the system:%OMNIHOME%\probes\win32\nco_p_hp_nnm.bat /REMOVE /INSTANCE instance-name

Replace instance-name with the instance name you supplied when registeringthe probe as a service.

16 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 25: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Properties and command line optionsYou use properties to specify how the probe interacts with the device. You canoverride the default values by using the properties file or the command lineoptions.

The following table describes the properties and command line options specific tothis probe. For information about properties and command line options common toall probes, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide. Assupplied the location and name of the properties file is $OMNIHOME/probes/arch/hp_nnm.props.

Note: The ProcessSNMPAsV1 property that was used in Probe for HP NNM-i 9.2Version 1.0 has been removed. SNMP messages from different versions areuniformly represented using a common data object for the uniformed extractionprocess.

Table 9. Properties and command line options

Property name Command line option Description

DataBackupFile string -databackupfile string Use this property to specify thelocation of the probe's databackup file, relative to$NCHOME/omnibus/var.

The default is: "".

HeartbeatInterval integer -heartbeatintervalinteger

The probe regularly checkswhether the subscription with theHP NNM-i 9.2 server is active.Use this property to specify thefrequency (in seconds) of thischeck. You can specify a valuefrom 1 to 299.

The default is: 60.

Note: The HeartbeatIntervalproperty replaces theAgentheartbeat property that wasused in Probe for HP NNMi-series Version 8 and Version 9.

Inactivity integer -inactivity integer Use this property to specify thelength of time (in seconds) thatcan pass without the probereceiving events. If this timeexpires, the probe disconnectsfrom the target system and shutsdown. A value of 0 means that theprobe never shuts down.

The default is: 0.

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 17

Page 26: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 9. Properties and command line options (continued)

Property name Command line option Description

InitialResync string -initialresync string Use this property to specifywhether the probe resynchronizeswith the target system at startup:

true: At startup, the proberesynchronizes with the targetsystem.

false: At startup, the probe doesnot resynchronize with the targetsystem.

The default is: false.

MaxEventQueueSize integer -maxeventqueuesizeinteger

Use this property to define themaximum number of entries tohold in the queue for processing.Use a value of zero to switch offthis feature.

The default is 0.

NNMAddress string -nnmip string Use this property to specify theTCP/IP address of the HP NNM-i9.2 system.

The default is 127.0.0.1.

NNMPassword string -nnmpassword string Use this property to specify theencrypted password to theaccount identified by theNNMUserID property.

The default is "".

NNMPort integer -nnmport integer Use this property to specify theport on the HP NNM-i 9.2 systemwhere the system's web servicesare exposed.

The default is 80.

NNMUserID string -nnmusername string Use this property to specify theencrypted identifier of an accounton the HP NNM-i 9.2 system usedto receive events.

The account you specify musthave one of the following roles:

v Admin

v System

v WebServices

The default is "".

PidFile string -pidfile string Use this property to define the filethat contains the process ID forthe device.

18 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 27: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 9. Properties and command line options (continued)

Property name Command line option Description

ProbeReceiverPort integer -probereceiverportinteger

Use this property to specify theport of the probe system thatreceives events from the HPNNM-i 9.2 system.

The default is 8080.

ResyncBatchSize integer -resyncbatchsize integer Use this property to specify themaximum number of alarmsretrieved in eachresynchronization operation.

The default is 100.

ResyncFilterName string -resyncfiltername string Use this property to specify theevent values you want to receiveduring a resynchronizationoperation. “Defining aresynchronization filter” on page11 lists the values that thisproperty can have.

The default is severity.

ResyncFilterOperationstring

-resyncfilteroperationstring

Use this property to specify thecondition to filter events onduring a resynchronizationoperation. “Defining aresynchronization filter” on page11 lists the values that thisproperty can have.

The default is "=".

ResyncFilterValue string -resyncfiltervalue stringUse this property to specify thevalue for the condition that youwant to filter events on during aresynchronization operation.

The default is "CRITICAL".

ResyncInterval integer -resynchinterval integer Use this property to specify thetime (in seconds) between eachresynchronization operation. Avalue of 0 means that the probenever resynchronizes with thetarget system.

The default is: 0.

Note: The ResyncIntervalproperty replaces the Resync andRetryConstantWait properties thatwere used in Probe for HP NNMi-series Version 8 and Version 9. Inother words, the samefunctionality that was previouslysupplied with two properties isnow supplied with one property.

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 19

Page 28: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 9. Properties and command line options (continued)

Property name Command line option Description

RetryCount integer -retrycount integer Use this property to specify themaximum number of times theprobe tries to reconnect to thetarget system following acommunications failure. Ifreconnection does not occur afterthis number of attempts, the probeshuts down. A value of 0 meansthat the probe does not try toreconnect to the target but simplyshuts down.

The default is: 0.

Note: The RetryCount propertyreplaces the Retry andRetryMaxTime properties that wereused in Probe for HP NNMi-series Version 8 and Version 9. Inother words, the samefunctionality that was previouslysupplied with two properties isnow supplied with one property.

RetryInterval integer -retryinterval integer Use the property to specify thetime (in seconds) between eachattempt to reconnect to the targetsystem. A value of 0 means thatthe probe uses an exponentiallyincreasing period betweensuccessive connection attempts.For example, the probe waits 1second, then 2 seconds, then 4seconds, and so on.

The default is: 0.

RotateEndpoint -rotateendpoint Use this property to specifywhether the probe should attemptto connect to another endpoint ifthe connection to the first onefails. The values this property canhave are:

true: The probe attempts toconnect to another endpoint.

false: The probe does not attemptto connect to another endpoint.

The default is: false.

SubscriptionFilter string -subscriptionfilterstring

Use this property to specify theXPath expression that defines thefilter for subscription events.

The default is "".

20 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 29: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

ElementsThe probe breaks event data down into tokens and parses them into elements.Elements are used to assign values to ObjectServer fields; the field values containthe event details in a form that the ObjectServer understands.

The following table describes the elements that the Probe for HP NNM-i 9.2generates. Not all the elements described are generated for each event; theelements that the probe generates depends upon the event type. For more detailedinformation about each token, see the HP documentation.

Table 10. Elements

Element name Element description

$Id This element contains the ID of the HP NNM-i9.2 user.

$AssignedTo This element identifies the user to whom thealarm was assigned

$Category This element shows the category priority of thealarm.

$cia_address This element contains the custom incidentattributes (CIA) address of the source from whichthe alarm was sent.

$cia_agentAddress This element contains the CIA SNMP agentaddress.

$cia_originaladdress This element identifies the original trap's address.

$cia_snmpoid This element identifies the CIA SNMP objectidentifier (OID).

$DuplicateCount This element contains the number of times thealarm has been duplicated.

$Family This element identifies the event source.

$FormattedMessage This element contains the name of the alarm.

$LifecycleState This element displays the lifecycle status of thetoken generated.

$Name This element contains the name of the event.

$Notes This element identifies user suppliedremarks/notes.

$Priority This element indicates the priority of the alarm.

$SourceName This element contains the name of the alarmsource.

$SourceNodeName This element displays the node name of thesource from which the alarm was sent.

$SourceNodeUuid This element displays the node UUID of thesource from which the alarm was sent.

$Severity This element indicates the severity of the alarm.Possible values include:

v CRITICAL

v MAJOR

v MINOR

v WARNING

v NORMAL

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 21

Page 30: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 10. Elements (continued)

Element name Element description

$Uuid This element shows the unique identifier for anHP NNM-i 9.2 event.

$Created This element identifies the time the event wascreated.

$FirstOccurrenceTime This element identifies the first occurrence of theevent.

$LastOccurrenceTime This element identifies the last time the eventoccurred.

$Modified This element identifies the last time the alarm'sdetails were modified.

$Nature This element indicates the nature of the alarm.Possible values include:

v ROOTCAUSE

v SECONDARYROOTCAUSE

v SYMPTOM

v SERVICEIMPACT

v STREAMCORRELATION

v NONE

$Origin This element indicates the origin of the alarm.Possible values include:

v MANAGEMENTSOFTWARE

v MANUALLYCREATED

v REMOTELYGENERATED

v SNMPTRAP

v SYSLOG

v OTHER

$OriginOccurrenceTime This element identifies the time of the occurrencethat generated the event.

$SourceType This element identifies the data type of the sourceobject.

Error messagesError messages provide information about problems that occur while running theprobe. You can use the information that they contain to resolve such problems.

The following table describes the error messages specific to this probe. Forinformation about generic error messages, see the IBM Tivoli Netcool/OMNIbusProbe and Gateway Guide.

22 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 31: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 11. Error messages

Error Description Action

Encountered aJAXException attemptingto send subscriptionrequest

Encountered aSOAPException attemptingto send subscriptionrequest

Encountered aWebServiceExceptionattempting to sendsubscription request

Error creating aDocumentBuilder instance:message

Error creating aJAXBContext instance:message

Error formatting Expiresto String: message

Error parsing Expires toDate: message

ReferenceParameter doesnot exist inSubscribeResponse

These errors indicateproblems with probe startup.

Ensure that theNNMPortproperty points to the portwhere the HP NNM-i 9.2system has been configured tohost the WS-API.

Check any firewalls betweenthe probe and the HP NNM-i9.2 machine.

Confirm that the NNMWebServices API isfunctioning correctly bychecking that your HP NNM-i9.2 installation has anIntegration EnablementLicense and that the servicesare available. This can beconfirmed by looking at thejmx-console view of the NNMJboss server.

Check that the environmenthas been configured to useJava.

HeartbeatInterval out ofrange! Please reconfigureproperty.

The probe performed a checkon the value specified in theHeartbeatInterval propertyand determined it was out ofrange.

Check the value of theHeartbeatInterval propertyan ensure the value isbetween 1 and 299.

NNM credentials notrecognized

End Point Started at :Location of Probe'sReceiver Endpoint

End Point Stopped at :Location of Probe'sReceiver Endpoint

These errors indicateproblems with the probeconfiguration.

Ensure that the NNMAddress,NNMPassword, and NNMPortproperties are set correctly.

Check that the Probe ReceiverPort is clear.

Unable to contact the NNMIncident service forresynchronizationbecause: message

The probe was unable tocontact the HP NNM-i 9.2Incident service forresynchronization. Themessage provides additionalinformation about the error.

Check the values of theNNMAddress and NNMPortproperties to ensure a validTCP/IP address and portnumber for the HP NNM-i 9.2system.

Also check that there is nofirewall blocking access to theHP NNM-i 9.2 system.

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 23

Page 32: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Table 11. Error messages (continued)

Error Description Action

Unable to processincident array receivedin resynchronizationbecause: message

The probe was unable toprocess the HP NNM-i 9.2incident array received in theresynchronization operation.The message providesadditional information aboutthe error.

Check the values of theNNMUserID and NNMPasswordproperties to ensure these arevalid encrypted identifiers ofan account on the HP NNM-i9.2 system.

Also check that the valuespecified for theResyncFilterValue property isvalid for the event valuesspecified in theResyncFilterName property.

Unable to processrequested custom filter

The probe was unable toprocess the custom filter. As aresult, the probe continuesprocessing with the defaultresynchronization filters.

A resynchronization filter wasdefined using theResyncFilterName,ResyncFilterOperation, andResyncFilterValue properties.Check each of theseproperties as follows:

v That the name youspecified for theResyncFilterName is one ofthe valid names. Note thatthese names are casesensitive.

v That the operation youspecified for theResyncFilterOperationproperty is one of the validoperators and conditions.The character operators arecase sensitive.

See “Defining aresynchronization filter” onpage 11 for the valid valuesassociated with theseproperties.

24 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 33: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

ProbeWatch messagesDuring normal operations, the probe generates ProbeWatch messages and sendsthem to the ObjectServer. These messages tell the ObjectServer how the probe isrunning.

Currently, the probe does not generate any ProbeWatch messages.

IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2 25

Page 34: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

26 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 35: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Appendix. Notices and Trademarks

This appendix contains the following sections:v Noticesv Trademarks

NoticesThis information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia CorporationLicensing 2-31 Roppongi 3-chome, Minato-kuTokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions, therefore, this statement may not applyto you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

© Copyright IBM Corp. 2014 27

Page 36: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who want to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM CorporationSoftware Interoperability Coordinator, Department 49XA3605 Highway 52 NRochester, MN 55901U.S.A.

Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

The licensed program described in this information and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement, or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subjectto change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

28 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 37: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs.

Each copy or any portion of these sample programs or any derivative work, mustinclude a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp.Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rightsreserved.

If you are viewing this information softcopy, the photographs and colorillustrations may not appear.

TrademarksIBM, the IBM logo, ibm.com, AIX, Tivoli, zSeries, and Netcool are trademarks ofInternational Business Machines Corporation in the United States, other countries,or both.

Adobe, Acrobat, Portable Document Format (PDF), PostScript, and all Adobe-basedtrademarks are either registered trademarks or trademarks of Adobe SystemsIncorporated in the United States, other countries, or both.

Intel, Intel Inside (logos), MMX, and Pentium are trademarks of Intel Corporationin the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks ofMicrosoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in theUnited States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, orboth.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Appendix. Notices and Trademarks 29

Page 38: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

30 IBM Tivoli Netcool/OMNIbus Probe for HP Network Node Manager-i version 9.2: Reference Guide

Page 39: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00
Page 40: IBM Tivoli Netcool/OMNIbus Probe for HP Network … Probe for HP Network Node Manager-i version 9.2 Version 1.0 Reference Guide November 7,2014 SC27-6551-00

����

Printed in USA

SC27-6551-00