IBM Support

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

Download


Abstract

This fix pack addresses problems reported in IBM Tivoli Netcool Impact V5.1.1

Download Description


Fix Pack 5.1.1-TIV-NCI-FP0003 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-FP0003.aix.tar.gz
HP-UX * 5.1.1-TIV-NCI-FP0003.HPUX.tar.gz
Linux * 5.1.1-TIV-NCI-FP0003.Linux.tar.gz
Solaris * 5.1.1-TIV-NCI-FP0003.Solaris.tar.gz
Windows * 5.1.1-TIV-NCI-FP0003.win.zip
zLinux * 5.1.1-TIV-NCI-FP0003.Linuxs390.tar.gz


all platforms * 5.1.1-TIV-NCI-FP0003.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


======================================
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



==========================
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.


4.3 How to configure a connection to a secure OMNIbus server.

It is now possible to connect to a secure OMNIbus server using an encrypted
password.

Proceed as follows:
1. Set up secure communications between the Impact and Omnibus
servers using documented SSL procedures.
2. Create an ObjectServer data source using valid credentials and
enable SSL Mode in the tick box.
3. Add the following three properties to the Impact server
server.props file:
(default is $IMPACT_HOME/etc/NCI_server.props)
impact.objectserver.securemode=true
impact.objectserver.secureusername=<omnibus username>
impact.objectserver.securepassword=<omnibus password>

Use the $IMPACT-HOME/bin/nci_encrypt utility to generate the
encrypted password. Include the {aes} prefix when pasting it
into the props file.
4. Restart the Impact server.



=================
List of APARs
=================

5.1.1 Fixes (APARs) Included In this Fix Pack.

APAR Description
IZ57782 SECURE OMNIBUS SERVER CONNECTIONS
It is now possible to connect to a secure OMNIbus server
using an encrypted password

IV33973 JMS READER DOES NOT CONVERT ACTIVEMQMAPMESSAGE DATA FOR
TRANSFER TO SECONDARY CLUSTER MEMBER
Serialization error when transferring a ActiveMQ JMS message
that contains an ActiveMQMapMessage from the primary Impact
server to the secondary Impact server.

IV35885 IMPACT NEEDS TO CHECK USER CREATED SERVICES, FOR WITH NAMES
THAT END WITH A "_SERVER"
When using the nci_compilewsdl tool the script is not able
to load the messages file and display information in the
configured language.

IV38045 ORACLE DSA ERROR FOR COLUMN NAMES WITH "DOUBLE-QUOTES" AND
"NOT-ALL-CAPS"

IV42715 ERROR WHEN USING # IN IMPACT FILTER FROM DATATYPE DATAITEMS
GUI WINDOW

IV45838 OBJECTSERVER CONNECTION DOES NOT RECOVER FROM BUSY PERIOD IF
SELFMONITORING (DATASOURCE MONITORING) IS ENABLED
If a customer is monitoring an object server datasource and
this is the same datasource where the event reader is sending
the events, sometimes when the object server is busy or
unavailable, impact is not able to connect to it when it
becomes available and the event reader is not able to send
events

IV46493 ATTEMPTING TO USE DATATYPE FILTERS - "SPECIAL" CHARACTERS
BEING CONVERTED TO HTML ENCODING THAT BREAKS OUTGOING SQL

IV46851 IMPROVE ROBUSTNESS OF JABBER SERVICE WHEN JABBERSERVER GOES
DOWN
High CPU usage when the jabber server that the jabber
service is connected to goes down.

IV47748 CAN'T LOAD WEBSERVICE LIBRARIES THAT HAVE JAVA OR JAVAX
PACKAGES IN THEM
Webservices that include jars from the java or javax class
path are not usable in Impact web service policies.

IV48382 OPVIEW_ADD1TWIN ERROR WHEN DELETING EXPIRED WINDOW IN MWM
If the Impact cluster name is different from default one
(NCICLUSTER) and try to delete the expired windows on MWM it
will fail with following error:

Could not find the file specified in the URL:
NCICLUSTER-onetwins.html

IV50058 IMPACT SERVER FAILS TO WORK PROPERLY WITH ANY SPACES IN
CONFIGURABLE PROPS FILES
If any of the configurable props or datasource files contain
spaces, they were not being read correctly.

IV50329 WEBSERVICES SECURITY NOT FUCTIONAL
Web Services WSS security is not functional.

IV51062 DB2 DSA FAILS TO QUERY COLUMN NAMES WITH "DOUBLE-QUOTES AND
NOT-ALL-CAPS"

