Netcool/OMNIbus Probe for Nortel CNM IBM 1.0.3744 Reference Guide frontmatter.
Note Before using this information and the product it supports, read the information in Appendix A. "Notices" on page 25. 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.
Contents Document control page . . . . . . . . . . . . . . . v Command line interface . . . . . . . . . . . . . . . . . . . 7 Probe for Nortel CNM . . . . . . . . . . . . . . . . . 1 Peer-to-Peer failover functionality . . . . . . . . . . . . . 9 Example property file settings for peer-to-peer failover9 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . 3 Basic configuration . . . . . . . . . . . . . . . . . .
iv Netcool/OMNIbus Probe for Nortel CNM Reference Guide
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.
vi Netcool/OMNIbus Probe for Nortel CNM Reference Guide
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.
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.
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.
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.
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.
Filtering notifications and alarms The NotificationFilter and AlarmFilter properties allow you to specify what notifications and alarms the probe expects from the device. When you use these properties, you must use the actual token names. For example, the token h represents the element NV_PERCEIVED_SEVERITY; so, to specify that the probe is only sent notifications with a perceived severity of 3, you must set the NotificationFilter property to $h == 3.
Table 3.
Table 4. CLI commands (2 of 2) Command Description resynch_filter Allows you to a perform partial resynchronization with the 3GPP2 interface. Note: This command takes as a parameter a filter in the same format as the AlarmFilter property. For details, see "Filtering notifications and alarms" on page 6. unacknowledge_alarm Allows you to unacknowledge an alarm in the 3GPP2 interface. userid_clear_alarms Allows you to clear an alarm in the 3GPP2 interface by specifying the USER_ID.
Peer-to-Peer failover functionality The Probe for Nortel CNM supports failover configurations where two probes run simultaneously. One probe acts as the master probe, sending events to the ObjectServer; the other acts as the slave probe on standby. In the event of the master probe failing, the slave probe activates. While the slave probe receives heartbeats from the master probe, it will not forward events to the ObjectServer.
Internationalization support The Probe for Nortel CNM supports multi-byte character sets. To view the character sets correctly, you must configure the locale settings on the host machine correctly. Each multi-byte character set is configured slightly differently on each platform. The following section describes example locale configurations on a UNIX platform; other character sets on other platforms will be configured in a similar way.
Properties and command line options Table 5 describes the properties and command line options specific to this probe. For information about generic probe properties and command line options, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide, (SC23-6387). Table 5. Properties and command line options (1 of 4) Property name Command line option Description AckSystemId string -acksystemid string Processing system on which the IRP Manager runs. This is used by the acknowledge_alarm CLI function.
Table 5. Properties and command line options (2 of 4) Property name Command line option Description CommandPort integer -commandport integer Specifies the port to which users can telnet to communicate with the 3GPP2 interface using the Command Line Interface (CLI) supplied with the probe. For more information on CLI, see "Command line interface" on page 7. The default is 6970. CommandPortLimit integer -commandportlimit integer Maximum number of telnet connections that can be made to the probe.
Table 5. Properties and command line options (3 of 4) Property name Command line option Description Password string -password string Password required with the Username property to log in to the system. The default is "". Note: Specify the password encrypted using the nco_g_crypt utility. For details about this utility, see IBM Tivoli Netcool/OMNIbus Administration Guide, SC23-6371.
Table 5. Properties and command line options (4 of 4) Property name Command line option Description TimeTick integer -timetick integer Time (in minutes) that the Notificiation IRP session remains open to connections. This is used by the 3GPP server. The default is 15. Note: A value of -1 keeps the session forever open. Username string -username string Username required by the Nortel Security Building Block to provide the object reference to the EntryPoint IRP. The default is "".
Elements Table 6 describes the elements generated by the Probe for Nortel CNM. Table 6. Elements (1 of 2) Element name Element description AttributeValue(element_name) Contains the value of an element being monitored. This element is generated dynamically and its content is dependent on the IRP agent. Note: The element_name part of this element and the next element can be the name of any of the other elements in this table.
Table 6. Elements (2 of 2) 16 Element name Element description NV_CORRELATED_NOTIFICATIONS_ notif_ID_Set Set of notifications to which this notification is considered to be correlated. This element is generated dynamically and its content is dependent on the IRP agent. NV_CORRELATED_NOTIFICATIONS_ SOURCE Source of the notification set. NV_EVENT_TIME Time at which the event occurred. NV_MANAGED_OBJECT_CLASS Managed object class of the network resource.
Error messages Table 7 describes the error messages specific to this probe. For information about generic error messages, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide, (SC23-6387). Table 7. Error messages (1 of 4) Error Description Action Cannot initialize the Orb: The probe could not initialize the ORB. Ensure your CLASSPATH contains the path to the Visibroker jar files. Command_Port Error occurred There was a problem with command port functionality.
Table 7. Error messages (2 of 4) Error Description Action BAD_PARAM Exception i.e one or more of the in/out parameter is null There is a problem with the CORBA interface. Refer to your CORBA documentation. The probe cannot connect to the server. Check that the Nortel CNM server is running correctly. Check that you have specified the parameters correctly in the properties file. InvalidParameter Exception NetcoolIRPManager: Exception occurred.
Table 7. Error messages (3 of 4) Error Description Action Error to parse event completely The probe cannot parse the alarm; this is probably because the alarm is not in a format that the probe can understand. Check that the Nortel CNM server is running correctly. Failed to get timeout property value, defaulting to 0 The Timeout property has not been set. Check the value for the Timeout property; change this value if necessary.
Table 7. Error messages (4 of 4) Error Description Action NetcoolIRPManager: Failed to retrieve EntryPointIRP object from security interface: The probe has failed to take the Corba Object of the Security IRP and narrow it to its specific type. Check the value for the SecurityIrpFtpCommand property; change this value if necessary. Problem while trying to connect to the IRP points The probe found a problem while connecting to the AlarmIRP or NotificationIRP points.
ProbeWatch messages Table 8 describes the raw ProbeWatch error messages that the probe generates. For information about generic ProbeWatch messages, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide, (SC23-6387). Table 8. ProbeWatch messages (1 of 3) ProbeWatch message Description Triggers/causes Communication failure - lost connection to NoticiationIRP The probe has failed to get the subscription status from the NotificationIRP point. The Notification service is not available.
Table 8. ProbeWatch messages (2 of 3) ProbeWatch message Description Triggers/causes Failed to log in to the Nortel Security IRP - incorrect username/password The probe could not login to the SecurityIRP file. Incorrect username and password given in the properties file. Failed to find IOR file ior_file_name The probe could not find the specified file. The IRP Manager has not been set up correctly using the properties file.
Table 8. ProbeWatch messages (3 of 3) ProbeWatch message Description Triggers/causes SYNCHRONIZATION FAILED The probe could not get new alarms. The probe failed to get the alarm list, or failed to perform resynchronization of alarms. Unable to get events The probe could not get events from Nortel CNM 3GPP2. The probe has failed to get events. Unexpected fatal error, failed to connect The probe encountered an unexpected fatal error. Contact the IBM support.
24 Netcool/OMNIbus Probe for Nortel CNM Reference Guide
appnotices.fm December 22, 2007 Appendix A. Notices This appendix contains the following: • "Notices" on page 25 • "Trademarks" on page 27 Notices This 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 in other countries. Consult your local IBM representative for information on the products and services currently available in your area.
LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary.
28 Netcool/OMNIbus Probe for Nortel CNM Reference Guide