IBM Support

IBM Tivoli Netcool/Impact V6.1.1 Fix Pack 5 (6.1.1-TIV-NCI-FP0005)

Download


Abstract

This Fix Pack addresses problems reported in IBM Tivoli Netcool/Impact 6.1.1

Download Description

Notice: IBM will withdraw support for the Tivoli Netcool/Impact versions 6.1.x versions licensed under the IBM International Program License Agreement.
https://www-01.ibm.com/support/entdocview.wss?uid=swg22009215

IBM recommends upgrading to later versions of Tivoli Netcool/Impact 7.1.x as soon as possible in order to maintain full support.

Tivoli Netcool/Impact 6.1.* uses IBM Java v6 and IBM Websphere Application Server v7
IBM SDK v6 has been announce End Of Service Sept 2017.
https://developer.ibm.com/javasdk/support/lifecycle/
This means that IBM will no longer make fixes generally available for Java v6.

IBM Websphere Application Server v7 will be withdrawn April 2018. See related Websphere Application Server Software Withdrawal notice:
https://www-01.ibm.com/common/ssi/cgi-bin/ssialias?subtype=ca&infotype=an&appname=iSource&supplier=897&letternum=ENUS916-143

See link for information on Tivoli Netcool/Impact v7.1.0:
https://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0/com.ibm.netcoolimpact.doc_7.1/welcome_kc.html



======================================================================
Readme file for: IBM Tivoli Netcool/Impact
Product/Component Release: 6.1.1
Update name: Fix Pack 5
Fix ID: 6.1.1-TIV-NCI-FP0005
IBM Corp.
Publication date: November 3, 2017
Last modified date: October 31, 2017

Attention: You can always find the most current version of the readme file online.

Publish date is subject to change at any time without notices
======================================================================


Contents:

1.0 Files included in this Fix Pack
2.0 Hardware and software requirements
3.0 Installation information
3.1 Dependencies
3.2 Prerequisites
3.3 Special considerations and Notices
3.4 Superceded Fixes
3.5 Extracting Fix Pack files
3.6 Installation in a Cluster Environment
3.7 Installation of the Fix Pack
3.8 Uninstalling the Fix Pack
3.9 Recovering from a failed Fix Pack installation
3.10 Policies overwritten by this Fix Pack
3.11 Discovery Library Toolkit
3.12 "Service Level Objectives (SLO) Reporting" function
4.0 Additional information
5.0 List of APARs
5.1 Fixes (APARs) Included In this Fix Pack.
6.0 New support and features
6.1 Additional Browser Support with Fix Pack 5
Additional Browser Support with Fix Pack 4
Additional Browser Support with Fix Pack 3
Additional Browser Support with Fix Pack 2
Additional Browser Support with Fix Pack 1
6.2 Additional Platform support with Fix Pack 5
Additional Platform support with Fix Pack 4
Additional Platform support with Fix Pack 3
Additional Platform support with Fix Pack 2
Additional Platform support with Fix Pack 1
6.3 eWAS Fixes and Upgrades
6.4 Enhancements in Fix Pack 5
Enhancements in Fix Pack 4
Enhancements in Fix Pack 3
Enhancements in Fix Pack 2
Enhancements in Fix Pack 1
6.5 Deprecated features in Fix Pack 5
Deprecated features in Fix Pack 4
Deprecated features in Fix Pack 3
Deprecated features in Fix Pack 2
Deprecated features in Fix Pack 1
6.6 MSN support in Fix Pack 1
7.0 Known Issues in Fix Pack 5
7.1 Auto saved Policies not cleaned up
7.2 Unable to save ObjectServer DataType when the
Impact server name is long
7.3 WEBSERVICES SECURITY NOT FUNCTIONAL
7.4 If using WEBSERVICES SECURITY (WSS) user authentication
7.5 Microsoft Internet Explorer 11
7.6 Change the cursor sensitivity for DB2 JDBC Connections
8.0 Copyright and trademark information


===================================
1.0 Files included in this Fix Pack
===================================

This Fix Pack is a cumulative Fix Release, addressing APARs and
internally found issues post-dating the release of IBM Tivoli
Netcool/Impact version 6.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 * 6.1.1-TIV-NCI-FP0005-aix.tar
Linux * 6.1.1-TIV-NCI-FP0005-linux.tar
Solaris * 6.1.1-TIV-NCI-FP0005-solaris.tar
Windows * 6.1.1-TIV-NCI-FP0005-windows.zip
Linux for * 6.1.1-TIV-NCI-FP0005-zLinux.tar
System z

all platforms * 6.1.1-TIV-NCI-FP0005.README


Note: The installer only works for 64 bit 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
* zLinux


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

For information about supported operating systems and software, see
System requirements or see Planning, Setting up a deployment,
System requirements in the Netcool/Impact Administration Guide PDF.

http://www.ibm.com/support/knowledgecenter/SSSHYH_6.1.1.5/com.ibm.netcoolimpact.doc/common/dita/imp_hardware_requirements.html

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

Please refer to Tivoli Netcool/Impact 6.1.1 Documentation for
additional information


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

5.1 Fixes (APARs) Included In this Fix Pack
---------------------------------------

The following IMPACT APARs are delivered with Fix Pack 5:

IV73243: XSS ISSUE IN PROJECTNAME PARAMETER
IV75005: TBSM SERVER WILL NOT STARTUP WITH ITCAM FOR TRANSACTIONS
IV76521: UI DATA PROVIDER DOES NOT PRESERVE PROVIDER/SOURCE ON EDIT
IV78197: NCI_STARTSVN DOESN'T HANDLE .JS POLICIES
IV79350: EXCEPTION HANDLER UNABLE TO CATCH EXCEPTION WHEN POLICY IS EXECUTED FROM AN OPERATOR VIEW
IV79363: STARTING TIME FOR POLICY ACTIVATOR SERVICES IS NOT CORRECTLY LOGGED
IV80613: WITH IMPACT POLICY, OUTPUT OF SNMPGETNEXTACTION IS GARBLED
IV80747: THE PARAMETER SECURITYTOKENFROMREQUEST HAS THE SESSION INFORMATION
IV85196: COMMANDLINEMANAGER SERVICE DOESN'T STOPS ON SECONDARY IMPACT SERVERS
IV86919: IMPACTDB/DERBY DATABASE PROBLEMS IN CLUSTER
IV87164: POLICY ACTIVATORS RUNS TWICE IF RESTARTED WHILE POLICY RUNNING *HIGH*
IV87831: OUT-OF-THE-BOX JARS COPIED FROM THE SOURCE SERVER WHEN MIGRATING
IV89467: BACKUP DERBY NOT STARTING IN SLAVE MODE
IV91142: SERVER LOAD INCREASE AFTER UPGRADE TO 611 FP4


The following IMPACT APARs are delivered with Fix Pack 4:

IV59728: IMPACT SECONDARY IS NOT SHUTTING DOWN IF RESYNC WITH PRIMARY FAILS
IV59840: Jabber Service sending GroupChat message not received when accounts and groups are hosted on Cisco XMPP server
IV66337: WEBSERVICE LISTENER POLICY STRING VALUE PARAMETERS CAN'T ACCEPT MULTIPLES LINES ENTRIES AND SOME SPECIAL CHARACTERS
IV66441: NULLPOINTER EXCEPTION DURING REPLICATION
IV68163: IMPACT UNABLE TO STOP PROPER HAD TO KILL THE SERVICE
IV71068: JREXECACTION FAILS WHEN IMPACT.SERVER.SSL_ENABLED=TRUE
IV72091: GETBYFILTER UNABLE TO HANDLE DBCS DATA
IV72561: JAVA.LANG.RUNTIMEEXCEPTION: NO CONTEXT ASSOCIATED WITH CURRENT THREAD
IV72673: UNHANDLED EXCEPTION: ORA-01003: NO STATEMENT PARSED
IV74071: CPU USAGE INCREASING DUE TO REGEX LOOPING
IV74421: MEMORY LEAK DUE TO EVENT READER CHECK POINT"
IV74485: DATABASEEVENTREADER USES INCORRECT DATE FORMAT ON RESTARTING
IV75602: DERBY REPLICATION DOES NOT WORK CONSISTENTLY BETWEEN IMPACT CLUSTER MEMBERS
IV75913: ABLE TO ACCESS ITEMS IN SCRIPTS DIRECTORY WITHOUT AUTHENTICATION
IV77882: MDVREGR - LIKE COMPARISON OPERATOR IN A POLICY NOT WORKING
IV79004: DIRECTSQL ON OPERATOR VIEW POLICY DOESN'T WORK AFTER FP1
IV79769: SERVICE LEVEL OUTAGES(SLO) CALCULATED INCORRECTLY : REGRESSION
IV79910: REXTRACTALL FUNCTION DOES NOT RETURN MATCHING CONTENT :REGRESSION
IV80388: THE "COMMONS-FILEUPLOAD-1.0.JAR" FILE IS VULNERABLE TO CVE-2013-0248



