IBM Support

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

Download


Abstract

This Fix Pack will address problems found in Netcool/Impact V7.1.0

Download Description

**********************************************************
* NOTE !! Before installing this Fix Pack, a health check script MUST be
* executed. The purpose of this Health Check, is to detect potential issues
* on the environment, prior to the installation of a Fix Pack. Failing to
* perform a Health Check, could potentially affect the Fix Pack installation
* process; which might lead to a failed Fix Pack install. The health check
* script can be downloaded from the fixcentral link, detailed at start
* installation instructions below.
**********************************************************
* A change introduced by this Fix Pack might negatively
* affect existing product function.
*
* Please refer to APAR IV97414 for a description of the
* problem and corrective action.
*
* Please refer to APAR IV90357 for a description of the
* problem and corrective action.
*
* Please refer to APAR IV89653 for a description of the
* problem and corrective action.
*
* Please refer to APAR IV86760 for a description of the
* problem and corrective action. IMPACTUI DOES NOT HANDLE EAST
* ASIAN LANGUAGE IN UI DATA PROVIDER POLICY RELATED ACTIONS
*
* Evaluate these APARs for the potential impact in your environment.
*************************************************************

7.1.0.6 Release addresses the problems that have been reported in IBM Tivoli Netcool/Impact version 7.1, 7.1.0.1, 7.1.0.2, 7.1.0.3, 7.1.0.4 and 7.1.0.5. This is a Fixpack only release and not a refresh of full installer (Impact 7.1.0.4 was both). It can only be applied on a previous Impact 7.x release (7.1, 7.1.0.1, 7.1.0.2, 7.1.0.3, 7.1.0.4 and 7.1.0.5).

Note: Impact 7.1.0.4 Release is both a Fixpack and also GA Install Refresh Release. If you planning to Install Impact 7.1.x for the first time, you can do a direct 7.1.0.4 Full Install and then can apply Impact 7.1.0.6 on top of it (Instead of starting with Impact 7.1.0.1). For those migrating from previous releases (5.1.1 or 6.1/6.1.1), you can install Impact 7.1.0.4, migrate directly to 7.1.0.4 and then apply 7.1.0.6 Fixpack.

You can access the Impact 7.1.0.6 README here:

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

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-FP0006.zip
Linux 7.1.0-TIV-NCI-LINUX-FP0006.zip
Solaris 7.1.0-TIV-NCI-SOLARIS-FP0006.zip
Windows 7.1.0-TIV-NCI-WINDOWS-FP0006.zip
zLinux 7.1.0-TIV-NCI-ZLINUX-FP0006.zip

all platforms * 7.1.0-TIV-NCI-FP0006.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:

AIX
Linux
Solaris
Windows
zLinux


2.0 Hardware and software requirements

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.6/com.ibm.netcoolImpact.doc/admin/imag_start_c.html


4.0 Additional information

For Tivoli Netcool/Impact 7.1.0.6 Documentation, please refer to:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.6/com.ibm.netcoolImpact.doc/welcome_kc.html


5.0 List of APARs


5.1 Fixes (APARs) Included in this Fix Pack.


The following Netcool/Impact APARs are delivered with Fix Pack 6:


IV85746: NEW PROPERTY IN IMPACTDAP.PROPERTIES FOR EXTERNALCONFIGURATION
IV85304: EXTRA SOFTWARE TAGS DISCOVERED BY SOFTARE ANALYSIS
IV84274: POLICY VARIABLE SCOPE IMPROVEMENTS
IV84201: NETCOOL IMPACT V7.1.0.2 VULNERABILITY CROSS FRAME SCRIPTING -VERSION 2 (XFSV2) - POST AUTHENTICATION
IV84121: NULL POINTER EXCEPTION IN GETALLNODES IN GUI SERVER
IV84040: DOCUMENTATION REQUIRED FOR NEW FORCE SELECT PARAMETER IN DIRECTSQL
IV83829: UNABLE TO SEND INVALID XML CHARACTERS WITH WEB SERVICES
IV83725: RFC1213-MIB FILE IS CORRUPT
IV83663: POLICY INPUT PARAMETERS USING THE "TIMESTAMP" FORMAT DO NOT APPEAR IN INPUT FORM WIDGET CORRECTLY
IV83127: UPDATE EXPIRE CERTIFICATES ON IMPACT 7.1
IV83051: IN THE 7.1 DOCS WE NEED TO DOCUMENT THE FACT THAT ONE MUST DELETE THE JAVASCRIPT FUNCTION
IV82945: CONFAUTH4OMNIBUS SCRIPT FAILS
IV82909: CONFIGIMPACTSSL.SH ENABLE FAILS
IV82883: STARTTLS NOT WORKING FOR EMAIL SENDER SERVICE
IV82584: MISSING UI ENCODING FOR FORWARD SLASH
IV81912: UNABLE TO SEND NULL PARAMETERS USING THE CALLSTOREDPROCEDURE FUNCTION
IV81745: COMMAND LINE METHOD TO DELETE IMPACT ITEM (DATA MODEL/TYPE) IS NOT WORKING
IV81409: A javascript policy that returns a NULL value from database : field, results in a 'org.mozilla.javascript.undefined@f8bead21'
IV80388: THE "COMMONS-FILEUPLOAD-1.0.JAR" FILE IS VULNERABLE TO CVE-2013-0248
IV79350: EXCEPTION HANDLER UNABLE TO CATCH EXCEPTION WHEN POLICY IS EXECUTED FROM AN OPERATOR VIEW


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

IV81745: COMMAND LINE METHOD TO DELETE IMPACT ITEM (DATA MODEL/TYPE) IS NOT WORKING
IV82883: STARTTLS NOT WORKING FOR EMAIL SENDER SERVICE
IV83051: IN THE 7.1 DOCS WE NEED TO DOCUMENT THE FACT THAT ONE MUST DELETE THE JAVASCRIPT FUNCTION
IV83127: UPDATE EXPIRE CERTIFICATES ON IMPACT 7.1
IV81226: ONE MUST RECREATE THE CERTIFICATE, AS A POST INSTALL STEP, IF USING IP ADDRESS DURING INITIAL PRODUCT INSTALLATION
IV84040: DOCUMENTATION REQUIRED FOR NEW FORCE SELECT PARAMETER IN DIRECTSQL
IV81409: A javascript policy that returns a NULL value from database : field, results in a 'org.mozilla.javascript.undefined@f8bead21'
IV81625: HIBERNATION FUNCTION DOES NOT WORK WITHIN CHAINED POLICIES AS IT CAUSES THE POLICY TO EXIT PRIOR TO COMPLETION
IV82945: CONFAUTH4OMNIBUS SCRIPT FAILS


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

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


6.0 New support and features

6.1 Browser Support with Fix Pack 6

Impact 7.1.0.6 supports:

Firefox ESR 45
Internet Explorer 10 and 11

6.2 Component Updates

Java has been updated to version 7.0.9.40
Websphere Liberty has been updated to version 8.5.5.9 + PI63436

6.3 Enhancements in Fix Pack 6


Fix Pack includes the following enhancements:


RESTful Data Source Adaptor (DSA) – Ability to interact with RESTful web services using a Data Source and associated policy functions (RESTfulAPIGET, RESTfulAPIPOST, RESTfulAPIPUT and RESTfulAPIDELETE).

New Policy Editor (Beta) available when enabled from UI Preferences.

Policy Logger UI – Ability to exclude Strings when filtering in the Log Viewer.


Install

LDAP based authentication – support for Custom LDAP Attributes
Runbook Automation (RBA) – Automated scripts to ease setup process


7.0 Known Issues in Fix Pack 6

