IBM Netcool/OMNIbus Probe for Nortel CNM manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of IBM Netcool/OMNIbus Probe for Nortel CNM, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of IBM Netcool/OMNIbus Probe for Nortel CNM one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of IBM Netcool/OMNIbus Probe for Nortel CNM. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of IBM Netcool/OMNIbus Probe for Nortel CNM should contain:
- informations concerning technical data of IBM Netcool/OMNIbus Probe for Nortel CNM
- name of the manufacturer and a year of construction of the IBM Netcool/OMNIbus Probe for Nortel CNM item
- rules of operation, control and maintenance of the IBM Netcool/OMNIbus Probe for Nortel CNM item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of IBM Netcool/OMNIbus Probe for Nortel CNM alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of IBM Netcool/OMNIbus Probe for Nortel CNM, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the IBM service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of IBM Netcool/OMNIbus Probe for Nortel CNM.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the IBM Netcool/OMNIbus Probe for Nortel CNM item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    SC23-6398-02 IBM Netcool/OMNIbus Probe for Nortel CNM 1.0.3744 frontmatter.f m December 22, 2007 Reference Guide Publication Date: December 22, 2007[...]

  • Page 2

    This edition applies to 1.0.3 744 of Netcool/OMNIbus Prob e for Nortel CNM (SC23-6398-02) an d to all subseque nt releases and modifications until otherwise indica ted in new editions. This edition replaces SC23-6398-01. © Copyright International Business Machines Corporation , 2007. All rights r eserved. US Government Users Restricted Rights - Us[...]

  • Page 3

    iii Contents Document control page . . . . . . . . . . . . . . . v Probe for Nortel CNM . . . . . . . . . . . . . . . . . 1 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . 3 Basic configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Inst[...]

  • Page 4

    Netcool/OMNIbus Probe for No rtel CNM Reference Guide iv[...]

  • Page 5

    v docscontrol.fm Dec ember 22, 2007 Document control page The Netcool/OMNIbu s Probe for Nortel CNM documentation is provided in softcopy format only. To obta in the most recent vers ion, visit the IBM Tivoli Netcoo l Information Center: http://publib.boulde r.ibm.com/ in focenter/tivihelp/v8r1/index.jsp Table 1. Document modification history Docum[...]

  • Page 6

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide vi[...]

  • Page 7

    Probe for Nortel CNM 1 Nortel CNM.fm December 22, 2007 Probe for Nortel CNM Nortel CNM (CDMA Network manager) is a ne tworking and service management system that provides a real-time vi ew of the serv ice provisioning, order mana gment, fault and performance management for an enterprise customer’s netw ork. This sy stem supports multiple wireless[...]

  • Page 8

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 2 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 numbe r 1.0 Probe supported on HP-UX, Solaris Properties file $OMNIHOME/probes/ arch /nortel_cnm.props Rules file $OMNIHOME/probes/ ar[...]

  • Page 9

    Probe for Nortel CNM 3 Supported platforms For details of the versions of H P-UX and Sola ris on which t his probe is supported, see the following page on the IBM Tivo li Netcool Information Center: http://publib.boulder. ibm.com/infocenter/tivihelp/v8r 1/index.jsp?topic=/com.ibm.net cool_OMNIbus.doc/Su pported_Platfo rms.htm Basic configuration Th[...]

  • Page 10

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 4 Data acquisition The Probe for Nortel CNM gathers events fr om the Nortel CNM 3GPP servers using a Common Object Request Broker Architecture (CORBA) interface. CORBA is an Ob ject Management Group specification that provides a standard interface definition between objects in a distributed e nvi[...]

  • Page 11

    Probe for Nortel CNM 5 The FTP command is run in the user ’s home direct ory. For FT P users other than root, you must change the default path specified by the NortelSecurityIrpFile property to enable the probe to locate the se curity IR P file; for example, if the FTP user is norteluser , the home directory for this user will be /hom e/norteluse[...]

  • Page 12

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 6 Filtering notifications and alarms The NotificationFilter and AlarmFilter properties allow you to specify what notifications and alarms the pr obe expects from the device. When you use these properti es, you must use the actual token names. For example, the token h represents the element NV_PER[...]

  • Page 13

    Probe for Nortel CNM 7 Command line interface The Probe for Nortel CNM is supplied with a co mmand line inte rface (CLI). This interfac e allows you to perform commands using the prob e (f or example, to acknowledge alarms or to request a full resy nchronization of the CORBA interface). To use th e CLI, you must u se the CommandPort property in the[...]

  • Page 14

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 8 Note: Since the CLI is based upon telnet conne ctions, you can connect to the probe from anywhere. This m eans that simple scri pts can be set up to allow u sers to acknowledge selected events from the Tivoli Netcool/OMNIbu s event list by creating desktop tools to telnet to the pr obe, send a [...]

  • Page 15

    Probe for Nortel CNM 9 Peer-to-Peer failover functionality The Probe for Nortel CNM supports failover confi gurations where two probes run simultaneously. One probe acts as the master probe, se nding events to the ObjectServer; the other acts as the slave probe on standby. In th e event of the master pro be failing, th e slave probe activates. Whil[...]

  • Page 16

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 10 Internationalization support The Probe for Nortel CNM supports multi-byte ch aracter sets. To view the chara cter sets correctly, y ou must c onfigure the lo cale se ttings on the host machine c orrectly. Each multi-byte charac ter set is configured slightly differently on each platform. The f[...]

  • Page 17

    Probe for Nortel CNM 11 Properties and command line options Table 5 describes the properties and command line options spe cific to this probe. For information about generic probe properti es and command line options, see the IBM Tivoli Netcool/OMNIbu s Probe and Gateway Guide , (SC23-6387). Table 5. Properties and command line options (1 of 4) Prop[...]

  • Page 18

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 12 CommandPort integer -commandport integer Specifies the port to which users can te lnet to communicate with the 3GPP2 interface using the Command Line Interface (CLI) supplied with the probe. For more information on CLI, see "Command line interfac e" on page 7. The default is 6970 . C[...]

  • Page 19

    Probe for Nortel CNM 13 Password string -password string Password required with th e 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 . Resynch string -resynch str[...]

  • Page 20

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 14 TimeTick integer -timetick integer Time (in minutes) that the Notificiatio n 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 th e Nortel Secu[...]

  • Page 21

    Probe for Nortel CNM 15 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 dynamica lly and its content is dependent on the IRP agent. Note: The element_na[...]

  • Page 22

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 16 NV_CORRELATED_NOTIFICATIONS_ notif_ID_Set Set of notificat ions to which this notifica tion 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 noti fication set. NV_EVENT_TIME Ti[...]

  • Page 23

    Probe for Nortel CNM 17 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. Ensu[...]

  • Page 24

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 18 BAD_PARAM Exception i.e one or more of the in/out parameter is null InvalidParameter Exception NetcoolIRPManager: Exception occurred. Stack trace to stderr OperationNotSupported Exception Unexpected CORBA Exception There is a pr oblem with the CORBA interface. Refer to your CORBA documentati o[...]

  • Page 25

    Probe for Nortel CNM 19 Error to parse event completely Failed to parse event completely Name is null, cannot create Element NetcoolIRPManager: Category Value NOT supported: Discarding Alarm NetcoolIRPManager: Error when parsing event NetcoolIRPManager: Failed to send event The probe cannot parse the alarm; this is probably because the alarm is not[...]

  • Page 26

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 20 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 va lue if necessary. Problem while tryin[...]

  • Page 27

    Probe for Nortel CNM 21 ProbeWatch messages Table 8 des cribes th e raw Pro beWatch er ror messages that the pro be generates. For information about generic ProbeWatch me ssages, see the IBM Tivoli Netcoo l/OMNIbus Probe and Gateway Guide , (SC23-6387). Table 8. ProbeWatch messages (1 of 3) ProbeWatch message Description Triggers/causes Communicati[...]

  • Page 28

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 22 Failed to log in to the Nortel Security IRP - incorrect username/password Failed to log in to interface PermissionDenied Failed to get IRP Outline The probe could not login to the SecurityIRP file. Incorrect username and password given in the properti es file. Failed to find IOR file ior_file_[...]

  • Page 29

    Probe for Nortel CNM 23 SYNCHRONIZATION FAILED The probe could not get new alarms. The probe failed to get the al arm list, or failed to perform resynchronization of alarms. Unable to get events The probe could not get eve nts from Nortel CNM 3G PP2. The probe has failed to get events. Unexpected fatal error, failed to connect Unexpected fatal erro[...]

  • Page 30

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 24[...]

  • Page 31

    25 appnotices.f m December 22, 2007 Appendix A. Notices This appendix cont ains the following: • "Notices" on page 25 • "Trademarks" on page 27 Notices This information was dev eloped for produc ts and services offered in the U.S.A . IBM may not offer the products, services, or fe atures di scussed in th is doc ument in othe[...]

  • Page 32

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 26 LIMITED TO, THE IMPLIED WARRA NTIES OF NON-INFRINGEME NT, MERCHANTABIL ITY OR FITNES S FOR A PARTICULAR PURPOS E. Some states do not allow disclaimer of express or impli ed warrant ies in certain transact ions, therefore, this statement may not apply to you. This information could inclu de tec[...]

  • Page 33

    Appendix A. Notic es 27 Any performance data contained herein was determined in a controll ed environment. Therefore, the results obtained in other oper ating environments may vary significantly. Some measure ments may have been made on development-level s ystems and there is no guarantee that these measurements will be the same on generally availa[...]

  • Page 34

    Netcool/OMNIbus Probe for Nortel CNM Reference Guide 28[...]