The following IMPACT APARs are delivered with Fix Pack 3:

IV27869: related to PMR 15590,SGC,724 - For 6.1.1 Impact
- The latest build should be installing version 2.2.0.2 of
VMMObjectServerPlugin
IV50058: IMPACT SERVER FAILS TO WORK PROPERLY WITH ANY SPACES IN CONFIGURABLE PROPS FILES
IV58590: SNMPTRAPACTION FAILS ON 2ND TRAP WHEN PROCESSING MULTIPLES
IV59481: UNABLE TO SEND HIBERNATIONS TO CLUSTER MEMBERS WHENEVER DIRECTSQL IS BEING USED
IV59770: DATA ITEMS RETRIEVED FROM A DIRECTSQL'S SELECT ARE NOT ABLE TO BE UPDATED
IV60438: IMPACT POLICY WIZARD (XML) FAILS WITH JAVA.LANG.NULLPOINTEREXCEPTION
IV61538: MWM WINDOWS DO NOT ADJUST FOR DST
IV61725: GETSCHEDULEMEMBER FUNCTION ISSUE
IV63535: UNABLE TO PERFORM DECRYPTION OF INPUT VALUE - DATA SOURCE ACCOUNT GETTING LOCKED
IV63942: SESSION.SENDCOMMAND IN A JS POLICY DOESN'T RETURNS ANY RESPONSE
IV64075: NullPointerExceptions
IV64837: IMPACT MWM WINDOW CREATED WITH WRONG END DATE
IV65055: GET/SETGLOBALVARIABLES DO NOT WORK WITH ACTIVATE FUCNTION
IV65179: LOCAL VARIABLES NOT RESTORED AFTER HIBERNATION
IV66164: ADD RECURRING MW WINDOW
IV67091: TBSM FAILOVER BACKUP NOT STARTED CORRECTLY IF STARTED TOO SOON
IV67829: ITM/TEPS DATA DISPLAYED INCORRECTLY IN UI
IV68383: DEBUG FLAG GENERATES MEMORY ISSUES WHEN NON OMNIBUS EVENTS ARE PROCESSED
IV69164: POLICY USES HIBERNATION WILL NOT WAKE UP
IV70836: COMMANDRESPONSE ERROR IN JS POLICY
IV71157: ACTIVATE FUNCTION CALLED FROM WITHIN POLICY SUB-FUNCTION HAS NO EFFECT
IV71513: EVENT IS NOT BEING PROCESSED CORRECTLY AFTER HIBERNATION
IV73098: EVENTS OCCURING ONE HOUR BEFORE ONE TIME WINDOW GOING INTO MAINTENANCE
IV73243: XSS ISSUE IN PROJECTNAME PARAMETER

The following IMPACT APARs are delivered with Fix Pack 2:

IV18554: 511:EVAL FUNCTIONALITY HAS CHANGED FROM 4.1 TO 5.1.1
IV23315: UPGRADE FROM IMPACT 5.1.1 TO IMPACT 6.x DISTRIBUTED [611]
IV64152: SECONDARY NODE CAN'T BIND TO THE NAME SERVER
IV61089: INSTALL FAILS AT STARTWAS STEP
IV63137: IMPACT 6.1.1 REPLICATION FROM PRI TO SEC NOT WORKING
IV62792: 1.2 GB WAS BEING FILLED BY BLANKS FROM LOGGER FUNCTION
IV61956: DATA MODEL NOT SORTED IN ALPHABETICAL ORDER
IV61746: IMPACT 611 FP1 INSTALL FAILS WHEN INSTALLING ON GA 611, WHICH HAS BEEN FIRST UPGRADED FROM IMPACT
IV61399: NULL VALUE ON FIELD, DASH WIDGET SPINS TO MANY TIME MAKING DATA VEIW VERY SLOW TO VIEW.
IV60005: DATA TYPE NOT SAVED CORRECTLY IF FEILD DELETED AND REMAINDER RE-ORDERED.
IV60253: TEPS UIDP NOT CLEARING CACHE, CAUSING MEMORY LEAKS.
IV58616: DIRECTSQL EXECUTE CAUSES EXCEPTION IN POLICY EXECUTION
IV58511: EMAIL READER SERVICE DOES NOT HANDLE EMAILS THAT USE A NON-STANDARD CHARACTER SET
IV53717: JMS MESSAGE LISTENER SERVICE NOT STOPPING PROPERLY
IV56745: IMPACT IS UNABLE TO HANDLE EXCEPTIONS FROM A WEBSERVICES CALL
IV56068: IMPACT THREADS INCREASING WHEN WEBSERVICES SECURITY IS ENABLED
IV55989: HIDDEN/DELETED FIELDS NOT BEING REMOVED FORM OPERATOR VIEW
IV50329: WEBSERVICES SECURITY NOT FUCTIONAL
IV56541: CONFVMM4NCOS SCRIPT IN IMPACT 6.1 IS NOT WORKING AS EXPECTED
IV47748: CAN'T LOAD WEBSERVICE LIBRARIES THAT HAVE JAVA OR JAVAX PACKAGES IN THEM
IV55464: UNABLE TO CREATE A BUTTON ON JAZZ AFTER JAZZ FP2
IV60923: USING THE DIRECTSQL APPROACH AND HAS IDENTIFIED THE NON-REFRESH OF THE SCHEMA ON USERNAME UPDATE IN THE DSA AS SECURITY RISK

The following IMPACT APARs are delivered with Fix Pack 1:

IV11728: USING EVENTREADER PARSERESTRICTIONFILTER TO ALLOW THE USE OF GETDATE()
IV21717: ONE TIME MAINTENANCE WINDOWS DO NOT ADJUST FOR DST
IV22560: ANALYZE EVENT MAPPING TOOL FAILS AND HAMMERS CPU
IV33973: JMS READER DOES NOT CONVERT ACTIVEMQMAPMESSAGE DATA FOR TRANSFER TO SECONDARY CLUSTER MEMBER
IV34503: "OPTIMIZE LIST" OPTION DOESN'T REFLECT THE APPLIED CHANGES TOTHE LIST IN THE "RESTRICT FIELDS", WITHIN THE EVENTREADER
IV35827: ERROR PRODUCED IN NETCOOL.LOG WHEN USING AN EVENTREADER WITH A BLANK FILTER VALUE
IV35885: IMPACT NEEDS TO CHECK USER CREATED SERVICES, FOR WITH NAMES THAT END WITH A "_SERVER".
IV35940: RETURNEVENT() FUNCTION WITHIN DATABASEEVENTREADER ADDED UNWANTED SINGLE QUOTES TO THE IDENTIFER FIELD IN THE SQL "VIA" STATEMENT
IV36405: THE CONFVMM4LDAP COMMAND IS SHIPPED WITH IMPACT 6.1, BUT IS NOT DOCUMENTED
IV36503: MWM CALENDAR: USING FORWARD BY ONE MONTH CAN LEAD TO NON-EXISTENT DATES BEING CREATED
IV37040: USING "NCI_COLLECT_LOGS" UTILITY IN A GUI SERVER ONLY INSTALL DOES NOT WORK.
IV37369: OBJECT.PROTOTYPE.TOSTRING.CALL(OBJ) RETURNS {}
IV37717: IMPACT 6.1 FP1 OPVIEW SOAP ERROR
IV37759: INTERNAL DATATYPE STRING VALUE IS INTERPRETED AS AN INTEGER IF IT CONTAINS ONLY DIGITS
IV38045: ORACLE DSA ERROR FOR COLUMN NAMES WITH "DOUBLE-QUOTES" AND "NOT-ALL-CAPS"
IV38585: NCI_EXPORT NOT EXITING CLEANLY WHEN RUNNING ON A NON PRIMARY IMPACT
IV38961: APPLICATION AND DATA NEEDS TO BE VALIDATED.
IV39368: INCREASING CPU WHEN JABBERSERVICE
IV40158: ABILITY TO CHANGE NUMBER OF POLLING INTERVALS
IV41888: DISABLE THE HIBERNATION STORAGE
IV42715: ERROR WHEN USING # IN IMPACT FILTER FROM DATATYPE DATAITEMS GUI WINDOW
IV43030: IMPACT MISSED ENRICHING FEW EVENTS WHICH OCCURED SIMULTANIOUSLY
IV43751: EVENTPROCESSOR IN A SECONDARY SERVER IS UN-ABLE TO CONTACT PRIMARY SERVER EVENTPROCESSOR.
IV45068: ERROR TRYING TO CREATE SCHEDULE DATATYPE DATAITEM: ERROR MESSAGE: HTTP ERROR 500 INTERNAL SERVER ERROR
IV45511: NEEDED 6.1.1 MWM OPVIEW POLICIES GET OVER-WRITTEN, AFTER MIGRATION FROM EITHER IMPACT 5.X OR 6.1, CAUSING MWM ISSUES
IV45569: DOCUMENTATION NEEDED ...HOW TO HANDLE BUILD-UP OF "ORPHANED" FILES, CREATED FOR XINY DATATYPE
IV45838: OBJECTSERVER CONNECTION DOES NOT RECOVER FROM BUSY PERIOD IF SELFMONITORING (DATASOURCE MONITORING) IS ENABLED
IV46099: JMSREPLYTO WAS NOT ABLE TO SET CORRECT QUEUE.
IV46493: ATTEMPTING TO USE DATATYPE FILTERS - "SPECIAL" CHARACTERS BEING CONVERTED TO HTML ENCODING THAT BREAKS OUTGOING SQL.
IV46696: LIMITING THE NUMBER OF CONNECTIONS THAT IMPACT OPENS TO JMS
IV46729: TOPOLOGY WIDGET KEEPS THE OLD LINKS BETWEEN NODES AND DOESN'T CLEAR IT, RESULTING IN AN INCORRECT RELATIONSHIP
IV46799: FUNCTION <FUNCTIONNAME> IS NOT DEFINED BEFORE CALL
IV47058: MWM POLICY SETS SUPPRESESCL FIELD TO 6 IMMEDIATELY AFTER SETTING TO 1.
IV47799: SELECTING 2 KEY FIELDS IN DATA TYPE ON DEFAULTOBJECTSERVER DOESN'T WORK
IV47904: EIC 'TEST SQL' FAILS DUE TO UNSCAPED CHARACTERS
IV47988: SETTING THE WSSETDEFAULTPKGNAME VALUE GLOBALLY DOESN'T WORK WHEN THE WSINVOKE FUNCTION IS INSIDE A POLICY FUNCTION
IV48113: SLOW RESPONSE ON THE POLICY PAGE WHEN ATTEMPTING TO OPEN A LARGE NUMBER OF POLICIES VIA THE GUI
IV48113: SLOW RESPONSE ON THE POLICY PAGE WHEN ATTEMPTING TO OPEN A LARGE NUMBER OF POLICIES VIA THE GUI
IV50464: JMS TIMEOUT CAUSES POLICY ASSIGNED TO OPERATORVIEW EXECUTE TWICE
IV50932 MAINTENANCE WINDOW EVENT SHOWED STATUS 'NORMAL' - parent apar cancelled
IV51062: DB2 DSA FAILS TO QUERY COLUMN NAMES WITH "DOUBLE-QUOTES AND NOT-ALL-CAPS"
IV51098 WIDGET TABLE STOPPED WORKING AFTER JAZZ FIX PACK 1 INSTALLATION
IV51100 THE "VALUE STATUS GAUGE" IN JAZZ FIX PACK 1 FOR SERVICE MANAGEMENT DOES NOT WORK WITH NETCOOL IM
IV53483: CALLDBFUNCTION USAGE IN ORACLE DATABASE WITH FILTER 0=1
IV53810: I10N - TRANSLATION ISSUE
Translation issues in XinY policy and in Browse and Cancel buttons have been fixed.
IV53818: ISSUES WITH INTEGRATIONS ON 611
Web services related issues have been fixed.
IV53822: FIXES FOR HA IN 611 FP1
Issues related to Omnibus failover/failback have been fixed.
IV53824: FIXES IN IMPACT SCRIPTS FOR 611 FP1
Issues in Impact scripts nci_export, nci_import and nci_encryptpolicy have been fixed.
IV53825: THIS APAR INCLUDES FIXES FOR DATA MODEL ISSUES IN 611 FP1
IV53826: FIXES ISSUES IN 611 FP1 WITH POLICIES
IV53827: THIS APAR FIXES SERVICES RELATED ISSUES IN 611 FP1
IV53836: FIXES UI DATA PROVIDER ISSUES IN 611 FP1
IV54939: A MISSING $IMPACT_HOME/LOGS/INSTALL/ DIRECTORY WILL RESULT IN THE NCI_CONFIGURATION_UTILITY PROBLEM
IV55776: UI PROVIDER ENHANCEMENTS IN 611 FP1
This contains UI Provider enhancements where the user can show status and percentage in topology,
tree, table, and list widgets
IV55778: JABBER UPDATES IN 611 FP1
This contains Jabber Updates to use the smack library.
IV55779: ADDITIONAL POLICY FUNCTIONS IN 611 FP1
This contains additional policy functions to escape special characters and filter malicious
content in strings.
IV55780: DSA ENHANCEMENTS IN 611 FP1
DSA enhancements that alert the user when users switch between failover and
failback configuration. Improved handling of network timeouts.
IV55781: SERVICEABILITY IMPROVEMENTS IN 611 FP1
Serviceability improvements, which include improved error messages for
GetHTTP and services.



List of Impact APARs that have documentation updates or have additional information:

IV20165: E-MAIL READER DELETES E-MAILS AFTER READING THEMe
The email reader service reads incoming email, and runs policies based on the
contents of the email.
To stop the email reader from deleting emails after you read them, add the
following property to the <EmailReaderName>.props file.
<emailreadername>.deleteonread=false
Where <emailreadername> is the email reader service name. Restart the service.
This only works for IMAP email servers.

IV37369: OBJECT.PROTOTYPE.TOSTRING.CALL(OBJ) RETURNS {}
If a customer is using Object.prototype.toString.call(obj) in a javascript policy,
and wants to follow the javascript standard, he can add the following property
to NCI_server.props file -

impact.featureToStringAsSource.enabled=false

When the property is set to false, the data follows the JavaScript standard and
the data output by the Log function is not the same as in IPL. To make the
output the same in JavaScript and IPL, make the value true but this does not
follow the javascript standard.

IV38585: NCI_EXPORT NOT EXITING CLEANLY WHEN RUNNING ON A NON PRIMARY IMPACT
NCI_EXPORT restriction: nci_export will not execute on the non-primary member of a cluster.

http://www.ibm.com/support/knowledgecenter/SSSHYH_6.1.1.3/com.ibm.netcoolimpact.doc/
admin/imag_tools_nci_export_c.html

IV40158: ABILITY TO CHANGE NUMBER OF POLLING INTERVALS
In order to make the readEventBuffer store the events for a longer interval, the number of
intervals can be updated. The default number is 3.

Add the following property to the <CLUSTERNAME>_<readername>.props. file (eg NCI_omnieventreader.props file)-

impact.<readername>.numreaderbuffer=4

The default value for this property is 3.

IV40179: ERROR MESSAGES FIRST APPEAR ON 6.1 AND 6.1.1 DURING STARTUP, DUE TO THE FACT THE
NAMESERVER IS NOT INITIALISED YET
When the Impact Server is started during the installation, the following message
is displayed in the netcool.log file:

Unable to login to configured name servers host , port

The message occurs because the Name Server can take time to initialize while
Netcool/Impact starts. You can ignore this message. It is normal and it
disappears when the Name Server server is initialized.

