IBM Tivoli Business Service Manager V6.1.0 Fix Pack 3(6.1.0-TIV-BSM-FP0003)

Downloadable files


Abstract

This Fix Pack addresses problems reported in IBM Tivoli Business Service Manager 6.1.0

Download Description

IBM Tivoli Business Service Manager 6.1.0
Fix Pack Version 6.1.0-TIV-BSM-FP0003

====================================================================
Readme file for: IBM Tivoli Business Service Manager
Product/Component Release: 6.1.0
Update name: Fix Pack 3
Fix ID: 6.1.0-TIV-BSM-FP0003
Publication Date: January 18, 2016
Last modified date: January 14, 2016
Online version of the readme file:
http://www.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm+Tivoli&product=ibm/Tivoli/Tivoli+Business+Service+Manager&release=6.1.0

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

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



Contents

1.0 Files included in this Fix Pack
2.0 Hardware and software requirements
3.0 Installation information
3.1 Dependencies
3.2 Prerequisites
3.3 Special considerations
3.4 Superceded Fixes
3.5 Extracting Fix Pack files
3.5.1 Extracting on Linux, Solaris, Linux for System z, and AIX
3.5.2 Extracting on Windows platforms
3.5.3 Fix pack directories
3.6 Maintenance upgrade strategy
3.6.1 Example maintenance scenario
3.7 Installation
3.7.1 Installing the Fix Pack
3.7.2 Discovery Library Toolkit
3.7.3 DBConfig
3.8 TBSM agent
3.9 Uninstalling the Fix Pack
3.10 Recovering from a failed Fix Pack install
3.11 Restoring failed DE upgrade from backup
4.0 Additional information for TBSM Fix Pack 1 APARS
4.1 IV01649 - AFTER ZOOM IN ON CANVAS, SINGLE CLICK CAUSES ZOOM OUT
4.2 IV03630 - SETTRACELEVEL DOES NOT PERSIST NUMBER OF LOG FILES
4.3 IV07914 - TBSM CONSISTENCY CHECKER CONSUMES MUCH OF OS CONNECTION TIME
4.4 IV19006 - THERE IS AN ISSUE WITH THE TBSM 6.1 30 DAY REPORT LAUNCH.URL
TO TCR IS INCORRECT
5.0 List of APARs
5.1 TBSM 6.1.0 Fix Pack 3 APARS
5.2 TBSM 6.1.0 Fix Pack 2 APARS
5.3 TBSM 6.1.0 Fix Pack 1 APARS
5.4 Tivoli Integrated Portal
6.0 New support and features
6.1 TBSM 6.1 Fixpack 2
6.2 Additional Browser Support with FP 2
6.3 eWAS Fixes and Upgrades
6.4 Java Runtime Environment (JRE)
7.0 Firefox 10 issues
7.1 TBSM 6.1 GA launchpad does not work on Firefox 10
8.0 Known issues
8.1 Some date options in TBSM Reports do not work
8.2 Issues creating wire between Service Tree and Active
Event List (AEL)
8.3 TBSM Agent Chart title differs from name in the
drop down list
8.4 Minimize-restore does not restore to correct size for
Service Navigation->Data Fetchers on Internet Explorer(IE) 9
8.5 Portlets covering content in a free form page
8.6 Java Security exception while editing Custom Canvas
8.7 Unexpected wide character messages are displayed in console mode
during installation or upgrade
8.8 Java Runtime Environment (JRE) 1.6.0_nn and
Internet Explorer 10 (and above) and Firefox 17 (and above).
8.9 Announcement of future withdrawal from support for TADDM 7.2.0
and 7.2.1
8.10 Internet Explorer 11 Security Settings
8.11 Internet Explorer and Compatibility View mode
8.12 Using Service Viewer Thin Client with Firefox ESR 38.4
8.13 AppsCan "RC4 cipher suites were detected" and
"Logjam (Diffie-Hellman key exchange downgrade)" issues
8.14 TBSM System Status Page stops working
8.15 AppScan discovered 1 High Severity vulnerability of type
"SQL Injection" in TIPChartPortlet/TIPChartController
9.0 Copyright and trademark information

1.0 Files included in this Fix Pack

Fix Pack 3 addresses the problems that have been reported in IBM
Tivoli Business Service Manager version 6.1.0. The following table
contains a list of files included in this Fix Pack and operating systems
associated with these files:

+---------+--------------------------------------------------------+
| Platform| File |
+---------+--------------------------------------------------------+
| AIX | 6.1.0-TIV-BSM-FP0003-aix.tar |
| | |
| | Agent installer |
| | KR9_aix523CD-6.1.0-TIV-BSM-FP0003.tar.gz -(32 bit) |
| | KR9_aix526CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit) |
+---------+--------------------------------------------------------+
| Linux | 6.1.0-TIV-BSM-FP0003-linux.tar |
| | |
| | Agent installer |
| | |
| | KR9_li6263CD-6.1.0-TIV-BSM-FP0003.tar.gz -(32 bit) |
| | KR9_lx8266CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit) |
+---------+--------------------------------------------------------+
| Solaris | 6.1.0-TIV-BSM-FP0003-solaris.tar |
| | |
| | Agent installer |
| | KR9_sol283CD-6.1.0-TIV-BSM-FP0003.tar.gz -(32 bit) |
| | KR9_sol286CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit) |
+---------+--------------------------------------------------------+
| Windows | 6.1.0.-TIV-BSM-FP0003-windows.zip |
| | |
| | Agent installer |
| | KR9_winntCD-6.1.0-TIV-BSM-FP0003.zip -(32 bit) |
| | KR9_wix64CD-6.1.0-TIV-BSM-FP0003.zip -(64 bit) |
+---------+--------------------------------------------------------+
| zLinux | 6.1.0-TIV-BSM-FP0003-zlinux.tar |
| | |
| | Agent installer |
| | KR9_ls3243CD-6.1.0-TIV-BSM-FP0003.tar.gz -(32 bit) |
| | KR9_ls3246CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit) |
| | KR9_ls3266CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit) |
+------------------------------------------------------------------+
|all platforms| 6.1.0-TIV-BSM-FP0003.README |
+-------------+----------------------------------------------------+
|all platforms| 6.1.0-TIV-BSM-FP0003.README_Translated.zip |
+-------------+----------------------------------------------------+


Note: Whenever <ARCH> is used in the text of this readme, as part of the
filename of the Fix Pack package, it refers to, and can be
substituted for one of the following operating systems:
* Linux
* Solaris
* AIX
* Windows
* zLinux

The following files have been updated or replaced by this Fix Pack.

Added files on the Data Server:
ObjectServer_DS_config.ant
tbsm_generic_ant_caller.bat
tbsm_generic_ant_caller.sh
TBSM_BusCompCreateShadows.js
TBSM_BusCompPlaceAllCIsByIdentifier.js
TBSM_BusCompShadowTechnologyGroups.js
TBSM_ResEnrichReaderRecycle.js
ApplyPoliciesFor61FP3
BSM_TemplateUpdates61FP0003.radsh
setJVMSettings.jy
setJVMSettings.bat
setJVMSettings.sh
smack-2.2.1.jar
smackx-2.2.1.jar
org.apache.axis2-woden.jar
ipa-1.0-20120430.jar
tbsm-info.jar
TDWHistory.xml
Files under tbsm/tools directory

Replaced files on the Data Server:
ASQLStore.class
BSM_Templates.radsh
BSM_Templates_updatepropagation.radsh
BSM_Templates_templates_only.radsh
BSM_Templates_instances_only.radsh
canvasOpenURLActions.xml
collect_logs.ant
fo_config.ant
fo_data_config.ant
tbsm_consistency.zip
setTraceLevel.jy
scriptedAPIStartup.bsh
MigrateUserActionscanvasDynamicSubMenuActions_X.xsl
MigrateUserActionscanvasOpenURLActions_X.xsl
tbsm_viewDefinitionFiles.lst
tbsmDataImport.xml
VisualRepresentationAttributes.xml
av.jar
itmdataclient.jar
maintcli.jar
ncs.jar
ncsagent.jar
ncsSoapClient.jar
RAD_namevalidator.props
TBSM_BusCompPlaceAllCIsByAttr.js
TBSM_markerChangeProvider.ipl
TBSM_ResEnrichMain.js
TBSM_SLAUpdateServiceEvent.ipl
TBSM_AV_GetColorForSeverity.ipl
versioninfo.bat
versioninfo
verutil.jar
Files under tbsm/contrib/gistools

Replaced Impact files on the Data Server:
nciJmxClient.jar
nci.jar
*_EIC_utils.ipl
*_Import.ipl
*_MWM.ipl
*_MigrateMWMWindows.ipl
*_Opview_Add1TWin.ipl
*_Opview_EIC_confSubmit.ipl
*_Opview_EIC_requestHandler.ipl
*_Opview_onetwins.ipl
*_Opview_openwins.ipl
*_Opview_rdomwins.ipl
*_Opview_rdowwins.ipl
*_Opview_rwdomwins.ipl
*_SerialRollover.ipl
*_XINY_DataType_PurgeData.ipl

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.orig)
can be found in the same directory as the original.
- The copy of the files can be found in the following
directory:
[InstallDirectory]/
tipv2/logs/tbsm/maintenance/backup/6.1.0.0/FP0003/data

---
Added files on the Dashboard Server:
ObjectServer_DS_config.ant
tbsm_generic_ant_caller.bat
tbsm_generic_ant_caller.sh
about_icon22.png
about_thumb.png
setJVMSettings.jy
setJVMSettings.bat
setJVMSettings.sh
tbsm-info.jar

