IBM Netcool/OMNIbus Probe for Nortel CNM, Tivoli Netcool/OMNIbus Probe for Nortel CNM Reference Manual

SC23-6398-02

IBM

Netcool/OMNIbus Probe for Nortel CNM

1.0.3744

frontmatter.fm December 22, 2007

Reference Guide

Publication Date: December 22, 2007

This edition applies to 1.0.3744 of Netcool/OMNIbus Probe for Nortel CNM (SC23-6398-02) and to all subsequent releases
and modifications until otherwise indicated in new editions.

This edition replaces SC23-6398-01.

© Copyright International Business Machines Corporation, 2007. All rights reserved.

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.

Note

Before using this information and the product it supports, read the information in Appendix A. "Notices" on page 25.

iii

Contents

Document control page. . . . . . . . . . . . . . . v

Probe for Nortel CNM

. . . . . . . . . . . . . . . . . 1

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . 3

Basic configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Installation requirements . . . . . . . . . . . . . . . . . . 3

Updating the rules file . . . . . . . . . . . . . . . . . . . . 3

Data acquisition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Connecting to the CORBA interface . . . . . . . . .4

Status checking . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Retrieving objects . . . . . . . . . . . . . . . . . . . . . . . . 5

Running multiple probes . . . . . . . . . . . . . . . . . . 5

Shutting down the probe . . . . . . . . . . . . . . . . . .5

Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Filtering notifications and alarms . . . . . . . . . . .6

Command line interface . . . . . . . . . . . . . . . . . . . 7

Peer-to-Peer failover functionality . . . . . . . . . . . . .9

Example property file settings for peer-to-peer
failover9

Internationalization support . . . . . . . . . . . . . . . . .10

Example multi-byte character set configuration
on Solaris10

Properties and command line options . . . . . . . . .11

Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Error messages . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

ProbeWatch messages . . . . . . . . . . . . . . . . . . . . . . 21

Appendix A. Notices . . . . . . . . . . . . . . . . 25

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Netcool/OMNIbus Probe for Nortel CNM Reference Guideiv

v

docscontrol.fm December 22, 2007

Document control page

The Netcool/OMNIbus Probe for Nortel CNM documentation is provided in softcopy
format only. To obtain the most recent version, visit the IBM Tivoli Netcool Information
Center:

http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp

Table 1. Document modification history

Document
version

Publication
date

Comments

01 June 22, 2007 First IBM publication.

02 December 22,

2007

Summary section updated.

Secure FTP connection information added.

Connecting to a remote system section added.

FtpPassword property removed.

Netcool/OMNIbus Probe for Nortel CNM Reference Guidevi

Probe for Nortel CNM 1

Nortel CNM.fm December 22, 2007

Probe for Nortel CNM

Nortel CNM (CDMA Network manager) is a networking and service management system
that provides a real-time view of the service provisioning, order managment, fault and
performance management for an enterprise customer’s network. This system supports
multiple wireless network technologies, and customer management interfaces for the
creation, delivery, and playback of multimedia over GSM and CDMA2000 wireless
networks.

The Probe for Nortel CNM collects alarms from Nortel CNM system using a 3GPP2 CORBA
(Common Object Request Broker Architecture) interface for CDMA2000 networks.

This guide contains the following sections:

• Summary

• Supported platforms

• Basic configuration

• Data acquisition

• Peer-to-Peer failover functionality

• Internationalization support

• Properties and command line options

• Elements

• Error messages

• ProbeWatch messages

Netcool/OMNIbus Probe for Nortel CNM Reference Guide2

Summary

Table 2 provides a summary of the Probe for Nortel CNM.

Table 2. Summary

Probe target Nortel CNM version 7

Probe executable name nco_p_nortel_cnm

Patch number 1.0

Probe supported on HP-UX, Solaris

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

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

Requirements A currently supported version of Tivoli Netcool/OMNIbus.

JDK 1.5

probe-compatibility-3.x (for Tivoli Netcool/

OMNIbus 3.6)

probe-nonnative-base

probe-nonnative-java

nco_p_commandport-0

probe-visibroker-support

Note: The Visibroker patch is not available on the support

site; to obtain this patch, you must contact IBM
Technical Support.

Connection method CORBA

Remote connectivity Yes

Licensing Electronic licensing is no longer implemented in Tivoli

Netcool/OMNIbus products. All Tivoli products now use
the IBM Tivoli software licensing process.

Internationalization Available

Peer-to-peer failover functionality Available

IP environment IPv4 and IPv6

Note: The probe only supports the IPv6 environment on

Tivoli Netcool/OMNIbus v7.x running on Solaris.

Probe for Nortel CNM 3

Supported platforms

