IBM Support

IBM Tivoli Netcool/Impact V5.1.1 Fix Pack 2 (5.1.1-TIV-NCI-FP0002)

Download


Abstract

This Interim Fix addresses problems reported in IBM Tivoli Netcool Impact V5.1.1

Download Description

Fix Pack 0002 addresses the problems that have been reported in IBM Tivoli
Netcool/Impact version 5.1.1. The following table contains a list of
files included in this Fix Pack and operating systems associated with
these files:

Platform File
AIX * 5.1.1-TIV-NCI-FP0002.aix.tar
HP-UX * 5.1.1-TIV-NCI-FP0002.HPUX.tar
Linux * 5.1.1-TIV-NCI-FP0002.Linux.tar
Solaris * 5.1.1-TIV-NCI-FP0002.Solaris.tar
Windows * 5.1.1-TIV-NCI-FP0002.win.zip
zLinux * 5.1.1-TIV-NCI-FP0002.Linuxs390.tar


all platforms * 5.1.1-TIV-NCI-FP0002.README


Note: The installer works for both 32 and 64 architectures

Note: Whenever <ARCH> is used in the text of this readme, as part of the
filename of the fix pack package, it refers to, and can be
substituted for one of the following operating systems:
* Linux
* Solaris
* AIX
* HPUX
* Linuxs390


======================================
2.0 Hardware and software requirements
======================================

Please refer to the 5.1.1 Release Notes for a full description of all
the hardware and software requirements of the product:

http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/topic/com.ibm.netcoolimpact.doc5.1.1/ReleaseNotes.pdf
=================
5.0 List of APARs
=================

5.1.1 Fixes (APARs) Included In this Fix Pack.

APAR Description

IV35940 RETURNEVENT() FUNCTION WITHIN DATABASEEVENTREADER ADDED UNWANTED SINGLE QUOTES TO THE IDENTIFER FIELD IN THE SQL "VIA" STATEMENT:[511]
When DatabaseEventReader service is used for omnibus events, the policies pick-up and process the events, but ReturnEvent() fails
because the update event function adds unwanted additional escaped single quotes.

IV12778 SETTING SIZE OF COLLECTION TYPE DOSE NOT WORK ON WEBSERVICES WIZARD
Could not set collection type parameters by Web Services Wizard


IV26951 ADDING A SPACE AFTER "); CAUSES A SYNTAX ERROR
This fix addresses an issue in Firefox with the policy editor:
1. Doing certain edits results in syntax errors and policy corruption.
2. Selecting text to replace via paste command does not replace the selected text with the text to copy- rather it appends the copied text after the selected text. Also, if you select text and hit delete button, the text is not deleted. These issues only occur before any edits have been done on the policy. The issues occur in FF3.6 and FF14.


IV08840 EVENT READER DOESN'T DETECT THE SERIAL ROTATION FOR INSERT ONLY
If the OMNIbus Serial field reached its maximum value (2147483647) and rotated, Impact event reader didn't detected the rotation and keeps asking for events with bigger Serial number.


IV11728 USING EVENTREADER PARSERESTRICTIONFILTER TO ALLOW THE USE OF GETDATE()
Enabling an EventReader to use GetDate() in one Filter for comparison against an ObjectServer field with the additional property:
impact.[EventReaderName].parserestrictionfilter=false
then sends an event matching any Filter in the EventReader to be processed by all Policies defined in the EventReader regardless
of the event matching those other Filters or not. The result is that all Policies linked to this EventReader try to process events that are intended to match only one Filter/Policy.


IV12282 SEF Cross-Site Scripting Vulnerabilities in Impact code
This fix is applied to address two vulnerabilities found in Impact - Cross-site scripting and Cross-site Request Forgery.


IV12589 NCI_REMOVESERVER.BAT TYPO ERROR
When trying to remove an Impact server on a Windows box nci_removeserver.bat fails repeatedly returning:
WASX7011E: Cannot find file "<%NCHOME%>\\impact\\bin\\jython\\remove.app.py <servername>"



IV12043 USING EVENTREADER ENABLE EVENTLOCKING WITHOUT AN EXPRESSION CAUSES AN ERROR AND FAILS TO PROCESS EVENTS
Selecting the Enable EventLocking button on an EventReader without setting an Expression causes the error.



IV18130 JMSCORRELATIONID SHOULD BE IN JMS HEADER OTHER THAN JMS PROPERTIES
JMSCorrelationID should be in JMS Header rather than JMS properties.


IV21219 LOG FILES HAVE GARBAGE CHARACTERS WHEN LOCALE IS SET TO FR_FR.UTF-8
When customer set a locale like fr_FR.UTF-8 which is needed to correct a problem with a radio button in the event reader service, the log files within eWAS display garbage characters (SystemOut.log)



IV20695 ONE TIME MWMW IS REUSING THE SAME CALENDAR OBJECT FOR BOTH START TIME AND END TIME
Events are showing active in MWM when they should not be. This is happening for the specific instance when using LIKE matching and the time window spans April 1st.
To install this fix please find the name of your server. Go to Impact/policy and rename NCI_Opview_Add1TWin.ipl to <server_name>_Opview_Add1TWin.ipl. If you are unsure of your server name do a search for *_server.props. The server name is whatever is returned by the *.