IV43157: ALL SERVERS IN A CLUSTER ARE REQUIRED TO USE THE SAME ADMIN UID AND PASSWORD
If you are configuring the Tivoli® Integrated Portal profile for a cluster
of servers, you must use the same user name and password for all the servers in
the cluster.

IV44875: SET JREXEC TO LOG TO FILE IS NOT WORKING
Documentation has been updated on JRExec server logging.

IV45481: NO DOCUMENTATION ON THE REQUIRED HTTP AUTHENTICATION FOR THE IMPACT 6.X WEBSERVICES
Documentation has been updated for Impact web services.

IV45569: DOCUMENTATION NEEDED ...HOW TO HANDLE BUILD-UP OF "ORPHANED" FILES, CREATED FOR XINY DATATYPE
A new policy has been added - XINY_DataType_PurgeData - to remove aged data items. More
information can be found in the Troubleshooting Guide.

IV46185: JAVACALL METHOD FAILS WITH JAVA.LANG.ILLEGALACCESSEXCEPTION-CANNOT ACCESS A MEMBER OF CLASS JAVA.UTIL.HASHTABLE$HASHITERATOR
Documentation has been updated for the NewJavaObject function.

IV46512: THERE'S A NEED TO DOCUMENT THE FACT THAT ONE NEEDS TO RESTART IMPACT FOR JVM TO RELEASE ANY LOADED JAR FILES FOR WEBSERVICES
Documentation has been updated to specify the procedure of what to do when a user compiles a wsdl file
using classes from a previously compiled file.

IV47057: DATA TYPE QUERY CACHING RETURNING BAD DATA
Documentation on Data caching information has been updated.

IV47454: INSTRUCTIONS ON HOW TO RUN UPGRADE PACAKAGE FOR IMPACT 6.1.1 ON CONSOLE OR SILENT MODE
Documentation on How to upgrade from Netcool/Impact 6.1 in console mode has been added.

IV50673: INCORRECT/UNCLEAR DOCUMENTATION FOR HANDLING EXCEPTIONS

IV50776: DURING UPGRADE WE WILL OVER WRITE ANY CUSTOMIZED MWM POLICIES WITH NEWER THE MWM DEFAULT POLICY'S VERSIONS

IV51431: NEED TO DOCUMENT THAT DOT NOATION CAN NOT BE USED IN THE NAMING OF POLICIES, SERVICES, DATA TYPES, DATA SOURCES, AND PROJECTS.
Documentation has been updated to note that Dot notation "." can not be used in the naming
of POLICIES, SERVICES, DATA TYPES, DATA SOURCES, AND PROJECTS.

IV52651: DATABASEREADER NOT WORKING PROPERLY WHEN USING GETUPDATES ON DATABASE TABLE'S TIMESTAMP FIELD
Database event reader service

An additional property can be added to the NCI_XXX.props file in order to match the
the date and time format of the timestamp field in the external database.
Where NCI is the name of the impact instance and XXX is the name of the database
event reader.
An example of this property is:
impact.XXX.formatpattern=dd-MMM-yy hh.mm.ss.SSS aaa

IV55778: JABBER UPDATES IN 611 FP1
An additional property can be added to the JabberReader property files if password is required to
login to a group.

impact.<jabberreader>.groupchatpassword=passwordToChatWithGroup

For e.g. if the reader is the DefaultJabberReader, then add the property shown below to the
NCI_defaultjabberreader.props file. If this property is present, it will be used while
login to the group.

impact.defaultjabberreader.groupchatpassword=passwordToChatWithGroup


IV71068: JREXECACTION FAILS WHEN IMPACT.SERVER.SSL_ENABLED=TRUE
Updated documentation, with specific steps needed to create
key file and setup SSL certificates between Impact and JRExec
server.

IV73181: ISSUES WITH SQL EXCEPTIONS APPEARING WHEN USING THE DB2 DSA, COULD BE RESOLVED BY ADDING ADDITIONAL DATASOURCE PROPERTIES
Troubleshooting Guide has been updated to address issues
related to the handling of "read only" data from DB2 Data
Sources. A new section has been added to the Troubleshooting
Guide and it is titled:
"Error returning read-only data from DB2 Data Source"

IV73633: HOW TO PROPERLY UPDATE THE INTERNAL HSQL OR DB2 DRIVERS WHICH ARE INCLUDED IN THE IMPACT 6.1.1 INSTALLATION
The Administration Guide has been updated. The section titled
"Adding JDBC drivers and third-party JAR files to the shared library"
has bee updated to include steps needed to drivers

IV75254: DOCUMENTATION OF ENABLING WEB SERVICES SECURITY NEEDS AN OVERHAUL"
Both the "Netcool/Impact DSA Reference Guide" and the
Troubleshooting Guide, have been updated to include detailed
information on Web Services security setup, specially in a
clustered environment.


IV75734: ERROR HANDLING NOT HANDLE BY POLICY EXECUTED FROM POLICY ACTIVATOR
The following information has been added to the
"Policy logger service configuration window" section, with
regards to the "Error-handling Policy":

Note: If you have a Policy Activator service and you want it
to utilize a default exception handler policy, you must
specify the following property in the
<servername>_<activatorservicename>.props file:
impact.<activatorservicename>.errorhandlername=<policy
name to run>


IV79194: DOCUMENTATION REQUIRED FOR UI DATA PROVIDER TIMEOUTS
Additional information has been added to the Solutions Guide.
The new information describes the availability of two parms
which can be used to control "Connection Timeout" and
"Response Timeout" associated with the UI data providers.
The two parms are:
impact.uidataprovider.gethttp.conntimeout=<connection_timeout_in_miliseconds>
and
impact.uidataprovider.gethttp.sotimeout=<response_timeout_in_miliseconds>

Those parms are to be defined in the server. props file.


IV82840: CLUSTER SECONDARY MIGRATION DOES NOT WORK 511 TO 611
The "About this task" statement on "Scenario 2: Migrating
5.1.1 servers to version 6.1.1, with both 6.1.1 servers
installed on different machines" section of the Admin Guide
is being updated to read as follows:

For simplicity's sake, we assume a deployment of a single GUI
Server, and Impact Server. In a clustered environment, please
see the procedure below. Also, note that the installation
paths that are used here for both version 5.1.1, and 6.1.1 are
default installation paths.

IV85196: COMMANDLINEMANAGER SERVICE DOESN'T STOPS ON SECONDARY IMPACT SERVERS
Additional information has been added to the Solutions Guide.
This information provides access to three property values
associated with the CommandLineManager behavior.


For additional information, refer to the following link:

http://www.ibm.com/support/knowledgecenter/SSSHYH_6.1.1.5/com.ibm.netcoolimpact.doc/welcome_kc.html


============================
6.0 New support and features
============================

6.1 Additional Browser Support with Fix Pack 5
------------------------------------------
Impact 6.1.1 supports FF ESR 54 as of Fix Pack 5 (and TIP 2.2.0.19)
As well as, Internet Explorer 11 (Compatibility Mode)


Additional Browser Support with Fix Pack 4
------------------------------------------
Impact 6.1.1 supports FF ESR 38 as of Fix Pack 4 (and TIP 2.2.0.17)
As well as, Internet Explorer 11 (Compatibility Mode)


Additional Browser Support with Fix Pack 3
------------------------------------------
None


Additional Browser Support with Fix Pack 2
------------------------------------------

Impact 6.1.1 supports FF ESR 31 and IE 11 as of Fix Pack 2.
IBM strongly recommends updating to TIP 2.2.0.15 if support is
required for FF ESR 31 and IE11.


Additional Browser Support with Fix Pack 1
------------------------------------------

Impact 6.1.1 supports FF ESR 10 and FF17 as of Fix Pack 1.
IBM strongly recommends updating to TIP 2.2.0.13 if support is
required for FF ESR 24 and IE10.

This Fix pack supports Internet Explorer 9(IE9) in
"Internet Explorer 9" browser mode which is the default mode, not
in "Internet Explorer 9 Compatibility View" browser mode.
The document mode is automatically set by TIP and should remain
'IE7 standards'.