Replaced files on the Dashboard Server:
canvasviewer_simple.html
tbsm-jviews.jar
tbsm-jviews-thin.jar
tbsm-symbol-palette.jar
Gauges.xml
Gauges_Content.xml
rad_nodes_links.css
LaunchTBSM.nova
RAD_help_eclipse.props
RAD_sla.props
RAD_namevalidator.props
serviceTreePortletView.jsp
serviceNavigatorPortletView.jsp
CreateDBPoller.jsp
ActionLoader.jsp
delete_template.jsp
About.jsp
esda_model.jsp
actionLoader.jsp
serviceViewerPortletView.jsp
autopop_config.jsp
ChartInstanceChooser.jsp
ism_instances.jsp
instanceuserpreferences.jsp
main_ruleset_id_fields.jsp
main_ruleset_rules_list.jsp
main_rulesets_output.jsp
main_rulesets_rules.jsp
main_rulesets_sla.jsp
serviceTreePortletEdit.jsp
serviceViewerPortletEdit.jsp
taguserpreferences.jsp
InstanceCustomizerWizard.jsp
EventRawAttributeSelector.jsp
TBSMCMPopup.jsp
BIRTChartConfig.jsp
columnProperties.jsp
dependency_rule.jsp
EditDBPollerFrames.jsp
ErrorMessageHandler.jsp
SLAReportToolbar.jsp
main_content.jsp
main_ruleset.jsp
main_rulesets_security.jsp
main_service.jsp
main_service_security.jsp
main_tabs.jsp
main_view.jsp
ServiceInstanceDependents.jsp
LaunchDataBrowser.jsp
rawattributeWizard/raw_event_table_fragment2.jsp
RAD_AV_GetColorForSeverity.ipl
radlabels.properties
ncs.jar
ncsSoapClient.jar
av.jar
ipa-1.0-20120430.jar
itmdataclient.jar
nci.jar
nciClient.jar
ncCommon.jar
tbsm-info.jar
web.xml
faces-config.xml
collect_logs.ant
fo_config.ant
fo_data_config.ant
Policies.jsp
TypeBrowser.jsp
impactAdmin.properties
ROIEffReportIWidget.xml
setTraceLevel.jy
versioninfo.bat
versioninfo
verutil.jar
Files under impactAdmin.war/scripts
Files under sla.war/dojo
Files under sla.war/audit/dojo
Files under twa.war/dojo

Replaced Impact files on the Dashboard Server:
nciClient.jar
nciJmxClient.jar
*-EIC_configure.html
*-new1twin.html
*-newrwin.html
*-newrwin.html


If you have made changes to the above mentioned files you will
find your copy of the file under:
- The copy of the files can be found in the following
directory:
[InstallDirectory]/
tipv2/logs/tbsm/maintenance/backup/6.1.0.0/FP0003/dash

---

Added files associated with the Discovery Library Toolkit:
scc_servicetreebuilder_reinit.sql
scc_servicetreebuilder_guts.sql
scc_servicetreebuilder_delta.sql
scc_servicetreebuilder_composites.sql
taddmconfig.bat
taddmrmiconfig.bat
taddmconfig.sh
taddmrmiconfig.sh
taddmmaint.bat
taddmmaint..sh
unloadBusinessComposerDefinitions.bat
unloadBusinessComposerDefinitions.sh

Replaced files associated with the Discovery Library Toolkit:
scc_refreshnamingcommitchanges.sql
scc_staging_schema_truncate.sql
scc_staging_schema_setup.sql
scc_staging_schema_index_setup.sql
scc_staging_schema_index_deletes.sql
scc_staging_schema_deletes.sql
scc_staging_schema_analyze.sql
scc_staging_schema_view_deletes.sql
scc_staging_schema_views.sql
scc_schema_truncates.sql
scc_schema_setup.sql
scc_schema_drop_indexes.sql
scc_schema_deletes.sql
scc_schema_views.sql
scc_schema_create_indexes.sql
scc_schema2_deletes.sql
scc_schema2_setup.sql
scc_schema_43_new_setup.sql
scc_processingworkingdeleterelations.sql
scc_processDeletes.sql
scc_processcreateattributes.sql
scc_processcreatecomponents.sql
scc_processAPICleanup.sql
scc_processAPIQueue.sql
scc_processcleanupstrandeddata.sql
scc_postdot1deleta.sql
scc_initialize.sql
scc_initiate_failover.sql
scc_migrate_421_to_43.sql
scc_pg_schema_setup.sql
scc_remove_merged_resources.sql
scc_getEnrichmentNotifications.sql
scc_getStageClassList.sql
genScrApiIdml.sql
scc_API_schema_analyze.sql
scc_610if0001_setup.sql
scc_analyzepersistent.sql
scc_processCreates.sql
scc_processAbstractRscs.sql
scc_processingworkingdeletecomps.sql
scc_processRefresh.sql
scc_recalc_dependency_and_counters.sql
createidmlbook.sql
db-cleanup.sql
scc_changeclasstypes.sql
scc_checkfordupsinstage.sql
scc_classToRuleE2.sql
scc_merge_guts.sql
remove_merged_resources.xml
base_schema_truncates.sql
taddm_del_gen_relations.sql
taddm_del_tag_attributes.sql
taddm_schema_setup_db2.sql
taddm_schema_setup_oracle.sql
tbsmudf_clear_regex_cache.db2.sql
ASICLTools.jar
BSM_Templates.xml
BSM_Templates.radsh
BSM_Templates_templates_only.radsh
BSM_Templates_instances_only.radsh
BSM_Templates_updatepropagation.radsh
BSM_TemplateUpdates61FP0003.radsh
BSM_TemplateUpdates61IF0001.radsh
classfilters.xml
uniqueClassFilters.xml
CDM_TO_TBSM4x_MAP.xml
CDM_TO_TBSM4x_MAP_Templates.xml
LabelingRules.xml
NamingRules.xml
EventIdentifierRules.xml
GenIdmlFromTWMNBN.xsl
genStep1DqlForTADDMFromOrm.xsl
getridofnamespaces.xsl
PolicyPatterns.xml
ScrPolicyRulesToSql.xsl
ScrProdcueEmulationsSql.xml
ScrProduceLabelingSql.xsl
ScrProducePostProcessingSql.xsl
ScrProducesql.xsl
sql_symbolics.xml
ScrNamingRulesToSql.xsl
loadBusinessComposerDefinitions.bat
loadBusinessComposerDefinitions.sh
setdbschema.bat
setdbschema.sh
reinit_servicemembership.xml
crviewer.zip (including most jar and SQL files under tools/crviewer)
TBSMExportToImport.xsl