IV52828 DEPLOY FUNCTION DOESN'T DEPLOY ADD ON PROPERTIES
Extra properties that are added to JMS data sources to
enable SSL connections are not included in the datasource
props file after the datasource has been deployed.

IV53320 BRACKETS ARE GETTING REPLACED WITH &\#41; CHARACTERS IN THE
DATASOURCE FILE

IV53717 JMS MESSAGE LISTENER SERVICE NOT STOPPING PROPERLY
When the JMS Listener is connected to the TIBCO JMS bus, the
Listener can still process messages when the JMS Listener
service stopped.

IV53981 WEBSERVICE .JAR FILES CORRUPTED ON SECONDARY IMPACTSERVER
DURING CLUSTER SYNC
When the secondary Impact server is started and cluster
synchronization occurs, the wslib files get corrupted.

IV56381 'GETBYLINKS'RETURNS 'NULL' AGAINS XSD SCHEMA
When using an xsd schema with a recursivity on a component,
the XML DSA will not load the component

IV59481 UNABLE TO SEND HIBERNATIONS TO CLUSTER MEMBERS WHENEVER
DIRECTSQL IS BEING USED
When running a policy in a clustered environment that uses
DirectSQL and Hibernations, some of the policies will have
Serialization errors and can't be saved

IV59920 NO MEANS OF ENCRYPTING IMPACT.OBJECTSERVER.SECUREPASSWORD
THAT WILL ALLOW AUTHENTICATION TO AN OBJECT SERVER USING FIPS

IV61084 IMPACT 5.1.1 POLICY - SOME HTML CHARACTERS ARE NOT BEING
CONVERTED TO CORRECT CHARACTERS
When impact logs the html characters, the html characters
are not translated to normal characters.

IV66337 WEBSERVICE LISTENER POLICY STRING VALUE PARAMETERS CAN'T
ACCEPT MULTIPLES LINES ENTRIES AND SOME SPECIAL CHARACTERS
When the customer enters multiples lines of text as value
for the policy user parameter, the policy fails with an
error

IV68383 DEBUG FLAG GENERATES MEMORY ISSUES WHEN NON OMNIBUS EVENTS
ARE PROCESSED

IV68934 FORMAT 'STRING' GETS CHANGE TO 'LONG' WHEN USING GETBYFILTER

IV70712 OPVIEW LOGIN DOESN'T ALLOW USERS TO ENTER PASSWORD CHARACTER
LENGTH LONGER THAN 16 CHARACTERS
Opview does not accept passwords longer than 16 characters.

IV70962 WHEN USING THE DATA ITEM GUI EDITOR TO EDIT THE FILTERSTAT
FIELD THE DATA ITEM IN THE MM_WINDOWS TABLE IS INCORRECT

IV75913 ABLE TO ACCESS ITEMS IN SCRIPTS DIRECTORY WITHOUT
AUTHENTICATION




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

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)

- see TechNote 1499750 "EventReader radio button issue":
http://www-01.ibm.com/support/docview.wss?uid=swg21499750


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 analyzer to verify a policy, it fails with an error if the filter contains a non-standard character.


5.1.3 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 additional
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 established. 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 credentials are applicable to any host

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

AuthenticationScheme - the authentication scheme the credentials apply
to. May be set to null if credentials 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 credentials 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);



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.
Contrary to what the Netcool/Impact 5.1.1 documentation claims, if you use the IP address of the Name Server instead of the fully qualified name in the silent installation response file, the installation fails. If you use the IP address of the Name Server instead of its fully qualified name in the silent installation response file, the installation fails.Do not enter the IP address of the Name Server in the NAMESERVER_HP parameter in the response file. Use the fully qualified name of the Name Server instead.



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 0003 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.


================
Known issues
================

Please refer to Netcool/Impact 5.1.1 documentation for additional
information

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

* Users who are using Microsoft Internet Explorer Version 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 0003
1) In Firefox, select Tools-->ClearRecentHistory-->Cache
2) Login to GUI again.

* This Fix Pack was tested with Internet Explorer 11 in compatibility
view mode only.

When accessing the GUI with IE 11, compatibility view mode is
required!

To enable compatibility view, first open up Internet Explorer and
access your Impact instance. Then click the Tools button in the top
right hand corner of the browser (Or use Alt+X) and then select
Compatibility View Settings. In the Compatibility View Settings
window, click the "Add" button to add the site to Compatibility View
and then click "Close". You may need to restart your browser for the
changes to occur.

* 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.

