

Title: 
------

   IBM® Tivoli® Business Service Manager Interim Fix Version
   4.2.1.2-TIV-BSM-IF0003 


 ====================================================================

Date:
-----
February 18, 2011

 ====================================================================
Copyright Notice:
-----------------

   © Copyright IBM Corp. 2011 All Rights Reserved.
                                                                  
   US Government Users Restricted Rights - Use, duplication or
   disclosure restricted by GSA ADP Schedule Contract with 
   IBM Corp.

 ====================================================================

Contents:
---------

   * Files that are included in this Interim Fix:

      - This README file (4.2.1.2-TIV-BSM-IF0003.README)
      - 4.2.1.2-TIV-BSM-IF0003-linux.tar
      - 4.2.1.2-TIV-BSM-IF0003-solaris.tar
      - 4.2.1.2-TIV-BSM-IF0003-zlinux.tar
      - 4.2.1.2-TIV-BSM-IF0003-aix.tar
      - 4.2.1.2-TIV-BSM-IF0003-windows.zip   

     For TBSM ITM Agent:
	 - r9v421b3-110123.aix.tar
	 - r9v421b3-110123.sun.tar
	 - r9v421b3-110123.ilinux.tar
	 - r9v421b3-110123.zlinux.tar
	 - R9C421B3-110123.Windows.zip


The following files have been replaced by this Interim Fix. 

Replaced files on the Data Server:
  RAD_Main_CheckForDepsEntry.ipl
  RAD_SLA_CumulDurationRuleState.type
  RAD_SLA_CumulRuleArchive.type
  RAD_namevalidator.props
  ActionLoader.jsp
  main_rulesets_output.jsp
  main_ruleset.jsp
  CreateDBPoller.jsp
  ncs.jar
  ncsi.jar
  ncsSoapClient.jar
  av.jar
  custom_canvas_actions.properties
  scriptedAPIStartup.bsh
  rad_compilewsdl.bat/rad_compilewsdl 

If you have made changes to the above mentioned files you will
find your copy of the file under:

 	- Copy of scriptedAPIStartup.bsh (scriptedAPIStartup.bsh.fp2)
	can be found in the same directory as the original. 
      - Copy of rad_compilewsdl(rad_compilewsdl.bat.fp2 or rad_compilewsdl.fp2)
	can be found in the same directory as the original.
      - The copy of the rest of the files can be found in the following
      directory: 
[InstallDirectory]/
     tip/logs/tbsm/maintenance/backup/4.2.1.2/IF0003/data/sla.war
      

Replaced files on the Dashboard Server:
  RAD_Main_CheckForDepsEntry.ipl
  RAD_SLA_CumulDurationRuleState.type
  RAD_SLA_CumulRuleArchive.type
  RAD_namevalidator.props
  ActionLoader.jsp
  main_rulesets_output.jsp
  main_ruleset.jsp
  CreateDBPoller.jsp
  launchtotbsm.sql
  launchtotbsmitm622.sql
  ncs.jar
  ncsi.jar
  ncsSoapClient.jar
  av.jar
  custom_canvas_actions.properties  
  avthin.jar
  rad_nodes_links.css
  
 
If you have made changes to the above mentioned files you will
find your copy of the file under:
  [InstallDirectory]/
     tip/logs/tbsm/maintenance/backup/4.2.1.2/IF0003/dash/sla.war


The following javascript files will be replaced on the Dashboard Server:

<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/content.js
<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/ibm/tivoli/tip/charts/dijit/ParametersWidget.js
<TIPHOME>/systemApps/isclite.ear/TIPChartPortlet.war/js/ibm/tivoli/tip/charts/dijit/ParametersWidget.js 
<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/dojox/grid/_data/model.js
<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/ibm/tivoli/tip/dojo/Server.js 

The installer will backup the script files to the following
location: 
- Copy of <TIPHOME>/systemApps/isclite.ear/TIPChartPortlet.war/js/ibm/
 tivoli/tip/charts/dijit/ParametersWidget.js (ParametersWidget.js.fp2)
 can be found in the same directory as the original.
- Copy of the rest of the files can be found under:     
[InstallDirectory]/tip/systemApps/isclite.ear/isclite.war/
   secure/isclite/scripts_BACKUPFP2   

          
 ====================================================================

About this Interim Fix:
------------------------------------

   This Interim Fix addresses problems reported in IBM Tivoli 
   Business Service Manager 4.2.1.