If you have made changes to the above mentioned toolkit files you will
find your copy of the files under:
[InstallDirectory]/tbsm/XMLtoolkit/log/install/maintenance/backup/61FP0003

---

Added files associated with the DBConfig installer:
tbsmdemo_create_indexes.sql
tbsmdemo_create_views.sql
tbsmdemo_drop_indexes.sql
tbsmdemo_drop_views.sql
tbsmmark_create_indexes.sql
tbsmmark_create_views.sql
tbsmmark_drop_indexes.sql
tbsmmark_drop_views.sql

Replaced files associated with the DBConfig installer:
scc_staging_schema_truncate.sql
scc_staging_schema_setup.sql
scc_staging_schema_index_setup.sql
scc_staging_schema_index_deletes.sql
scc_staging_schema_deletes.sql
scc_staging_schema_analyze.sql
scc_schema_truncates.sql
scc_schema_setup.sql
scc_schema_drop_indexes.sql
scc_schema_deletes.sql
scc_schema_create_indexes.sql
scc_schema_views.sql
scc_schema2_deletes.sql
scc_schema2_setup.sql
scc_610if0001_setup.sql
sql_symbolics.xml
setdbschema.bat
setdbschema.sh
dumpsql.bat
dumpsql.sh
ASICLTools.jar


If you have made changes to the above mentioned DBConfig files you will
find your copy of the files under:
[InstallDirectory]/tbsmdb/logs/install/maintenance/backup/61FP0003

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

Hardware and software requirements

For information about hardware and software requirements, see the
Tivoli Business Service Manager Installation Guide on the TBSM
Information Center:

http://www.ibm.com/support/knowledgecenter/SSSPFK_6.1.0/com.ibm.tivoli.itbsm.doc_6.1/welcome.htm

To apply this Fix Pack you will need 3 GB of disk space. Please check
the amount of space you have before you install, as the installation
will fail if you run out of space.

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

This fix pack will contain the following TBSM APARs:

IV53193 INCORRECT PROPERTY USE IN CODE ROOTCAUSEEVENTFIELD USED INSTEAD OF ROOTCAUSEEVENTKEYFIELD
IV53791 EVENT COUNTS FOR PARENT SERVICES IS NOT ALWAYS UPDATED
IV56450 NPE AFTER CLICKING ON 'FIND INSTANCE'
IV56853 RADSHELL IMPORT FAILS DUE TO ORPHANED CHILD SERVICE
IV60168 MODIFIED 'TBSM_NUMERICATTRIBUTEFUNCTIONS' POLICY DOESN'T GET EXPORTED
IV60619 DATA SERVER RESTART REQUIRED TO GET A WORKING DATA FETCHER AFTER DELETION OF DEPENDENT RULE
IV60961 CONCURRENTMODIFICATIONEXCEPTION THROWN WHEN YOU SELECT THE GUI FIND INSTANCE FUNCTION IN THE SERVICE AVILABILITY PORTLET
IV61278 RULE FILTER WITH 'NOT LIKE' ON SUMMARY FIELD MALFUNCTIONS
IV62456 OOM DUE TO CIRCULAR REFERENCES
IV62548 SAME SESSION CONTEXT USED FOR ALL RADSHELL SESSIONS, TRIGGERED FROM POLICIES
IV63608 AFTER FIX FOR APAR IV32754 SEE SQLSTATE=42704 EXCEPTION FOR TBSMSCR.SCCP_COMPCLASS IN TOOLKIT LOGS.
IV64797 SETDBSCHEMA -F A COMMAND SHOULD ALSO RESET THE RESENRICHREADER SERVICE.
IV64933 [NetcoolTimeoutException] Log file exceptions when persistifing ESDA instances 610 + CONTD
IV64950 DB2 ERROR DB2 SQL ERROR: SQLCODE=-805
IV65825 XMLToolkit: Single Quotes not Encoded on IDML file generation


List of TBSM APARs that have updates to the documentation:

IV67780 ´GENIDML.SH´ IMPORT/EXPORT CAPABILITIES AND LIMITATIONS.

IV53193 INCORRECT PROPERTY USE IN CODE ROOTCAUSEEVENTFIELD USED INSTEAD OF ROOTCAUSEEVENTKEYFIELD
Deprecated the following non-functional properties:
1. impact.sla.dorootcauseeventkeys
2. impact.sla.rootcauseeventkeysfield


The following IMPACT APARs are delivered with Fix Pack 3:

IV60062 'SIMPLETEXTCONNECTION.PARSEROW()' FAILS DUE DUE TO NULL POINTER
IV47748 CAN'T LOAD WEBSERVICE LIBRARIES THAT HAVE JAVA OR JAVAX PACKAGES IN THEM.
IV50058 IMPACT SERVER FAILS TO WORK PROPERLY WITH ANY SPACES IN CONFIGURABLE PROPS FILES
IV50329 WEBSERVICES SECURITY NOT FUCTIONAL
IV52828 DEPLOY FUNCTION DOESN'T DEPLOY ADD ON PROPERTIES
IV56381 'GETBYLINKS'RETURNS 'NULL' AGAINS XSD SCHEMA
IV59481 UNABLE TO SEND HIBERNATIONS TO CLUSTER MEMBERS WHENEVER DIRECTSQL IS BEING USED
IV63535 UNABLE TO PERFORM DECRYPTION OF INPUT VALUE - DATA SOURCE ACCOUNT GETTING LOCKED
IV65055 GET/SETGLOBALVARIABLES DO NOT WORK WITH ACTIVATE FUCNTION
IV65179 LOCAL VARIABLES NOT RESTORED AFTER HIBERNATION
IV66337 WEBSERVICE LISTENER POLICY STRING VALUE PARAMETERS CAN'T ACCEPT MULTIPLES LINES ENTRIES AND SOME SPECIAL CHARACTERS
IV68383 DEBUG FLAG GENERATES MEMORY ISSUES WHEN NON OMNIBUS EVENTS ARE PROCESSED
IV68934 FORMAT 'STRING' GETS CHANGE TO 'LONG' WHEN USING GETBYFILTER
IV70836 COMMANDRESPONSE ERROR IN JS POLICY
IV70962 WHEN USING THE DATA ITEM GUI EDITOR TO EDIT THE FILTERSTAT FIELD THE DATA ITEM IN THE MM_WINDOWS TABLE IS INCORRECT
IV72561 JAVA.LANG.RUNTIMEEXCEPTION: NO CONTEXT ASSOCIATED WITH CURRENT THREAD
IV72673 UNHANDLED EXCEPTION: ORA-01003: NO STATEMENT PARSED
IV73098 EVENTS OCCURING ONE HOUR BEFORE ONE TIME WINDOW GOING INTO MAINTENANCE
IV74421 MEMORY LEAK DUE TO EVENT READER CHECK POINT"
IV75913 ABLE TO ACCESS ITEMS IN SCRIPTS DIRECTORY WITHOUT AUTHENTICATION

Prerequisites

Tivoli Business Service Manager 6.1.0

Installation Instructions

3.1 Dependencies

This Fixpack must be installed on each server(s) that is running
the TBSM data server or TBSM dashboard server.

This Fixpack requires IBM Tivoli Business Service Manager
Version 6.1.0 to be installed.

This fixpack can also be installed on top of Fix Pack 1 and Fix Pack 2.


3.2 Prerequisites

Tivoli Integrated Portal 2.2.0.15 (TIP FP 2.2.0.15) or higher certified
versions of TIP must be installed after installing this fix pack.

If the TBSM data server and dashboard server are installed on different
machines, the TIP Fix Pack needs to be installed only on the dashboard
server. In case of a TIP HA environment, the HA nodes need to be
disjoined first before upgrading to TIP FP.

If TIP FP 2.2.0.15 (or 2.2.0.15) is installed on the GUI Server and the
GUI server is on a separate system than the Data server, the eWAS on
the TBSM Data server system must be upgraded to eWAS 7.0 Fix Pack 35
(or later). The instructions to apply the eWAS Fix Pack are in section
6.3 below.

Please note that eWAS AppServer and Java SDK 7.0 Fix Pack 39 addresses
various security related issues and therefore, is the recommended eWAS
Fix Pack.

If the TBSM data server and TIP are on the same system, the TIP Server
and the data server must be stopped prior to installing the TIP FP.

Link to download TIP FP 2.2.0.15:

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

3.3 Special considerations

Consider this information before you install the Fix Pack:
1. You will be prompted during the installation to specify a backup
directory name. The installer backs up DE at this location.

2. This Fixpack does not backup the entire application. It only
backs up the files that it has updated/replaced. A backup copy of the
original files can be retrieved from:
[InstallDirectory]/tipv2/logs/tbsm/maintenance/backup/6.1.0.0/FP0003

3. All TBSM and TIP processes or services must be stopped prior
to the update install, with the exception of Object server and the
DB2 database. Both the Object server and the DB2 database need to
be up and running prior to starting the install or un-install process.

On Linux/Unix: perform the following

a). To stop the TBSM Data server issue the following command:

$TIP_HOME/profiles/TBSMProfile/bin/stopServer.sh server1
-username <adminuser> -password <adminpassword>

b). 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.

c). To stop the TBSM Discovery Library Toolkit issue the
following command:

$TBSM_HOME/XMLtoolkit/bin/tbsmrdr_stop.sh

On Windows:

a). 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 - V2.2_TIPProfile_Port_16310.
This is the Dashboard server.
Tivoli BSM Discovery Library toolkit
Netcool/OMNIbus Object Server
NCO Process Agent
EIF probe
This service appears only if the EIF probe was installed
as a Windows service.

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