IV22560 ANALYZE EVENT MAPPING TOOL FAILS AND HAMMERS CPU
A large and fairly complex set of Filters in an EventReader causes the Analyze Event Mapping tool to fail and hits CPU so
much that the only way out is to kill -9 [PID] the Impact instance and restart


IV22741 EXTERNAL DSA SQL UPDATES NOT APPEARS ON THE POLICYLOGGER.
This fix addresses the issue whereby the users will not see the SQL update statement in the log. Hence, they will not be sure if the statement was sent to the database correctly


IV25900 JAVA.LANG.OUTOFMEMORYERROR. IMPACT NOT PROCESSING EVENTS.
The Impact server stops processing events and has an OutOfMemory error. One way to verify is that the .state file in the impact/etc directory does not update.


IV26951 ADDING A SPACE AFTER  ");  CAUSES A SYNTAX ERROR
1. Doing certain edits in FF14 results in syntax errors and policy corruption
2. Selecting text to replace via paste command does not replace the selected text with the text to copy- rather it appends the copied text after the selected text.

IV29936 EXCEPTION IN STORED PROCEDURE RESULTS IN NON CLOSURE OF SQL CONNECTION OF DATASOURCE
After a syntax error in the execution of an oracle stored procedure, the connection to Oracle does not work, and subsequent calls to Oracle hang.

IV30041 CHANGING THE ORACLE LDAP DATA SOURCE TO USE A JDBC LDAP URL TO OBTAIN A CONNECTION TO ORACLE
The aim of this APAR is to support the straightforward way of obtaining an Oracle connection through LDAP, using a url of the form: jdbc:oracle:thin:@ldap://<ldaphost>:<ldapport>/<ServiceName>,cn=OracleContext,DC=oracle,dc=support,dc=com

IV31226 CLEAR STATE CHANGE DOESN'T SET STATECHANGE >0
At certain times, when an event reader is cleared and restarted, it does not start reading events from StateChange =0, but rather starts from some other StateChange, thus missing events that it should pick up.

IV19026 UNABLE TO REAWAKEN HIBERNATION
Unable to reawaken hibernation due to NullPointer exceptions.

IV20367 ERROR FROM WAKING UP HIBERNATION
Hibernation ends in error when waking up.

IV21736 DELETING DATA ITEMS FROM ORACLE DATA TYPE CAUSES MAXIMUM OPENCURSOR ERRORS
When deleting a number of oracle data items within a policy, the maximum number of open cursors
is exceeded resulting in errors in the log files and issues running the policy in the future.

IV30383 CANNOT AUTHENTICATE TO OBJECTSERVER WITH SSL IN IMPACT511
When Impact is configured to authenticate to ObjectServer and ObjectServer is configured for SSL, authentication does not work. Also, Impact is not able to make any connection to Objectserver, even for event reading.

IV19818 THE RECURRING MAINTENANCE WINDOW DOES NOT TAKE DST INTO ACCOUNT
The recurring maintenance window does not take DST into account,
instead it stays at standard times, as the Time Zone settings
are based off of GMT.

IV29981 ERROR WITH IMPACT TO CHANGE AN ORACLE DATE IN ORACLE USING UPDATE
When trying to update a date field in an Oracle database, the update fails because the field names were case sensitive.

IV21503 PERFORM UNAUTHORIZED ADMINISTRATIVE FUNCTIONS
An attacker can perform unauthorized administrative functions against the Netcool Impact Nameservers without authentication.

IV17284 THE JMS CONNECTION DID NOTGET CLOSED ON FAILURE TOCOMMUNICATE AND WHEN THE AUTORECONNECT HAPPENS
If the JMS bus goes down, then JMS Listener will not reconnect when the JMS message bus comes back up.

IV19673 HIGHLIGHTED LINES OF POLICY CODE, ON POLICY EDITOR ON IE8BROWSER, RESULT IN LINES BEING DELETED
Highlighted lines of policy code in the policy editor disappear. This only happens when user holds down shift key and selects text.

IV31225 SEND A MESSAGE TO A JABBER CHAT ROOM AND AVOID A 15 SEC TIMEOUT
This APAR addresses multiple issues with the Jabber service in Impact.

- Sending messages to a groupchat did not work
- Sending a regular jabber message took about 15 seconds
- Exceptions in sending a jabber message were caught and not returned to the policy
- Password for groupchat was not supported
- When JabberService hangs on login to the jabber server, the Jabber service does not recover and cannot restart

IV18554 EVAL FUNCTIONALITY HAS CHANGED FROM 4.1 TO 5.1.1
Eval function has stopped working properly in 5.1.1

IV18060 THE FILTER ANALYSER DOES NOT PROCESS NON-STANDARD ASCII CHARACTERS
When using the filter analyser to verify a policy, it fails withan error if the filter contains a non-standard character.


5.1.2 Fixes (APARs) Included In this Fix Pack from FP1.

The Impact 5.1.1 FP1 readme can be viewed from: http://www-01.ibm.com/support/docview.wss?uid=swg24026299

APAR Description

IY97495 EVENTREADER MAPPING DOESN'T UPGRADE PROPERLY FROM 3.1 TO 4.0