* APARS that are included new in Interim Fix 3.

  IZ68171  ERROR FILLING TRACE LOGS
	     This APAR was in TBSM 4.2.1 FP2 but was not documented. While 
           diagnosing a failover issue, the logs were filled with one 
           message repeatedly, which made it very difficult to read the logs 
           and understand the underlying issue. The fix was to comment out 
           the log message line.
           
  IZ75707  CHANGE TO OUTPUT EXPRESSION WEB PAGE (TO SHOW TRANSLATION FOLLOW
           BY ENGLISH)
           When non-English language is used in the browser, the values in the 
           drop-down list for a template's Output Expression cannot be saved.
           The fix is to update the drop down boxes to display the local 
           language PLUS the English translation in brackets. Clicking the 
           down arrows to add to the expression, will only add the English 
           word(s). See additional information section below.
	
  IZ75774  GUI ISSUE WHERE THE PASSWORDS ARE NOT URL ENCODED CORRECTLY
           There is a GUI issue where the passwords are not URL encoded 
           correctly. This means the Test Connection from the GUI is failing.
           However,if a valid password is entered and the user/password is 
           later switched, the Save happens ok. The issue is just with the 
           Test Connection from the GUI.The fix was to URL encode the password. 
	
  IZ76068  NEED TO ADD INVALIDATESERVICENAME COMMAND TO RADSHELL
           There was no radshell command to invalidate services.
           New radshell command invalidateServiceName added to
           scriptedAPIStartup.bsh
           	
  IZ76156  TBSM 4.2.1 - EVENTBROKER LOG NOT CREATED ON STARTUP
           The RAD_eventbroker.log file is no longer created/written. Without 
           this file the TBSM_agent doesn't work correctly, and no 
           RAD_corbanameservice.log files are created/written.
                              	
  IZ76309  ONE DATA SOURCE FAILS AND CAUSES ALL OTHER DATA SOURCES TO HANG
           When a data source to a Database fails, if it throws an exception 
           for some reason, it can cause other data sources to the same Database 
           to fail. 
	
  IZ76423  HARD-CODED POSTGRES USER
           User name hard-coded for postgres user.This issue only occurs if 
           the User for Postgres is not postgres.
           
  IZ76719  WHEN SLA CONFIG ADDED TOP LEVEL SERVICE NOT AFFECTED
           If cumulative-time SLA settings are enabled in a template,
	     services created with that template will have the 'Time' column in 
           the service tree changed from a small grey dot to a large green dot, 
           except for top level services. These will change for a few seconds 
           and then change back again.
           	
  IZ76786  TBSM CAUSING SQL ERROR IN OMNIBUS WHEN SERVICE CREATED	
           If the Model Consistency Checker is enabled, in some circumstances,
           when a service is created, it generates invalid SQL which causes 
           errors in OMNIbus. 

  IZ76912  DELETE SERVICES FRAME
           When TBSM has a service with special non-printable characters in 
           the database, the delete services panel will not show.

  IZ77346  RADSHELL EXPORT() FAILS FOR FLOAT VALUES
           Exporting a complete Servicetree with radshell fails when float 
           values are used for severity thresholds. 
              	
  IZ78143  LAUNCH IN CONTEXT SQL SCRIPTS ARE WRONG
           The launch from ITM to TBSM in Context does not work- the request 
           Service is not displayed in the Service Viewer.See additional 
           information section below.

           	
  IZ78337  SCORECARD SHOWING INCONSITIENT VALUES FOR A DECIMAL DATA COLUMN
           When a user limits the number of decimal places to display in a 
           query result for the data fetcher,the data browser displays the 
           correct decimal places. However, if the value is displayed
           on the scorecard, the values are truncated. See additional 
           information section below.
           	
  IZ78826  PROBLEMS WRITING TO OMNIBUS CAUSES OOM AND DATA SERVER CRASH	
           If the data server encounters problems writing updates to OMNIbus, 
           these queued updates will use up memory until the java heap space 
           is exhausted and the data server crashes with an out of memory error.
           See additional information section below.

  IZ79682  DATA SHOWN IN SLA GRAPH/CHART INCONSISTENT WITH SLA DETAILS
           When a page is displayed with both an SLA graph or chart for a service, 
           the data shown is inconsistent with the SLA details i.e. an outage 
           shown in the details can sometimes not be shown in the SLA graph.
           
	
  IZ79767  NULL ERROR DISPLAYED ON EXPANDING DELETED SERVICE IN SERVICE
           When services are deleted, they remain visible in the service
           tree until the service tree is refreshed. Clicking on the + 
           sign to expand a Service Tree Parent node gives a null
           error if the Parent Service is deleted.           
	
  IZ80825  OUT OF MEMORY ON DATA SERVER
           The consumer queue contained large amounts of data. This caused 
           out of memory exceptions on Data Server.  Not all of the data is 
           needed on the queue so the fix was to reduce the size of the queue.

  IZ80953  NULL POINTER ERRORS IN THE DATA SERVER LOG
           TBSM Primary DataServer begins dumping then Secondary attempts to
	     take Primary role and crashes. Null pointer exceptions found in the
           logs.	

  IZ81602  TBSM 421 EVENTS NOT SHOWED CORRECTLY	
           The Events column in the Service tree scorecard show grey question 
           marks. This usually happens after a batch of events has been cleared.

  IZ81885  API TO GET THE SERVICE TREE FROM TBSM
           Cannot call top level services from radshell.

  IZ84140  NO POSSIBILITY TO CHANGE DATA SOURCE
           If a user has installed TBSM historical reporting, and configured it to
	     point to a certain ITM machine, then tries to make it point to another 
           ITM machine, user is not able to do so since there seems to be no 
           possibility to change data source information for TBSM package from 
           TCR web UI. When trying to generate the default TBSM historical reports
	     getting the message: 
           + Cannot open the connection for the driver:
           org.eclipse.birt.report.data.oda.jdbc Failed to get connection. SQL error #1:
	     The url cannot be null "
           See additional information section below.

  IZ84659  HOW TO DETERMINE NUMBER OF SERVICES ASSOCIATED TO A VIEW
           Customer needed a new function to count dependent objects 
           under a parent. See additional information section below.
	
  IZ84826  DO NOT USE "&" CHARACTER IN THE NAME OF THE TEMPLATE
           It will cause critical error situation if user defines a template 
           name with invalid characters.For example, Customer defined a 
           template including the "&" symbol/ special Character which when 
           saved and server stopped and restarted caused the Data server 
           to no longer initialize.Invalid characters cannot be used for 
           template names. See additional information section below.

  IZ85000  RAD_COMPILEWSDL.BAT COMMAND HANGS
           Using RAD_COMPILEWSDL.BAT to compile a WSDL file with extended 
           types, hangs. The command does not finish.See additional information 
           section below.
	
  IZ86017  ORACLE DATA FETCHER BREAKS WHEN ORACLE RESTARTED
           When the oracle database is restarted, TBSM datafetchers lose 
           the connection to the database, the data fetchers never
           seem to re-initialize a connection to the database.Error found 
           in the logs are similar to: Error with SQL Syntax or 
           Resync...Ioexception: Broken pipe Fetched failed.	

  IZ86425  ERROR RUNNING SELECT QUERY O RETRIEVE DATA FROM MSSQL 2005
           Using the DirectSQL function in a policy against MSSQL 2005 
           with 3 fields, datasource, query and countonly results in 
           an error - 
           com.jnetdirect.jsql.JSQLException: sp_cursoropen: 
           Specified concurrency control option 4 (OPTIMISTIC) is 
           incompatible with static or fast forward only cursors.
           Only read-only is compatible with static or fast forward only 
           cursors.

  IZ88180  IS THERE IS ANY RADSHELL COMMAND TO ASSOCIATE AN EXISTING 
           SERVICE TO AN EXISTING TEMPLATE
           Customer wanted a radshell command to associate an existing 
           service to an existing template. Added new setTemplateForInstance 
           radshell command. See additional information section below.
	
  IZ89601  CUSTOM CANVAS CORRUPTION WHEN CANVAS IS VIEWED BY THINCLIENT USER
           Custom canvas widgets, especially circularGauges stop getting updates 
           whenever a user (in Thin Client mode) views the custom canvas. All 
           users, including Full Client users loose the capability of getting 
           updates on the custom canvas. Issue does not clear, unless a re-start 
           of the Dashboard server is done.           
	
  IZ90044  USER PREFERENCES GETTING CHANGED TO 0 BYTES
           TIP portlet pages for users get completely blanked out, do not 
           display portlets. User preference prefs.xml files somehow get wiped to 
           0 bytes. TBSM code used to make a backup of the prefs.xml file so in 
           case, the prefs.xml file ever went to zero, the prefs.xml file could 
           be restored using the backup. But since the location of the prefs.xml 
           file was changed by TIP, TBSM was pointing to the wrong location and
           hence no backup was being created.

  IZ91241  MS SQL DATA FETCHER BREAKS WHEN MS SQL RESTARTED
           When the MS SQL data source is recycled, connections to the data 
           sources are not restored unless TBSM is recycled.The following is 
           shown in the logs:
	      com.micromuse.sla.databrowser.DataBrowserViewBean 
            getBrowserData ENTER^^T^CTGBA0049E An exception occurred while 
            processing the query select * from BC_Chronic_Scores. 
            Error with SQL Syntax or Resync...DBComms.transmit 
		exception:[java.net.SocketException: Broken pipe] context:[(1) [Thread
		[TransBlockRunner 4,5,main], IO:66e16, Dbc:c400c]]                    
            com.micromuse.sla.soap.RADSoapException:            
		CTGBA0049E An exception occurred while processing the
		query select * from BC_Chronic_Scores. Error with SQL Syntax or       
		Resync...DBComms.transmit exception:[java.net.SocketException: Broken 
		pipe] context:[(1) [Thread[TransBlockRunner 4,5,main], IO:66e16, Dbc: 
		c400c]]                                                               

  IZ91988  MAX VALUE ON THE SPEEDOMETER SHOWS 0 (ZERO)
           When using circularGauge2, there are two conditions that cause the 'max' 
           value on the gauge to display a zero '0' value instead of a default 
           value of '100'. All other circular Gauges automatically default to 
           display a default of zero '0' for the minimum gauge value and '100' 
           for the maximum. These values are shown on the gauge as the 
           min/max speedometer values.

  IZ92255  TBSM TOOLKIT WILL NOT RUN WITH TADDM 7.1.0
  	     TBSM toolkit will not start when connecting to TADDM 7.1.0. This APAR
           has been fixed by the toolkit available in this Interim Fix 3.
 

     
