IBM Tivoli Netcool/OMNIbus Probe for Alcatel-Lucent 5529 OAD V6

48 Pages·2017·1.33 MB·English

IBM® Tivoli® Netcool/OMNIbus Probe for
Alcatel-Lucent 5529 (OAD) V6
7.5
Reference Guide
March 12, 2021
IBM
SC22-5420-16
Note
Before using this information and the product it supports, read the information in Appendix A, “Notices
and Trademarks,” on page 37.
Edition notice
This edition (SC22-5420-16) applies to version 7.5 of Probe for Alcatel-Lucent 5529 OAD V6 and to all subsequent
releases and modifications until otherwise indicated in new editions.
This edition replaces SC22-5420-15.
© Copyright International Business Machines Corporation 2011, 2021.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
Contents
About this guide.................................................................................................... v
Document control page................................................................................................................................v
Conventions used in this guide..................................................................................................................viii
Chapter 1. Probe for Alcatel-Lucent 5529 OAD V6...................................................1
Summary......................................................................................................................................................1
Installing probes..........................................................................................................................................2
Configuring the probe..................................................................................................................................3
Obtaining the probe-nonnative patch....................................................................................................3
Configuring Sun Java..............................................................................................................................3
Jar files....................................................................................................................................................4
Configuring SSL.....................................................................................................................................12
Problem and resolution events............................................................................................................13
Additional considerations....................................................................................................................13
Running the probe.....................................................................................................................................14
Data acquisition.........................................................................................................................................14
Peer-to-peer failover functionality......................................................................................................14
Backoff strategy....................................................................................................................................15
Using HTTP or HTTPS protocol............................................................................................................15
Resynchronizing alarms.......................................................................................................................16
Performing partial resynchronization..................................................................................................16
Java Message Service..........................................................................................................................16
Using durable subscriptions.................................................................................................................17
Disabling durable subscriptions...........................................................................................................17
Java Messaging Service filter...............................................................................................................17
Inactivity...............................................................................................................................................17
Command line interface.......................................................................................................................17
Properties and command line options......................................................................................................18
Elements....................................................................................................................................................29
Error messages..........................................................................................................................................33
ProbeWatch messages..............................................................................................................................34
Known issue...............................................................................................................................................35
Appendix A. Notices and Trademarks...................................................................37
Notices.......................................................................................................................................................37
Trademarks................................................................................................................................................38
iii
iv
About this guide
The following sections contain important information about using this guide.
Document control page
Use this information to track changes between versions of this guide.
The Probe for Alcatel-Lucent 5529 OAD V6 documentation is provided in softcopy format only. To obtain
the most recent version, visit the following IBM Documentation page:
https://www.ibm.com/support/knowledgecenter/SSSHTQ_int/omnibus/probes/common/Probes.html
Table 1. Document modification history
Document Publication Comments
version date
SC22-5420-00 November 4, First IBM publication.
2011
SC22-5420-01 March 2, 2012 Note about lack of support for SSL communication features when
running the AIX version of the probe added to “Summary” on page
1.
SC22-5420-02 August 3, 2012 “Configuring SSL connections” on page 12 added.
The following properties added to “Properties and command line
options” on page 18:
• CertificateStore
• CertificateStorePassword
• TrustStore
• TrustStorePassword
• UseSsl
SC22-5420-03 November 30, “JMS ports” on page 16 updated.
2012
Descriptions for the following properties in “Properties and
command line options” on page 18 updated:
• ClusterURL
• FlushBufferInterval
• UseSsl
SC22-5420-04 April 28, 2013 Support extended to OAD version 9.2.
SC22-5420-05 December 6, “Backoff strategy” on page 15 added.
2013
“Additional considerations” on page 13 updated.
SC22-5420-06 June 12, 2014 Support extended to OAD version 9.3.
“Summary” on page 1 updated.
SC22-5420-07 July 11, 2014 “Summary” on page 1 updated.
© Copyright IBM Corp. 2011, 2021 v
Table 1. Document modification history (continued)
Document Publication Comments
version date
SC22-5420-08 June 11, 2015 Support extended to OAD version 9.4.
“Summary” on page 1 updated.
“Configuring SSL connections” on page 12 updated.
“Using HTTP or HTTPS protocol” on page 15 updated.
Descriptions for the following properties added to “Properties and
command line options” on page 18 :
• JavaNamingFactoryInitial
• ResyncRetryInterval
• HttpHostPort
• HttpTimeout
• SingletonServerPort
Description for the ClusterURL property updated. HttpHost and
HttpPort properties removed.
Enhancements: Version 5 of the Probe for Alcatel-Lucent 5529
OAD includes the following enhancements:
• 41495: Functionality added for retrying resynchronization if it
initially fails.
• 41581: Functionality added for specifying multiple hosts for the
probe to connect to.
• 65449: Support added for Alcatel-Lucent OAD 9.4.
SC22-5420-09 March 10, Support extended to OAD version 9.5.
2016
“Summary” on page 1 updated.
“Jar files” on page 4 updated.
SC22-5420-10 September 15, Guide updated for version 6 of Probe for Alcatel-Lucent 5529 OAD.
2016
“Summary” on page 1 updated.
Descriptions for the following properties added to “Properties and
command line options” on page 18 :
• AxSSSLSupport
• JndiConfigFile
Enhancements: Version 6 of the Probe for Alcatel-Lucent 5529
OAD includes the following enhancements:
• 88886: Provision of additional parameters for SSL connections.
SC22-5420-11 March 14, Guide updated for Version 7 of Probe for Alcatel-Lucent 5529 OAD.
2017
Support extended to OAD version 9.6.
“Summary” on page 1 updated.
“Jar files” on page 4 updated.
vi IBM Tivoli Netcool/OMNIbus Probe for Alcatel-Lucent 5529 OAD V6: Reference Guide
Table 1. Document modification history (continued)
Document Publication Comments
version date
SC22-5420-12 November 23, Support extended to OAD version 9.6.03.
2017
“Summary” on page 1 updated.
“Jar files” on page 4 updated.
SC22-5420-13 August 9, 2018 Support extended to OAD version 9.6.05.
“Summary” on page 1 updated.
“Jar files” on page 4 updated.
SC22-5420-14 June 28, 2019 Support extended to OAD version 9.7.
“Summary” on page 1 updated.
“Jar files for OAD Version 9.7” on page 10 updated.
“Properties and command line options” on page 18 updated.
SC22-5420-15 July 16, 2020 Guide updated for Version 7.5 of Probe for Alcatel-Lucent 5529
OAD.
Support extended to OAD version 9.7.03 and 9.7.05.
“Summary” on page 1 updated.
“Jar files for OAD Version 9.7.03” on page 10 added.
“Configuring SSL connections” on page 12 updated.
Fixes:Version 7.5 of the Probe for Alcatel-Lucent 5529 OAD
includes fixes for the following APARs:
• IJ24265: Introduced new properties: CertificateStoreType
and TrustStoreType both with the default value of JKS.
• IJ07134: Fixed probe crash issue in Solaris platform by setting
io.netty.noUnsafe=true in probe environment file. The issue is
caused by a defect reported in JBoss Enterprise Application
Platform (JBEAP-5410).
• IJ06495: Enriching Node field with aliasValue token to avoid
unnecessary alarm suppression due to deduplication.
• IJ05710: Updated README/description.txt to include jar file
requirements for integration to OAD version 9.6.03.
• IJ00242: Fixed issue where probe does not create connection
when HEAD request not returning the expected code. The issue
was observed when probe attempted connection to OAD version
9.6.03.
SC22-5420-16 March 12, Support extended to OAD version 9.7.07.
2021
“Summary” on page 1 updated.
“Jar files for OAD Version 9.7.07” on page 11 added.
Note: The Probe for Alcatel-Lucent 5529 OAD V6 was previously documented in the same reference guide
as the Probe for Alcatel-Lucent 5529 OAD. This reference guide documents the Probe for Alcatel-Lucent
5529 OAD V6 only.
About this guide vii
Conventions used in this guide
All probe guides use standard conventions for operating system-dependent environment variables and
directory paths.
Operating system-dependent variables and paths
All probe guides use standard conventions for specifying environment variables and describing directory
paths, depending on what operating systems the probe is supported on.
For probes supported on UNIX and Linux operating systems, probe guides use the standard UNIX
conventions such as $variable for environment variables and forward slashes (/) in directory paths. For
example:
$OMNIHOME/probes
For probes supported only on Windows operating systems, probe guides use the standard Windows
conventions such as %variable% for environment variables and backward slashes (\) in directory paths.
For example:
%OMNIHOME%\probes
For probes supported on UNIX, Linux, and Windows operating systems, probe guides use the standard
UNIX conventions for specifying environment variables and describing directory paths. When using the
Windows command line with these probes, replace the UNIX conventions used in the guide with Windows
conventions. If you are using the bash shell on a Windows system, you can use the UNIX conventions.
Note: The names of environment variables are not always the same in Windows and UNIX environments.
For example, %TEMP% in Windows environments is equivalent to $TMPDIR in UNIX and Linux
environments. Where such variables are described 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 arch directory under NCHOME or
OMNIHOME, arch is a variable that represents your operating 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 the table.
Table 2. Directory names for the arch variable
Operating system Directory name represented by arch
AIX® systems aix5
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 OMNIHOME environment variable in many
configuration files. Set the value of OMNIHOME as follows:
viii IBM Tivoli Netcool/OMNIbus Probe for Alcatel-Lucent 5529 OAD V6: Reference Guide
• On UNIX and Linux, set $OMNIHOME to $NCHOME/omnibus.
• On Windows, set %OMNIHOME% to %NCHOME%\omnibus.
About this guide ix
x IBM Tivoli Netcool/OMNIbus Probe for Alcatel-Lucent 5529 OAD V6: Reference Guide