IZ35154 CHANGES IN EVENTREADER FILTER CONDITIONS

IZ40005 ORACLE DSA FAILS TO REFRESH TABLE DEFINITION OR ACCESS TABLES

IZ40012 CANNOT UPDATE A STRING FIELD WITH A "?" CHARACTER IN IT WHEN USING THE
RETURNEVENT(EVENTCONTAINER)

IZ60300 THE INTERNAL DATA TYPE, THAT GETS CREATED AFTER USING THE XINY

IZ60303 POLICY EDITOR DOES NOT RETAIN SPACES CREATED USING TAB KEY.

IZ60396 $NCHOME/ETC/TIVOLI-VMM4NCOS/BIN/INSTALL-VMM4NCOS.SH IS BUGGY.

IZ61956 DIRECTSQL OVERWRITES THE DATASOURCE VARIABLE WITHIN POLICY

IZ62290 NCI_EXPORT IS NOT WORKING ON WINDOWS OS

IZ62403 WEBSERVICE DOES NOT IMPLEMENT KEEP ALIVE
To implement KeepAlive, add the following two properties to the policy:
CallProps = NewObject();
CallProps.KeepAlive = true;
CallProps.ReuseHTTPClient = true;

Pass CallProps to WSInvokeDL function:
WSInvokeDL(WSService, WSEndPoint, WSMethod, WSParasm,CallProps);

IZ62606 UNABLE TO USE MINUTES DATATYPE CHACHE QUERY OPTION

IZ63086 IMPACT 5.1 POLICY NO LONGER RECOGNISES THE USE_SHARED_SCOPE
PROPERTY THAT ALLOWED USE OF GLOBAL VARIABLES ACROSS FUNCTIONS

IZ63116 SUBTRACTIONS IN EVENT READER FILTERS CAUSE PROCESSING TO FAIL
The filter criteria in the event reader are used by Tivoli Netcool/Impact
and not the Object Server.
Impact does not support the Object Server function in the restriction filter.
If it is necessary to include an Object Server function in the filter then
edit the following file:
$NCHOME/impact/etc/<SERVER NAME>_<eventreadername>.props
And set the following property to false:
impact.<readename>.parserestrictionfilter=false
Please note that this option will force Impact to not parse
the expression and the filter will always be true.

IZ64363 IMPACT GENERATES AN ERROR WHEN TRYING TO VIEW TIMERANGEGROUP ENTRIES GREATER THAN 10

IZ64812 MALFORMED SQL STATEMENT

IZ65334 CANNOT SAVE NCI_EXPORT TO /TMP DIRECTORY

IZ65803 HIBERNATION FUNCTION DOESN'T WORK WHEN A USER FUNCTION IS CALLED FROM ANOTHER POLICY

IZ66288 HIBERNATE() DOESN'T WORK AS INTENDED WHEN USE_SHARED_SCOPE IS USED IN THE POLICY

IZ66290 CALLING HIBERNATE() AND REMOVEHIBERNATE() WITHIN 'IF-ELSE' FUNCTION DISRUPTS THE BEHAVIOUR OF HIBERNATION

IZ51096 IMPACT 5.1 WEBSERVICE DSA

IZ51342 CANNOT UPDATE A STRING FIELD CONTAINING A SINGLE QUOTE CHARACTER (') WHEN
USING THE RETURNEVENT(EVENTCONTAINER)

IZ51749 ALLOW FOR THE USE OF A LOAD BALANCER APPLICATION TO WORK WITH WEBSERVICE LISTENER.

IZ53023 REXTRACTALL FUNCTION ISN'T WORKING AS EXPECTED
RextractAll function returns only the very last match of the
given pattern. In order to return all the matches, an additionl
flag was added to rextractAll() function as follows:
RextractAll(string,pattern) // return only the last match
RextractAll(string,pattern,false); //return only the last match
RextractAll(string,pattern,true); //returns all the matches

The behaviour of RExtractAll has been modified since IF1 and the documentation for this is contained in the following note:
http://pic.dhe.ibm.com/infocenter/tivihelp/v39r1/index.jsp?topic=%2Fcom.ibm.netcoolimpact.doc6.2%2Fpolicy%2Fimpr_parser_rextractall_c.html



IZ53791 INTERNAL DATA ITEM CREATED AS A INTEGER SHOWS UP AS A STRING.

IZ53976 UNABLE TO DELETE DATASOURCE & DATATYPE AFTER INSTALLING FP1

IZ54066 WEBSERVICE WIZARD NOT GENERATING PROPER POLICY CODE BASED ON THE PROVIDED WSDLD FILE.

IZ55593 IMPACT FILTER ANALYZER THROWS AN ERROR IF THE FIELD'S VALUE HAS A SINGLE QUOTE CHARACTER (').

IZ55697 CVS COMMANDS ARE NOT WORKING AS INDICATED IN THE ADMIN GUIDE.

IZ56261 IF IDENTIFIER FIELD CONTENTS A BACKSLASH CHARACTER (\\) USING THE RETURNEEVENT().

IZ57382 IMPACT EVENTREADER CONNECTION TO OBJECTSERVER TIMES OUT IN 5.1.