====================================================================
This TBSM Interim Fix includes the latest TIP fixes for TNSQM issues.

The following javascript files will be replaced:

<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/content.js
<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/ibm/tivoli/tip/charts/dijit/ParametersWidget.js
<TIPHOME>/systemApps/isclite.ear/TIPChartPortlet.war/js/ibm/tivoli/tip/charts/dijit/ParametersWidget.js 
<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/dojox/grid/_data/model.js
<TIPHOME>/systemApps/isclite.ear/isclite.war/secure/isclite/scripts/ibm/tivoli/tip/dojo/Server.js 

The installer will backup the script files to the following
location: 
- Copy of <TIPHOME>/systemApps/isclite.ear/TIPChartPortlet.war/js/ibm/
 tivoli/tip/charts/dijit/ParametersWidget.js (ParametersWidget.js.fp2)
 can be found in the same directory as the original.
- Copy of the rest of the files can be found under:     
[InstallDirectory]/tip/systemApps/isclite.ear/isclite.war/
   secure/isclite/scripts_BACKUPFP2   

After this Interim Fix has been installed, clear the browser 
cache on the machine where you run your BROWSER. This 
will allow the browser to pick up changes to the javascript 
files. 

For example, in Firefox, select Tools --> Clear Private Data,
and select "Cache".
In Internet Explorer, select Tools --> Delete Browsing History, 
and click "Delete" for "Temporary Internet Files".


====================================================================
This TBSM Interim Fix enables the user to launch to WebGUI 7.3.1 from TBSM 4.2.1.
 
There are three basic steps needed to enable the new launch 
being provided with this support:

1)Create the RawEvents view for the Netcool/OMNIBus used by TBSM and 
WebGUI 731. 

  To create the TBSM views, execute the following command on the Dashboard server:

  If WebGUI is installed locally:
  On Unix:
  1. Open a command shell as a user with administrator permissions on Tivoli
  Integrated Portal.
  2. Change directories:
  cd <WebGUI NCHOME>/omnibus_webgui/waapi/bin/
  3. Run the command:
  ./runwaapi -file <TBSM TIP_HOME>/systemApps/isclite.ear/sla.war/install/
  webtopcore/create_tbsm_views.xml -user <userid> -password <password>

  On Windows:
  1. Open a command prompt as a user with administrator permissions on Tivoli
  Integrated Portal.
  2. Change directories:
  cd <WebGUI NCHOME>\omnibus_webgui\waapi\bin\
  3. Run the command:
  runwaapi -file <TBSM TIP_HOME>\systemApps\isclite.ear\sla.war\install\
  webtopcore\create_tbsm_views.xml -user <userid> -password <password>

  If WebGUI is installed remotely:  
  1. Copy the <TIP_HOME>/systemApps/isclite.ear/sla.war/install/webtopcore/create_tbsm_views.xml 
     from the TBSM server to <NCHOME>/omnibus_webgui/waapi/bin on the WebGUI server 
  2. On the WebGUI server change directories:
    cd <NCHOME>/omnibus_webgui/waapi/bin 
  3. On Unix:
     Run the command:     
     ./runwaapi -file <create_tbsm_views.xml> -user <userid> -password <password>

     On Windows:
     Run the command:     
     runwaapi -file <create_tbsm_views.xml> -user <userid> -password <password>

  