4. All non-vital programs should be closed prior to installation of
the Fixpack.



3.4 Superceded Fixes

6.1.0-TIV-BSM-FP0001 is superceded by this Fix Pack.
6.1.0-TIV-BSM-FP0002 is superceded by this Fix Pack.


3.5 Extracting Fix Pack files

NOTE: Do not extract the files to a directory name containing
embedded spaces

3.5.1 Extracting on Linux, Solaris, Linux for System z, and AIX
platforms

1. Copy the file 6.1.0-TIV-BSM-FP0003-<ARCH>.tar to a temporary location
on your TBSM Server.
2. Unpack the file on each host where you need to install the Fix Pack
using these commands:

tar -xvf 6.1.0-TIV-BSM-FP0003.<ARCH>.tar

3.5.2 Extracting on Windows platforms

1. Copy the 6.1.0-TIV-BSM-FP0003-windows.zip file to a temporary
location on your TBSM server host.
2. Unzip the file on each server where you need to install the Fix Pack.

3.5.3 Fix pack directories

When you extract the file, these directories are created:

TBSM -TBSM data server and dashboard server and TIP updates.

DiscoveryLibrary -Discovery Library Toolkit updates

DbConfig -Dbconfig updates


3.6 Maintenance upgrade strategy

Before you install the Fix Pack, you need to plan how and when you will
upgrade each TBSM server in your environment.

3.6.1 Example maintenance scenario

In this example, the maintenance is staged into two phases to reduce the
time required for the TBSM maintenance window.

In this example environment, there are four servers:
* primary data server
* backup data server
* two dashboard servers set up for load balancing called: dash1 and
dash2

Follow this sequence:

Before you start the maintenance window:
1. Upgrade backup data server
2. Upgrade one dashboard server (for example dash2)
3. Use the primary data server and dash1 for regular production
activities

After you complete the upgrade the two secondary servers, start the
maintenance window down time for the production servers.
1. Upgrade primary data server
2. Upgrade dash1

After you complete the upgrade for all the servers:
1. Start primary data server
2. Start backup data server
3. Wait until TBSM completes the server synchronization.
4. Start the dashboard servers.

3.7 Installation

3.7.1 Installing the Fix Pack

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

Attention: Install the Fix Pack with the same user that was used to
install TBSM 6.1.0 GA

All TBSM and TIP processes or services must be stopped prior
to the update install, with the exception of Object server and the
DB2 database. Both the Object server and the DB2 database need to
be up and running prior to starting the install or un-install process.

Running the install without backup:

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

-DNO_BACKUP=true

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

Follow this procedure to install the Fix Pack:

1. On the Tivoli Business Service Manager server host, change to the
[Fix Pack]/TBSM directory where you extracted the files.
2. Run the installation using one the following commands:
* setup-windows.exe - Windows.
* setup-<unixplatform>.bin - other operating systems.

Installation command options:

GUI mode No options, for example:
Windows: setup-windows.exe

or

UNIX : ./setup-<unixplatform>.bin
Console mode
Use the -i console option.
For example -
Windows: setup-windows.exe -i console

or

UNIX : ./setup-<unixplatform>.bin -i console
Silent Mode

a. Copy setupFP.rsp from the TBSM directory of the extracted
Fix Pack file to a location it can be edited (/tmp).
b. Update the file to match your environment.
c. Run:

Windows: setup-windows.exe -f C:\tmp\setupFP.rsp

or

UNIX :setup-<unixplatform>.bin -f /tmp/setupFP.rsp

Note: The response file needs to have a fully qualified
path.
3.During the install you will be asked to to verify
path names to the TIP install.

4. Restart all servers.

5. After restarting the servers, run the script ApplyPoliciesFor61FP3 which can be
found on the Data Server under $TBSM_HOME/bin. This script loads
the new/updated policies.
NOTE: Do not run the ApplyPoliciesFor61FP3 on the secondary/backup
data server of a failover pair. This only needs to be run on
the primary data server.

On Windows:

ApplyPoliciesFor61FP3.bat <adminuser> <adminpassword>
For example - ApplyPoliciesFor61FP3.bat tipadmin tipadmin

On Linux/Unix:

./ApplyPoliciesFor61FP3 <adminuser> <adminpassword>
For example - ./ApplyPoliciesFor61FP3 tipadmin tipadmin

NOTE: Verify that the adminuser id and password are
correct, else the script will fail at the last step.
If incorrect, rerun the script with a valid adminuser id and password.