IZ57610 THE COMMANDRESPONSE MODULE FAILS WITH JAVA.IO.IOEXCEPTION:

IZ58040 DATA SOURCE FILES (.DS) DO NOT INCLUDE THE JDCB DRIVER AFTER IMPORTING THEM FROM IMPACT 402.

IZ59235 IMPACT HIBERNATION BROKEN IF FUNCTION CALLED

IZ59258 IF IDENTIFIER FIELD CONTENTS A SINGLE QUOTE CHARACTER (') USING THE RETURNEEVENT()
FUNCTION FAILS TO UPDATE THE EVENT CORRECTLY.

IZ59267 IMPACT DOES NOT HANDLE THE HTTP SESSION TIME OUT PROPERLY WHEN XML DSA USES HTTPS.

IZ59942 OPERATOR VIEWS CORRUPTED CHARACTER IN SCALAR SHOWDATA.

IZ60602 IMPACT 5.1 - EXCEPTIONS GENERATED WHEN USING POLICY ACTIVATOR WITH AUTOMATIC STARTUP OPTION

IZ60743 NCI_CVS_REMOVE NOT WORKING ON WINDOWS.

IZ62290 NCI_EXPORT IS NOT WORKING ON WINDOWS OS

IZ65396 EVENT READER DOES NOT RESTART PROPERLY AND FAILS TO READ EVENTS

IZ66797 ORACLE DATA SOURCE DOES NOT GET MIGRATED CORRECTLY INTO IMPACT 5.1.1

IZ69135 DATASOURCE STATUS EVENTS IN SELFMONITORING (IMPACT 5.1) DO NOT GET DEDUPLICATED.

IZ67283 IMPACT UNABLE TO ENRICH/HANDLE EVENTS WHERE THE IDENTIFIER
CONTAINS A SINGLE QUOTE CHARACTER (') AT THE END OF THE STRING.

IZ70101 MEMORY INCREASING - UNABLE TO CLEAR ONE BLOCK OF EVENTS FROM PERSISTING

IZ68649 IMPACT 5.1.1 POLICYLOGGER LOGGING WITH SQL WHEN POLICY NAME AND/OR THREAD
NUMBER IS ADDED TO THE POLICYLOGGER LOGFILE NAME

IZ68908 NO VERTICAL SLIDE BAR TO MOVE UP AND DOWN TO VIEW A POLICY WHICH IS "LOCKED"
BY ANOTHER USER, ONLY AN ISSUE ON IE 6

IZ68912 BLOCK TEXT SELECTING DOESN'T EXPAND WITH ARROW KEYS WHEN USING THE POLICY EDITOR ON IE 6.

IZ67539 SCRIPT FOR ADDING OBJECT SERVER TO VMM IS POINTING TO THE WRONG JAR FILE

IZ72296 HIBERNATION FUNCTION UNABLE TO DO SERIALIZATION ON ORGNODE

IZ60529 ORACLE JDBC DRIVER DOES NOT WORK PROPERLY WITH CONCURRENCY STATEMENTS

IZ63815 EVENTREADER CONFIGURATION WINDOW DISPLAYED INCORRECTLY IN FIREFOX
WHEN MORE THEN 3 MAPPINGS ARE USED

IZ75489 SECOND SNMP TABLE DATA TYPE DOES NOT WORK

IZ75488 DSA RETURNS LAST ROW FOR EACH ROW QUERIED

IZ75804 SNMP Table Performance is very slow



5.2.1 List of APARs that Fixed as TechNotes.
The following APARs are fixed as TechNotes. There is no code fix available in the Fix Pack.


WI 39489 eWAS.bat usage information needed to be updated.

ewas.bat
Controls the embedded version of the WebSphere Application Server
SYNTAX: ewas.bat <start|stop>

"start|stop - will either start or stop the server"

EXAMPLES:

Start the server process
ewas.bat start

Stop the server process
ewas.bat stop -username "XXXX" -password "YYYY"

help
ewas.bat --help

NOTE: The default username and password for the stop command is "wasadmin / netcool"


IV12043 USING EVENTREADER ENABLE EVENTLOCKING WITHOUT AN EXPRESSION CAUSES AN ERROR AND FAILS TO PROCESS EVENTS.
Selecting the Enable EventLocking button on an EventReader without setting an Expression causes the error. The following text was added to the documentation under event locking: Note: You must set an event locking expression in order to use this feature.
Event locking depends on at least one or more fields to determine the order of processing the events.



IV24423 GETHTTP API HTTPPROPERTIES PARAMETERS NEED DOCS

The GetHTTP function needs documentation for the HTTPProperties. Here are all of the properties:

HTTP properties are created by creating NewObject containing name value pairs. The valid variables are:

ConnectionTimeout - Sets the timeout until a connection is etablished. A
value of zero means the timeout is not used. The default
value is zero

ResponseTimeout - Sets the default socket timeout (SO_TIMEOUT) in
milliseconds which is the timeout for waiting for data. A timeout value
of zero is interpreted as an infinite timeout.

AuthenticationHost - the host the credentials apply to. May be set to
null if credenticals are applicable to any host

AuthenticationPort - the port the credentials apply to. May be set to
negative value if credenticals are applicable to any port.

AuthenticationScheme - the authentication scheme the credentials apply
to. May be set to null if credenticals are applicable to any
authentication scheme.

Basic
Basic authentication is the original and most compatible
authentication scheme for HTTP. Unfortunately, it is also the least
secure as it sends the username and password unencrypted to the
server.

Digest
Digest authentication was added in the HTTP 1.1 protocol and while
not being as widely supported as Basic authentication there is a
great deal of support for it. Digest authentication is significantly
more secure than basic authentication as it never transfers the
actual password across the network, but instead uses it to encrypt a
"nonce" value sent from the server.

AuthenticationRealm - the realm the credentials apply to. May be set to
null if credenticals are applicable to any realm.

UserId: The user name.

Password: The password.

Link: http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp?topic=%2Fcom.ibm.netcoolimpact.doc5.1.1%2Fpolicy%2Fimpr_action_gethttp_c.html


IV27156 HIBERNATE IMPACT 5.1.1 DOC FUNCTION EXAMPLE IS MISSING REMOVEHIBERNATION(ACTIONKEY); LINE
The example was changed from:

// Call Hibernate and pass an action key and the number of seconds
// to hibernate as input parameters
ActionKey = "ActionKey" + GetDate();
TimeOut = 60;
Hibernate(ActionKey, NULL, Timeout);

to the following:

// Call Hibernate and pass an action key and the number of seconds
// to hibernate as input parameters
ActionKey = "ActionKey" + GetDate();
TimeOut = 60;
Hibernate(ActionKey, null, TimeOut);
RemoveHibernation(ActionKey);

Link to the technote: http://www-01.ibm.com/support/docview.wss?uid=swg21612459


IV27965 NEED TO DOCUMENT THAT FILTER CHANGES REQUIRE A RESTART OF THE EVENTREADER SERVICE, IF IT'S RUNNING AT THE TIME.
The docs state that you need to Press OK after changing an event filter for an Event Reader. When doing this, the change does not take affect. You need to restart the Event Reader for the change to take affect.



IV17558 [Document] IMPACT DOESN'T SUPPORT REF CURSOR FOR PASSING IN PARAMETERS
A technote FAQ has been added to address the fact that a ref cursor cannot be used as an input parameter for the CallStoredProcedure function. This technote can be found:
http://www-01.ibm.com/support/docview.wss?uid=swg21591352

IV16518 [Documentation] SILENT INSTALL WILL NOT WORK IF USING IP FOR NAMESERVER_HP.
A technote troubleshooting note has been added to address the situation where the silent installation fails if IP address of Name Server is used.



IV31225 SEND A MESSAGE TO A JABBER CHAT ROOM AND AVOID A 15 SEC TIMEOUT
1. We now allow the user to provide a password for a jabber groupchat. To do this, you need to set the variable GroupChatPassword in the policy, before calling SendInstantMessage to send to groupchat message.
(I think this can go in the section that documents the SentInstanceMessage function).

2. If you want to receive messages from a groupchat to a Jabber reader service, you need to add the following property to the props file of the jabber reader service (in the impact/etc directory):
impact.<jabberreadername>,groupchatroom=<chatroom>@jabberserver
Impact must be restarted for this change to take affect




IV30383: CANNOT AUTHENTICATE TO OBJECTSERVER WITH SSL IN IMPACT511
The new step added is to run confvmm4ssl.[sh/bat], which should now exist in the same $NCHOME//etc/tivoli-vmm4ncos/bin.



IV30467: ORACLE DSA NOT CORRECTLY RESOLVING STORED PROCEDURE WHERE: 511THERE ARE MULTIPLE INSTANCES OF THE SAME NAMED STORED PROCEDURE
The docs do not mention the scenario where there are multiple procedures with the same name in different packages. If automatic schema discovery is not disabled and the policy invokes CallStoredProcedure with procedure name argument set to <packagename>.<procedurename> then Impact will throw an error when it tries to discover the schema.



IV30041: CHANGING THE ORACLE LDAP DATA SOURCE TO USE A JDBC LDAP URL TO OBTAIN A CONNECTION TO ORACLE
Impact claims support for an Oracle LDAP connection, meaning you can configure a datasource in Impact by specifying configuration information for LDAP without exposing the Oracle host and port. The implementation of this feature required a java.sql.Datasource object to be bound in the LDAP server, which is completely unintuitive to the user, and in the cases of many LDAP implementations (such as Active Directory) very difficult to do. The aim of this APAR is to support the straightforward way of obtaining an Oracle connection through LDAP, using a url of the form: jdbc:oracle:thin:@ldap://<ldaphost>:<ldapport>/<ServiceName>,cn=OracleContext,DC=oracle,dc=support,dc=com

Link to the technote: http://www-01.ibm.com/support/docview.wss?uid=swg21620703


5.2.2 List of APARs that Fixed as TechNotes in FP1.
The following APARs are fixed as TechNotes. There is no code fix available in the Fix Pack.

IZ54766 COMPARISONS OF OBJECT SERVER FIELDS IN EVENT READER FILTERS
Filter Analyzer only supports the comparison of Strings,
other Object Comparisons are not supported.

Tech Note link is:
http://www-01.ibm.com/support/docview.wss?uid=swg1IZ54766


IZ55217 JREXEC PROPS FILE OPTIONS ARE BEING DISREGARDED
To change the port used by Tivoli Netcool/Impact for the JRExecServer:
1. Edit the file $NCHOME/impact/etc/jrexecserver.props
Change the property impact.jrexecserver.port=<any port: 1024
to port 6536>
2. Edit the file $NCHOME/impact/etc/<server Name>_server.props
Change the property impact.jrexecserver.port=<the port set in
jrexecserver.props>
3. Restart server
4. Start jrexec service.
5. Check that jrexec start on the new port.

TechNote link is:
http://www-01.ibm.com/support/docview.wss?uid=swg1IZ55217


IZ70788 SUBVERSION MECHANISM CREATED CORE DUMP DURING
ANY ACTION ON AIX 6.1 TL4

Tech Note link is:
http://www-01.ibm.com/support/docview.wss?uid=swg1IZ70788


5.3 eWAS Fixes and Upgrades

Please Note: When updating eWAS, any IBM product service that uses the eWAS should be set to Manual start and the machine
should be rebooted before the Update. You must confirm that the services did not start before running the install and ensure you backup
the eWAS using the backupConfig command

Netcool/Impact Fix Pack 0002 was tested and verified on
WebSphere Application Server (eWAS) 6.1 Fix Pack 43

Recommend use of WebSphere Application Server (eWAS) 6.1 Fix Pack 6.1.0.45 for Solaris installs

Please follow the instruction if you want to perform the upgrade:

1 - If you do not have the UpdateInstaller tool for WebSphere Application
Server - download and install it from.

http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24012718

2 - Install the eWAS and WASSDK packages

o Run the backupConfig command to back up configuration files.
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tcfg_svr_conf_backup.html

o Stop all application server processes.
The product might not continue to operate successfully if you attempt to
install Fix Pack while embedded WebSphere Application Server related Java
processes are still running.

o Download the eWAS and WASSDK maintenance packages from
http://www-01.ibm.com/support/docview.wss?uid=swg21404665

Place both maintenance pack files into the update installer maintenance directory:

<updi_install_root>/maintenance, where <updi_install_root> is the installed
location of the Update installer.

o To install downloaded maintenance packages

Open a command shell window and change directories to the
<updi_install_root> install location of the Update Installer.
cd <updi_install_root>

Use the "update" command to install the maintenance package that you
downloaded into <updi_install_root>/maintenance directory.

For Windows
update.bat

For Linux or UNIX platforms:
./update.sh

The logs for update will be available in <appsrv_install_root>/logs/update
folder.

Please point the installer to the $NCHOME\eWAS directory

Refer to the following file for detailed information on the use of the
"update" command, including silent mode installation.
<updi_install_root>/docs/readme_updateinstaller.html

3 - Verify the eWAS version after fix pack installation:

# for AIX, HP-UX, Solaris and Linux, open a login shell
cd <eWAS_install_location>/bin
./versionInfo.sh

# for Windows open a command prompt:
cd <eWAS_install_location>\bin
versionInfo.bat

4 - Proceed to restart your eWAS.


================
6.0 Known issues
================

Please refer to Netcool/Impact 5.1.1 documentation for additional information

* Users who are using Microsoft Internet Explorer Vesrion 6 are required to install Service Pack 3 and up

* Due to JavaScript changes, Users will be unable to access the GUI on Firefox unless they clear the cache before they
login to Netcool/Impact 5.1.1 Fix Pack 0002
1) In Firefox, select Tools-->ClearRecentHistory-->Cache
2) Login to GUI again.