When using LDAP based authentication with more than one repositories, if any one of them is unreachable (ex: Network cable is out, Network Interface card is corrupted etc), then there could be problems during server initialization.
Note: This is only if one or more LDAP servers are unreachable. In this case, even a ping from the machine where Impact server is running to the target LDAP server machine hangs and never returns back.
Once the network communication problem in the machine where LDAP server is setup gets resolved, it should fix the Impact server startup issue. The other option is to comment out the rogue LDAP server information from ldapRegistry.xml and only use the LDAP server which is running and reachable.

Prerequisites

Tivoli Netcool/Impact 7.1.0

Netcool/Impact version 7.1, 7.1.0.1, 7.1.0.2, 7.1.0.3, 7.1.0.4 and 7.1.0.5. This is a Fixpack only release and not a refresh of full installer. It can only be applied on a previous Impact 7.x release (7.1, 7.1.0.1, 7.1.0.2, 7.1.0.3, 7.1.0.4 and 7.1.0.5).

This fixpack is a cumulative fixpack, in other words you can apply it to any of the previous 7.x releases (7.1, 7.1.0.1, 7.1.0.2, 7.1.0.3, 7.1.0.4, 7.1.0.5) including Intermix Fix releases (IF2 and IF3) for both Impact Core and Impact for NOI releases.

Installation Instructions

***********************************************************************************************************************************
* Before installing this Fix Pack, it is recommended to run the following health check script to verify the system.
* Download from Fix Central:
http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=impact_server_health_check&source=SAR
* If any problem is reported by this script, it is essential that these are resolved before the Fix Pack is installed.
*
* Instructions for running Health Check Scripts:
* 1. unpack the zip to <Impact Install Directory>/install/configuration/cfg_scripts
* 2. For UNIX, make the script executable with either:
* chmod u+x impact_server_health_check.sh
* or
* chmod 744 impact_server_health_check.sh
* 3. Execute either the bat or sh script, from <Impact Install Directory>/install/configuration/cfg_scripts
* 4. For UNIX, run using
* <Impact Install Directory>/install/configuration/cfg_scripts/impact_server_health_check.sh
* 5. For WINDOWS , run using
* <Impact Install Directory>/install/configuration/cfg_scriptsimpact_server_health_check.bat
* 6. Scripts are successful, if the following is seen:
* On Unix:
* checkownership completed successfully!
* BUILD SUCCESSFUL
* On Windows:
* BUILD SUCCESSFUL
* Only install the Fix Pack if the script is successful.
* 7. Please NOTE!!!
* The Health Check will recycle the Impact server, therefore, it's recommended that you only run it during
* scheduled downtime.
*
* The Impact 7.1.0 FP 10 installer, will automatically run the same logic.
* Please refer to APAR IV95469 for a description of the problem and corrective action.
***********************************************************************************************************************************
3.0 Installation information

Note: To install FP6 from PassportAdvantage, make sure you use Installation Manager 1.8.0 or higher. Older Installation Manager (1.7.3 for example) will not work because of older SSL code

3.1 Dependencies

This fixpack is a cumulative fixpack, in other words you can apply it to any of the previous 7.x releases (7.1, 7.1.0.1, 7.1.0.2, 7.1.0.3, 7.1.0.4, 7.1.0.5) including Intermix Fix releases (IF2, IF3 and IF4) for both Impact Core and Impact for NOI releases.

3.2 Before you begin applying the Fix Pack


1. Backing up Directories

To apply this Fix Pack you will need 3 GB of free disk space

Check Instructions mentioned here:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.6/com.ibm.netcoolImpact.doc/admin/imag_upgrade_back_up_directories_t.html


2. Backup the entire Impact directory

This Fix Pack does not backup the entire Impact application. It only makes a backup of Impact configuration files.

A backup copy of Impact configuration files is located at [ImpactInstallDirectory]\backup\install


3.3 Extracting Fix Pack files
3.3.1 Extracting on Linux, Solaris, AIX , Windows and zLinux platforms


1. Copy the 7.1.0-TIV-NCI-<ARCH>-FP0006.zip file to your system.

2. Create a directory Impact_FP6 for example.