2)Enable SSO between the TIP 1.1 server hosting TBSM 421 and the 
TIP 2.1 server hosting WebGUI 731(included within the TIP 
documentation)

3)Enable the launch point within TBSM. To enable the launch point, 
the user would need to do the following:

   - Go to the file canvasDynamicSubMenuActions.xml located on the Data server
     under $TIP_HOME/profiles/TBSMProfile/installedApps/TBSMCell/tbsm.ear/sla.war/av/xmlconfig/.
     Edit this file and search for name = "IntegrationTools". Add the following 
     line to the end of the Old Menu Items of this dynamicSubMenuAction.
     
      <nextAction name = "WebGUI731"/>  
     
     After this addition, the Old Menu Items for this dynamicSubMenuAction will 
     look something like this:

     <!-- Old Menu Items -->
    <nextAction name = "ShowManagedSystem"/>
    <nextAction name = "SoaLaunch"/>
    <nextAction name = "ShowHOPViewLocal"/>
    <nextAction name = "ShowHOPViewRemote"/>
    <nextAction name = "ShowPhysicalTopology"/>
    <nextAction name = "ShowChangeHistory"/>
    <nextAction name = "ShowCIDetails"/>
    <nextAction name = "ShowOpenServiceRequest"/>
    <nextAction name = "TPCLaunch"/>
    <nextAction name = "WebGUI731"/>    
    <!-- End: Old Menu Items -->  


   - Make a backup of the file $TIP_HOME/profiles/TBSMProfile/
     installedApps/TBSMCell/tbsm.ear/sla.war/av/xmlconfig/canvasOpenURLActions.xml,
     located on the Data server, to a safe location.

   - Edit the above file to copy the following OpenURLAction to the bottom 
     of the file, just before </canvasConfig>.

<openURLAction description="Show service affecting events in a WebGUI 731 AEL."
    displayName="Service Affecting Events (WebGUI 731 AEL)"
    enableDisableExpression="" name="WebGUI731"
    permissionCheckerClassName="com.micromuse.sla.map.AVCheckRADInstancePermissionsImpl"
    roleRequired="ncw_user"
    target="javascript:new parent.TBSM_executeCMSAction(__URL__);" visibleInGUI="false">
    { 
      "launchType": "WEB_URL", 
      "isAEL": "true",
      "uri": "https://__WebGUI_731_HOST__:16311/ibm/console/webtop/AELView/?sql=SQL_FILTER&amp;transientname=RawEvents__"_"+ServiceInstanceID__&amp;viewname=RawEvents&amp;viewtype=system&amp;forceoverwrite=true",
      "parameters": [ 
            { "name": "RADEntityName", "value": "__entityName__"}, 
            { "name": "RADEventFilterType", "value": "RawEvents"} 
      ] 
    }
  </openURLAction>   
   
   - Search for the stanza where the name="WebGUI731".

   - Within this stanza change the value of the visibleInGUI 
attribute from "false to "true" and replace 
the __WebGUI_731_HOST__ variable with the fully-qualified 
hostname of the server hosting the WebGUI 731 application.

   -Verify that the default port specified following the host 
name (16311) is correct. If a different port was selected 
when installing WebGUI 731,then modify the port number 
accordingly. Also,verify that the root context(/ibm/console/)
of the URL is correct.

     
    -Save the changes to the file and restart the dashboard and 
data servers in the environment.

   -After restart, the right-click "Launch to" context menu 
should contain a menu item titled "Service Affecting Events (WebGUI 731 AEL)".

====================================================================

This TBSM Interim Fix includes fixes for the TBSM toolkit that supersedes
the toolkit portion of TBSM 4.2.1 FP2. There is a separate README
available for the toolkit - 4.2.1-TIV-BSM-IF0003-DLT.README.

====================================================================