6. After installing the Fixpack, run the dbfileutility command found
under [InstallDirectory/tbsm/XMLtoolkit/bin to update the database
with the correct URL for the 'Show 30 day History' launch.
The canvasOpenURLActions.xml file has the updated URL
and this file can be found on the data server under
[InstallDirectory]/tbsm/av/xmlconfig.

On Windows:

dbfileutility.bat put -f <install_dir>/tbsm/av/xmlconfig/
canvasOpenURLActions.xml -category menuactions -subcategory
action -origin TBSM

On Linux/Unix:

./dbfileutility.sh put -f <install_dir>/tbsm/av/xmlconfig/
canvasOpenURLActions.xml -category menuactions -subcategory
action -origin TBSM

Then run

UNIX

$TBSM_HOME/bin/rad_reinitcanvas tipadmin tippass

Windows

%TBSM_HOME%\bin\rad_reinitcanvas.bat tipadmin tippass



3.7.2 Discovery Library Toolkit
===================================================
1. Navigate to the DiscoveryLibrary directory.
2. To install Fixpack 3,

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

setup-dltoolkit-6.1.0-FP0003-windows<_64>.exe

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

setup-dltoolkit-6.1.0-FP0003-<unixplatform><_64>.bin

For console mode, specify "-i console".

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

3. The toolkit installer requires access to the database.

This fixpack includes an update to the database
schema used by the toolkit. The schema can be updated
either by the toolkit installer or by the DBConfig
installer.

In addition to the database schema update, the toolkit
installer will also update the IBM versions of the
CDM_TO_TBSM4x_MAP.xml, CDM_TO_TBSM4x_MAP_Templates.xml,
EventIdentifierRules.xml, LabelingRules.xml,
classfilters.xml, and uniqueClassFilters.xml files.
These are stored in the database.

The toolkit installer will ask whether or not it should
update the database schema.

If 'yes' is selected, then the database user and
password provided must have sufficient authority to create
and drop tables, indexes, and views. If 'yes' is selected,
then the DBConfig install for this fixpack does not
need to update the schema. If the DBConfig installer for
this fixpack was previously run and it updated the
database schema, then specify 'no' here since there is no
need to update the schema twice.

If 'no' is specified, then the database user and
password should have authority to write to the database.
This is required so that the above mentioned XML files can
be updated in the database.

The schema update may take several minutes to complete.


4. Notes and Post-Install Considerations:

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

b) Before restarting the toolkit, the database schema
must be updated. If this installer did not perform
that task, then the DBConfig installer must be run
to update the schema.

5. Restart the toolkit.

Note:
This fixpack includes the Business Service Composer
(BSC). This feature uses the Impact service,
ResEnrichReader. This service is not set to automatically
start. If you plan to use the BSC, then the
ResEnrichReader should be set to automatically start.

To set the properties for the ResEnrichReader, go to:
System Configuration->Event Automation->Services

If the service is not shown in the service list, from
the Project pull-down, select Global, this should show
all of the available services in the list.

Select ResEnrichReader, right-mouse and select Edit.
Check the Startup Automatically check box and then save
the change (select the Save Service icon upper left).
Close the edit tab by selecting the "x" in the tab name.

To start the service, select ResEnrichReader, right-mouse
and select Start.

3.7.3 DBConfig
===================================================
1. Navigate to the DBConfig directory.
2. To install fixpack 3,

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

setup-dbconfig-6.1.0-FP0003-windows.exe

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

setup-dbconfig-6.1.0-FP0003-<unixplatform>.bin

For console mode, specify "-i console".

Note: If the installer cannot find the TBSM 6.1 DBConfig,
verify that the database configurator is installed and that
it was installed by the user that the fixpack is being installed
with. If these are both okay, then set the environment variable
TBSM_DBCONFIG_BASE to the location of DBConfig and restart the
installer. For example:
Windows:
set TBSM_DBCONFIG_BASE=C:\Program Files\IBM\tivoli\tbsmdb
UNIX:
export TBSM_DBCONFIG_BASE=/opt/IBM/tivoli/tbsmdb

3. This fixpack includes an update to the database
schema used by the toolkit. The installer will
ask whether or not it should update the database
schema.

If 'yes' is specified, then the database user and
password provided must have sufficient authority to create
and drop tables, indexes, and views.

If 'no' is specified, then the updated files will be
written to the file system, and the database will need
to be updated either manually after the install completes
or by the Discovery Library Toolkit installer.

If the toolkit installer updated the database schema,
specify 'no'.

4. Notes and Post-Install Considerations:
a) Even if the toolkit installer updated the database
schema, we still recommend that you run the DBConfig
installer so that the SQL files used by any future
invocation of the tbsm_db script are up to date.

b) After installation is complete, you may remove
[fixpack] to save space.

c) To update the database schema manually:
- cd [InstallDirectory]/tbsmdb/tools/XMLtoolkit/bin

On Windows:

- setdbschema -U dbuser -P dbpw -f upd6103
- setdbschema -U dbuser -P dbpw -f 2
- setdbschema -U dbuser -P dbpw -f t
- setdbschema -U dbuser -P dbpw -f v

On UNIX:

- ./setdbschema.sh -U dbuser -P dbpw -f upd6103
- ./setdbschema.sh -U dbuser -P dbpw -f 2
- ./setdbschema.sh -U dbuser -P dbpw -f t
- ./setdbschema.sh -U dbuser -P dbpw -f v

3.8 TBSM agent

Installing the TBSM agent:

The following packages are available for download in the TBSMAgent
directory on the support download site.
* AIX: KR9_aix523CD-6.1.0-TIV-BSM-FP0003.tar.gz -(32 bit)
KR9_aix526CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit)

* Linux: KR9_li6263CD-6.1.0-TIV-BSM-FP0003.tar.gz -(32 bit)
KR9_lx8266CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit)

* Solaris: KR9_sol283CD-6.1.0-TIV-BSM-FP0003.tar.gz -(32 bit)
KR9_sol286CD-6.1.0-TIV-BSM-FP0003.tar.gz -(64 bit)