* Some of the information panels in Fix Pack Installer show English text for a non-English installation

* XinY Data Type throws an Exception if you try to edit one of the Data Items in the Data Items Viewer.
Local Fix: Use Action Policy BatchUpdate to update the items if necessary.

=======================================
7.0 Copyright and trademark information
=======================================

http://www.ibm.com/legal/copytrade.shtml

7.1 Notices

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Some jurisdictions 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. IBM may
make improvements and/or changes in the product(s) and/or the program(s)
described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft
Corporation in the United States, other countries, or both.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino,
Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and
Pentium are trademarks or registered trademarks of Intel Corporation or
its subsidiaries in the United States and other countries.

Other company, product, or service names may be trademarks or service
marks of others.

Please read THE IBM Tivoli Netcool/Impact v4.0.2 NOTICES AND INFORMATION
in the file notices1.txt included in this Fix Pack before you proceed
with the download and installation of this Fix Pack. You can find the
additional notices file on the same webpage as this Fix Pack.

7.2 THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices and
other information IBM must provide to you under its license to certain
software code. The relevant terms and conditions, notices and other
information are provided or referenced below. Please note that any
non-English version of the licenses below is unofficial and is provided
to you for your convenience only. The English version of the licenses
below, provided as part of the English version of this file, is the
official version.