6.2 Additional Platform support with Fix Pack 5
-------------------------------------------
This Fix Pack 5 has been tested on Solaris 11.3, Linux RHEL 6.8 and
7.3 in addition to the platforms supported in Impact 6.1.1 GA and prior
Fix Packs

Additional Platform support with Fix Pack 4
-------------------------------------------
None

Additional Platform support with Fix Pack 3
-------------------------------------------

This Fix Pack 3 has been tested on AIX7.1, Solaris 11.2, Linux SLES 12
and Linux & zLinux RHEL 7 in addition to the platforms supported
in Impact 6.1.1 GA and Fix Pack 1.

zLinux SLES 12 is NOT currently supported!


Additional Platform support with Fix Pack 2
-------------------------------------------
None


Additional Platform support with Fix Pack 1
-------------------------------------------

This Fix Pack 2 has been tested on Solaris 11, SuSE 11.3
and RHEL 6.5 in addition to the platforms supported
in Impact 6.1.1 GA.


6.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 6.1.1 Fix Pack 5 was tested and verified on
WebSphere Application Server (eWAS) 7.0 Fix Pack 43 (which is included
in TIP 2.2.0.19)

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.ibm.com/support/docview.wss?uid=swg21205991

2 - Install the eWAS and WASSDK packages

o Run the backupConfig command to back up configuration files.
http://pic.dhe.ibm.com/infocenter/wasinfo/v7r0/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
ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixpacks/was70/cumulative/cf70043

embedded WAS AppServer: 7.0.0-WS-WASEmbeded-<osarch>-FP0000043.pak
WAS SDK: 7.0.0-WS-WASSDK-<osarch>-FP0000043.pak


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 the
<appsrv_install_root>/logs/update folder.

For the Product Selection Directory path, point the installer to the
Impact <installdir>/tipv2 directory.

For the Maintenance Package Directory Selection, point the installer to
the UPDI maintenance directory:

<installdir>/tipv2/WebSphereUpdateInstallerV7/maintenance

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.4 Enhancements in Fix Pack 5
--------------------------
Fix Pack 5 includes the following enhancements:
- Added support MS-SQL TLS v1.2 for use with Impact.
Refer to the following URL for information on how to setup the
secured connection:

https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Business%20Service%20Manager1/page/TLS%20Configuration%20Setup

- Display proper policy name and line number, when running nested
policy calls.


Enhancements in Fix Pack 4
--------------------------
Fix Pack 4 includes the following enhancements:
- Replication of a cluster that uses three or more Impact Servers:
To ensure that the preferred server is always the primary server
whenever it is available, it is best practice to set
impact.server.preferredprimary=true in the
$IMPACT_HOME/etc/<ServerName>_server.props on the primary
preferred server. A restart of the server is required.

To ensure that the secondary preferred server is always the
primary server whenever the primary preferred server is not
available, it is best practice to set
impact.server.secondary.preferredprimary=true
in $IMPACT_HOME/etc/<ServerName>_server.props on the
secondary preferred server. A restart of the server is required.

NOTE: The above parms should only be used on the first two
servers of a two or more cluster setup.

- Enhancements to the Impact Solution called
"Service Level Objectives (SLO) Reporting". The SLO function
is enhanced by Fixpack 4 for:

* New SLO calculation algorithm and sample usage
* Maintaining the reporting data in the SLORPRT database
* Removing service, SLA, and calendar definitions
* Exporting service and calendar definitions
* Removing specific outage data
* Restoring outage data
* Setting SLO configuration values


Enhancements in Fix Pack 3
--------------------------
Fix Pack 3 includes the following enhancements:
- Tivoli Netcool/Impact provides new property to ascertain which Data
Provider field is used, when retrieving ITM data from the REST
Service
- Enhancements to the Impact Solution called
"Service Level Objectives (SLO) Reporting". The SLO function
is enhanced by Fixpack 3 for:

* Support of a time zone specification when creating the SLA
definitions

* Detection of active outages in the sample policy that reads from
a TBSM Metric History database

* Bug fixes and improved documentation

Enhancements in Fix Pack 2
--------------------------

None

Enhancements in Fix Pack 1
--------------------------

Fix Pack 1 includes the following enhancements:
- UI Provider Enhancements, you can show status and percentage in
topology, tree, table, and list widgets.
- UI Provider - Large table model support for Apache Derby and
HSQLDB databases.
- OSLC security requirements can be enabled or disabled by using a
script.
- Jabber Updates to use the smack library.
- Web Documenter security enhancements. The Web Documenter can be
viewed only by a logged in user.
- Additional policy functions, Escape, and Illegal to escape special
characters and filter content from strings.
- DSA enhancements, that alert you when you switch between failover
and failback configuration. Improved handling of network timeouts.
- Serviceability improvements, which include improved error messages
for GetHTTP and services.
- Configuring Netcool/Impact to send messages to Tivoli Monitoring
Universal Message Console. Now uses the ITMLibraryFunctions.zip
file that is available for download from Netcool/Impact devWorks
wiki in the Scenarios and Examples page.
- Policy preferences updates that include the option to enable the
table preference for navigation to enhance performance.

6.5 Deprecated features in Fix Pack 5
---------------------------------
None

Deprecated features in Fix Pack 4
---------------------------------
The following features are being marked as deprecated in this release.

- Tivoli Common Reporting (TCR) version 2.x is no longer supported
for running SLO reports, as end-of-service for TCR 2.x is announced
for April 2016. For SLO reports, use Tivoli Common Reporting (TCR)
3.1 or higher. The Netcool/Impact Infocenter has been updated to
reflect this change.

Deprecated features in Fix Pack 3
---------------------------------
None

Deprecated features in Fix Pack 2
---------------------------------
None

Deprecated features in Fix Pack 1
---------------------------------

The following features are being marked as deprecated in this release.
- Web Services Distributed Management (WSDM) functions.
WSDMGetResourceProperty
WSDMInvoke
WSDMUpdateResourceProperty
- Web Services Notification Listener Service
- Cramer DSA
- Socket DSA
- External SVN, RCS, and ClearCase® as version control systems.


6.6 MSN support in Fix Pack 1
-------------------------

Messenger was retired by Microsoft in April 2013. As a result, Jabber
integration with MSN is no longer supported by Impact.



===============================
7.0 Known Issues in Fix Pack 5
===============================
7.1 Auto saved Policies not cleaned up
The auto saved copy of a policy is not removed after the recovered
policy is saved. There is no issue with leaving the auto saved copy on
the Impact server. It will be overwritten by the next auto saved copy
of the policy.

However, if user wants to manually remove the auto saved copy, user
needs to log in to the Impact server and then manually remove the copy
from:

<install>\impact\policy\.autoSaved\defaultWIMFileBasedRealm\<user>\

7.2 Unable to save ObjectServer DataType when the Impact server name is
long. There is an issue with saving ObjectServer DataType when the
Impact server name is longer than 23 characters.

To workaround this issue, user needs to override the APPLICATIONNAME
property with a shorter string.

Workaround:
1. Log into the Impact server
2. Navigate to the <installDir>/impact/etc/ directory
Open the appropriate .ds file for the object server you want to
connect to:

<serverName>_<datasourceName>.ds

e.g.

NCI_PRI-1_TEST-2_FINAL-impact_defaultobjectserver.ds

3. Add the following properties to the file:

<datasourceName>.ObjectServer.NUMDSPROPERTIES=1
<datasourceName>.ObjectServer.DSPROPERTY.1.NAME=APPLICATIONNAME
<datasourceName>.ObjectServer.DSPROPERTY.1.VALUE=NCI

e.g.

defaultobjectserver.ObjectServer.NUMDSPROPERTIES=1
defaultobjectserver.ObjectServer.DSPROPERTY.1.NAME=APPLICATIONNAME
defaultobjectserver.ObjectServer.DSPROPERTY.1.VALUE=NCI

NOTE: If user already has a datasource specific property in
the property file, then the above should be set to a number
higher.
e.g
defaultobjectserver.ObjectServer.NUMDSPROPERTIES=2
defaultobjectserver.ObjectServer.DSPROPERTY.2.NAME=APPLICATIONNAME
defaultobjectserver.ObjectServer.DSPROPERTY.2.VALUE=NCI

4. Save the changes.

5. Restart the Impact server and UI server.