3. Unzip the file 7.1.0-TIV-NCI-<ARCH>-FP0006.zip to directory Impact_FP6.

3.3.2 Fix pack directories

When you extract the Fix Pack file, the following directories are created:

ImpactExtRepository (Contains Impact Extensions for NOI, Server and GUI Server updates)
ImpactRepository (Contains Impact Server and GUI Server updates)
response files (Contains response files for silent update)
scripts files (Contains installer update files)

and the following files are available:

update_console.sh (Update in console mode)
update_gui.sh (Update in GUI mode)
update_silent.sh (Update in Silent mode)

3.3.3 Installing Fix Pack in GUI and Console Mode

Check Instructions Here:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.6/com.ibm.netcoolImpact.doc/admin/imag_upgrade_gui_and_console_t.html

3.3.4 Installing Fix Pack in Silent Mode

Check Instructions Here:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.6/com.ibm.netcoolImpact.doc/admin/imag_upgrade_silent_mode_t.html


3.4 Installation in a Cluster Environment

Stop all Impact servers in a cluster environment before and after each update.

Example: A two server cluster would be updated as follows:

Stop all servers in the cluster
Update the primary
Stop the primary
Update the secondary
Stop the secondary
Start the primary
Start the secondary

3.5 Post Fix Pack Considerations

The Browser cookies and cache should be cleaned up before launching the UI. If you are using IE and have the Impact URL saved to your Favorites, then you must ensure that the "Preserve Favorites website data" is not enabled.

3.6 Rollback to previous version

You can remove the Fix Pack by doing a rollback to a previous version.
This rollback process is different from uninstall which removes Impact product entirely.

Check instructions here:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.6/com.ibm.netcoolImpact.doc/admin/imag_rollback_to_prev_netcoolimpact.html


Note: If you are rolling back to Impact 7.1.0.1 or 7.1 GA, you must not run the Rollback feature directly from Installation Manager. Instead, the rollback scripts (rollback_gui/rollback_console) and restore script (restore_from_backup) scripts located at IMPACT_HOME/install/rollback should be run. Details here:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.6/com.ibm.netcoolImpact.doc/admin/imag_rollback_to_prev_netcoolimpact.html

3.7 Recovering from a failed Fix Pack installation


Check instructions here:

http://www.ibm.com/support/knowledgecenter/SSSHYH_7.1.0.6/com.ibm.netcoolImpact.doc/admin/imag_restore_ni_backup_directories.html


3.8 Policies overwritten by this Fix Pack

When applying Test Fixes and Interim Fixes/Fix Packs to an existing system, the policies

provided by Netcool/Impact 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.

If you are using a Netcool Operations Insight (NOI) install, the following policies would be overwritten:

NCI_ConfigureResults.js
NOI_Constants.js
NCI_NOI_GETANALYTICSCONFIG.params
NCI_NOI_UTILS.js
NCI_PG_GETALLTYPES.js
NCI_PG_GETGENERALIZEDPATTERNS.js
NCI_PG_GETGENERALIZEDPATTERNS.params
NCI_PG_GETPATTERN.js
NCI_PG_PROCESSPATTERNS.js
NCI_PG_SAVEPATTERN.js
NCI_PG_SAVEPATTERN.params
NCI_PG_UTILSGROUP.js
NCI_RE_ACT_GROUPSYNTHETIC.js
NCI_RE_CONFIGURE.js
NCI_RE_GETCONFIGS.js
NCI_RE_GETCONFIGS_ACTIVE.params
NCI_RE_GETCONFIGS_ARCHIVED.params
NCI_RE_GETCONFIGS_EXPIRED.params
NCI_RE_GETCONFIGS_WATCHED.params
NCI_RE_GETGROUPEVENTS.js
NCI_RE_GETGROUPINSTANCES.js
NCI_RE_GETGROUPINSTANCEV1.js
NCI_RE_GETGROUPS.js
NCI_RE_GROUPSOURCES.js
NCI_RE_PROCESS.js
NCI_RE_STARTPROCESSING.js
NCI_RE_UTILS.js
NCI_seasonalityProcess.js
NCI_SE_GETRELATEDEVENTS.js
NCI_SE_UTILS.js