For details of the versions of HP-UX and Solaris on which this probe is supported, see the
following page on the IBM Tivoli Netcool Information Center:

http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp?topic=/com.ibm.net
cool_OMNIbus.doc/Supported_Platforms.htm

Basic configuration

This section describes the basic configuration requirements for the Probe for Nortel CNM.

Installation requirements

Before running the probe, you must install the JDK 1.5 runtime libraries and the following
IBM Tivoli Netcool/OMNIbus patches in the following order:

1. probe-compatibility-3.x

2. probe-nonnative-base

3. probe-nonnative-java

4. nco_p_commandport-0

5. probe-visibroker-support

Note: These patches (except the VisiBroker patch) are available from the IBM Support

Site. To obtain the VisiBroker patch, you must contact IBM Support.

Updating the rules file

The Probe for Nortel CNM is supplied with a lookup table (Corba_3gpp2_
R6C1.lookup). This file is installed in the following location:

$OMNIHOME/probes/includes/

This file is referenced in the rules file by the following command:

include "/opt/netcool/probes/includes/Corba_3gpp2_R6C1.lookup"

If the Tivoli Netcool/OMNIbus installation directory is different from /opt/netcool/,
you must update the rules file include statement accordingly.

Note: $OMNIHOME cannot be used in the paths to the lookup files; you must enter the full

path to the Tivoli Netcool/OMNIbus installation directory.

Netcool/OMNIbus Probe for Nortel CNM Reference Guide4

Data acquisition

The Probe for Nortel CNM gathers events from the Nortel CNM 3GPP servers using a
Common Object Request Broker Architecture (CORBA) interface. CORBA is an Object
Management Group specification that provides a standard interface definition between
objects in a distributed environment; that is, it allows applications to communicate with one
another regardless of where they are located or who has designed them.

Connecting to the CORBA interface

The Probe for Nortel CNM acts as an Integration Reference Point (IRP) Manager. The
AlarmIRPOperation and NotificationIRPOperation points form a part of the IRP agent to
which the probe connects through a CORBA interface.

The probe uses the Using Interoperable Object Reference (IOR) files for this connection:

Using IOR files

To connect to the CORBA interface, the probe uses the SecurityIRPAgent Interoperable
Object Reference (IOR) file. If the IOR file is on a remote machine, specify the FTP command
that the probe must use to access it using the SecurityIrpFtpCommand property. If the
IOR file is on a local machine, specify its location using the NortelSecurityIrpFile
property.

Connecting to a remote system

The probe uses secure mode to connect to the remote machine where the IOR file is
available.

To access the IOR file on the remote machine, perform the following steps:

1. Set up the required OpenSSL environment in both the probe server and target system.

2. Create your own PKI key. Remember the password that you specify while creating the
PKI key.

3. Change the access permissions of the PKI key for the SSH to access.

4. Edit the download_ior.sh script so that the IOR_FILE_NAME script variable points
to the same value as the NortelSecurityIrpFile property.

5. Replace the <remote machine name>:<remote path to nortel ior file>
text in the download_ior.sh script with the location and name of the remote
machine.

6. Replace the <password> text in the add-passwd script with the password you
specified while creating the PKI key.

7. Run the probe.

Probe for Nortel CNM 5

The FTP command is run in the user’s home directory. For FTP users other than root, you
must change the default path specified by the NortelSecurityIrpFile property to
enable the probe to locate the security IRP file; for example, if the FTP user is norteluser,
the home directory for this user will be /home/norteluser. In this case, you must change
the default path specified by the NortelSecurityIrpFile property to:

../../opt/nortel/config/3GPP/NortelSecurityIrpAgent.ior

Status checking

The probe checks the status of the IRP agent every 60 seconds. You can change this
frequency if required using the Agentheartbeat property.

Retrieving objects

If the Resynch property is set to true, the probe initially receives a list of all active alarms
from the AlarmIRP server. The probe then connects to the NotificationIRP server and uses
the CORBA notification push model to receive new alarms from the server as they are
generated. If the Resynch property is set to false, the probe only receives new alarms.

The probe initially receives a list of all active alarms from the AlarmIRP server. The probe
then connects to the NotificationIRP server and uses the CORBA notification push model
to receive new alarms from the server as they are generated.

Running multiple probes

You can run multiple instances of the Probe for Nortel CNM. For each instance running,
you must specify a different port to which the server listens using the ORBLocalport
property.

Shutting down the probe

To stop an instance of the probe, you must issue a stop signal to the process associated with
that probe instance.

Timeout

The Probe for Nortel CNM has a timeout facility that allows it to di sconnect from the s ystem
if there is no activity for a predefined amount of time. You can specify how long the probe
waits before disconnecting using the Timeout property.