Netcool/OMNIbus Probe for Alcatel 5620 (CORBA) - e IBM Tivoli ...

frontmatter.fm January 10, 2006 

Netcool®/OMNIbusTM Probe for Alcatel 5620 (CORBA) 

Supporting Products 

Publication Date: January 10, 2006

© 2006 Micromuse Inc., Micromuse Ltd. 

All rights reserved. No part of this work may be reproduced in any form or by any 

person without prior written permission of the copyright owner. This document is 

proprietary and confidential to Micromuse, and is subject to a confidentiality 

agreement, as well as applicable common and statutory law. 

Micromuse Disclaimer of Warranty and Statement of Limited Liability 

Micromuse provides this document "as is", without warranty of any kind, either 

express or implied, including, but not limited to, the implied warranties of 

merchantability, fitness for a particular purpose or non-infringement. This 

document may contain technical inaccuracies or typographical errors. Micromuse 

may make improvements and changes to the programs described in this document 

or this document at any time without notice. Micromuse assumes no responsibility 

for the use of the programs or this document except as expressly set forth in the 

applicable Micromuse agreement(s) and subject to terms and conditions set forth 

therein. Micromuse does not warrant that the functions contained in the programs 

will meet your requirements, or that the operation of the programs will be 

uninterrupted or error-free. Micromuse shall not be liable for any indirect, 

consequential or incidental damages arising out of the use or the ability to use the 

programs or this document. 

Micromuse specifically disclaims any express or implied warranty of fitness for high 

risk activities. 

Micromuse programs and this document are not certified for fault tolerance, and 

are not designed, manufactured or intended for use or resale as on-line control 

equipment in hazardous environments requiring fail-safe performance, such as in 

the operation of nuclear facilities, aircraft navigation or communication systems, 