Installation, migration, upgrade and configuration information:
---------------------------------------------------------------

   * Hardware and software requirements:

      Refer to the TBSM 4.2.1 Release Notes for a full description
      of all the hardware and software requirements.

      You will need 1.5G of disk space in order to install this
      Interim Fix.  Please check the amount of space you have before you
      install, as the installation will fail if you run out of 
      space.

   * Dependencies:
      
      This Interim Fix must be installed on each server(s) that is running 
      the TBSM data server and TBSM dashboard server.

      This Interim Fix requires TBSM 4.2.1 FP2 to be installed.       


   * Special considerations:

   1) A copy of the sla.war files will be made and placed in:
     [InstallDirectory]/
     tip/logs/tbsm/maintenance/backup/4.2.1.2/IF0003/data/sla.war
      and
     [InstallDirectory]/
     tip/logs/tbsm/maintenance/backup/4.2.1.2/IF0003/dash/sla.war

   2) All TBSM and TIP processes or services must be stopped prior
       to the update install.  

        On Linux/Unix: perform the following

        1. To stop the TBSM Data server issue the following command:
           $TIP_HOME/profiles/TBSMProfile/bin/stopServer.sh server1 -username <adminuser> -password <adminpassword> 

        2. To stop the TBSM Dashboard server, issue the following command: 
            $TIP_HOME/profiles/TIPProfile/bin/stopServer.sh server1 -username <tipadminuser> -password <adminpassword> 
            By default, username is tipadmin and password 
            is the tipadmin password.

         On Windows:

         1. In the Start menu, click Settings -> Control Panel
          -> Administrative Tools -> Services.
           The Services window opens. Depending on what services 
           you have installed, the available services are as follows: 

           Tivoli Business Service Manager - TBSMProfile_Port_17310. 
             This is the Data server. 
           Tivoli Integrated Portal - TIPProfile_Port_16310.
             This is the Dashboard server. 
           Tivoli BSM Discovery Library toolkit 
           Tivoli Postgres Database 
           EIF probe 
             This service appears only if the EIF probe was installed 
             as a Windows service. 
           OMNIbus server (the Netcool/OMNIbus ObjectServer) 
           OMNIbus gateway (the Netcool/OMNIbus Bidirectional
             ObjectServer Gateway; This service is created if you 
             created a service for the OMNIbus bidirectional gateway 
             when you configured OMNIbus for failover)

         2. Right-click the service that you want to stop and click Stop.
  

   3) The installer will backup the script files to the following
      location. These files are being backed up because the TIP
      fix for TNSQM issues in this Interim Fix will replace some of 
      these files.
       
      [InstallDirectory]/tip/systemApps/isclite.ear/isclite.war/
        secure/isclite/scripts_BACKUPFP2             

  4) All non-vital programs should be closed prior to installation of 
     the Interim Fix. Other processes accessing the [InstallDirectory],
     tip directory or it's sub-directories may cause conflicts with the
     Interim Fix installation. A reboot may be necessary to ensure no rogue 
     processes are accessing the install directory.

  
 * Extracting this Interim Fix:
     Non-Windows
     
      1. Copy the file 4.2.1.2-TIV-BSM-IF0003-<os>.tar to a 
         temporary location on your TBSM Server.
      2. Untar the file on each server that you need to install on.
         tar -xvf 4.2.1.2-TIV-BSM-IF0003-<os>.tar 


     Windows 
       1.Copy the file 4.2.1.2-TIV-BSM-IF0003-windows.zip to a
         temporary location on your TBSM server.
       2. Unzip the file on each server that you need to install on.

     After untarring/unzipping the file you will have 3 directories:
       DiscoveryLibrary - Updates to the TBSM Toolkit
       omnibus - no changes - ignore
       TBSM --TBSM data server and dashboard server updates, 
              TIP updates
       
  

   * Installing this Interim Fix:

      [Interim Fix] Refers to the directory where this Interim Fix
      resides (after you have extracted it from the zip/tar file).  

      On the Tivoli Business Service Manager server system:

        Navigate to the [Interim Fix] directory where the files
          were extracted.

        Install the Interim Fix with the same user that was used to 
        install TBSM 4.2.1 GA.
        Note: the Interim Fix cannot be installed as "root".        

      All TBSM Servers
      ===================================================
       1.)Navigate to the TBSM directory.
       2.)To install Interim Fix 3, 
          If you are on a Windows operating system, run the following
          command from a prompt:       
 
             setup-windows.exe -i console 

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

             setup-<unixplatform>.bin -i console
           
          NOTE: There is no GUI mode for this Interim Fix. It
                can only be installed in console mode.
                For example ./setup-linux.bin -i console
                        or   setup-windows.exe -i console

       3.)During the install you will be asked to to verify
          path names to the TIP install.
      
       4.)Notes and Post-Install Considerations:
       
          a)For the latest TIP fixes for TNSQM issues to take effect,
            after this Interim Fix has been installed, clear the browser 
            cache on the machine where you run your BROWSER. This 
            will allow the browser to pick up changes to the javascript 
            files. 

		For example, in Firefox, select Tools --> Clear Private Data,
 		and select "Cache".
		In Internet Explorer, select Tools --> Delete Browsing History, 
            and click "Delete" for "Temporary Internet Files".
          
          b) For the SLA chart to display correctly, AlterSLAColumns.sql 
             needs to be run against the postgres DB before using TBSM. This file 
             can be found on the data server under $TIP_HOME/profiles
             /TBSMProfile/installedApps/TBSMCell/tbsm.ear/sla.war/install.
             After installing the IF, run the following steps on your
             TBSM data server:

             On Linux/Unix: 
             1. Stop TBSM
		 2. Start postgres: 
			$TBSM_HOME/bin/rad_db start
             3. cat <TIP_HOME>/profiles/TBSMProfile/installedApps/TBSMCell/tbsm.ear/
              sla.war/install/AlterSLAColumns.sql  | <INSTALL DIR>/tbsm/bin/rad_db log | tee  AlterSLAColumns.sql.output             

             On Windows:
             1. Stop TBSM
		 2. Start postgres: 
			<TBSM_HOME>\bin\rad_db start
             3. type <TIP_HOME>\profiles\TBSMProfile\installedApps\TBSMCell\tbsm.ear\
              sla.war\install\AlterSLAColumns.sql  | <INSTALL DIR>\tbsm\bin\rad_db log              

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

      5.)Restart all servers.

        

 * Uninstalling the Interim Fix:

   Before uninstalling the Interim Fix all TBSM processes should be
   STOPPED. The interim fix will NOT stop any TBSM process for the user.
   The user must manually stop the TBSM processes, before the install
   of the Interim Fix and before the uninstall of the Interim Fix.  
   
      On the Tivoli Business Service Manager server system:

       1.Navigate to the TBSM directory
          <installDir>/_uninst/TBSM_IF3 
          
          Uninstall the Interim Fix with the same user that was used 
          to install TBSM 4.2.1 GA.         
          
      
       2. If you are on a Unix operating system, run the following
          command from a prompt.

             ./uninstall -i console
         

          If you are on a Windows operating system, run the following
          command from a prompt:
             
             uninstall.exe -i console

       3.Upon uninstalling, check if the following maintenance folder exists:

         [InstallDirectory]/tip/logs/tbsm/maintenance  

         If it does exist, check the TBSMUninstall-00.log file for <warningCount> 
         (found normally towards the bottom of the log).If the warningCount 
         is not 0,and if the error message has 'ACUASI0196E Encountered 
         problem trying to delete file', replace the sla.war directory on 
         the system with the backup sla.war found under:

         On the Data Server:
            the sla.war directory can be found under:
            [InstallDirectory]/
            tip/profiles/TBSMProfile/installedApps/TBSMCell/tbsm.ear
  
         	the backup sla.war can be found under:
        	[InstallDirectory]/
        	tip/logs/tbsm/maintenance/backup/4.2.1.2/IF0003/data
        
         On the Dashboard Server:
            the sla.war directory can be found under:
            [InstallDirectory]/
            tip/systemApps/isclite.ear

         	the backup sla.war can be found under:
        	[InstallDirectory]/
        	tip/logs/tbsm/maintenance/backup/4.2.1.2/IF0003/dash

         The TBSMUninstall-00.log file can be found in the user's home 
         directory.

       4.Delete the maintenance folder as follows before reinstalling
         [InstallDirectory]/tip/logs/tbsm/maintenance          
        
       5.Restart the Data Server and Dashboard Server

       6.On Unix operating systems, uninstalling the Interim Fix may remove 
        execute permissions from rad files, in the <INSTALL DIR>/tbsm/bin
        directory. To determine if this is the case, change to the
        directory and use ls -l rad* command, as below:

      	cd <INSTALL DIR>/tbsm/bin
               ls -l rad*

        The permissions should show execute (x) for each file,
        for all groups.