* Windows: KR9_winntCD-6.1.0-TIV-BSM-FP0003.zip -(32 bit)
KR9_wix64CD-6.1.0-TIV-BSM-FP0003.zip -(64 bit)

* zLinux: KR9_ls3243CD-6.1.0-TIV-BSM-FP0003.tar.gz - (32 bit)
KR9_ls3246CD-6.1.0-TIV-BSM-FP0003.tar.gz -Li S390R2.4(64 bit)
KR9_ls3266CD-6.1.0-TIV-BSM-FP0003.tar.gz -Li S390R2.6(64 bit)


To install the updated TBSM agent:
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.

For instructions on installing and configuring the TBSM agent, see:

http://www.ibm.com/support/knowledgecenter/SSSPFK_6.1.0/com.ibm.tivoli.itbsm.doc_6.1/installguide/bsni_agent_ic_install_config.html


3.9 Uninstalling the Fix Pack

Before uninstalling the FixPack all TBSM processes should be
STOPPED. The user must manually stop the TBSM processes, before
the install of the FixPack and before the uninstall of the
FixPack, with the exception of Object server and the DB2 database.
Both the Object server and the DB2 database need to be up and running
prior to starting the install or un-install process.


Please note: If uninstalling on a windows system please copy the following
before attempting an uninstall:

Copy the files in:
<installDir>/tipv2/logs/tbsm/Maintenance/backup/6.1.0.0/FP0003/data/TBSM.ear
to
<installDir>/tipv2/profiles/TBSMProfile/installedApps/TBSMCell/TBSM.ear


Attention: Uninstall the Fix Pack with the same user that was used to
install TBSM 6.1.0 GA.

Install method and uninstall


The uninstaller runs using the same method that was used for
the install.


Silent mode and uninstall


If silent mode was used for the install, the uninstall will
default to a silent uninstall and you must supply a response
file or the uninstall will fail.

For silent mode uninstalls, locate the setup_uninstall.rsp
file, located under the following directory:

<installDir>/tbsm/_uninst/TBSM_FP3

and update the file with the correct information. Then launch
the installer specifying the file. For example:

uninstall -f setup_uninstall.rsp

On the Tivoli Business Service Manager server system:

1. Change to the directory:
<installDir>/tbsm/_uninst/TBSM_FP3

2. Run the uninstall command:

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



./uninstall

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



.\uninstall.exe

3. After the command has completed, run the following commands to clear
the server cache.

Linux/AIX: <TIP_HOME>/bin/clearClassCache.sh

Solaris: java -Xshare:dump

Windows: <TIP_HOME>\bin\clearClassCache.bat


4. Restart the Data Server and Dashboard Server.

5. On Unix operating systems, uninstalling the Fix Pack 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

Discovery Library Toolkit
===================================================

The toolkt portion of this fixpack cannot be uninstalled.
A backup copy of the original files can be retrieved from:

[InstallDirectory]/tbsm/
XMLtoolkit/log/install/maintenance/backup/61FP0003


DBConfig
===================================================

The DBConfig portion of this fixpack cannot be uninstalled.
A backup copy of the original files can be retrieved from:

[InstallDirectory]/
tbsmdb/log/install/maintenance/backup/61FP0003


3.10 Recovering from a failed Fix Pack install

If the install fails, try to uninstall in which case, it goes back to the
previous version. If there is no uninstall file under _uninst/TBSM_FP3,
then nothing really got installed and you can delete the TBSM_FP3 file and
reinstall.


3.11 Restoring failed DE upgrade from backup

To recover a failed Deployment Engine upgrade in TBSM 6.1.0, see the
TBSM Installation Guide at:

http://www.ibm.com/support/knowledgecenter/SSSPFK_6.1.0/com.ibm.tivoli.itbsm.doc_6.1/installguide/bsmi_upgrade_t_restore42.html

Download package

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central(FC)?
6.1.0-TIV-BSM-FP0003-linux 18 Jan 2016 English 1038518357 FC
6.1.0-TIV-BSM-FP0003-windows 18 Jan 2016 English 1113845901 FC
6.1.0-TIV-BSM-FP0003-aix 18 Jan 2016 English 1096770152 FC
6.1.0-TIV-BSM-FP0003-solaris 18 Jan 2016 English 1055409428 FC
6.1.0-TIV-BSM-FP0003-zlinux 18 Jan 2016 English 1038580375 FC

Problems (APARS) fixed
IV53193 IV53791 IV56450 IV56853 IV60168 IV60619 IV60961 IV61278 IV62456 IV62548 IV63608 IV64797 IV64933 IV64950 IV65825 IV67780 IV53193 , IV60062 IV47748 IV50058 IV50329 IV52828 IV56381 IV59481 IV63535 IV65055 IV65179 IV66337 IV68383 IV68934 IV70836 IV70962 IV72561 IV72673 IV73098 IV74421 IV75913

Document information


More support for:

Tivoli Business Service Manager

Software version:

6.1

Operating system(s):

AIX, Linux, Solaris, Windows

Software edition:

All Editions

Reference #:

4036874

Modified date:

2014-01-22

Translate my page

Content navigation