7.3 WEBSERVICES SECURITY NOT FUNCTIONAL
If using WebService Security when making a WebService call,
(callProps.EnableWSS=true), the jar file
tipv2/plugin/org.apache.axis2.jar must be replaced by the jar
file impact/lib3p/org.apache.axis2-woden.jar and the newly replaced
file must be renamed to org.apache.axis2.jar.

Restart is required.

7.4 If using WEBSERVICES SECURITY (WSS) user authentication, then the
impact/dsa/wsdsa/wss/conf/wscb.properties needs to be altered to
only have one entry. If there is more than one entry in the file,
only the uid.1 and pwd.1 will be read

7.5 Microsoft Internet Explorer 11.
IE11 (supported only with TIP 2.2.0.15 and above) may cause
unexpected behavior in the Policy Editor, whereby the Policy List
panel disappears when the Project drop-down menu is selected. To
circumvent this, simply click on a different project in the
Project drop-down list and then click again on the desired
project, to restore the correct layout.

7.6 Change the cursor sensitivity for DB2 JDBC Connections
Netcool/Impact as the underlying engine for JDBC connections.
Netcool/Impact decides which cursor sensitivity setting to use when
running JDBC statements. Is it possible to override the default
setting? The answer is: Yes!

Refer the following technote for proper procedure:
http://www.ibm.com/support/docview.wss?uid=swg21975764

7.7 In the IBM Dashboard Application Services Hub (DASH), when using
Large Data Model, clicking "Show more items ..." very quickly,
results in the List widget filter being lost. It works as expected
if one waits some seconds between the consecutive selects of
"Show more items ..."


=======================================
8.0 Copyright and trademark information
=======================================

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

8.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 v5.1.1 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.

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

8.3 IBM obtained Smack V3.3.0 under the following current license from
Apache Software Foundation:

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


Installation Instructions

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

3.1 Dependencies
------------

IBM Tivoli Netcool/Impact version 6.1.1

This Fix Pack is applied to Tivoli Netcool/Impact 6.1.1 Server and 6.1.1 GUI
Server.


3.2 Prerequisites
-------------

Tivoli Integrated Portal 2.2.0.11 (TIP Fix Pack 2.2.0.11). This has been
installed as part of Impact 6.1.1 GA.

However,IBM strongly recommends updating to TIP Fix Pack 2.2.0.19
if support is required for Firefox ESR 54 and
Internet Explorer 11, as well as, Java JRE 8.

If the Impact server and GUI server are installed on different systems, the
TIP Fix Pack needs to be installed only on the GUI server. If TIP Fix Pack
is installed on the GUI Server, which is on a separate system, the eWAS on
the Impact Server system must be upgraded to eWAS 7.0 Fix Pack 43 (or higher).
The instructions to apply the eWAS Fix Pack are in section 6.5 below.

If the Impact Server and TIP are on the same system, the TIP Server
and the Impact server must be stopped prior to installing the TIP Fix Pack.
The TIP Fix Pack will automatically upgrade eWAS and the WASSDK, on the server
where it is run.

Netcool/Impact 6.1.1 Fix Pack 9 is certified for TIP FP 2.2.0.19.

To download TIP FP 2.2.0.19 go to:

http://www.ibm.com/support/fixcentral/swg/selectFixes?
parent=ibm~Tivoli&product=ibm/Tivoli/Tivoli+Integrated+Portal
&release=2.2.0.19&platform=All&function=all


3.3 Special considerations and Notices
----------------------------------

* Notice: IBM will withdraw support for the Tivoli Netcool/Impact
versions 6.1.x versions licensed under the IBM International
Program License Agreement.

https://www-01.ibm.com/support/entdocview.wss?uid=swg22009215

IBM recommends upgrading to later versions of Tivoli
Netcool/Impact 7.1.x as soon as possible in order to maintain
full support.

* Tivoli Netcool/Impact versions 6.1.x uses IBM Java v6 and IBM
Websphere Application Server v7. IBM SDK v6 End Of Service
has been announced.

https://developer.ibm.com/javasdk/support/lifecycle/

This means that IBM will no longer make fixes generally available
for Java v6.

* IBM Websphere Application Server v7 will be withdrawn April 2018.
See related Websphere Application Server Software Withdrawal
notice:

https://www-01.ibm.com/common/ssi/cgi-bin/ssialias?subtype=ca&infotype=an&appname=iSource&supplier=897&letternum=ENUS916-143

See link for information on Tivoli Netcool/Impact v7.1.0:

https://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0/com.ibm.netcoolimpact.doc_7.1/welcome_kc.html

* Announcement: TADDM 7.2.0 and 7.2.1 support has been withdrawn.
Refer to the following link for more info:

https://www.ibm.com/developerworks/community/blogs/7d5ebce8-2dd8-449c-a58e-4676134e3eb8/entry/Announcement_of_future_withdrawal_from_support_for_TADDM_7_2_0_and_7_2_1?lang=en

* Starting TBSM 6.1.1 Fixpack 4, the default value set for TADDM
port in the toolkit configuration file is 9433 instead of 9530.
Port 9433 is the default port number used in TADDM versions
7.2.2 and above.
The installer will not override the existing copy of toolkit
configuration xmltoolkitsvc.properties, but a copy with
updated comments on TADDM ports can be found in directory
$TOOLKIT_HOME/bin/install. To reconfigure TADDM ports if
necessary, please use the taddmconfig command:
taddmconfig.sh -e

* The following browser version are no longer supported with
Fix Pack 4:

Firefox 17 ESR
Firefox 24 ESR
Firefox 31 ESR

Internet Explorer 8
Internet Explorer 9
Internet Explorer 10

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

1. Backup the current server using the command:
nci_export <serverInstanceName> <absolute path directory>

For example:
Non-Windows Operating System:
$NCHOME/impact/bin/nci_export NCI /tmp/exports/NCI_exports

Windows Operating System:
%NCHOME%\impact\bin\nci_export.bat NCI C:\tmp\exports\NCI_exports

2. Backup the current jar file:
Non-Windows Operating System:
cp $NCHOME/impact/lib/nci<date><current-buildlevel>.jar $NCHOME/impact/tmp/

Windows Operating System:
copy %NCHOME%\impact\lib\nci<date><current-buildlevel>.jar %NCHOME%\impact\tmp\

3. You will be prompted during the installation to specify a backup
directory name. The installer backs up DE at this location.

NOTE: Please ensure this backup directory exists with write permission before launching the installer.

4. This fix pack does not back up the entire Impact application. It only
backs up the files that it has updated or replaced. A backup copy of the
original files is located at [InstallDirectory]/tipv2/logs/impact/maintenance/backup/6.1.1.0/FP0005


3.4 Superceded Fixes
----------------

6.1.1-TIV-NCI-FP0001 is superceded by this Fix Pack.
6.1.1.1-TIV-NCI-IF0001 is superceded by this Fix Pack.
6.1.1-TIV-NCI-FP0002 is superceded by this Fix Pack.
6.1.1-TIV-NCI-FP0003 is superceded by this Fix Pack.
6.1.1-TIV-NCI-FP0004 is superceded by this Fix Pack.


3.5 Extracting Fix Pack files
-------------------------

3.5.1 Extracting on Linux, Solaris, AIX and zLinux platforms
1. Copy the 6.1.1-TIV-NCI-FP0005-<ARCH>.tar file to your system.
2. Unpack the file using this command:
* tar -xvf 6.1.1-TIV-NCI-FP0005-<ARCH>.tar

3.5.2 Extracting on Windows platforms to your system
1. Copy the 6.1.1-TIV-NCI-FP0005-windows.zip
2. Extract the contents of the file to a selected directory.

3.5.3 Fix pack directories

When you extract the file, these directory are created:

Impact (this contains Impact Server and GUI server updates)
launchpad/<ARCH> (contains the standalone Discovery Library Toolkit installer)



3.6 Installation in a Cluster Environment
-------------------------------------

Please follow the instructions in the Netcool/Impact 6.1.1 administration guide
for setting up a server cluster.

http://www.ibm.com/support/knowledgecenter/SSSHYH_6.1.1.5/com.ibm.netcoolimpact.doc/impact_pdflibrary_ic.html