air traffic control, direct life support machines, or weapons systems ("High Risk 

Activities") in which the failure of programs could lead directly to death, personal 

injury, or severe physical or environmental damage. 

Compliance with Applicable Laws; Export Control Laws 

Use of Micromuse programs and documents is governed by all applicable federal, 

state and local laws. All information therein is subject to U.S. export control laws 

and may also be subject to the laws of the country where you reside. 

All Micromuse programs and documents are commercial in nature. Use, 

duplication or disclosure by the United States Government is subject to the 

restrictions set forth in DFARS 252.227-7015 and FAR 52.227-19. 

Trademarks and Acknowledgements 

Micromuse and Netcool are registered trademarks of Micromuse. 

Other Micromuse trademarks include but are not limited to: Netcool/OMNIbus, 

Netcool/OMNIbus for Voice Networks, Netcool/Reporter, Netcool/Internet 

Service Monitors, Netcool/ISM, Netcool/ISM Global Perspective, Netcool/NT 

Service Monitors, Netcool/Wireless Service Monitors, Netcool/WSM, 

Netcool/Usage Service Monitors, Netcool/USM, Netcool/Telco Service 

Monitors, Netcool/TSM, Netcool/Fusion, Netcool/Data Center Monitors, 

Netcool DCM, Netcool/Impact, Netcool/Visionary, Netcool/Precision, Netcool 

Probes & Monitors, Netcool Desktops, Netcool Gateways, Netcool Impact/Data 

Source Adaptors, Netcool EventList, Netcool Map, Netcool Virtual Operator, 

Netcool/Precision for IP Networks, Netcool/Precision for Transmission 

Networks, Netcool/Firewall, Netcool/Wave, Netcool/Webtop, Netcool TopoViz, 

Netcool/SM Operations, Netcool/SM Configuration, Netcool/OpCenter, 

Netcool/System Service Monitors, Netcool/SSM, Netcool/Application Service 

Monitors, Netcool/ASM, Netcool/ISM WAM, Netcool/SM Reporter, Netcool 

for Asset Management, Netcool/Realtime Active Dashboards, 

Netcool/Dashboards, Netcool/RAD, Netcool for Voice over IP, Netcool for 

Security Management, Netcool Security Manager, Netcool/Portal 2.0 Premium 

Edition, Netcool ObjectServer, Netcool/RAD, Netcool GUI Foundation, 

Netcool/Installer, Netcool/Licensing, Netcool/Software Developers Kit, NGF, 

Micromuse Alliance Program, Micromuse Channel Partner, Authorized Netcool 

Reseller, Netcool Ready, Netcool Solutions, Netcool Certified, Netcool Certified 

Consultant, Netcool Certified Trainer, Netcool CCAI Methodology, Micromuse 

University, Microcorrelation, Acronym, Micromuse Design, Integration Module 

for Netcool, The Netcool Company, VISIONETCOOL, Network Slice. 

Micromuse acknowledges the use of I/O Concepts Inc. X-Direct 3270 terminal 

emulators and hardware components and documentation in Netcool/Fusion. 

X-Direct ©1989-1999 I/O Concepts Inc. X-Direct and Win-Direct are 

trademarks of I/O Concepts Inc. 

Netcool/Fusion contains IBM Runtime Environment for AIX®, Java 

Technology Edition Runtime Modules © Copyright IBM Corporation 1999. All 

rights reserved. 

Netcool/Precision IP includes software developed by the University of California, 

Berkeley and its contributors. 

Micromuse acknowledges the use of MySQL in Netcool/Precision for IP 

Networks. Copyright © 1995, 1996 TcX AB & Monty Program KB & Detron 

HB Stockholm SWEDEN, Helsingfors FINLAND and Uppsala SWEDEN. All 

rights reserved. 

Micromuse acknowledges the use of the UCD SNMP Library Netcool/ISM. 

Copyright © 1989, 1991, 1992 by Carnegie Mellon University. Derivative Work 

- Copyright © 1996, 1998, 1999, 2000 The Regents of the University of 

California. All rights reserved. 

Portions of the Netcool/ISM code are copyright ©2001, Cambridge Broadband 

Ltd. All rights reserved. 

Portions of the Netcool/ISM code are copyright © 2001, Networks Associates 

Technology, Inc. All rights reserved. 

Micromuse acknowledges the use of Viador Inc. software and documentation for 

Netcool/Reporter. Viador © 1997-1999 is a trademark of Viador Inc. 

Micromuse acknowledges the use of software developed by the Apache Group for 

use in the Apache HTTP server project. Copyright © 1995-1999 The Apache 

Group. Apache Server is a trademark of the Apache Software Foundation 

(http://www.apache.org/). All rights reserved. 

Copyright 2005 Micromuse. Portions licensed under the Apache License, Version 

2.0 (the "License"); you may not use this file except in compliance with the 

License. You may obtain a copy of the License at 

http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law 

or agreed to in writing, software distributed under the License is distributed on an 

"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 

KIND, either express or implied. See the License for the specific language 

governing permissions and limitations under the License. 

Micromuse acknowledges the use of software developed by Edge Technologies, 

Inc. 2003 Edge Technologies, Inc. and Edge enPortal are trademarks or registered 

trademarks of Edge Technologies Inc. All rights reserved. 

Micromuse acknowledges the use of Merant drivers. Copyright © MERANT 

Solutions Inc., 1991-1998. 

The following product names are trademarks of Tivoli Systems or IBM 

Corporation: AIX, IBM, OS/2, RISC System/6000, Tivoli Management 

Environment, and TME10. 

IBM, NetView/6000, Domino, Lotus, Lotus Notes, and WebSphere are either 

trademarks or registered trademarks of IBM Corporation. VTAM is a trademark 

of IBM Corporation. 

Omegamon is a trademark of Candle Corporation. 

Netspy is a trademark of Computer Associates International Inc. 

The Sun logo, Sun Microsystems, SunOS, Solaris, SunNet Manager, Java are 

trademarks of Sun Microsystems Inc. 

SPARC is a registered trademark of SPARC International Inc. Programs bearing 

the SPARC trademark are based on an architecture developed by Sun 

Microsystems Inc. SPARCstation is a trademark of SPARC International Inc., 

licensed exclusively to Sun Microsystems Inc. 

UNIX is a registered trademark of the X/Open Company Ltd.

Sybase is a registered trademark of Sybase Inc. Adaptive Server is a trademark of 

Sybase Inc. 

Action Request System and Remedy are registered trademarks of Remedy 

Corporation. 

Peregrine System and ServiceCenter are registered trademarks of Peregrine Systems 

Inc. 

HP, HP-UX and OpenView are trademarks of Hewlett-Packard Company. 

InstallShield is a registered trademark of InstallShield Software Corporation. 

Microsoft, Windows 95/98/Me/NT/2000/XP are either registered trademarks or 

trademarks of Microsoft Corporation. 

Microsoft Internet Information Server/Services (IIS), Microsoft Exchange Server, 

Microsoft SQL Server, Microsoft perfmon, Windows Media, and Microsoft 

Cluster Service are either registered trademarks or trademarks of Microsoft 

Corporation in the United States and/or other countries. 

BEA and WebLogic are registered trademarks of BEA Systems Inc. 

FireWall-1 is a registered trademark of Check Point Software Technologies Ltd. 

Netscape and Netscape Navigator are registered trademarks of Netscape 

Communications Corporation in the United States and other countries. 

Netscape's logos and Netscape product and service names are also trademarks of 

Netscape Communications Corporation, which may be registered in other 

countries. 

Micromuse acknowledges the use of Xpm tool kit components. 

SentinelLM is a trademark of Rainbow Technologies Inc. 

GLOBEtrotter and FLEXlm are registered trademarks of Globetrotter Software 

Inc. 

Red Hat, the Red Hat "Shadow Man" logo, RPM, Maximum RPM, the RPM 

logo, Linux Library, PowerTools, Linux Undercover, RHmember, RHmember 

More, Rough Cuts, Rawhide and all Red Hat-based trademarks and logos are 

trademarks or registered trademarks of Red Hat Inc. in the United States and other 

countries. 

Linux is a registered trademark of Linus Torvalds. 

SUSE is a trademark of SUSE LINUX Products GmbH, a Novell business. 

Macromedia and Flash are trademarks or registered trademarks of Macromedia, 

Inc. in the United States and/or other countries. 

Nokia is a registered trademark of Nokia Corporation. 

WAP Forum and all trademarks, service marks and logos based on these 

designations (Trademarks) are marks of Wireless Application Protocol Forum Ltd. 

Micromuse acknowledges the use of InstallAnywhere software in Netcool/WAP 

Service Monitors. Copyright © Zero G Software Inc. 

Orbix is a registered trademark of IONA Technologies PLC. Orbix 2000 is a 

trademark of IONA Technologies PLC. 

Micromuse acknowledges the use of Graph Layout Toolkit in Netcool/ Precision 

for IP Networks. Copyright © 1992 - 2001, Tom Sawyer Software, Berkeley, 

California. All rights reserved. 

Portions of Netcool/Precision for IP Networks are © TIBCO Software, Inc. 

1994-2003. All rights reserved. TIB and TIB/Rendezvous are trademarks of 

TIBCO Software, Inc. 

Portions of Netcool/Precision for IP Networks are Copyright © 1996-2003, 

Daniel Stenberg, . 

Micromuse acknowledges the use of Digital X11 in Netcool/Precision for IP 

Networks. Copyright 1987, 1988 by Digital Equipment Corporation, Maynard, 

Massachusetts, All Rights Reserved. DIGITAL DISCLAIMS ALL 

WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL 

IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN 

NO EVENT SHALL DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT 

OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER 

RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN 

AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS 

ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 

PERFORMANCE OF THIS SOFTWARE. 

Netcool/SM Operations, Netcool/SM Configuration and Netcool/OpCenter 

include software developed by the OpenSSL Project for use in the OpenSSL 

Toolkit (http://www.openssl.org/). 

Micromuse acknowledges the use of software developed by ObjectPlanet. ©2003 

ObjectPlanet, Inc., Ovre Slottsgate, 0157 Oslo, Norway. 

Micromuse acknowledges the use of Expat in Netcool/ASM. Copyright 1998, 

1999, 2000 Thai Open Source Software Center Ltd. and Clark Cooper. Copyright 

2001, 2002 Expat maintainers. THE EXPAT SOFTWARE IS PROVIDED 

HEREUNDER "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 

OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 

OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR 

COPYRIGHT HOLDERS OF THE EXPAT SOFTWARE BE LIABLE FOR 

ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 

ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 

OUT OF OR IN CONNECTION WITH THE EXPAT SOFTWARE OR 

THE USE OR OTHER DEALINGS IN THE SOFTWARE. Expat explicitly 

grants its permission to any person obtaining a copy of any Expat software and 

associated documentation files (the "Expat Software") to deal in the Expat 

Software without restriction, including without limitation the rights to use, copy, 

modify, merge, publish, distribute, sublicense, and/or sell copies of the Expat 

Software. Expat's permission is subject to the following conditions: The above 

copyright notice and this permission notice shall be included in all copies or 

substantial portions of the Expat Software. Except as set forth hereunder, all 

software provided by Micromuse hereunder is subject to the applicable license 

agreement. 

Micromuse acknowledges that Netcool Security Manager includes Hypersonic 

SQL. Copyright (c) 2001-2002, The HSQL Development Group. All rights 

reserved. 

JABBER® is a registered trademark and its use is granted under a sublicense from 

the Jabber Software Foundation. 

Micromuse acknowledges the use of MySQL in Netcool/Precision for IP 

Networks and in Netcool/Precision for Transmission Networks. Copyright © 

1995, 1996 TcX AB & Monty Program KB & Detron. 

Micromuse acknowledges the use of Cryptix in Netcool/Precision IP. Copyright 

(c) 1995-2004 The Cryptix Foundation Limited. All rights reserved. 

Redistribution and use in source and binary forms, with or without modification, 

are permitted provided that the following conditions are met: 

1. Redistributions of source code must retain the copyright notice, this list of 

conditions and the following disclaimer. 

2. Redistributions in binary form must reproduce the above copyright notice, this 

list of conditions and the following disclaimer in the documentation and/or other 

materials provided with the distribution. 

THIS SOFTWARE IS PROVIDED BY THE CRYPTIX FOUNDATION 

LIMITED AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR 

IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 

IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 

PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 

CRYPTIX FOUNDATION LIMITED OR CONTRIBUTORS BE LIABLE 

FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 

OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED 

TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 

OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 

HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 

WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 

OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 

POSSIBILITY OF SUCH DAMAGE.

Micromuse acknowledges the use of PCRE in Netcool/Precision. Copyright 

©1997-2005 University of Cambridge. All rights reserved. Redistribution and use 

in source and binary forms, with or without modification, are permitted provided 

that the following conditions are met: 

1. Redistributions of source code must retain the above copyright notice, this list 

of conditions and the following disclaimer. 

2. Redistributions in binary form must reproduce the above copyright notice, this 

list of conditions and the following disclaimer in the documentation and/or other 

materials provided with the distribution. 

3. Neither the name of the University of Cambridge nor the name of Google Inc. 

nor the names of their contributors may be used to endorse or promote products 

derived from this software without specific prior written permission. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 

CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED 

WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 

PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 

COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY 

DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 

CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 

PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 

USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 

CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 

CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 

NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 

USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 

POSSIBILITY OF SUCH DAMAGE. 

All other trademarks, registered trademarks and logos are the property of their 

respective owners. 

Micromuse Inc., 650 Townsend Street, San Francisco, USA CA 94103 

www.ibm.com 

Document Version Number: 1.8

Contents 

Document Control Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 

Probe for Alcatel 5620 (CORBA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 

Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

License Band . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 

License Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 

Supported Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 

Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 

Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 

Installation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

Basic Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

Data Acquisition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 

Connecting to the CORBA Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 

Resynchronization on Alcatel 5620 Versions 6.x and Below. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 

Resynchronization on Alcatel 5620 Version 7.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 

Contents 

Inactivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 

Retrieving On-line Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 

Command Line Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

Properties and Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

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

Elements Common to all Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 

Elements Common to all Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 

Elements Generated for AttributeValueChange Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 

Elements Generated for StateChange Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 

Elements Generated for ObjectCreation and ObjectDeletion Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 

Netcool/OMNIbus Probe for Alcatel 5620 (CORBA) i

Contents 

ii 

Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 

Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 

Netcool/OMNIbus Probe for Alcatel 5620 (CORBA)

docscontrol.fm January 10, 2006 

Document Control Page 

The Probe for Alcatel 5620 (CORBA) documentation is provided in softcopy format only—to obtain the 

most recent version, please visit the IBM Tivoli Information Center: 

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

Table 1: Document Modification History 

Document Version Publication Date Comments 

1.0 14 August 2002 Released 

1.1 21 October 2002 Updated 

1.2 15 November 

2002 

Updated 

1.3 30 January 2003 Updated 

1.4 14 April 2003 Updated 

1.5 13 April 2004 License band information updated. 

Inactivity functionality enhanced. 

DeleteLogAtEnd property removed. 

ORBLocalPort property added. 

1.6 17 May 2004 Known issue regarding the Alcatel 5620 CORBA interface sending events 

documented. 

Decription about using the SkipSync property updated. 

Instructions on how to limit the number of log records received when 

resynchronizing added. 

Note about the additionalText element added. 

1.7 31 August 2004 Supported platform information added. 

Requirements details updated, including the use of the Nonnative Library. 

Support for Alcatel 5620 6.2 added. 

Support for specifying NamingService and EventChannel objects on remote 

machines added. 

ReceiveAlarmsOnly property added. 

SpecificProblems elements added. 

Description of the SystemID property updated. 

Netcool/OMNIbus Probe for Alcatel 5620 (CORBA) 1

Document Control Page 

2 

Table 1: Document Modification History 

Document Version Publication Date Comments 

1.8 10 January 2006 Version of Alcatel 5620 NM supported updated. 

Description of new synchronization method added. 

Description of Command Line Interface functionality added. 

Filter and Uselog properties added. 


Alcatel 5620 (CORBA).fm January 10, 2006 

Probe for Alcatel 5620 (CORBA) 

The Alcatel 5620 Network Manager is a network management system that provides access to network 

performance, fault management, diagnostic, and accounting data. A CORBA interface provides access to 

the network data managed by the Alcatel 5620 Network Manager through an object-oriented management 

information base. 

This guide contains the following sections: 

• Summary 

License Band 

License Model 

Supported Platforms 

Data Acquisition 

Properties and Command Line Options 

Elements 

Error Messages 


Document Version Number 1.8, Last Update: January 10, 2006 

Summary 

4 

Table 2 provides a summary of the Probe for Alcatel 5620 (CORBA). 

Table 2: Probe for Alcatel 5620 (CORBA) Summary 

Probe Target Alcatel 5620 NM version 4.1, 5.0, 5.1, 5.2, 5.3, 6.1, 6.2, 6.3, 7.0 

Probe Executable Name nco_p_alcatel_5620_corba 

Patch Number 3.1 

Probe Supported On Solaris 

Properties File $OMNIHOME/probes/arch/probe_name.props 

Rules File $OMNIHOME/probes/arch/probe_name.rules 

Requirements A currently supported version of Netcool/OMNIbus. 

JRE 1.3.1 

Connection Method CORBA 

Remote Connectivity Yes 

Note: Installed with the probe. 

probe-compatibility-3.x (UNIX only, on Netcool/OMNIbus 3.6 and 

below) 

probe-nco-p-nonnative 

probe-nco-p-nonnative-scripts 

probe-nco-p-nonnative-java 

omnibus-3.x-solaris2-probe-visibroker-support_0 

Note: The visibroker patch is not available on the support site; to obtain 

this patch, you must contact the technical support. 

License Band Elan: Band EMS; FLEXlm license: nco_p_alcatel_5620_corba 

License Model Single 

Peer-to-Peer Failover Functionality Available 

IP Environment IPv4 only 


License Band 

License Band 

The introduction of FLEXlm licensing has implications on the way in which probes are licensed. Rather 

than licenses being issued for probe bands, they are now issued for individual probes, by probe name. For 

example, the Probe for Alcatel 5620 (CORBA) for Netcool/OMNIbus version 3.5 was licensed as a band 

EMS probe. Netcool/OMNIbus versions 3.6 and later use the license name alcatel_5620_corba. 

License Model 

The probe requires a single license for each running instance of the probe. 

Supported Platforms 

For details of the versions of Solaris on which this probe is supported, see the following page on the 

IBM Tivoli Information Center: 

Installation 

Supported_Platforms.htm 

This section describes software requirements, the installation procedure, and basic configuration. 

Software Requirements 

Table 3 outlines the software required to run the Probe for Alcatel 5620 (CORBA). 

Table 3: Software Packages 

Software Package Version 

Alcatel 5620 Network Manager 4.1, 5.0, 5.1, 5.2, 5.3, 6.1, 6.2, 6.3, or 7.0 

Alcatel 5620 CORBA Network OSS Interface 4.1, 5.0, 5.1, 5.2, 5.3, 6.1, 6.2, 6.3, or 7.0 

Sun J2SE JRE 1.3.1 

Netcool/OMNIbus ObjectServer A currently supported version of Netcool/OMNIbus 

OMNIbus Probe Library A currently supported version of common-libOpl 

Nonnative Library probe-nco-p-nonnative 

probe-nco-p-nonnative-scripts 

probe-nco-p-nonnative-java 



Installation Procedure 

6 

The following installation procedure assumes that the Alcatel 5620 NM, Alcatel 5620 CORBA, and 

Netcool/OMNIbus are already installed. 

1. Install nco-p-nonnative. 

2. Install probe. 

3. Install JRE 1.3.1. 

4. Install the Visibroker patch. 

Probable Causes File Location 

The rules file refers to the file probableCauses.rep to create a table. The default path to this file is: 

/opt/Omnibus/probes/solaris2/probableCauses.rep. 

If the Netcool/OMNIbus installation directory differs from the default (/opt/Omnibus), you must edit 

the file alcatel_5620_corba.rules to refer to the correction location of this file. 

Basic Configuration 

This section describes the Probe for Alcatel 5620 (CORBA) configuration requirements. 

Environment Variables 

Before using the Probe for Alcatel 5620 (CORBA) for the first time, you must include the following paths 

in the $CLASSPATH and $VBROKER environmental variables: 

$OMNIHOME/probes/java/nco_p_alcatel_5620_corba.jar 

$OMNIHOME/probes/java/NSProbe.jar 

$OMNIHOME/probes/java/vbjorb.jar 

$OMNIHOME/probes/java/lm.jar 

$OMNIHOME/probes/java/vbsec.jar 


You must also include the following paths in the $LD_LIBRARY_PATH environment variable: 

Where: 

jre_directory/lib/sparc 

$OMNIHOME/platform/arch/lib 

$OMNIHOME is the usual OMNIbus directory 

jre_directory is the directory where the JRE is installed 

arch is the operating system platform architecture, for example, solaris2 

Properties File 

Installation 

On the machine where the Alcatel 5620 CORBA application is installed, check the value of the SystemId 

in the following file: 

/opt/netmgt/conexec/bin/CE_network.conf 

The SystemId property in the probe properties file must be of the same value as that in CE_ 

network.conf. 

The EfdId and LogId properties in the probe properties file should each be configured to have a unique 

Event Forwarding Discriminator (EFD) and log Object Identifiers (OID) respectively. 

Client and Server Interoperability 

There is an interoperability problem when a client developed with Visibroker for Java (for example, the 

probe) deals with a server developed with Visibroker for C++ 3.x (for example, the EventChannel). When 

the probe attempts to parse a TypeCode that contains an indirection to the server, it fails; an indirection 

occurs when somewhere in the definition of a type, some other type is used multiple times. 

When the probe parses such an event, it receives one online event and then the PushConsumer 

disconnects. One message is written to the log file. From the server side, an exception is raised stating the 

following: 

ProxyPushSupplier::sendData caught: Exception: CORBA::MARSHAL. 

To overcome this interoperability problem, set the -ORBtcIndirection flag in the 

netconfig.CEJprocess file to 0. This change only affects applications passing TypeCodes of 

complex types (for example, Anys) in which member types are repeated. 



8 

To set the -ORBtcIndirection flag: 

1. Stop the Probe for Alcatel 5620 (CORBA). 

2. Access the following file: 

/opt/netmgt/conexec/jidm/bin/netconfig.CEJprocess 

3. Change this file as follows (the new entry appears in bold): 

CosEventChannelScript osagent 0 1 - 0 0 -1 

-ORBtcIndirection 0 -maxQueueLength=5000 EventService -OAagent 0 -OAport 

8241 

4. Restart Alcatel 5620 CORBA. 

5. Restart the Probe for Alcatel 5620 (CORBA). 


The Probe for Alcatel 5620 (CORBA) connects to the Alcatel 5620 Network Manager through a CORBA 

interface. 

Connecting to the CORBA Interface 

The probe uses the Interoperable Object Reference (IOR) specified by the NamingServiceIORFile 

property to get a reference for the NamingService object of the Alcatel 5620 CORBA interface. It then 

uses the IOR specified by the EventChannelIORFile property to get a reference for the EventChannel 

object. From these two references, the probe can get references for all other objects of the Alcatel 5620 

interface required to subscribe to notifications on the EventChannel and to retrieve LogRecord objects. 

If the IOR files reside on a remote machine, you must precede the paths specified by the 

NamingServiceIORFile property and the EventChannelIORFile property with the name of 

the remote machine and a colon; for example: 

dev:/opt/netmgt/conexec/jidm/bin/etc/CosEventChannel.ior 

Each time the probe starts it attempts to rcp the IOR files from the remote machine (in the example: dev) 

to the machine on which the probe is running. 

Note: If the NamingServiceIORFile and EventChannelIORFile properties specify IOR files 

on a remote machine, the user running the probe must have authority to rcp files from one machine to 

another. 


Resynchronization on Alcatel 5620 Versions 6.x and Below 

This section describes how to perform resynchronization on Alcatel 5620 versions 6.x and below. 

Retrieving LogRecord Objects 


When the probe connects to the Alcatel 5620 CORBA interface, it checks whether a Log object exists. If 

no Log object exists, the probe creates one. It does not specify any filter for the new object, thus enabling 

all notifications to be logged. If a Log object does exist, the probe retrieves all the LogRecords that it 

contains. The probe parses each of these notifications and forwards them to the ObjectServer. 

You can instruct the probe to skip the procedure of retrieving LogRecord objects by setting the 

SkipSynch property to 1. 

Limiting the Number of Log Records Received when Resynchronizing 

Due to a limitation of the Alcatel 5620 CORBA interface, the probe cannot resynchronize solely on active 

alarms. However, the probe can be made to limit the number of LogRecords received when 

resynchronizing. To do this, set the SkipSynch property to 0 and specify the frequency with which the 

probe deletes the LogRecords using the DeleteLogRecords property. 

While deleting the Log object, the probe stores all notifications received in a backup Log object. When the 

probe has deleted all the records in the object, it resynchronizes with the backup Log object, then deletes 

the backup object. 

You can also limit the number of events that the probe receives by specifying that the probe only receives 

alarm events. To do this, set the ReceiveAlarmsOnly property to 1. 

Resynchronization on Alcatel 5620 Version 7.0 

On Alcatel 5620 version 7.0, resynchronization is performed by calling the retrieveActiveAlarms 

method. This method retrieves active alarms from the GenericAction object instead of the Log object. 

To instruct the probe to perform resynchronization, set the SkipSynch property to 1. 

Note: When instructing the probe to perform resynchronization when acquiring data from Alcatel 5620 

version 7.0, you can still instruct the probe to create a log object to store notifications by setting the UseLog 

property to 1; however, Micromuse recommends using the new method (that is, by setting the 

SkipSynch property to 1). 



Inactivity 

10 

You can specify a period of inactivity using the Inactivity property. If the Alcatel 5620 CORBA 

interface is silent for this length of time, the probe polls the interface to check that it is still running. If the 

interface responds, the probe continues to wait to receive a notification. If the interface does not respond, 

the probe disconnects from the interface. 

Retrieving On-line Notifications 

When retrieving on-line notifications, the probe retrieves a reference on the SupplierAdmin attribute 

of the EventChannel object. It then creates an EventPort to connect to this object. 

The probe also needs an Event Forwarding Discriminator (EFD) on the ManagedObjectDomain 

object to tell the agent where to forward its notifications. If an EFD already exists, the probe updates the 

DestinationTitle of the EFD by adding the AE_Title of the EventPort (this is specified by 

the EventPortTitle property). 

On startup, the probe reads the value of the EfdID property. Before creating an EFD, the probe checks 

whether a file named efdCreated.txt exists in the $OMNIHOME/var directory. If no file exists, the 

probe creates one. If the file exists, the probe uses the value of the ID in this file. If the value of the EfdID 

property is different from the ID in the efdCreated.txt file, the probe uses the ID in the file. 

Finally, the probe creates a PushConsumer object and connects it to the EventChannel. Each time a 

notification is received, a callback method of the PushConsumer object is called, the notification is parsed, 

and forwarded to the ObjectServer. 


Command Line Interface 


The Probe for Alcatel 5620 (CORBA) is supplied with a Command Line Interface (CLI). This interface 

allows you to perform commands using the probe (for example, to acknowledge alarms or to request a full 

resynchronization of the CORBA interface). 

To use the CLI, you must use the CommandPort property in the properties file to specify a port through 

which commands will be sent. When you want to perform commands, telnet to this port. Table 4 describes 

the commands that you can use with the Command Line Interface. 

Table 4: CLI Commands 

Command Description 

retrieve.active.alarms Allows you to retrieve all active alarms on Alcatel 5620 CORBA. 

version Displays the version of the probe. 

Note: Since the CLI is based upon telnet connections, you can connect to the probe from anywhere. This 

means that simple scripts can be set up to allow users to acknowledge selected events from the 

Netcool/OMNIbus event list by creating desktop tools to telnet to the probe, send a command, and then 

close the connection. 




12 

Table 5 describes the properties and command line options specific to this probe. For details about generic 

properties and command line options, see the Netcool/OMNIbus Probe and Gateway Guide. 

Table 5: Probe for Alcatel 5620 (CORBA) Properties and Command Line Functions (1 of 3) 

Property Name Command Line Option Description 

CommandPort integer -commandport integer Specifies the port to which users can telnet to 

communicate with the 3GPP interface using the 

Command Line Interface (CLI) supplied with the 

probe. For details about the CLI, see Command Line 

Interface on page 11. 

CommandPortLimit 

integer 

DeleteLogRecords 

integer 

-commandportlimit 

integer 

-deletelogrecords 

integer 

The default is 6970. 

Maximum number of telnet connections that can be 

made to the probe. 


Time (in seconds) after which the probe deletes log 

records. 


EfdId integer -efdid integer Identifier of the EFD object that the probe creates. 

EventChannelIORFile 

string 

-eventchanneliorfile 

string 


Path of the file that contains the IOR that the probe 

uses to connect to the EventChannel. 

The default is: 

/opt/netmgt/conexec/jidm/bin/etc/ 

CosEventChannel.ior. 

Note: If the probe is not installed on the machine 

running Alcatel 5620, you must precede the path to 

the IOR with the name of the remote machine and a 

colon; for example: 

dev:/opt/netmgt/conexec/jidm/bin/ 

etc/CosEventChannel.ior. 

If you do not have authority to rcp files from the the 

remote machine to the machine on which the probe 

is running, you must instead copy the 

CosEventChannel.ior file to the machine on 

which the probe is installed. 

EventPortTitle string -eventporttitle string AE_Title the probe uses when creating an EventPort 

object. 

The default is 0.1.0.12.20. 





Filter string -filter string Filter used to specifiy which events the probe 

receives. Use this property to specify the object 

identifier (OID) of the events that you want to 

receive. 

The default is "". 

Note: If you want to exclude the events listed by this 

property, precede the entry with NOT. If you want to 

specify that the probe receives events of all types, set 

this property to ALL. 

Inactivity integer -inactivity integer Time (in seconds) that the probe waits to receive a 

notification before polling the interface to check 

whether it is still active. 

The default is 0 (device is never deemed inactive). 

LogId integer -logid integer ID of the log object the probe creates. 


MaxLogSize integer -maxlogsize integer Maximum size (in bytes) for log objects. If a log 

object becomes larger than the MaxLogSize, the 

object wraps onto itself. 

NamingServiceIORFile 

string 

-namingserviceiorfile 

string 

The default is 0 (there is no maximum log size). 

Path of the file that contains the IOR that the probe 

uses to connect to the NamingService. 

The default is: /opt/netmgt/conexec/jidm/ 

bin/etc/NamingContext.ior. 

If the probe is not installed on the machine running 

Alcatel 5620, you must precede the path to the IOR 

with the name of the remote machine and a colon; 

for example: 

dev:/opt/netmgt/conexec/jidm/bin/ 

etc/NamingContext.ior. 

If you do not have authority to rcp files from the the 

remote machine to the machine on which the probe 

is running, you must instead copy the 

NamingContext.ior file to the machine on 

which the probe is installed. 

OidTableFile string -oidtablefile string File containing a table of object identifiers (OIDs) and 

corresponding values. 

The default is 

$OMNIHOME/probes//oid.txt. 



14 



ORBLocalPort integer -orblocalport integer Local port to which the ORB to listens. 

ProxyAgentTitle string -proxyagenttitle 

string 

ReceiveAlarmsOnly 

integer 

-receivealarmsonly 

integer 


AE_Title the probe uses to get the reference for the 

ProxyAgent object. 

The default is 1.2.3.4.5. 

Specifies whether the probe receives all events or 

only alarm events: 

0 - probe receives all events of all types 

1 - probe receives only alarm events 


SkipSynch integer -skipsynch integer Setting this property instructs the probe to omit the 

procedure of retrieving active alarms from the 

GenericAction object on startup: 

0 - probe does not skip this procedure 

1 - probe skips this procedure 


SystemId string -systemid string Identifier of the root object of the managed object 

tree. 

The default is "". 

Note: For details of how to find out what this 

property should be set to, see Basic Configuration on 

page 6. 

UseLog integer UseLog integer Specifies whether the probe creates a log object to 

store notifications for retrieval during 

resynchronization: 

0 - probe does not create a log object 

1 - probe creates a log object 



Elements 

Elements 

This section describes the elements that the probe generates for each type of notification it receives from the 

Alcatel 5620 system. 

Elements Common to all Notifications 

Table 6 describes the elements that the probe generates for all notifications. 

Table 6: Probe for Alcatel 5620 (CORBA) Elements 

Element Name Element Description 

$managedObjectClass Class of the object for which the notification was sent. 

$managedObjectInstance Instance of the object for which the notification was sent. 

$eventTime Time at which the notification was sent. 

$eventType Type of notification: 

Elements Common to all Alarms 

Table 7 describes the elements that the probe generates for all alarms in addition to those described in 

Table Elements Common to all Notifications on page 15. 

Table 7: Probe for Alcatel 5620 (CORBA) Elements (1 of 2) 

AttributeValueChange 

StateChange 

ObjectCreation 

ObjectDeletion 

CommunicationsAlarm 

EquipmentAlarm 

ProcessingErrorAlarm 

EnvironmentalAlarm 

QualityOfServiceAlarm 


$additionalInformation Contains identifiers for the problem code and the object affected. 

$additionalText Brief description of the alarm. 

$monitoredAttributesNN Defines one or more attributes of the monitored object. 



16 

Table 7: Probe for Alcatel 5620 (CORBA) Elements (2 of 2) 


$perceivedSeverity Indication of the severity of the alarm: 

Indeterminate 

Critical 

Major 

Minor 

Warning 

Cleared 

$probableCause Brief description of the probable cause of the alarm. 

$specificProblemNN Description of the specific problem to which the alarm relates. 

$thresholdInfo Contains details of a threshold that has been passed. 

Note: If the probe is used against the Alcatel 5620 NM simulator, the $additionalText element for 

equipmentAlarm alarms may contain extended characters. 

Elements Generated for AttributeValueChange Events 

Table 8 describes the elements that the probe generates for AttributeValueChange events in 

addition to those described in Table Elements Common to all Notifications on page 15. 



$sourceIndicator Indication of the source of the event: 

resourceOperation 

managementOperation 

unknown 

$attributeValueChangeDefinitionNN Description of the attribute whose value has been changed, 

including its name, old value, and new value. 


Elements Generated for StateChange Events 

Elements 

Table 9 describes the elements that the probe generates for StateChange events in addition to those 

described in Table Elements Common to all Notifications on page 15. 






unknown 

$stateChangeNN Description of the attribute whose state has been changed, 

including its name, old state, and new state. 

Elements Generated for ObjectCreation and ObjectDeletion Events 

Table 6 describes the elements that the probe generates for ObjectCreation and ObjectDeletion 

events in addition to those described in Table Elements Common to all Notifications on page 15. 






unknown 

$attributeNN Description of the attribute that was either created or deleted. 




18 

Table 11 describes the error messages specific to this probe. For information about generic error messages, 

see the Netcool/OMNIbus Probe and Gateway Guide. 

Table 11: Probe for Alcatel 5620 (CORBA) Error Messages (1 of 2) 

Error Description Action 

Can't create Java VM 

[Code:] 

Can't find AlcatelClient 

class 

Ensure that $CLASSPATH 

includes nco_p_alcatel_ 

5620.jar's location 

Error Occurred Calling 

AlcatelClient.run 

Error Occurred Creating 

ObjectArray 

Error: Cannot get Global 

Reference 

Out of memory 

Unable to allocate 

AlcatelClient object 

Unable to allocate 

netcoolOut object 

You must specify both IOR 

files 

There is a problem starting the Java 

Virtual Machine (JVM). This could be due 

to insufficient memory. 

The JVM is unable to locate the 

AlcatelClient class. 

The path of the nco_p_alcatel_ 

5620.jar file is missing from the 

$CLASSPATH environment variable. 


AlcatelClient class. 

The probe failed to allocate internal 

storage. 

An IOR file has not been specified for 

either the NamingService or from the 

EventChannel. 

Make more memory available. 

Check the location of nco_p_ 

alcatel_5620_ 

corba.jar in the $CLASSPATH 

environment variable. 

Update the $CLASSPATH environment 

variable. 





Make more memory available. 

Check that you have specified values for 

both the NamingServiceIORFile 

and EventChannelIORFile 

properties. 

Failed to initialize Internal errors. Refer to your support contract for 

information about contacting the help 

desk. 

Exception in thread 

“main” java.lang. 

NoClassDefError: nco_p_ 

alcatel_5620_corba.jar 

The JVM is unable to locate the nco_p_ 

alcatel_5620_corba class. 






Table 11: Probe for Alcatel 5620 (CORBA) Error Messages (2 of 2) 

Error Description Action 


“main” 

java.lang.NoClassDefErro 

r: com/micromuse/nsprobe/ 

NSProbe 


“main” 

java.lang.NoClassDefErro 

r: 

org/omg/PortableService/ 

Servant 


NSProbe class. 

The JVM is unable to locate the vbjorb 

class. 


Check the location of NSProbe.jar in 

the $CLASSPATH environment 

variable. 

Check the location of vbjorb.jar in 

the $CLASSPATH environment 

variable. 



20 


ackmatter.fm January 10, 2006 

Contact Information 

Corporate 

Region Address Telephone Fax World Wide Web 

USA Micromuse Inc. (HQ) 

650 Townsend Street 

San Francisco 

CA 94103 

USA 

Europe Micromuse Ltd. 

Disraeli House 

90 Putney Bridge Road 

London SW18 1DA 

United Kingdom 

Asia-Pacific Micromuse Ltd. 

Level 25 

77 St Georges Terrace 

Perth WA 6000 

Australia 

Technical Support 

1-800-Netcool (638 2665) 

+1 415 568 9800 

Region Telephone Fax 

USA 1-800-Netcool (800 638 2665) 

+1 415 568 9800 (San Francisco) 

+1 415 568 9801 http://www.micromuse.com 

+44 (0) 20 8875 9500 +44 (0) 20 8875 9995 http://www.micromuse.co.uk 

+61 (0) 8 9213 3400 +61 (0) 8 9486 1116 http://www.micromuse.com.au 

+1 415 568 9801 

Europe +44 (0) 20 8877 0073 (London, UK) +44 (0) 20 8875 0991 

Asia-Pacific +61 (0) 8 9213 3470 (Perth, Australia) 

Online 

+10 800 852 1012 (North China) 

+10 800 152 1012 (South China) 

+61 (0) 8 9486 1116 

Team E-Mail World Wide Web 

Licensing Temporary Licenses: temp.licensing@micromuse.com 

Permanent Licenses: perm.licensing@micromuse.com 

support.micromuse.com/helpdesk/licenses 

Support support@micromuse.com support.micromuse.com 


Contact Information 

22

Netcool/OMNIbus Probe for Alcatel 5620 (CORBA) - e IBM Tivoli ...

Create successful ePaper yourself

Delete template?

Save as template?