Notwithstanding the terms and conditions of any other agreement you may
have with IBM or any of its related or affiliated entities (collectively
"IBM"), the third party software code identified below are "Excluded
Components" and are subject to the following terms and conditions:

* the Excluded Components are provided on an "AS IS" basis
* IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT
NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND
THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE
* IBM will not be liable to you or indemnify you for any claims related
to the Excluded Components
* IBM will not be liable for any direct, indirect, incidental, special,
exemplary, punitive or consequential damages with respect to the
Excluded Components.

IBM obtained Smack V2.2.1 under the following license from Apache Software Foundation:

Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by,
or are under common control with that entity. For the purposes of this definition, "control" means (i) the power,
direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or
(ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications, including but not limited to software source code,
documentation source, and configuration files.

"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form,
including but not limited to compiled object code, generated documentation, and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated
by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and
for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original
work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable
from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications
or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in
the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner.
For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to
the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code
control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing
and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by
the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received
by Licensor and subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to
You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare
Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works
in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a
perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license
to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to
those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by
combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent
litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution
incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You
under this License for that Work shall terminate as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or
without modifications, and in Source or Object form, provided that You meet the following conditions:

(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark,
and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute
must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that
do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file
distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative
Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear.
The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own
attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the
Work, provided that such additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in
the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have
executed with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the
Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor
provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including,
without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated
with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor
be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising
as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been
advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and
charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License.
However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other
Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims
asserted against, such Contributor by reason of your accepting any such warranty or additional liability.


Prerequisites

IBM Tivoli Netcool/Impact version 5.1.1

Installation Instructions

============================
3.0 Installation information
============================

3.1 Dependencies

IBM Tivoli Netcool/Impact version 5.1.1.

This Fix Pack is applied to Tivoli Netcool/Impact 5.1.1 Server and the GUI Server of Tivoli Netcool/Impact.
Impact 5.1.1 GA is required.

3.2 Special considerations

To apply this Fix Pack you will need 500 Mb of free disk space.

For UNIX

1. Backup the current server using the command:
$NCHOME/impact/bin/nci_export <serverInstanceName> <absolute path
directory>

For example:
$NCHOME/impact/bin/nci_export NCI /tmp/exports/NCI_exports

2. Backup the current jar file:
$NCHOME/impact/lib/nci200910231929v5.1.1b114.jar using the command:
cp $NCHOME/impact/lib/nci200910231929v5.1.1b114.jar $NCHOME/impact/tmp/

For Windows

1. Backup the current server using the command:
%NCHOME%\impact\bin\nci_export.bat <serverInstanceName> <absolute path
directory>

For example:
C:\%NCHOME%\impact\bin\nci_export.bat NCI C:\tmp\exports\NCI_exports

2. Backup the current jar file:
%NCHOME%\impact\lib\nci200910231929v5.1.1b114.jar using the command:
copy C:\%NCHOME%\impact\lib\nci200910231929v5.1.1b114.jar C:\%NCHOME%\impact\tmp\


3.3 Extracting Fix Pack files

3.3.1 Extracting on Linux, Solaris, AIX, and HP-UX platforms
1. Copy the 5.1.1-TIV-NCI-FP0002.<ARCH>.tar.gz file to your system.
2. Unpack the file using these commands:
* gunzip 5.1.1-TIV-NCI-FP0002.<ARCH>.tar.gz
* tar -xvf 5.1.1-TIV-NCI-FP0002.<ARCH>.tar

3.3.2 Extracting on Windows platforms
1. Copy the 5.1.1-TIV-NCI-FP0002.zip to your system.
2. Extract the contents of the file to a selected directory.


3.4 Installation in Cluster Environment
To install Netcool/Impact 5.1.1 FP0002 in cluster environment in different machines:
1) Install it in the primary server (see section 3.7)
2) Stop the primary server, using ewas stop command, so that the secondary server becomes primary
3) Please follow the instructions in the following flash/alert:

http://www-01.ibm.com/support/docview.wss?uid=swg21439209

3.5 Custom Jar Files Installation
If you are installing the fix in an Impact Server that includes custom jar(s)
such as JMS jars, DB2 jars, etc. please follow the instructions in the following alert/flash:

http://www-01.ibm.com/support/docview.wss?uid=swg21439258


3.6 Username and Password
IBM Netcool/Impact 5.1.1 Fix Pack 0002 uses the default password
for wasadmin username which is used by Netcool/Impact 5.1.1 GA version.
If the password was changed, it must be reverted back to default value.
You may contact Netcool/Impact support for the default password value.
To change the password, follow the instructions in the following link:

http://www-01.ibm.com/support/docview.wss?uid=swg21426040

3.7 Installation

[Fix Pack] Refers to the directory where you extracted the Fix Pack
files from the zip/tar file.

Attention: Install the Fix Pack with the same user that was used to
install TBSM 5.1.1

Follow this procedure to install the fix pack:
1. Make sure the Tivoli Netcool/Impact server is running.
2. On the Impact server host, change to the
[Fix Pack]/IMPACT directory where the you extracted the files.
3. Run the installation using one the following commands:
* setupwinFP0002-<build level>.exe - Windows.
* setup<ARCH>FP0002-<build level>.bin - other operating systems.

Installation command options:

GUI mode No options, for example: setupwinFP0002-<build level>.exe

Console mode
Use the -i console option. For example ./setup<ARCH>FP0002-<build level>.bin -i
console

Silent Mode