3.7 Installation of the fix pack
----------------------------

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

NOTE: If you have deployed the Service Level Objectives (SLO)
Reporting Function, you must do the following before
installing the Fix Pack:

- Stop all Impact services that are running policies that
call the SLO functions to record data in the SLORPRT
database. If you have the service set to start at
server startup, then turn this option off before
installing the fixpack, as the server is restarted
during the fixpack install.

Installing without a backup:

If you prefer to backup DE with your own procedures, you can
run the install with the following parameter:

-DNO_BACKUP=true

(For Silent Install, uncomment the "NO_BACKUP=true" parm on the
setupFP.rsp response file)

If you choose this method, you must backup DE
before you install. Restore the original system using
your backup or restore procedures or utilities.

Follow this procedure to install the fix pack:

NOTE: If the Impact "Service Level Objectives (SLO) Reporting"
function was previously enabled, please
perform the following two actions prior to installing this
Fix Pack:
a) Stop all Impact services that are running policies
that call the SLO functions to record data in the
SLORPRT database.

b) If you have the service set to start at server
startup, then turn this option off before installing
the fixpack, as the server is restarted during the
fixpack install (one or more times).

1. Before installing the fix pack all Impact processes must be
running.
2. Change to the [Fix Pack]/Impact directory where you extracted the
files.
3. Run the installation using one the following commands:
* setupwin.exe - Windows.
* setup<ARCH>.bin - other operating systems.

Installation command options:

GUI mode
No options, for example:

Windows: setupwin.exe

Or

Unix: ./setup<ARCH>.bin

Console mode
Use the -i console option. For example:

Windows: setupwin.exe -i console

or

Unix: ./setup<ARCH>.bin -i console

Silent Mode
a. Copy installSilent_responseFP.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
c. Run:

UNIX: setup<ARCH>.bin -f /tmp/installSilent_responseFP.txt
or
Windows: setupwin.exe -f C:\tmp\installSilent_responseFP.txt
Note: The response file needs to have a fully
qualified path.
Note: before you do the upgrade, please backup impact data

4. After installing the servers, run the script checkEarWarUpdate.ant
which can be found on the servers under <installDir>/impact/bin.
This script will verify if there were any issues with upgrade
and deployment.
On Windows:

nc_ant.bat -f checkEarWarUpdate.ant

On Linux/Unix:

./nc_ant -f checkEarWarUpdate.ant

If no issues are detected, it will display a message
'No issues were detected!.' If there were issues, it will display
the file where it found the issue.
If the installation completed successfully but errors were
detected when running this script, please contact IBM Support
for commands that can be run post-install to fix the issue.

5. After installing the Fix Pack, the following policy needs to be
loaded and run. To accomplish this task, the following needs
to done:
a) Upload the MigrateMWMWindows.ipl policy either via the UI
or by using the command line.
via UI:
- Logon to Impact and navigate to System Configuration >
Event Automation > Policies
- Click on the upload button
- Upload file
<installdir>/impact/tmp\import-nci-policy\MigrateMWMWindows.ipl

via Command Line:
- From the Impact server's <installdir>/impact/bin
run: nci_policy <SERVER_NAME> push <tipadmin> <password> <installdir/impact/tmp/import-nci-policy/MigrateMWMWindows.ipl

for example: nci_policy NCI push tipadmin password ..\tmp\import-nci-policy\MigrateMWMWindows.ipl

b) Run the newly uploaded policy. This too can be accomplished
via the UI or by using the command line.
via UI:
- Logon to Impact and navigate to System Configuration >
Event Automation > Policies
- Locate the MigrateMWMWindows policy
- Open/Edit the policy and run it!

via Command Line:
- From the Impact server's <installdir>/impact/bin
run: nci_trigger <SERVER_NAME> <tipadmin>/<password> MigrateMWMWindows

for example: nci_trigger NCI tipadmin/password MigrateMWMWindows

The expected outcome: "Policy completed successfully"

6. After installing this Fix Pack, end-users may need to clear their
browser cache, close and re-open the browser; in order to avoid
any issues on the client side.

7. If the Impact "Service Level Objectives (SLO) Reporting"
function was enabled, please refer to section 3.12 for additional
post Fix Pack installation required actions.



3.8 Uninstalling the Fix Pack
-------------------------

Before uninstalling the Fix Pack all Impact processes must be
running.

Attention: Uninstall the Fix Pack with the same user that was used to
install Impact 6.1.1 GA. Note that on Windows, if running the uninstall
from the IMPACTInstall611_FP5 directory, this directory file itself
cannot be deleted although its contents are.


Follow this procedure to uninstall the Fix Pack:
1. Change to the directory:
<installDir>/impact/_uninst/IMPACTInstall611_FP5
2. Run the uninstallation using one the following commands:
* uninstall.exe - Windows.
* uninstall - other operating systems.

Uninstallation command options:

GUI mode
No options, for example:

Windows: uninstall.exe

Or

Unix: ./uninstall

Console mode
Use the -i console option. For example:

Windows: uninstall.exe -i console

or

Unix: ./uninstall -i console

Silent Mode
a. If silent mode was used for the installation,
the uninstallation defaults to a silent
uninstallation and you must supply a response
file or the uninstallation fails.
b. Copy the uninstallSilent_responseFP.rsp
file from the Fix Pack image to the directory:

<installDir>/impact/_uninst/IMPACTInstall611_FP5

c. Update the file to match your environment
Run:

UNIX: ./uninstall -f uninstallSilent_responseFP.rsp
or
Windows: uninstall.exe -f uninstallSilent_responseFP.rsp

3. After uninstalling this Fix Pack, end-users may need to clear
their browser cache, close and re-open the browser; in order to
avoid any issues on the client side.


3.9 Recovering from a failed Fix Pack installation
----------------------------------------------

If the installation fails, attempt an uninstallation in which case, it
reverts to the previous version. If there is no uninstallation file in
the impact/_uninst/IMPACTInstall611_FP5 directory, nothing is installed
and you can delete the IMPACTInstall611_FP5 directory and reinstall.


3.10 Policies overwritten by this Fix Pack
-------------------------------------

When applying Test Fixes and Interim Fixes/Fix Packs to an existing
system, the policies provided by IBM may be overwritten with newer
versions to fix issues. If these policies contain custom changes, you
will need to update these newer files with the custom changes.

In this Fix Pack, the following policies have been overwritten:
EIC_utils.ipl
EIC_IsolateAndCorrelate.ipl
Import.ipl
MigrateMWMWindows.ipl
MWM.ipl
Opview_Add1TWin.ipl
Opview_EIC_confSubmit.ipl
Opview_EIC_requestHandler.ipl
Opview_onetwins.ipl
Opview_openwins.ipl
XINY_DataType_PurgeData.ipl

If Service Level Objectives (SLO) Reporting was previously
deployed, then the following policy files will also be
overwritten by this Fix Pack:

createBusinessCalendarDefn.js
createServiceDefinition.js
recordSLAMetric.js
serviceDowntimeBasedOnTBSMStatusChange.js
slaDefGlobalSettings.js
serviceDefinition.js
db2GetData.js
getDataFromTBSMAvailability.js
BusinessCalendar.js


Backups of the original files can be found under the following
directory on the Impact server:

[InstallDirectory]/tipv2/logs/impact/maintenance/backup/6.1.1.0/FP0005/policy.


3.11 Discovery Library Toolkit
-------------------------

NOTE 1: Announcement of future withdrawal from support of TADDM 7.2.0
and 7.2.1 has been made. Refer to the following link for
more info:

https://www.ibm.com/developerworks/community/blogs/7d5ebce8-2dd8-449c-a58e-4676134e3eb8/entry/Announcement_of_future_withdrawal_from_support_for_TADDM_7_2_0_and_7_2_1?lang=en

NOTE 2: Starting Impact 6.1.1 Fixpack 4, the default value set for TADDM
port in the toolkit configuration file is 9433 instead of 9530.
Port 9433 is the default port number used in TADDM versions
7.2.2 and above.
The installer will not override the existing copy of toolkit
configuration xmltoolkitsvc.properties, but a copy with
updated comments on TADDM ports can be found in directory
$TOOLKIT_HOME/bin/install. To reconfigure TADDM ports if
necessary, please use the taddmconfig command:
taddmconfig.sh -e