-rwxr-xr-x  1 <user> <user group> 2529  Aug 30  2008 rad_compilewsdl
-rwxr-xr-x  1 <user> <user group> 2238  Aug 30  2008 rad_crypt
-rwxr-xr-x  1 <user> <user group> 19398 Jul 20 14:02 rad_db
-rwxr-xr-x  1 <user> <user group> 2827  Aug 30  2008 rad_discover_schema
-rwxr-xr-x  1 <user> <user group> 2225  Aug 30  2008 rad_keystore
-rwxr-xr-x  1 <user> <user group> 2084  Aug 30  2008 rad_maint_add
-rwxr-xr-x  1 <user> <user group> 2084  Aug 30  2008 rad_maint_remove
-rwxr-xr-x  1 <user> <user group> 4055  Aug 30  2008 rad_radshell
-rwxr-xr-x  1 <user> <user group> 2494  Jul 20 14:02 rad_reinitcanvas
-rwxr-xr-x  1 <user> <user group> 2258  Aug 30  2008 rad_sendevent

If required, use chmod 755 to update the permission for required files,
 i.e.   chmod 755 rad_db



* Installing the TBSM agent:
      The following packages are available for download in the 
      Interim Fix 3.
	 - r9v421b2-110119.aix.tar
	 - r9v421b2-110119.sun.tar
	 - r9v421b2-110119.ilinux.tar
	 - r9v421b2-110119.zlinux.tar
	 - R9C421B2-110119.Windows.zip

    1)Download the appropriate agent code for your platform.
    2)Untar or unzip the file.
    3)Install the agent according to the directions in the TBSM 
      Installation Guide. This is a complete install package
      for the TBSM agent support and can be used for a fresh 
      install of the agent.

      
 ====================================================================
Additional Information

IZ75707: CHANGE TO OUTPUT EXPRESSION WEB PAGE (TO SHOW TRANSLATION FOLLOW
         FOLLOW BY ENGLISH)

TBSM Service Configuration Guide   
Chapter: Service Templates
Section: Output expressions                                             
Sub-Section: Creating and editing output expressions

"Expression builder drop-down lists and Insert buttons "

To use these fields, select the value you want from the drop-down list 
and click Insert to the right of the field. For non-English browsers, 
translated values will be displayed in the drop down lists, followed by 
English, displayed in brackets. The Insert buttons will insert the English 
only, as this is required for TBSM processing.

IZ78143: LAUNCH IN CONTEXT SQL SCRIPTS ARE WRONG

Please refer to TBSM Customization Guide TBSM FP2, Section=Configuring 
the launch URL in IBM Tivoli Monitoring, Sub-Section= Procedure
 
Point 4. 
The & character before the ManagedSystemName must be URL encoded, i.e. 
replaced with %26 when specifying the URL. 
The = character after the ManagedSystemName must be URL encoded, i.e. 
replaced with %3D when specifying the URL. 

IZ78337: SCORECARD SHOWING INCONSITIENT VALUES FOR A DECIMAL DATA COLUMN

If the user doesn't want the max decimal places to be controlled by TBSM, 
the following property in the RAD_sla.props file needs to be uncommented
and set to false. Default is true. 

#impact.sla.setMaxDecimalPlaces=false.

To set the maximum number of decimal places for KPI values on the scoreboard,
the following property in the RAD_sla.props file needs to be uncommented
and set to some number. Default is 3. 

#impact.sla.kpidecimalplaces=somenumber


IZ78826: PROBLEMS WRITING TO OMNIBUS CAUSES OOM AND DATA SERVER CRASH

The consumerQueue will now be limited based on a impact.sla.maxconsumerqueueentries 
property in the RAD_sla.props file. Once the consumerQueue reaches this limit, 
it will no longer add to the queue. The consistency checker will take care 
of ensuring all the status of the service instances are correct.Default 
is 500,000. The following property in RAD_sla.props file needs to be
uncommented and filled with some number. 

# impact.sla.maxconsumerqueueentries=somenumber


IZ79682:  DATA SHOWN IN SLA GRAPH/CHART INCONSISTENT WITH SLA DETAILS

For this function to work properly, the user will need to run the file 
SLAColumns.sql against the postgres DB before the user runs TBSM, 
or SLA chart will not display. This file, AlterSLAColumns.sql,can be 
found on the data server under $TIP_HOME/profiles/TBSMProfile
/installedApps/TBSMCell/tbsm.ear/sla.war/install. The steps for running 
the file against the postgres DB are mentioned under Installing this 
Interim Fix->Notes and Post-Install Considerations. If the user has 
run this file once, there is no need to run it again.  

