IBM Tivoli Netcool Configuration Manager Version 6.3 Fix Pack 4 Readme

Content

IBM® Tivoli® Netcool® Configuration Manager Version 6.3 Fix Pack 4 Readme

Readme file for: IBM Tivoli Netcool Configuration Manager (ITNCM)
Product/Component Release: 6.3
Update Name: Fix Pack 4
Platforms: Linux, Solaris and AIX®

Fix ID: 6.3.0-TIV-ITNCM-FP004
Publication Date: 30th November 2012
Last modified date:

Abbrievations
IBM Tivoli Netcool Configuration Manager (ITNCM)
IBM Tivoli Network Manager (ITNM)
IBM Tivoli Common Reporting (TCR)
IBM Tivoli Integrated Portal (TIP)

Contents
Along with the APAR fixes listed below, this fix pack will be used to enable the support of FireFox 10 ESR (Extended Support Release). Depending on your set up you will need to do the following:

• If you are running ITNCM integrated with ITNM you will need to apply the ITNM/TCR patches for FireFox 10 ESR support as well as this ITNCM fix pack.
• If you are running ITNCM stand alone (i.e. not integrated with ITNCM) and you use TCR Report Studio to create your own reports and are using FireFox 10 ESR then you will need to apply a fix pack supplied by TCR to upgrade Reports to allow you to continue to do so. Note: You can avoid patching TCR in this scenario if you use TCR Report Studio with a browser other than FireFox.

Download location
Prerequisites and co-requisites
Known problems and workarounds

Installation information
Prior to installation
Installing
Post-Install steps
Uninstalling Fix Pack if necessary

List of fixes
Copyright and trademark information

Download location

Download ITNCM for Linux, Solaris and AIX Fix Pack 4 from the following location, using the Fix ID below:
http://www.ibm.com/support/fixcentral/

Below is a list of components and Fix IDs that apply to this fix pack.

Product/Component Name	Fix ID
ITNCM	6.3.0-TIV-ITNCM-FP004

The following files are available. You will need to download the ITNCM patch (6.3.0-TIV-ITNCM-FP004.zip) plus any extra files dependent on your system setup, e.g. DB2®, OOBC, integration with ITNM:

File Name	Description
6.3.0-TIV-ITNCM-FP004.zip	ITNCM 6.3.0.4 Fix Pack for Linux, AIX and Solaris
ibm_tivoli-ncm_db2_udf.jar	Patch to enable DB2 regular expressions functionality - required if you are using a DB2 database. See post install steps for details.
ITNCM_TIP_‹os›.bin	Linux, AIX and Solaris installers to upgrade TIP in line with ITNCM 6.3.0.4 - required to integrate with ITNM, not required for stand alone ITNCM installs. See post install steps for details.
ITNCMClient_‹os›.zip	ITNCM Client installers for Windows, AIX, Linux and Solaris, required if you use the ITNCM API. See post install steps for details.
oobc_‹os›.zip	OOBC installers for AIX, Linux and Solaris
ncm_itnm_tarball_4.0.1.19.tar.gz	Integration tarball - required to allow ITNCM to integrate with ITNM, not required for stand alone ITNCM installs. See post install steps for details
Tarball_Upgrade.html	This file contains the steps to upgrade the tarball on a previously integrated system.

Prerequisites and co-requisites

Before downloading ITNCM Version 6.3 Fix Pack 4, perform the following steps:

1. Backup the ITNCM database(consult with your database administrator)
2. Ensure that your system has at least 200 MB available in the ITNCM install directory and at least 400 MB available in the directory to which you will extract the Fix Pack zip file.
3. Review the Flashes and open Authorized Problem Analysis Reports (APARs) on the ITNCM product support Web site
4. Read the entire contents of this Fix Pack 4 Readme, including any workarounds documented in the "Known problems and workarounds" section.
5. If you require Reporting to be upgraded then Reporting must be enabled using the setPlatform.sh script before applying the FixPack.
6. Installing the fix pack will overwrite AutoDiscovery xml files in install_dir/autodiscovery/xml as well as ad.properties and commands.properties in the install_dir/autodiscovery directory. If you have made any changes to those files you may want to back them up and merge in the values you had changed once the fix pack has been applied. Please note that any changes you raised as an APAR may already be incorporated into the fix pack and will not need merged.

This fix pack is a cumulative patch that also contains all fixes in ITNCM 6.3 Fix Pack 1, 2 and 3. ITNCM 6.3 Fix Pack 4 can only be applied to an ITNCM 6.3.0.0, 6.3.0.1, 6.3.0.2 and 6.3.0.3 system.

