IBM Support

IBM Tivoli Netcool/Impact V7.1.0 Fix Pack 14 (7.1.0-TIV-NCI-FP0014)

Download


Abstract

This fix pack is a cumulative fix release and addresses APARs and internally found issues since the release of IBM Tivoli Netcool/Impact version 7.1.0 (for both Impact Core and Impact for NOI).

Download Description

Before installing or upgrading IBM Tivoli Netcool/Impact 7.1.0.14, refer to the Following documentation:

*********************************************************************************************************************
* A change introduced by this Fix Pack might negatively  affect existing product function.
* Upgrading Impact removes TBSM war files . TBSM users, please refer to https://www.ibm.com/developerworks/community/wiki/home?lang=en#!/wiki/Tivoli%20Netcool%20Impact/page/Installation%20issues

  • Please refer to  APAR IJ18856 for a description of the problem(s) and corrective action(s).
  • Please refer to APAR IJ10655 for a description of the problem and corrective action
  • Please refer to APAR IJ11133 for a description of the problem produced by APAR IJ08786 and the corrective action.
  • Please refer to APAR IJ13081 for a description of the problem and corrective action.
  • Please refer to APAR IJ14577 for a description of the problem produced by APAR IJ06886 and the corrective action.
  • Please refer to APAR IJ15285 for a description of the problem  and corrective action.
  • Please refer to APAR IJ17097 for a description of the problem produced by APAR IJ05850 and the corrective action.

**********************************************************************************************************************

  • Review Known issue in Fix Pack 14 section.

---------------------------------------------------------------------------------------------------------------------

For details of an individual APAR, go to https://www.ibm.com/support/home/ then enter the APAR name/# in "Search Support" then select search.

1. The following Netcool/Impact APARs are delivered with Fix Pack 14:

  • IJ00173: CUSTOMER IS UNABLE TO CONFIGURE A DATABASEEVENTREADER TO GENERATE A QUERY WITH RESTRICTION FILTERS
  • IJ03831: EVENT LOCKING LOCKS ALL EVENTS READERS ON VALUE
  • IJ04364: WATCHED/ARCHIVED/ACTIVE PATTERNS GET DELETED ON RE-RUN
  • IJ04490: IMPACTSLOREPORTPACKAGE  NEEDS TO HAVE ZIP FORMAT BEFORE IMPORTING IT
  • IJ04527: INCORRECT USAGE IN SQL QUERY OF IMPACT EVENTREADER FOR ORACLE DATASOURCE
  • IJ05315: .JS POLICY GENERATES ERROR
  • IJ05346: DEADLOCK IN THE SELF MONITORING
  • IJ05374: MULTIPLE VULNERABILITIES FOR NETCOOL/IMPACT
  • IJ05850: THREADS ARE NOT CLOSED AFTER COMMANDRESPONSE FUNCTION WAS USED
  • IJ05970: OOM FOR IMPACT 6.1.1.5  FOR CASE TS000125875
  • IJ05990: HISTORY IN UNIX CONTAINS UNENCRYPTED PASSWORDS
  • IJ06002: FIX PACKS ARE OVERWRITING UIPROVIDERCONFIG FILES
  • IJ06067: MEMORY LEAK 7.1.0.11 WAS OBJECT
  • IJ06394: LOG MESSAGE: AdvancedEncryptionStandardStrategy
  • IJ06474: SPELLING ERROR 'EDITTING' IN IMPACT AUDIT MESSAGING
  • IJ06759: OMNIBUS EVENT LISTENER ON SECONDARY IMPACT SERVER THROWS EXCEPTIONS ON RETURNEVENT
  • IJ06886: DUPLICATE ENTRIES WHEN REFRESHING WIDGET'S POLICY-BASED DATA TYPE
  • IJ06983: NEEDING THE ABILITY TO SPECIFY A START-UP ORDER OF SERVICES MANAGED BY IMPACT SERVICELIST FILE
  • IJ07148: NOI PATTERNS CANNOT BE RENAMED BECAUSE OF DUPLICATED EXISTING EVENT TYPES IN ANOTHER ANALYTICS CONFIGURATION
  • IJ07265: ERROR RETRIEVING SE HISTORICAL EVENTS
  • IJ07384: SYNTHETIC EVENTS HOUR_OF_DAY RULE  ISSUE
  • IJ07401: REGRESSION IMPACT FP13 NOT STARTING ON CLUSTER NODE WITH NO IMPACTDB CONFIGURED
  • IJ07564: ERROR [ADVANCEDENCRYPTIONSTANDARDSTRATEGY] UNABLE TO PERFORM DECRYPTION OF INPUT VALUE
  • IJ07744: RE_GETGROUPINSTANCEV1 POLICY UNABLE TO RETRIEVE VALUES FOR CUSTOM ROLLUP FIELDS
  • IJ08185: NOI ERROR WHEN TRYING TO SAVE A PATTERN
  • IJ08786: WHILE SECONARY IMPACT STARTUP, SOMETIMES IMPACT DATABASE FAILED TO START
  • IJ08833: Impact 71014 NOI RE Config failing with Errors
  • IJ08901: NEW NAME SIMILARITY FEATURE FOR EVENT ANALYTICS
  • IJ09028: SEASONAL EVENT RULES DOES NOT SYNC BETWEEN IMPACT INSTANCE
  • IJ09594: EVENT ANALYTICS CONFIGURATION WIZARD CANNOT DISPLAY TIMESTAMP WITH LOCAL TIMEZONE

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

  • IJ02154: RBA: SERVICE RESTART REQUIRED WHEN ADDING PREDEFINED FILTERS IN RBA DIRECTLY TO THE DATABASE
  • IJ03831 EVENT LOCKING LOCKS ALL EVENTS READERS ON VALUE
  • IJ04364: WATCHED/ARCHIVED/ACTIVE PATTERNS GET DELETED ON RE-RUN
  • IJ05850: THREADS ARE NOT CLOSED AFTER COMMANDRESPONSE FUNCTION WAS USED
  • IJ05990: HISTORY IN UNIX CONTAINS UNENCRYPTED PASSWORDS
  • IJ06931: NOI DOCUMENTATION REFERS TO CREATING THE SEASONALITY DB IN DB2
  • IJ06939: WHEN CA SIGNED CERT RECEIVED ORIGINAL REQUEST MUST BE DELETED
  • IJ06995: DOCUMENTATION UPDATE NEEDED FOR OPERATOR VIEWS
  • IJ07082: NOI CONFIGURATION DOESN'T SAVE AFTER FP13 WAS INSTALLED
  • IJ07242: ADD GUIDELINES FOR IMPACT/RUNBOOK INTEGRATIONS THAT CONNECT TO ACUTELY ACTIVE OBJECT SERVERS
  • IJ07744: RE_GETGROUPINSTANCEV1 POLICY UNABLE TO RETRIEVE VALUES FOR CUSTOM ROLLUP FIELDS

