Licensed Materials - Property of IBM
Copyright IBM Corp. 2010 All Rights Reserved.
US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

PRODUCT : IBM Tivoli Service Automation Manager
IFIX : 7.2.1.0-TIV-TSAM-IF0001
RELEASE : v7.2.1.0
DATE : 2010/07/16
LAST UPDATE : 2010/07/16


============================================================================
Table of Contents
============================================================================

I. FIX
II. PREREQUISITES
III. DESCRIPTION
IV. INSTALLATION INSTRUCTIONS
V. MODIFIED FILES
VI. KNOWN DEFECTS OR LIMITATIONS
VII. ADDITIONAL INFORMATION


You should print and read this document and all associated references 
before applying this maintenance package. The online page where this 
package was downloaded is the most up to date information and supersedes 
all other versions of this document. 


I. FIX

7.2.1.0-TIV-TSAM-IF0001 - This IFix corrects the national language capabilities of Tivoli Service Automation Manager.


II. PREREQUISITES

Tivoli Service Automation Manager 7.2.1.0


III. DESCRIPTION

This IFix should ONLY be applied to the Tivoli Service Automation Manager. 
This IFix will correct the national language capabilities of Tivoli Service Automation Manager and
Tivoli Service Automation Manager installer.


IV. INSTALLATION INSTRUCTIONS


Tivoli Service Automation Manager Installer language code fixes:

This fix replaces scripts which are needed for the TSAM postinstallation configuration. It is highly recommended for customers 
installing the product on a non-english system. It needs to be done before a new installation of Tivoli Service Automation Manager is started. 

Copy the files checkMiddleware.sh and validateInstallationParameters.sh from the postinstall
directory extracted from the iFix ZIP file into directory TSAMBASE7210/install/postinstall of
the TSAM installation sources. Be sure to make the scripts executable after copying to the
target location (chmod +x).

The following fix will switch the installation language on Linux and AIX sytems to english, which prevents from the 
encoding problem of error messages to happen.

When starting the launchpad on Linux and AIX systems, set the environment variable LANG to the default locale: 
Example: "LANG=C ./launchpad.sh"


Installing Tivoli Service Automation Manager Fix:

To apply any Interim Fix to the Tivoli Service Automation Manager 7.2.1.0, the fix has to be applied directly to the administrative workstation. 

1. Before you install, please back up your Maximo administrative workstation environment and 
Maximo database. It is best practice to perform a database backup with any environment change.

Example:
copy c:\IBM\SMP\maximo\deployment\default\maximo.ear c:\IBM\SMP\maximo\deployment\default\maximo.ear.20100716

2. Download 7.2.1.0-TIV-TSAM-IF0001.zip to the administrative workstation. Goto the c:\IBM\SMP directory 
and create a new directory, name it "7210-TIV-TSAM-IF0001"

Example:
c:\IBM\SMP\7210-TIV-TSAM-IF0001

3. Extract the contents of 7.2.1.0-TIV-TSAM-IF0001.zip to the new directory.

Example:
copy 7.2.1.0-TIV-TSAM-IF0001.zip C:\IBM\SMP\7210-TIV-TSAM-IF0001\
cd C:\IBM\SMP\7210-TIV-TSAM-IF0001\
unzip 7.2.1.0-TIV-TSAM-IF0001.zip

You should have the following files from extracting the archive

7.2.1.0-TIV-TSAM-IF0001-changes.zip
7.2.1.0-TIV-TSAM-IF0001.README

4. Apply Updates to SimpleSRM Web Applications:
4.1 Update module SimpleSRM.war
Log into the WebSphere Admin Console
Go to Applications -> Enterprise Applications
Check-mark application MAXIMO and click update
Select update option "Replace or add a single module"
In field "Specify the path beginning with the installed application archive file to the module to be replaced or added." enter: SimpleSRM.war
Specify the full path to the SimpleSRM.war file contained in the UI driectory extracted from the iFix ZIP file. You may point to file located
on your local workstation or on the server where TSAM is installed (make sure the access rights are set correctly).
In field "Context root" enter: SimpleSRM
Click the "Next" button.
On the next page, go directly to the Summary step, since no setting shall be modified.
Click "Finish".
When the update process has completed, select "Save directly to master configuration"