a. Copy installSilent_response.txt from the Impact directory of the extracted
Fix Pack file to a location it can be edited (/tmp).
b. Update the file to match your environment by following
the comments in the file text.
c. Run:

UNIX:setup<ARCH>FP0002-<build level>.bin -f /tmp/installSilent_response.txt
or

Windows: setupwinFP0002-<build level>.exe -f C:\tmp\installSilent_response.txt

Note: The response file needs to have a fully qualified
path.

Note: If you use this option and do not perform your own backup you
will have to reinstall the product if you encounter any
problems.

4. Restart all servers.

3.8 Post installation steps

1. After installation is complete, you may remove the Fix Pack files to save space.
2. To apply APAR IV20695 please find the name of your server. Go to Impact/policy and rename NCI_Opview_Add1TWin.ipl to <server_name>_Opview_Add1TWin.ipl.
If you are unsure of your server name do a search for *_server.props. The server name is whatever is returned by the *.


==========================
4.0 Additional information
==========================

Please refer to Tivoli Netcool/Impact 5.1.1 documentation for additional information

4.1 Versioninfo
Extra functionality has been added to allow the customer to pull current build information.
The user should have environment variables set to run this script:
WAS_HOME and NCHOME.
The script is run in the following manner:
$NCHOME/bin/versioninfo
or
cd %NCHOME%\bin
versioninfo.bat

4.2 Chart view

The chart view will not render a bar graph if only one data point is used. The legend and chart layout will render but a single data point will not be
displayed visually as a bar. Only when multiple data points are available (2+) will the bars be displayed within the chart.

[{"INLabel":"5.1.1-TIV-NCI-FP0002-aix","INLang":"English","INSize":"195734711","INURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=5.1.1-TIV-NCI-FP0002-aix&product=ibm%2FTivoli%2FTivoli+Netcool+Impact&source=dbluesearch"},{"INLabel":"5.1.1-TIV-NCI-FP0002-windows","INLang":"English","INSize":"182145384","INURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=5.1.1-TIV-NCI-FP0002-windows.zip&product=ibm%2FTivoli%2FTivoli+Netcool+Impact&source=dbluesearch"},{"INLabel":"5.1.1-TIV-NCI-FP0002-linux","INLang":"English","INSize":"182222337","INURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=5.1.1-TIV-NCI-FP0002-linux&product=ibm%2FTivoli%2FTivoli+Netcool+Impact&source=dbluesearch"},{"INLabel":"5.1.1-TIV-NCI-FP0002-solaris","INLang":"English","INSize":"205489082","INURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=5.1.1-TIV-NCI-FP0002-solaris&product=ibm%2FTivoli%2FTivoli+Netcool+Impact&source=dbluesearch"},{"INLabel":"5.1.1-TIV-NCI-FP0002-zlinux","INLang":"English","INSize":"192144581","INURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=5.1.1-TIV-NCI-FP0002-zlinux&product=ibm%2FTivoli%2FTivoli+Netcool+Impact&source=dbluesearch"},{"INLabel":"5.1.1-TIV-NCI-FP0002-hpux","INLang":"English","INSize":"203500607","INURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=5.1.1-TIV-NCI-FP0002-hpux&product=ibm%2FTivoli%2FTivoli+Netcool+Impact&source=dbluesearch"}]
On
[{"Product":{"code":"SSSHYH","label":"Tivoli Netcool\/Impact"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"--","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"}],"Version":"5.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Problems (APARS) fixed
IV35940;IV12778;IV26951;IV08840;IV11728;IV12282 ;IV12589 ;IV12043;IV18130;IV21219;IV20695 ;IV22560;IV22741;IV25900;IV26951;IV29936;IV30041 ;IV31226 ;IV19026 ;IV20367 ;IV21736 ;IV30383 ;IV19818 ;IV29981 ;IV21503 ;IV17284 ;IV19673 ;IV31225 ;IV18554 ;IV18060 ;IY97495 ;IZ35154 ;IZ40005 ;IZ40012 ;IZ60300 ;IZ60303 ;IZ60396 ;IZ61956 ;IZ62290 ;IZ62403 ;IZ62606 ;IZ63086 ;IZ63116 ;IZ64363 ;IZ64812 ;IZ65334 ;IZ65803 ;IZ66288 ;IZ66290 ;IZ51096 ;IZ51342 ;IZ51749 ;IZ53023 ;IZ53791 ;IZ53976 ;IZ54066 ;IZ55593 ;IZ55697 ;IZ56261 ;IZ57382 ;IZ57610 ;IZ58040 ;IZ59235 ;IZ59258 ;IZ59267 ;IZ59942 ;IZ60602 ;IZ60743 ;IZ62290 ;IZ65396 ;IZ66797 ;IZ69135 ;IZ67283 ;IZ70101;IZ68649;IZ68908;IZ68912;IZ67539 ;IZ72296;IZ60529 ;IZ63815 ;IZ75489 ;IZ75488 ;IZ75804 ;IV12043 ;IV24423 ;IV27156 ;IV27965 ;IV17558 ;IV16518;IV31225 ;IV30383;IV30467;IV30041;IZ54766;IZ55217 ;IZ70788

Document Information

Modified date:
15 June 2018

UID

swg24031659