To check the APARs that were part of the previous FixPack (7.1.0.13), please check this link:

https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli Netcool Impact/page/Impact 7.1.0.13 README

2.0 New support and features

2.1 Browser Support with Fix Pack 14

Impact 7.1.0.14 supports:

    Firefox ESR 60
    Internet Explorer 11

    JazzSM 1.1.3.0 DASH 3.1.3.0 CP6

2.2 Component Updates

    Java has been updated to version 1.8.0_181 (8.0 SR5 FP20)
    WebSphere Application Server Liberty has been updated to version 18.0.0.2

    Derby 10.14.2.0

2.3 Enhancements in Fix Pack 14

 Fix Pack includes the following enhancements:

  • IBM Runbook Automation (RBA)  (IJ02154):
    If a user has the Runbook Automation add-on installed, additional Predefined filters can be added via the Impact GUI, by performing the following actions:

       1. Expand the RBA_Derby datasource to reveal the data types.

       2. Right click on the RBA_PredefinedFilters data type and select view Data items.

       3. Click on the top left "New Data item" button.

       4. Insert the required fields for the new Predefined Filter into the data item fields in the Data Item Field Editor.

          If using the FILTEROPERATORS, 'LIKE' or '=', surround the FILTERVALUE field with single quotes. For example:   

          FILTERVALUE:'myFilterValueText'

          Set the FILTERTYPE to PREDEFINED i.e: FILTERTYPE:PREDEFINED

      5. Click Save

NOTE:

The newly added predefined filter will be available to be used in the RBA DASH GUI after 5 minutes. The RBA release that contains this feature was released on August 24th 2018.

  • NOI: Provide process and functions to update NOI Data and Source Type for the new Configuration UI to refresh information
    • A new UI Data Type function is now available to update data type from within a policy.
    • A new Data Source Resource API is now available, to update data source from within a policy using a new function.
    • New Function and Process to Dynamically Add Rollups and view them in DASH
    • Make NOI configuration actions less manual
  • Pattern Matching Functionality.

    • You can now extend pattern matching functionality in the following two ways to enable the discovery of a pattern instance on more than one resource:

    • Using regular expressions:  You can define a regular expression to apply to the contents of the resource field during pattern matching. Resource names  that match the regular expressions are candidates to be included in a single pattern. You can optionally specify a regular expression when you create a pattern.

    • Using name similarity: This feature uses a string comparison algorithm to determine whether the resource names contained in two resource fields are similar. Name similarity is used when patterns are suggested and when live events are correlated to identify pattern instances. The end result is that during pattern processing of live events it is possible to have more than one resource name in a single pattern instance if the string comparison algorithm determines that the resource names are similar. By default name similarity is enabled.