Known problems and workarounds.

None

Installation information:
Prior to installation

Before installing ITNCM Version 6.3 Fix Pack 4, perform the following steps:

1. Stop ITNCM on all ITNCM instances by running <install_dir>/bin/itncm.sh stop

Installing

Follow these steps to install the ITNCM Version 6.3 Fix Pack 4:

1. Create a fix pack directory on all ITNCM instances  e.g <install_dir>/FP4
2. Download the fix pack from fix central and store in the directory created above.
3. cd <install_dir>/FP4
4. Extract 6.3.0-TIV-ITNCM-FP004.zip.
5. Execute sh ./install.sh
6. Review the license terms and conditions.
7. Follow the on-screen prompts. (If your deployment has more than one instance per server then make sure to enter the correct install directory)
8. Execute the following script to upgrade the ITNCM database schema (The script only needs to be run once on one of your ITNCM instances): sh <install_dir>/bin/utils/db/upgradeDBSchema.sh
Post Install Steps

After installing ITNCM Version 6.3 Fix Pack 4, perform these steps:

• (Perform this step only if your ITNCM system is integrated with ITNM.) Download the appropriate Tivoli Integrated Portal (TIP) installer (ITNCM_TIP_‹os›.bin) from the 6.3.0.4 Fix Pack and follow these steps to upgrade TIP in line with ITNCM 6.3.0.4. Make sure to also configure the Alerts menu in TIP following these steps. You will also need to download the integration tarball file (ncm_itnm_tarball_4.0.1.19.tar.gz) from the fix pack and upgrade your existing tarball following the steps outlined in the Tarball_Upgrade.html file included in this fix pack.
• If you use the ITNCM API then download the ITNCMClient installer specific to your system (Windows, AIX, Linux or Solaris) and install following these steps
• If you are installing on AIX and you have reporting installed please edit install_dir/reporting/ITNCMReports/itncm_env.sh and uncomment LIBPATH= and export LIBPATH and comment out LD_LIBRARY_PATH and export LD_LIBRARY_PATH before starting ITNCM .
• If you are using a DB2 database and are upgrading from ITNCM 6.3.0.0 or 6.3.0.1 then you will need to upgrade the ibm_tivoli-ncm_db2_udf.jar in your database to add regular expression support. The procedure requires that you remove the existing jar file from the DB and then apply the new one.

1. Steps to remove the existing jar file
2. Steps to apply the new jar file and add regular expression support
3. When the jar file has been updated on your database then run the following SQL commands:

CREATE FUNCTION REGEXP_LIKE(SOURCE VARCHAR(3000), REGEX VARCHAR(512), MODE VARCHAR(3)) RETURNS INTEGER FENCED NOT DETERMINISTIC NO SQL LANGUAGE JAVA PARAMETER STYLE JAVA EXTERNAL NAME 'ncm_db2_udf:com.ibm.tivoli.ncm.database.db2.NcmCustomFunctions.regexpLike' NO EXTERNAL ACTION;

CREATE FUNCTION REGEXP_LIKE(CLOB, REGEX VARCHAR(512), MODE VARCHAR(3)) RETURNS INTEGER FENCED NOT DETERMINISTIC NO SQL LANGUAGE JAVA PARAMETER STYLE JAVA EXTERNAL NAME 'ncm_db2_udf:com.ibm.tivoli.ncm.database.db2.NcmCustomFunctions.regexpLikeClob' NO EXTERNAL ACTION;

CREATE FUNCTION DECODE_FUNCTION(VARCHAR(400)) RETURNS VARCHAR(400) FENCED NOT DETERMINISTIC NO SQL LANGUAGE JAVA PARAMETER STYLE JAVA EXTERNAL NAME 'ncm_db2_udf:com.ibm.tivoli.ncm.database.db2.NcmCustomFunctions.decodeBase64' NO EXTERNAL ACTION;

• Start Server - <install_dir>/bin/itncm.sh start

Uninstalling Fix Pack if necessary

Steps for rolling back the fix pack are as follows:

1. Stop Server - <install_dir>/bin/itncm.sh stop

2. cd <install_dir>/FP4

3. execute sh ./install.sh and follow the on-screen prompts to rollback.

4. Restore to database backup taken in pre-requisites steps (Consult with your Database Administrator).

5. Start Server - <install_dir>/bin/itncm.sh start