1. Navigate to the [Fix Pack]/launchpad/<ARCH> directory.

2. To install Fixpack 5,

If you are on a Windows operating system, run the following
command from a prompt:

setup-dltoolkit-windows_64.exe

If you are on a Unix operating system, run the following
command from a prompt:

setup-dltoolkit-<unixplatform>_64.bin

For console mode, specify "-i console".

Note: If the installer cannot find the TBSM 6.1.1 Discovery
Library Toolkit, verify that the toolkit is installed and
that it was installed by the user that the fixpack is being
installed with. If these are both okay, then set the environment
variable TBSM_TOOLKIT_BASE to the location of the toolkit and
restart the toolkit installer. For example:
Windows:
set TBSM_TOOLKIT_BASE=C:\Program Files\IBM\tivoli\tbsm\XMLtoolkit
UNIX:
export TBSM_TOOLKIT_BASE=/opt/IBM/tivoli/tbsm/XMLtoolkit

3. The toolkit installer requires access to the database.


4. Notes and Post-Install Considerations:

a) After installation is complete, you may remove
[Fix Pack] to save space.

5. Restart the toolkit.


3.12 "Service Level Objectives (SLO) Reporting" function
---------------------------------------------------

The information in this section applies only if you have deployed
the Impact Solution called "Service Level Objectives (SLO)
Reporting". The SLO function is enhanced by Fixpack 4 for:

* Automatic pruning of the table of outage data used in the
reports

* Capability to delete service, SLA, and calendar definitions

* Improved TBSM sample policy to only consider "Bad" status as an
outage

* Capability to export service and calendar definitions

* Utility functions for removing and restoring specific outage
data

* Bug fixes and updated documentation

This function is documented on the following page in the Knowledge
Center:
http://www-01.ibm.com/support/knowledgecenter/SSSHYH_6.1.1.4/com.ibm.netcoolimpact.doc/solution/imsg_slo_reporting_c.html?lang=en

If you have not deployed this solution, then you can skip this section.

Before you install the Fixpack:
1) Stop all Impact services that are running policies that call
the SLO functions to record data in the SLORPRT database.
2) If you have the service set to start at server startup, then
turn this option off before installing the fixpack, as the
server is restarted during the fixpack install.


After installing the Fixpack, but before restarting any SLO
services, update the SLORPRT database schema using the following
steps:

a) You will need access to the machine where the SLORPRT
database was installed. If this database has not been
installed, then the SLO solution has not been deployed
and there is no need to continue this update to the schema.

b) It is recommended to make a backup of the SLORPRT database
before continuing.

c) Copy sql files needed to update the SLORPRT database schema:

If you have not previously installed Fixpack 3, copy files
add_timezone.sql and update_views_timezone.sql from
[InstallDirectory]/impact/add-ons/slo/db to a location
accessible from the system you will use to update the
database schema in the next step.

Copy file sloutility.sql from
[InstallDirectory]/impact/add-ons/slo/db to a location
accessible from the system you will use to update the
database schema in the next step.

d) Open a DB2 command window on a system with access to the
SLORPRT database and run the following commands:

db2 connect to SLORPRT user dbuser using dbpassword
(replace dbuser and dbpassword with the user/password
specified in datasource SLOReportDatasource )

(Only if you have not previously installed Fixpack 3)
db2 -tvf <slo_sql_dir>/add_timezone.sql

(Only if you have not previously installed Fixpack 3)
db2 -tvf <slo_sql_dir>/update_views_timezone.sql

db2 -tvf <slo_sql_dir>/sloutility.sql

db2 connect reset

Where <slo_sql_dir> would be
[InstallDirectory]/impact/add-ons/slo/db if on the same
machine as the Impact server, or the directory where you
copied the files in step b if the SLORPRT database is on
a different machine.

Fixpack 4 provides a new Impact project called SLA_Utility which
provides most of the enhancements to the SLO function. Import
this project as follows:

a) Navigate to the [InstallDirectory]/impact/bin directory
and run the following command:

nci_import.[bat/sh] <servername> [InstallDirectory]/impact/add-ons/slo/sloutility

After importing the project, update datasource SLOUtilityDatasource
to use the same SLORPRT database that is used by datasource
SLOReportDatasource.

When you have installed the fixpack, updated the SLORPRT database
schema, and imported the SLA_Utility project, start any Impact
services configured for SLO processing. If you originally
configured the service to start when the server starts, remember
to check that option again.

This fixpack includes the option to collect outage data from
TBSM Metric History only when the status in TBSM is Bad. Refer
to the Impact documentation for information on how to update the
SLO configuration to use this option.

Off
[{"DNLabel":"6.1.1-TIV-NCI-FP0005-aix.tar","DNDate":"03 Nov 2017","DNLang":"English","DNSize":"422410240","DNPlat":{"label":"AIX","code":"PF002"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=6.1.1-TIV-NCI-FP0005-aix&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"6.1.1-TIV-NCI-FP0005-linux.tar","DNDate":"03 Nov 2017","DNLang":"English","DNSize":"413368320","DNPlat":{"label":"Linux","code":"PF016"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=6.1.1-TIV-NCI-FP0005-linux&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"6.1.1-TIV-NCI-FP0005-solaris.tar ","DNDate":"03 Nov 2017","DNLang":"English","DNSize":"412907520","DNPlat":{"label":"Solaris","code":"PF027"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=6.1.1-TIV-NCI-FP0005-solaris&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"6.1.1-TIV-NCI-FP0005-windows.zip","DNDate":"03 Nov 2017","DNLang":"English","DNSize":"423707265","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=6.1.1-TIV-NCI-FP0005-windows&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"6.1.1-TIV-NCI-FP0005-zlinux.tar","DNDate":"03 Nov 2017","DNLang":"English","DNSize":"412979200","DNPlat":{"label":"Linux","code":"PF016"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=6.1.1-TIV-NCI-FP0005-zlinux&source=SAR","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SSSHYH","label":"Tivoli Netcool\/Impact"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Netcool\/Impact","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF002","label":"AIX"}],"Version":"6.1.1","Edition":"Advanced","Line of Business":{"code":"LOB45","label":"Automation"}}]

Problems (APARS) fixed
IV75005 IV76521 IV78197 IV79350 IV79363 IV80613 IV80747 IV85196 IV86919 IV87164 IV87831 IV89467 IV91142 IV82840;IV59728 IV59840 IV66337 IV66441 IV68163 IV71068 IV72091 IV72561 IV72673 IV74071 IV74421 IV74485 IV75602 IV75913 IV77882 IV79004 IV79769 IV79910 IV80388 IV71068 IV73181 IV73633 IV75254 IV75734 IV79194;IV11728 IV21717 IV22560 IV33973 IV34503 IV35827 IV35885 IV35940 IV36405 IV36503 IV37040 IV37369 IV37717 IV37759 IV38045 IV38585 IV38961 IV39368 IV40158 IV41888 IV42715 IV43030 IV43751 IV45068 IV45511 IV45569 IV45838 IV46099 IV46493 IV46696 IV46729 IV46799 IV47058 IV47799 IV47904 IV47988 IV48113 IV50464 IV50932 IV51062 IV53483 IV53810 IV53818 IV53822 IV53824 IV53825 IV53826 IV53827 IV53836 IV54939 IV55776 IV55778 IV55779 IV55780 IV55781 IV20165 IV37369 IV38585 IV40158 IV40179 IV43157 IV44875 IV45481 IV45569 IV46185 IV46512 IV47057 IV47454 IV50673 IV50776 IV51431 IV52651 IV18554 IV23315 IV64152 IV61089 IV63137 IV62792 IV61956 IV61746 IV61399 IV60005 IV60253 IV58616 IV58511 IV53717 IV56745 IV56068 IV55989 IV50329 IV56541 IV47748 IV55464 IV60923 IV59920 IV50058 IV58590 IV59481 IV59770 IV60438 IV61538 IV61725 IV63535 IV63942 IV64075 IV64837 IV65055 IV65179 IV66164 IV67091 IV67829 IV68383 IV69164 IV70836 IV71157 IV71513 IV73098 IV73243

Document Information

Modified date:
15 June 2018

UID

swg24044185