4.2 Update module TSAM_Web.war
Go to Applications -> Enterprise Applications
Check-mark application MAXIMO and click update
Select update option "Replace or add a single module"
In field "Specify the path beginning with the installed application archive file to the module to be replaced or added." enter: TSAM_web.war
Specify the full path to the TSAM_web.war file contained in the UI driectory extracted from the iFix ZIP file. You may point to file located
on your local workstation or on the server where TSAM is installed (make sure the access rights are set correctly).
In field "Context root" enter: tsam
Click the "Next" button.
On the next page, go directly to the Summary step, since no setting shall be modified.
Click "Finish".
When the update process has completed, select "Save directly to master configuration"

5. Update Cloud.ear
Go to Applications -> Enterprise Applications
Check-mark application CloudEAR and click update
Select update option "Replace or add a single module"
In field "Specify the path beginning with the installed application archive file to the module to be replaced or added." enter: RMWS.war
Specify the full path to the RMWS.war file contained in the Cloud.ear directory extracted from the iFix ZIP file. You may point to file located
on your local workstation or on the server where TSAM is installed (make sure the access rights are set correctly).
In field "Context root" enter: RM
Click the "Next" button.
On the next page, go directly to the Summary step, since no setting shall be modified.
Click "Finish".
When the update process has completed, select "Save directly to master configuration"

6. Update Language Packs:

Update the required language packs using TDToolkit on the Administration Server:

Unzip the LanguagePack archive CIRESPMPLangPack.zip into /opt/IBM/SMP/maximo
Unzip the LanguagePack archive RDPPMPLangPack.zip into /opt/IBM/SMP/maximo
Unzip the LanguagePack archive TSAMCCMDBINTPMPLangPack.zip into /opt/IBM/SMP/maximo
Unzip the LanguagePack archive TSAMCFGPMPLangPack.zip into /opt/IBM/SMP/maximo
Unzip the LanguagePack archive TSAMPMPLangPack.zip into /opt/IBM/SMP/maximo

7. Execute the following TDToolkit commands in sequence:

/opt/IBM/SMP/maximo/tools/maximo/TDToolkit.sh -pmpupdatecires -VersionV7100-000
/opt/IBM/SMP/maximo/tools/maximo/TDToolkit.sh -pmpupdaterdp_pmp -VersionV7100-000
/opt/IBM/SMP/maximo/tools/maximo/TDToolkit.sh -pmpupdatetsamcfg_pmp -VersionV7100-000
/opt/IBM/SMP/maximo/tools/maximo/TDToolkit.sh -pmpupdatezhybrid_ccmdbint_pmp -VersionV7100-000
/opt/IBM/SMP/maximo/tools/maximo/TDToolkit.sh -pmpupdatezhybrid_pmp -VersionV7100-000

8. Restart the Maximo Server

Login to the management server as tioadmin, and execute the following commands;
cd $TIO_HOME/tools
./tio.sh stop 
./tio.sh start

9. Edit the Automation workflows to enable Windows provisioning on non-english environments

9.1 Make the workflow editable to replace/edit it :

On Management Server run the following commands:

su - ctginst1
db2
connect to maxdb71
set schema maximo
update workflow4 set IS_EDITABLE='Y' where WORKFLOW_NAME='Cloud_VMWare_Windows_Configure_Routes'
update workflow4 set IS_EDITABLE='Y' where WORKFLOW_NAME='VMware_VI3_VM_configure'
commit

9.2 Edit the workflows
 
Open the Maximo UI in web browser
1) Go to Provisioning workflows application
2) Open the Workflow "Cloud_VMWare_Windows_Configure_Routes" and "VMware_VI3_VM_Configure"
3) Overwrite the contents with the contents of the respective .wkf files from the extracted "workflows" directory in the IFix
4) Save the workflows. 
5) Wait for 2 minutes before the machine can be used for provisioning (this time is needed for TPM deployment engine to pick up the new compiled workflow classes).


V. MODIFIED FILES

checkMiddleware.sh
validateInstallationParameters.sh
SimpleSRM.war
TSAM_Web.war
Cloud.ear
Multiple xliff files
Cloud_VMWare_Windows_Configure_Routes.wkf
VMware_VI3_VM_configure.wkf


VI. KNOWN DEFECTS OR LIMITATIONS

1. There is no uninstall process for this fix.
2. This IFix does not address the mixed simplified and traditional chinese strings on the SimpleSRM Web2.0 UI
3. This IFix does not address the pSeries HMC Image re-discovery problem. Please note that a HMC Image re-discovery
   will erase previously discovered and registered images. This issue will be addressed by a later fixpack.


VII. ADDITIONAL INFORMATION

TARGET FIXPACK: TSAM 7.2.1.1 will contain fixes delivered with this package.
 
  
Prerequisites 
IBM Tivoli Service Automation Manager 7.2.1.0