IZ84140:  NO POSSIBILITY TO CHANGE DATA SOURCE

If the user needs to change the ITM warehouse database connection information 
or get errors indicating a connection failure such as

ReportDesign (id = 1):
+ Cannot open the connection for the driver:org.eclipse.birt.report.data.oda.jdbc
Failed to get connection.
SQL error #1: The url cannot be null 

the user needs to configure the TBSM historical reports to enable a database 
connection using JDBC (see steps below). This allows the user to alter the 
database configuration through the Reporting GUI. 

Steps to follow:
1.  Rename [InstallDirectory]/tip/products/tcr/data/database/resource/tbsm/resources/tbsm/lib/tbsm.rptlibrary
2.  Copy tbsm.rptlibrary from under [InstallDirectory]/tip/products/tcr/data/database/resource_IF3/
    resources/tbsm/lib to the location in step 1.
3.  Copy db2jcc.jar and db2jcc_license_cu.jar from [InstallDirectory]/tip/universalDriver/lib
    to [InstallDirectory]/tip/products/tcr/lib/birt-runtime-2_2_1/ReportEngine/plugins/
    org.eclipse.birt.report.data.oda.jdbc_2.2.1.r22x_v20070919/drivers. If user is using
    Oracle, user needs to copy the Oracle jdbc drivers to the above mentioned location.
4.  Select a TBSM report: Common Reporting -> Report Sets -> Tivoli Products -> 
    Tivoli Business Service Manager
    Click on Detail Reports, Summary Reports, or top Level Service.
5.  Right click on any reports in the right-hand pane to open the context menu.
6.  Select "Data Sources ..."
7.  Select "ITM Warehouse" and click Edit on the bottom of the pane.
8.  Configure the data source for your installation:
    a.  User ID
    b.  Password
    c.  DB2_HOST_NAME, DB2_PORT, DB2_DATABASE_NAME, DB2_SCHEMA in JDBC URL parameter.  
        An example is
        jdbc:db2://servername.com:50000/WAREHOUS:currentSchema=ITMUSER;
    Note: If the user is using Oracle, user needs to put in the Oracle data source
          information and configure the JDBC DRIVER field in addition to the above
          mentioned fields.    
9.  Select SAVE at the bottom of the pane.
10. Close the Report Data Sources UI.
11. Run a report.  Restarting TBSM is not required.        


IZ84659: HOW TO DETERMINE NUMBER OF SERVICES ASSOCIATED TO A VIEW

This function is not made to be executed multiple times in an environment
with a large service model. As with any radshell command, objects 
in memory are manipulated and could cause more objects to be created 
thus resulting in an OOM problem.


IZ84826: DO NOT USE "&" CHARACTER IN THE NAME OF THE TEMPLATE

To fix this issue, line impact.template.invalidNameChars 
for the Template has been added in RAD_namevalidator.props file 
for both data and dashboard servers.

The RAD_namevalidator.props file for the dashboard server is located in
$TIP_HOME/systemApps/isclite.ear/sla.war/install/etccore/RAD_namevalidator.props
and $TIP_HOME/systemApps/isclite.ear/sla.war/etc/rad/RAD_namevalidator.props

The RAD_namevalidator.props file for the data server is located in
$TIP_HOME/profiles/TBSMProfile/installedApps/TBSMCell/tbsm.ear/sla.war
/install/etccore/RAD_namevalidator.props and $TIP_HOME/profiles/TBSMProfile
/installedApps/TBSMCell/tbsm.ear/sla.war/etc/rad/RAD_namevalidator.props

For example:
# validation attributes for a template
impact.template.invalidNameChars =$! %&"<>|:/*\\?


IZ85000: RAD_COMPILEWSDL.BAT COMMAND HANGS

To enable RAD_COMPILEWSDL to use extended types, the Sun JRE 1.6 or above  
must be installed and the SUNJREEXEC environment variable set to the full path, 
including file name of the Sun java.exe, 
i,e,

On Unix
1. Install Sun's JRE 1.6 or above (if not already installed)
2. Set the SUNJREEXEC env variable as appropriate, i,e,
export SUNJREEXEC=/opt/SunJRE/jre1.6.0_23/bin/java

On Windows
1. Install Sun's JRE 1.6 or above (if not already installed)
2. Set the SUNJREEXEC env variable as appropriate, i,e,
set SUNJREEXEC=C:\Program Files\Java\jre1.6.0_05\bin\java.exe
    NOTE:  Do NOT enclose the fully qualified directory name in quotes!

To stop using the Sun JRE and go back to using the default TBSM supplied JRE, 
all that is needed, is set the SUNJREEXEC back to blank.



IZ88180: IS THERE IS ANY RADSHELL COMMAND TO ASSOCIATE AN EXISTING SERVICE 
         TO AN EXISTING TEMPLATE.
Usage:
radshell> help("setTemplateForInstance");
/**
 * associate an existing service to an existing template.
 * @param serviceName 
 * @param templateName 
 */
public void setTemplateForInstance( String serviceName, String templateName )
---------------------------------------------------------------------------
For example, "DBCluster1" is an existing service instance name, 
"DB1" is an existing template name and do not associate to "DBCluster1".

radshell> setTemplateForInstance("DBCluster1","DB1");      
DBCluster1 associated to DB1 successfully!

Exceptions:
a. CTGBC0032E The instance named # was not retrieved.
b. CTGBB0006E The template name # was not found.
c. serviceName has been associated to templateName

For example, Service instance "1" and template "2" do not exist;
Template "DBCluster" has been a template of service instance "DBCluster1";
radshell> setTemplateForInstance("1","2");
CTGBC0032E The instance named 1 was not retrieved.
radshell>  setTemplateForInstance("DBCluster1","2");       
CTGBB0006E The template name 2 was not found.
radshell>  setTemplateForInstance("DBCluster1","DBCluster");
DBCluster1 has been associated to DBCluster


====================================================================
Troubleshooting/Known Issues