For more information, refer to Fixpack 14 documentation in Knowledge center.

  • Migration of rollups in Netcool/Impact v7.1.0.13 (and above)
    • Fix pack v7.1.0.13 (and above) uses a new format for the creation of rollups that is different to previous versions of Netcool/Impact.  Refer to the following link for additional information and to take additional actions:

Migration of rollups in Netcool/Impact v7.1.0.14

  • Many of the Impact Command Line Interface (CLI) scripts allow/accept user credential information to be passed as clear text.  The following list of CLI scripts have been adjusted to allow for prompting of the password (which now hides the text). 

NOTE: The prior option of passing all credential information as clear text, will still be available!

The following scripts have been updated and now prompt and hide the credential information:

install/security/confAuth4LDAP
install/security/confAuth4OMNIbus
install/security/configImpactSSL
install/security/configImpactSSO
install/security/configUsersGroups
bin/nci_add_service
bin/nci_db
bin/nci_policy
bin/nci_sendevent
bin/nci_trigger
bin/nci_encryptpolicy

  • The nci_collect_logs script now accepts new parameters
  • Usage: ./bin/nci_collect_logs [  NO ARGUMENT | -DexcludePolicyEtcFiles=true | -Dlogfilelocation | -help ]

Refer to the topic “Collecting log files for debugging” in the Tivoli Netcool/Impact 7.1 Trobuleshooting General Issues Wiki Page for more details:

Troubleshooting Netcool Impact 7.1 > General issues

3.0 Known Issues in Fix Pack 14

  • ITNMEventListener fails to start, if connecting to ITNM versions 4.2.  Currently, only versions 3.8 and 3.9 are fully supported.
  • The following applies only to Netcool/Impact Clients with  Netcool Operations Insight (NOI) - and only for those with Existing configurations!!!   After upgrading to Netcool/Impact 7.1.0 FP13 (and above), run through the Wizard; confirm, verify & save the configuration. Refer to: Event Analytics Configuration

    1. It is a known issue that custom rollup changes to properties and params files are overwritten. Running through the wizard will repair these.
    2. Also for seasonality View, it is advisable to run through the Wizard to make sure the right columns are displayed.  Refer to the following link for appropriate actions: Migration of rollups in Netcool/Impact v7.1.0.14
  • The EventReader service for Seasonality Events is called "ProcessSeasonalityEvents" and it does not (by default) read updated or de-duplicated events. "Get updated events" is not selected (by default) in the UI for the "ProcessSeasonityEvents" Service, on the Event Mapping tab.
    The reason for this is due to the wide Filter for the "ProcessSeasonityEvents" Event Reader service. By default, the filter is set to "1=1". With this wide filter, if "Get updated events" was enabled, and Seasonality rules fired, this could lead to an infinite loop. i.e. Seasonality Rules updating events which in turn get read by the reader and fire the Seasonality Rules again.
    The solution is for the Event Mapping Filter to be set, in such a way, as to avoid already processed events. i.e. if the Seasonality rules are setting the Service field to "something" then the Event Mapping Filter could be set to restrict these.
  • NOI: Impact Event Isolation and Correlation page does not load if non-default cluster name is used (such as NCICLUSTER_Z )
    • To resolve this issue, perform the following actions:
      • stop the Impact GUI server $IMPACT_HOME/bin/stopGUIServer.sh
      •  copy or rename the file with the correct cluster name. For example:
        • cp $IMPACT_HOME/opview/displays/NCICLUSTER-EIC_configure.html $IMPACT_HOME/opview/displays/NCICLUSTER_Z-EIC_configure.html
      • restart the Impact GUI server $IMPACT_HOME/bin/startGUIServer.sh
      • go to the Event Isolation and Correlation page and confirm the page is displayed without the errors.
  • If  IF 6 is not uninstall prior to installing Fixpack 14,  Fixpack 14 Installation will fail due to  httpclient-4.5.5.jar file permission issue. The FP14 installation will generate the following error if the IF not first remove:  "CRIMA1020E: Failed to extract zip com.ibm.tivoli.impact.ibm_connections_jar 1.0.0.0.a7612a807baaae562962dec40f65859. File /opt/IBM/tivoli/impact/dsalib/httpclient-4.5.5.jar already exists."

     Workaround: Uninstall Interim Fix 6, then install Fixpack 14.

Prerequisites

IBM Tivoli Netcool/Impact 7.1.0.0 or 7.1.0.4 Refresh must be installed before applying this Fix Pack.

Notes:

  • If you plan to install 7.1.0.14 from Passport Advantage, the version of Installation Manager on your machine should be 1.8.3 or higher.

  • If you have previously installed 7.1.0-TIV-NCI-IF0006, then it must be un-installed, before installing FP14. If not, the Fixpack 14 Installation may fail due to a file permissions issue with the httpclient-4.5.5.jar file.