* The "Tivoli Netcool/Impact 5.1.1>Version 5.1.1>Administration
Guide>Self-monitoring>Data source status monitoring>Data source status
events" section contains the following information for Data source
status events:

http://www.ibm.com/support/knowledgecenter/SSSHYH_5.1.1/com.ibm.netcoolimpact.doc5.1.1/admin/imag_monitor_data_source_status_events_c.html

Data source status events
.......
Failed execution of an SQL query against a data source

SQL queries are sent to data sources under a variety of conditions
(for example, when it process a function like GetByFilter or
AddDataItem in a policy or when you view the contents of a data type
in the GUI). If an SQL query fails, another attempt is made to send
the query to the database server. If the second attempt fails, the
self-monitoring service sends an event to the Object Server with a
severity of 4.

Adding the following note:

NOTE:
(* failed SQL queries on Objectserver datasources are not reported on.)

* When editing a policy in the policy editor, users need to use the
system shortcut keys (ctrl+X, ctrl+C, ctrl+V) to "cut", "copy" or
"paste"

* Impact stops reading events from OMNIbus through EventReader.
If there are Policy error messages (such as DB failure, Concurrency
failure, etc) and if a restart of Impact resolves the issue; then
the root cause is likely that the MAXSQLCONNECTION is too low!

Please refer to the following Technote, to address the issue:


http://www.ibm.com/support/docview.wss?uid=swg21515550

Prerequisites

IBM Tivoli Netcool Impact 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/nci<date>v5.1.1b<build>.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\nci<date>v5.1.1b<build>.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-FP0003.<ARCH>.tar.gz file to your system.
2. Unpack the file using these commands:
* gunzip 5.1.1-TIV-NCI-FP0003.<ARCH>.tar.gz
* tar -xvf 5.1.1-TIV-NCI-FP0003.<ARCH>.tar

3.3.2 Extracting on Windows platforms
1. Copy the 5.1.1-TIV-NCI-FP0003-win.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 FP0003 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 0003 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 Impact 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:
* setupwinFP0003-<build level>.exe - Windows.
* setup<ARCH>FP0003-<build level>.bin - other operating systems.

Installation command options:

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

Console mode
Use the -i console option. For example ./setup<ARCH>FP0003-<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>FP0003-<build level>.bin -f /tmp/installSilent_response.txt
or

Windows: setupwinFP0003-<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 *.

On
[{"DNLabel":"5.1.1-TIV-NCI-FP0003-aix","DNDate":"20 Sep 2015","DNLang":"English","DNSize":"194748627","DNPlat":{"label":"AIX","code":"PF002"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=5.1.1-TIV-NCI-FP0003-aix&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"5.1.1-TIV-NCI-FP0003-Linuxs390","DNDate":"20 Sep 2015","DNLang":"English","DNSize":"191308852","DNPlat":{"label":"z/OS","code":"PF035"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=5.1.1-TIV-NCI-FP0003-Linuxs390&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"5.1.1-TIV-NCI-FP0003-Solaris","DNDate":"20 Sep 2015","DNLang":"English","DNSize":"204480688","DNPlat":{"label":"Solaris","code":"PF027"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=5.1.1-TIV-NCI-FP0003-Solaris&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"5.1.1-TIV-NCI-FP0003-win","DNDate":"20 Sep 2015","DNLang":"English","DNSize":"181290879","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=5.1.1-TIV-NCI-FP0003-win&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"5.1.1-TIV-NCI-FP0003-HPUX","DNDate":"20 Sep 2015","DNLang":"English","DNSize":"202488945","DNPlat":{"label":"HP-UX","code":"PF010"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=5.1.1-TIV-NCI-FP0003-HPUX&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"5.1.1-TIV-NCI-FP0003-Linux","DNDate":"20 Sep 2015","DNLang":"English","DNSize":"181417096","DNPlat":{"label":"Linux","code":"PF016"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=5.1.1-TIV-NCI-FP0003-Linux&source=SAR","DNURL_FTP":" ","DDURL":null}]
[{"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"},{"code":"PF035","label":"z\/OS"}],"Version":"5.1.1","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Problems (APARS) fixed
IZ57782 IV33973 IV35885 IV38045 IV42715 IV45838 IV46493 IV46851 IV47748 IV48382 IV50058 IV50329 IV51062 IV52828 IV53320 IV53717 IV53981 IV56381 IV59481 IV59920 IV61084 IV66337 IV68383 IV68934 IV70712 IV70962 IV75913;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

Document Information

Modified date:
15 June 2018

UID

swg24036880