1)One problem that prevents the launch to omnibus from working on the 
initial attempt when SSO is configured.
The error message is: "Error 500: java.lang.IllegalArgumentException:
containerSessionId is null or empty". 
After this initial error,subsequent attempts to launch succeed and do
not require the user to enter credentials.Without SSO configured, 
the error does not occur, however, the user is prompted to enter user
credentials at the TIP 21 login screen before being redirected to the 
AEL.

2)In order for TIP 2.1 products and TIP 1.1 products to share the same 
host name within the same browser session, SSO must be enabled for 
both TIP stacks.
====================================================================

Notices and trademarks:
-----------------------

   Notices:

    This information was developed for products and services offered 
    in the U.S.A. IBM may not offer the products, services, or 
    features discussed in this document in other countries. Consult 
    your local IBM representative for information on the products 
    and services currently available in your area. Any reference to 
    an IBM product, program, or service is not intended to state or 
    imply that only that IBM product, program, or service may be 
    used. Any functionally equivalent product, program, or service 
    that does not infringe any IBM intellectual property right may be
    used instead. However, it is the user’s responsibility to 
    evaluate and verify the operation of any non-IBM product, 
    program, or service.

    IBM may have patents or pending patent applications covering 
    subject matter described in this document. The furnishing of this 
    document does not give you any license to these patents. You can 
    send license inquiries, in writing, to:

    IBM Director of Licensing 
    IBM Corporation
    North Castle Drive
    Armonk, NY 10504-1785 U.S.A.

    For license inquiries regarding double-byte (DBCS) information, 
    contact the IBM Intellectual Property Department in your country 
    or send inquiries, in writing, to:

    IBM World Trade Asia Corporation
    Licensing
    2-31 Roppongi 3-chome, Minato-ku
    Tokyo 106, Japan

    The following paragraph does not apply to the United Kingdom or 
    any other country where such provisions are inconsistent with 
    local law:

    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 states do not allow disclaimer of express or implied 
    warranties in certain transactions, therefore, this statement 
    might 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.

    Any references in this information to non-IBM Web sites are 
    provided for convenience only and do not in any manner serve as 
    an endorsement of those Web sites. The materials at those Web 
    sites are not part of the materials for this IBM product and use 
    of those Web sites is at your own risk.

    IBM may use or distribute any of the information you supply in 
    any way it believes appropriate without incurring any obligation 
    to you.
 
    Licensees of this program who wish to have information about it  
    for the purpose of enabling: (i) the exchange of information 
    between independently created programs and other programs 
    (including this one) and (ii) the mutual use of the information 
    which has been exchanged, should contact:

    IBM Corporation
    2Z4A/101
    11400 Burnet Road
    Austin, TX 78758 U.S.A.

    Such information may be available, subject to appropriate terms 
    and conditions, including in some cases payment of a fee.

    The licensed program described in this document and all licensed 
    material available for it are provided by IBM under terms of the 
    IBM Customer Agreement, IBM International Program License 
    Agreement or any equivalent agreement between us.

    Any performance data contained herein was determined in a 
    controlled environment. Therefore, the results obtained in other 
    operating environments may vary significantly. Some measurements 
    may have been made on development-level systems and there is no 
    guarantee that these measurements will be the same on generally 
    available systems. Furthermore, some measurement may have been
    estimated through extrapolation. Actual results may vary. Users 
    of this document should verify the applicable data for their 
    specific environment.

    Information concerning non-IBM products was obtained from the 
    suppliers of those products, their published announcements or 
    other publicly available sources. IBM has not tested those 
    products and cannot confirm the accuracy of performance, 
    compatibility or any other claims related to non-IBM products. 
    Questions on the capabilities of non-IBM products should be 
    addressed to the suppliers of those products.

    All statements regarding IBM’s future direction or intent are 
    subject to change or withdrawal without notice, and represent 
    goals and objectives only.

    This information may contain examples of data and reports used in 
    daily business operations. To illustrate them as completely as 
    possible, the examples include the names of individuals, 
    companies, brands, and products. All of these names are 
    fictitious and any similarity to the names and addresses used by 
    an actual business enterprise is entirely coincidental.

    COPYRIGHT LICENSE:

    This information may contain sample application programs in 
    source language, which illustrate programming techniques on 
    various operating platforms. You may copy, modify, and distribute 
    these sample programs in any form without payment to IBM, for the 
    purposes of developing, using, marketing or distributing 
    application programs conforming to the application programming 
    interface for the operating platform for which the sample 
    programs are written. These examples have not been thoroughly 
    tested under all conditions. IBM, therefore, cannot guarantee or
    imply reliability, serviceability, or function of these programs. 
    You may copy, modify, and distribute these sample programs in any 
    form without payment to IBM for the purposes of developing, 
    using, marketing, or distributing application programs conforming
    to IBM's application programming interfaces.


   Trademarks:

    The following terms are trademarks of International Business 
    Machines Corporation in the United States, other countries, or 
    both: IBM, IBM logo, Tivoli, Tivoli logo, AIX®, AOC/MVS™, APPN, 
    CICS®, CICSPlex®, CICS/ESA®, DB2®, DB2 Universal Database™, 
    DFSMShsm™, Domino®, DB2 Universal Database, IMS™, IMS/ESA®,
    Informix®, MQSeries®, MVS, MVS/ESA™, NetView®, NWays, OS/390®,
    RACF®, RMF™, SNA/APPN, SecureWay®, Tivoli Enterprise™, Tivoli
    Enterprise Console®, Tivoli Management Environment, TME 10™,
    VTAM®, WebSphere®, z/OS®.
 
    UNIX® is a registered trademark of The Open Group in the United 
    States and other countries.

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

    Java™ and all Java-based trademarks and logos are trademarks or 
    registered trademarks of Sun Microsystems, Inc. in the United 
    States and other countries.

    Pentium® is a registered trademark of Intel® in the United States 
    and other countries. Other company, product, or service names may 
    be trademarks or service marks of others.

 ====================================================================