For information about supported hardware and software, check the Software Product Compatibility Reports (SPCR) here:

http://www-969.ibm.com/software/reports/compatibility/clarity/index.html

And the Planning Section in the Netcool/Impact Administration Guide:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.14/com.ibm.netcoolimpact.doc/admin/imag_start_c. html

Installation Instructions

When using the 7.1.0-TIV-NCI-*-FP0014.zip, IBM Tivoli Netcool/Impact 7.1.0.14 can be installed on all previously installed fix packs, including 7.1.0.4 refresh.

If you have previously installed 7.1.0-TIV-NCI-IF0006, then it must be un-installed, before installing FP14. If not, the Fixpack 14 Installation may fail due to a file permissions issue with the httpclient-4.5.5.jar file.

For those migrating from previous releases (5.1.1 or 6.1/6.1.1), you can install Impact 7.1.0.14, using the Impact 7.1.0.14 “Full installer” package (rather than the zip packages listed below) and then migrate directly to 7.1.0.14. 

The following table contains a list of files included in this Fix Pack and operating systems associated with these files:

Platform

File

AIX

7.1.0-TIV-NCI-AIX-FP0014.zip

Linux

7.1.0-TIV-NCI-LINUX-FP0014.zip

Solaris

7.1.0-TIV-NCI-SOLARIS-FP0014.zip

Windows

7.1.0-TIV-NCI-WINDOWS-FP0014.zip

zLinux

7.1.0-TIV-NCI-ZLINUX-FP0014.zip

all platforms * 7.1.0-TIV-NCI-FP0014.README

Note: The installer only works for 64 bit architectures

Note 1: If you plan to install 7.1.0.14 from Passport Advantage, the version of Installation Manager on your machine should be 1.8.3 or higher. Older versions of Installation Manager (1.7.3 for example) will not work, as they do not support the TLS protocol.

Note 2: Starting with Impact 7.1.0 Fix Pack 10, a new utility is now available (and run automatically right before the update; unless the update is done via the Passport Advantage repository!). This new utility is the Impact server Health Check utility!  This utility will perform an overall Health Check of Impact, prior to allowing the update installer to continue with the update. The utility is also available as a standalone utility; which can be retrieved via the following url:

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

Off
[{"DNLabel":"7.1.0-TIV-NCI-LINUX-FP0014.zip","DNDate":"28 Sep 2018","DNLang":"English","DNSize":"590886803","DNPlat":{"label":"Linux","code":"PF016"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=7.1.0-TIV-NCI-LINUX-FP0014&source=SAR","DNURL_FTP":"","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-AIX-FP0014.zip","DNDate":"28 Sep 2018","DNLang":"English","DNSize":"580567749","DNPlat":{"label":"AIX","code":"PF002"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=7.1.0-TIV-NCI-AIX-FP0014&source=SAR","DNURL_FTP":"","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-SOLARIS-FP0014.zip","DNDate":"28 Sep 2018","DNLang":"English","DNSize":"506501253","DNPlat":{"label":"Solaris","code":"PF027"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=7.1.0-TIV-NCI-SOLARIS-FP0014&source=SAR","DNURL_FTP":"","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-WINDOWS-FP0014.zip","DNDate":"28 Sep 2018","DNLang":"English","DNSize":"592273408","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=7.1.0-TIV-NCI-WINDOWS-FP0014&source=SAR","DNURL_FTP":"","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-ZLINUX-FP0014.zip","DNDate":"28 Sep 2018","DNLang":"English","DNSize":"606318435","DNPlat":{"label":"Linux","code":"PF016"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=7.1.0-TIV-NCI-ZLINUX-FP0014&source=SAR","DNURL_FTP":"","DDURL":null}]
[{"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Product":{"code":"SSSHYH","label":"Tivoli Netcool/Impact"},"Component":"Netcool/Impact","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.1.0","Edition":"Advanced"}]

Product Alias/Synonym

TIVOLI;NETCOOL;IMPACT;NOI;

Problems (APARS) fixed
IJ00173;IJ02154;IJ03831;IJ04364;IJ04490;IJ04527;IJ05315;IJ05346;IJ05374;IJ05850;IJ05970;IJ05990;IJ06002;IJ06067;IJ06394;IJ06474;IJ06759;IJ06886;IJ06931;IJ06939;IJ06983;IJ06995;IJ07082;IJ07148;IJ07242;IJ07265;IJ07384;IJ07401;IJ07564;IJ07744;IJ08185;IJ08786;IJ08833;IJ08901;IJ09028;IJ09594

Document Information

Modified date:
11 September 2019

UID

ibm10731749