List of fixes
This is a cumulative fix pack and will contain fixes released in all previous ITNCM Version 6.3 fix packs.

Fixes included in ITNCM Version 6.3 Fix Pack 4:

IV21479: AUTODISCOVERY - UNKNOWN VTMOS
IV21505: UNABLE TO DISCOVER CISCO/ROUTER/CRS/3.8.2
IV23150: EXECPTION IN ITNCM API DOES NOT CALL ONEXCEPTION()
IV23292: AUTO IDT CONNECTS TO TELNET FIRST AND FAILS EVEN THOUGH SSH IS ENABLED IN PRIORITY
IV23335: UOW ARCHIVING NOT FUNCTION CORRECTLY
IV23461: WHEN COMPLIANCE POLICY NAMES INCLUDE UNDERSCORES "_" IN THEIR NAME, RIGHT CLICK ACTIVITY VIEWER TOOL ON POLICY EVENT IS EMPTY
IV23909: CANNOT CREATE POLICIES WITHIN NCM COMPLIANCE
IV23921: ITNCM REPORTING INACCURATE - PART 1
IV24391: ITNCM NOT APPLYING POLICY SETS TO WORKFLOW REALMS CORRECTLY
IV24571: EXCEPTION[JAVA.LANG.ILLEGALSTATEEXCEPTION: INVALID USE OF SINGLECLIENT
IV24768: UNABLE TO DISCOVER EXTREME/SWITCH/BD-88/12.*
IV24764: UNABLE TO DISCOVER CISCO/SWITCH/C4507R
IV24796: DISCOVERY FOR F5 BIGIP WHEN SSH USES "KEYBOARD INTERACTIVE"
IV25199: FP2 ROLLBACK TO FP3 UPDATE SQL ISSUE
IV25324: REALM HIERARCHY COULD NOT BE DETERMINED FOR 0 APPEARING REPEATEDLY IN INTELLIDEN.LOG (APAR=IV25324)
IV25455: AVAYA 48XX NATIVE DIFF IS NOT WORKING
IV25486: DRIVERTOOLS.SH -STATUS NOT SHOWING ALL SERVERS
IV25639: ISSUES WITH RUNNING "SHOW DIFFERENCES" IN NATIVE MODE
IV25677: IDT COMMANDS AUTO EXECUTING WHEN PASTED INTO A SESSION
IV25761: ITNCM 6.2 COMPLIANCE PERFORMANCE ISSUE
IV25886: COMMAND SETS APPLICATION ORDER NOT CORRECT
IV26402: MISSING EVENTS WHEN MULTIPLE APPLICATIONS ARE SUBSCRIBED FOR EVENTS
IV27191: CAN'T RUN/CREATE/SAVE JAVASCRIPT NCS IN INTERROGATION MODE WHEN THE SCRIPT CONTAIN THE WORD "RETURN"
IV27056: DRIVERTOOLS.SH DOES NOT ALWAYS SELECT THE MOST UP-TO-DATE TEMPLATE WHEN CREATING A NEW STANDARD DRIVER
IV27343: PRE-EMPTIVE COMPLIANCE CHECK NOT FINDING POLICIES
IV27190: JAVASCRIPT NATIVE COMMAND SET
IV27617: DATACONFIGFACADE.GETCURRENTUNFORMATTEDDATE()
IV27348: FAILING TO DISCOVER SSG-320M JUNIPER DEVICE. NO SSG-320M SUPPORT
IV30584: DUPLICATE SCHEDULED JOBS
IV30781: SCORE TREND REPORT WITHIN NETCOOL REPORTING NOT FUNCTIONAL
IV31711: ITNCM/ITNM DEVICE SYNC FAILS
IV31878: DRIVERTOOL.SH UNABLE TO LIST UNUSED DRIVERS
IV32432: COMPLIANCE ENGINE PERFORMANCE ISSUE WITH MODELLED EVALUATIONS AND MODELLED EXTRACTIONS

Fixes included in ITNCM Version 6.3 Fix Pack 3:

IV21828: REPORTS CACHE QUERIES USED IN REPORTS - LEADING TO CONFUSION
IV21188: ITNCM COMPLIANCE UI DOES NOT DISPLAY CONFIGS
IV21268: UOW APPROVAL STATUS REPORT DOES NOT ALIGN WITH QUEUE MANAGER
IV21470: IDT DOES NOT USE THE PRIMARY IP ADDRESS OF A DEVICE
IV21476: Dequeueing a UOW while executing causes StackOverFlowError
IV21477: ERROR DURING CUTOVER SCRIPT EXECUTION
IV21505: UNABLE TO DISCOVER CISCO/ROUTER/CRS/3.8.2
IV10399: ALU 7342(OLT) SHOW CONFIG DIFFERENCES MODELED VIEW ISSUE
IV14394: /ETC/RC.D/INIT.D SUSE CREATEAUTOSTART.SH
IV15823: SSH AUTO NEGOTIATION
IV16064: De-queuing a UOW before it is decomposed does not work
IV16475: ABILITY TO CHANGE IDT SESSION BACKGROUND COLORS
IV17109: DISCOVERY FAILS FORAUTO CISCO/FIREWALL/ASA5505/8.4
IV18030: GUI SERVERS VERY SLOW TO START
IV18333: VULNERABILITY AND SECURITY SCAN ON APPLICATION INTERFACE - 'SESSION FIXATION'.
IV18640: WHEN IMPORT MULTIPLE DEVICES CONFIGURATION, GET DB2 SQL ERROR.
IV18647: SUBMITTING A DRAFT CONFIGURATION IN REPORT ONLY MODE LOCKS IT
IV18687: API RESPONSE PERFORMANCE DEGRADED WITH LARGER NECB FILE SIZE
IV19013: COMPLIANCE NATIVE CLI REQUESTS NOT SENT AFTER REMEDIAL CMD SET ERROR
IV19128: SEARCH BY NATIVE CONFIG DOES NOT RETURN NETWORK RESOURCES
IV19155: DRIVER METADATA DELETED INCORRECTLY
IV19453: REPORT ONLY DESIGNATION FOR COMMANDSETS IN QUEUE MANAGER DISPLAYS
IV19903: COMPLIANCE. DEFINITION CREATION GUI. SCHEMA NOT FOUND TYPE ERROR
IV20167: UOWS SCHEDULED FROM OOBC FAR IN THE FUTURE
IV20300: NOT ABLE TO GET THE OUTPUT RESULT FOR SHOWING DIFFERENCE AGAINST ENBS ON EM-LEM EMS
IV20540: AUTODISCOVERY REPORTING "FAILED FOR AN UNKNOWN REASON" WHEN TRYING TO DISCOVER A PARTICULAR CISCO/ROUTER/2600/12.3
IV20546: UNABLE TO DELETE OS REGISTRY GRS
IV20560: AUTODISCOVERY DOES NOT DISCOVER TYPE - JUNIPER/UNKNOWN/EX2200/10.1R1.8
IV20624: ITNCM CONFIGURATION & OS CHANGE SUMMARY REPORT IS POORLY FORMATTED
IV20879: GROUPS WITHOUT MODIFY RIGHTS CAN VIEW AUTH RESOURCE CREDENTIALS IF IGNORE IS SET TO TRUE

Fixes included from ITNCM Version 6.3 Fix Pack 2:

IV05821: ITNCM SENDING XML TAGS INSTEAD OF CLI TO DEVICES.
IV10374: No Rollback available when applying a config to a device
IV12216: ITNCM.PROPERTIES/SERVERISPROMISCUOUS DOCUMENTATION IS INCORRECT
IV12217: LOCATION OF ITNCMCOMPLIANCEDEFINITIONS.BIN INCORRECT
IV12434: AUTODISCOVERY FAILING DUE TO USERNAME/PASSWORD PROMPT MATCHING PROBLEMS
IV12658: IMPORTING DEVICES FROM ITNM INTO ITNCM FAILS WHEN USING DISTRIBUTED INFORMIX DATABASE AND TIP INSTALLATIONS.
IV12696: COMPLIANCE REPORTS ARE INCONSISTANT
IV12938: POOR PERFORMANCE EXHIBITED DURING THE MODELCONFIG OPERATION OF UOWS
IV13109: CISCO ME-3600 V15 RESTORE FAILURE WITH DISASTER RECOVERY
IV13118: CANNOT REQUEUE TWO FAILED UNITS OF WORK.
IV13149: WORK SERVER GR DOCUMENTATION NEEDS ENHANCING
IV13640: ALCATEL 7750 IDT AUTO LOGIN FAILURE
IV14247: CONFIGURATION HOUSEKEEPING FAILS WITH OPTIMISTICLOCKEXCEPTION IF LASTNENTRIES IS USED
IV14255: UNABLE TO AUTODISCOVER CISCO C2960S SWITCHES
IV14252: DOCUMENTATION ON HOW TO ACCESS ITNCM-REPORTS MISSING
IV14394: /ETC/RC.D/INIT.D SUSE CREATEAUTOSTART.SH
IV14991: DB2 RETURNS AN EMPTY STRING INSTEAD OF A NULL IF THERE IS NO DATA IN THE FIELD IN THE DATABASE. LEADS TO PROBLEMS ON IMPORT
IV15326: QUEUE MANAGER > UOW > COMMAND SET NO LONGER HAS A VIEW BUTTON TO DISPLAY COMMAND SET XML
IV15727: ALCATEL PON IDT AUTO PRINTING DUPLICATE CHARACTERS
IC81456: HOUSEKEEPING NOT CLEANING DEVICECONFIGPAGED AND UNFORMATTEDCONFIGURATION TABLES
IV15816: UNABLE TO DELETE SHORTCUTS
IV15879: USERS ARE UNABLE TO SEARCH DEVICES CONFIGURATION
IV16064: DE-QUEUING WORK BEFORE IT IS DECOMPOSED DOES NOT PREVENT THE WORK FROM RUNNING
IV16065: EXCEPTION THROWN WHEN TASK EXPIRES
IV16096: IMPORTING DEVICE FAILS IN DB2 IF 'SHOW INFO' IS LARGER THAN 1MB
IV16114: UOWS LEAVING ORPHANED ROWS IN DB

Fixes included from ITNCM Version 6.3 Fix Pack 1:

IV12036: LOCKED CONFIG SET TO 'EXPIRED' WHEN UOW EXPIRES
IV11729: INSTALL GUIDE DOESN'T FULLY LIST GLIBC AND LIBGCC REQUIREMENTS
IV10928: EVENT LISTENER STOPS RECEIVING EVENTS
IV10522: SUPPORT FOR RAC NOT DOCUMENTED
IV10339: CONFIGURATION EDITOR:- SHOW MANDATORY, MENU ITEM
IV10348: ARCHIVE FUNCTION NOT WORKING IN 6.3
IV09226: UNABLE TO DISCOVER CISCO/ROUTER/AS5300/12.3
IV11676: PERFORMANCE DEGRADES AFTER A NUMBER USERS AND GROUPS ARE ADDED
IV10369: PASTING LARGE CLIPBOARD CONTENTS TO DEVICES VIA IDT FAILS
IV10378: "IDT COMMAND FILTER NOT WORKING ON DEVICES WITH HYPHEN AND HASH IN THEIR PROMPT"
IV10346: "IMPROPER ERROR MESSAGES ARE DISPLAYED WHEN ADDING OBJECTS USING THE CM"
IV09867: COMPLIANCE REMEDIAL QUEUE RIGHT CLICK ACTIONS HAVE NO EFFECT
IV09396: """ICOSADMIN CHANGEPBCMDBDETAIL"" UTILITY NEEDS IMPROVEMENTS AND DOCUMENTATION"
IV09345: CREATION OF COMMAND SET NOT POSSIBLE WITH REFERENCED PARENT NODE
IV09343: "DURING ROLLBACK WITH NO PREVIOUS LOAD,""%RESOURCE_BROWSER_CUSTOM_LABEL7%"" IS SENT."
IV09129: IDT USAGE OF DEFAULT DEVICE CREDENTIALS NEEDS TO BE CUSTOMIZED
IV09130: "SHORTCUTS TO MANAGED DEVICES MAY SHOW UP IN A SEARCH FOR ""STAGED DEVICES INCLUDING SHORTCUTS"""
IV08973: """ERROR: NO AUTHENTICATORS PRESENT"" IN WEBLOGIC.OUT SHOULD BE DOWNGRADED IN SEVERITY"
IC79104: BANDWIDTH INDEX VALUES
IV08626: SHOW DIFFERENCE NATIVE VIEW FAILING DUE TO BADLOCATION ERROR.
IC78919: "ITNCM 'SH ./RSERIES.SH STATUS' OPERATION IS SOMETIMES STUCK FOREVER"
IC78820: POLICY EXCEPTION SHOULD BE HANDLED BETTER.
IV08070: HOW TO ENABLE/DISABLE SECURE OPTION THROUGH PROPERTIES.

Copyright and trademark information

             ©Copyright 2002, 2012 IBM Corporation. Licensed Materials - Property of IBM.

             IBM, Tivoli, Netcool, AIX and DB2 are trademarks of IBM Corporation, registered in many jurisdictions worldwide.

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

             Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

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

            U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

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.

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.