and the following are the new policies shipped for a NOI install:

NCI_NOI_MANAGE_EXPORT.js
NCI_NOI_MANAGE_EXPORT.params
NCI_NOI_MANAGE_EXPORT_DATASETS.js
NCI_NOI_MANAGE_EXPORT_DATASETS.params
NCI_NOI_MANAGE_EXPORT_FILES.js
NCI_NOI_MANAGE_EXPORT_STATUS.js
NCI_NOI_MANAGE_EXPORT_STATUS.params
NCI_NOI_MANAGE_TOKENS.js
NCI_NOI_MANAGE_TOKENS.params
NCI_PG_REGEX_FIELD_VALUES.js
NCI_PG_REGEX_FIELD_VALUES.params
NCI_SE_REINSERTDATA.js
NCI_SE_REINSERTDATA.params

On
[{"DNLabel":"7.1.0-TIV-NCI-AIX-FP0006","DNDate":"30 Jun 2016","DNLang":"English","DNSize":"517046486","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-FP0006&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-LINUX-FP0006","DNDate":"30 Jun 2016","DNLang":"English","DNSize":"521221465","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-FP0006&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-SOLARIS-FP0006","DNDate":"30 Jun 2016","DNLang":"English","DNSize":"496125478","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-FP0006&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-WINDOWS-FP0006","DNDate":"30 Jun 2016","DNLang":"English","DNSize":"508050831","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-FP0006&source=SAR","DNURL_FTP":" ","DDURL":null},{"DNLabel":"7.1.0-TIV-NCI-ZLINUX-FP0006","DNDate":"30 Jun 2016","DNLang":"English","DNSize":"535175499","DNPlat":{"label":"z/OS","code":"PF035"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FTivoli%2FTivoli+Netcool+Impact&fixids=7.1.0-TIV-NCI-ZLINUX-FP0006&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"},{"code":"PF035","label":"z\/OS"}],"Version":"7.1.0","Edition":"Advanced","Line of Business":{"code":"LOB45","label":"Automation"}}]

Problems (APARS) fixed
IV85746 IV85304 IV84274 IV84201 IV84121 IV84040 IV83829 IV83725 IV83663 IV83127 IV83051 IV82945 IV82909 IV82883 IV82584 IV81912 IV81745 IV81409 IV80388 IV79350 IV81745 IV82883 IV83051 IV83127 IV81226 IV84040 IV81409 IV81625 IV82945;IV75602 IV78525 IV78678 IV79004 IV79133 IV79363 IV79827 IV79867 IV79910 IV80038 IV80183 IV80613 IV80747 IV80800 IV80818 IV80891 IV81135 IV81155 IV81630 IV81644 IV75734 IV79086 IV79133 IV79631 IV72531 IV74071 IV74485 IV74878 IV75552 IV75913 IV76395 IV76875 IV77882 IV77953 IV78327 IV79776 IV79806 IV60062 IV65958 IV66441 IV66950 IV68163 IV68195 IV68934 IV69164 IV69904 IV70656 IV70712 IV70836 IV71068 IV71157 IV71513 IV71554 IV72091 IV72486 IV72561 IV72673 IV73098 IV73376 IV73620 IV74071 IV74211 IV74300 IV74421 IV74765 IV75085 IV70628 IV68912 IV74334 IV70784 IV69906 IV55989 IV59886 IV60438 IV61084 IV61538 IV61725 IV61956 IV62792 IV63137 IV63138 IV63535 IV63942 IV64075 IV64152 IV64837 IV65055 IV65179 IV66164 IV66210 IV66337 IV67091 IV67829 IV67936 IV68383 IV55600 IV66968 IV67231 IV67839 IV67936 IV83358 IV83071 IV81613

Document Information

Modified date:
15 June 2018

UID

swg24042426