Readme document for IBM(R) Tivoli(R) Release Process Manager v7.1.1.2 Fix Pack 0002
Date: 03/13/2009

(C) Copyright International Business Machines Corporation 2008. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted
by GSA ADP Schedule Contract with IBM Corp.


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

1. Introduction
2. Contents
3. Installation instructions
4. Resolved issues

	
====================================================================================
1. Introduction
====================================================================================

This readme document provides information about product fixes that are provided in 
the v7.1.1.2 fix pack. Fixes are provided for both IBM Tivoli Release Process Manager
and the IBM Tivoli Provisioning Manager Information Module (IM). You can use the 
information in this document to upgrade Release Process Manager and the Tivoli 
Provisioning Manager IM to the latest versions. 

After you apply these fixes to your products, your updated product versions will be 
as follows:

                IBM Tivoli Release Process Manager 7.1.1.2
                IBM Tivoli Provisioning Manager Integration Module 7.1.1.2
				
Dependencies 	None                  

Prerequisites	Before you install these fixes, you must have installed the
                following products:
                  
                IBM Tivoli Release Process Manager 7.1.1
                IBM Tivoli Provisioning Manager Integration Module (IM) 7.1.1
                     (if you are using the Tivoli Provisioning Manager IM to 
                     distribute software packages)
                IBM Tivoli Change and Configuration Management Database (CCMDB)
                     7.1.1.2 (the update package for CCMDB 7.1.1)
		
Be sure to install this fix pack to get the best product usability and software 
support.


====================================================================================
2. Contents
====================================================================================

The following items are included:

1) release_pmp_7.1.1.2.zip
----------------------------
This zip package refreshes your Release Process Manager product with the fixes
that are included in this update.


2) imtpm_7.1.1.2.zip
-------------------------
This zip package refreshes the IBM Tivoli Provisioning Manager integration module 
(IM) with the fixes that are included in this updage.


3) The updatedbscript folder
----------------------------
This folder contains three script files. Before you install the product fixes, you
run a command to apply the script that corresponds to your database. The script 
renames an attribute of the APP.SOFTWARE classification; this attribute must be
renamed in order for the installation to complete successfully. The files 
contained in the updatedbscript folder are as follows:
     updatedbentry.ora (Oracle database)
     updatedbentry.db2 (DB2 database)
     updatedbentry.sqs (Microsoft SQL database)

====================================================================================
3. Installation instructions
====================================================================================

This section steps you through the process of installing the release_pmp_7.1.1.2.zip 
and imtpm_7.1.1.2.zip packages. The packages must be installed in the order that is 
presented here.

You must install this package from the Maximo administrative workstation. Ensure 
that WebSphere Application Server, IBM WebSphere Deployment Manager, the IBM 
WebSphere Node Agent, the Maximo database server, and the Maximo application are 
running. For additional information about steps to take before an installation, 
see "Before you perform an installation" in the Installing section of the Release 
Process Manager infocenter at 
http://publib.boulder.ibm.com/infocenter/tivihelp/v10r1/index.jsp. 

You can install the .zip files included in this package in either of two ways: 
from the Process Solution Installation command line interface (CLI), or using the 
Process Solution Installation wizard.


Running the updatedbentry script for your database:
-----------------------------------------------------------------------------------

1)  Make sure that you know the complete file path name for the updatedbscript 
    folder.

2)  If you have not already done so, set the following environment variable to
    the directory where you have CCMDB installed: 
       
    %CTG_CCMDB_HOME% 

3)  Copy the contents of the updatedbscript folder to the following directory:

    %CTG_CCMDB_HOME%\maximo\tools\maximo\en\release_pmp

4)  Go to the following directory:

    %CTG_CCMDB_HOME%\maximo\tools\maximo\internal

5)  Run the following command from the command prompt:

    runscriptfile.bat -crelease_pmp -fupdatedbentry

6)  Continue to the next section to install Release Process Manager 7.1.1.2.

Installing Release Process Manager 7.1.1.2 from the CLI:
-----------------------------------------------------------------------------------

Note: You must install CCMDB 7.1.1.2 prior to installing the Release Process 
Manager 7.1.1.2 package. These instructions also assume that you
have previously installed Release Process Manager version 7.1.1, and that you have
run the updatedbentry script described in the preceding section.

1)  Make sure that you know the complete file path name for the 
    release_pmp_7.1.1.2.zip file.

2)  If you have not already done so, set the following environment variable to
    the directory where you have CCMDB installed: 
       
    %CTG_CCMDB_HOME% 

3)  Issue the following command from the CLI command prompt: 

    %CTG_CCMDB_HOME%\bin\solutionInstaller.bat -action upgrade -pkgpath 
    <productimage_path>\release_pmp_7.1.1.2.zip -maxuser <maxid> -maxpwd
    <maxpwd> -dbuser <dbid> -dbpwd <dbpwd> -wasuser <wasid> 
    -waspwd <waspwd> -wasrxauser <wasrxaid> -wasrxapwd <wasrxapwd> 
    [-skipj2eeconfig]

    For complete information about the variables and command flags that are
    included in this command, see "Upgrading to version 7.1.1 > Using the CLI" 
    in the Installing section of Release Process Manager infocenter at 
    http://publib.boulder.ibm.com/infocenter/tivihelp/v10r1/index.jsp.


Installing Release Process Manager 7.1.1.2 using the installation wizard:
-----------------------------------------------------------------------------------

1)  Click Start > Programs > IBM Tivoli base services > Process Solution Installer
    to access the installation wizard. 

1)  Select a language for your installation, and then click OK.

2)  In the Introduction panel, click Next.

3)  In the Choose PSI Package panel, click Choose, navigate to the 
    release_pmp_7.1.1.2.zip file, select it, and click Next. The installation
    program verfies that the package is valid and that the prerequisite packages
    are installed.

4)  In the Package Validation Results panel, review and verify the information 
    displayed, and then click Next.

5)  In the Middleware Credentials panel, enter the credentials for which you are
    prompted. Click Next after you enter each pair of credentials.
    After you enter the required IDs and passwords, the installation program 
    uses them to connect to WebSphere and the Maximo database, verifies the 
    credentials, and checks to confirm that all installation requirements are 
    in place. 

6)  In the Package Options panel, specify the following option for the 
    installation, and click Next:  

    * Select Defer Maximo Application Redeployment if you want to postpone 
      application deployment. For example, if you are planning to install the
      Tivoli Provisioning Manager IM v7.1.1.2 package after you install the
      Release Process Manager package, you can postpone application deployment
      until both packages are installed. If you select this option, you must 
      redeploy the application later in order to have product functionality.
   
7)  In the Pre-Install Summary panel, review and verify the information that is 
    displayed, and then click Next.

    The installation process begins. A progress panel informs you of the progress 
    of the installation.

8)  After the installation completes successfully, click Next in the Package 
    Successfully Deployed panel. 

    If there is a package failure, a message is displayed for the step 
    that failed. Do not proceed to the next step until the error has been
    resolved and the package is successfully installed.

9)  If you want to install the Tivoli Provisioning Manager IM package now, select
    Install Another package? in the Install Another Package panel, and click Done.
    You can use the installation wizard to install the IM. If you do not want to 
    install the IM package, or if you want to install it later, unselect Install
    Another Package? and click Done.


Installing the Tivoli Provisioning Manager IM from the CLI:
-----------------------------------------------------------------------------------

Note: You must install Release Process Manager 7.1.1.2 prior to installing the
Tivoli Provisioning Manager IM package. These instructions also assume that you
have previously installed the Tivoli Provisioning Manager IM version 7.1.1.

1)  Make sure that you know the complete file path name for the 
    imtpm_7.1.1.2.zip file.

2)  If you have not already done so, set the following environment variable to
    the directory where you have CCMDB installed: 
       
    %CTG_CCMDB_HOME% 

3)  Issue the following command from the CLI command prompt: 

    %CTG_CCMDB_HOME%\bin\solutionInstaller.bat -action upgrade -pkgpath 
    <productimage_path>\imtpm_7.1.1.2.zip -maxuser <maxid> -maxpwd
    <maxpwd> -dbuser <dbid> -dbpwd <dbpwd> -wasuser <wasid> 
    -waspwd <waspwd> -wasrxauser <wasrxaid> -wasrxapwd <wasrxapwd> 
    [-skipj2eeconfig]

    For complete information about the variables and command flags that are
    included in this command, see "Upgrading an installation module > Using 
    the CLI" in the Installing section of Release Process Manager infocenter at 
    http://publib.boulder.ibm.com/infocenter/tivihelp/v10r1/index.jsp.


Installing the Tivoli Provisioning Manager IM using the installation wizard:
----------------------------------------------------------------------------------

1)  Click Start > Programs > IBM Tivoli base services > Process Solution Installer
    to access the installation wizard. 

1)  Select a language for your installation, and then click OK.

2)  In the Introduction panel, click Next.

3)  In the Choose PSI Package panel, click Choose, navigate to the 
    imtpm_7.1.1.2.zip file, select it, and click Next. The installation
    program verfies that the package is valid and that the prerequisite packages
    are installed.

4)  In the Package Validation Results panel, review and verify the information 
    displayed, and then click Next.

5)  In the Middleware Credentials panel, enter the credentials for which you are
    prompted. Click Next after you enter each pair of credentials.
    After you enter the required IDs and passwords, the installation program 
    uses them to connect to WebSphere and the Maximo database, verifies the 
    credentials, and checks to confirm that all installation requirements are 
    in place. 

6)  In the Package Options panel, specify the following option for the 
    installation, and click Next:  

    * Select Defer Maximo Application Redeployment if you want to postpone 
      application deployment. If you select this option, you must redeploy the 
      application later in order to have product functionality.
       
7)  In the Pre-Install Summary panel, review and verify the information that is 
    displayed, and then click Next.

    The installation process begins. A progress panel informs you of the progress 
    of the installation.

8)  After the installation completes successfully, click Next in the Package 
    Successfully Deployed panel. 

    If there is a package failure, a message is displayed for the step 
    that failed. Do not proceed to the next step until the error has been
    resolved and the package is successfully installed.

Post-installation tasks
----------------------------------------------------------------------------------

If you deferred application redeployment during installation, you must redeploy 
the application at some later time in order to have package functionality. In the 
installation window, application redeployment is deferred using the Defer Maximo 
Application Redeployment option in the Package Options window; in the CLI, the 
-skipj2eeconfig flag is used to defer application redeployment.

Deploying a newly installed package requires that the enterprise archive (EAR) 
file that contains consolidated product information be rebuilt and redeployed. 
This is referred to as the Maximo EAR file. After you rebuild and redeploy the 
Maximo EAR file, all of the package functionality that you have installed is 
available for use.

You rebuild and redeploy the Maximo EAR file from the IBM® WebSphere® 
Application Server. For instructions for performing this task, see the 
"Working with EAR files" section of the following document:

"IBM Change and Configuration Management 7.1 System Administrator Guide"
Chapter 1: Managing the IBM WebSphere Application Server

To access this document, click System Administrator Guide in the Reference section
of the CCMDB information center at 
http://publib.boulder.ibm.com/infocenter/tivihelp/v10r1/index.jsp.

	
====================================================================================
4. Resolved issues
====================================================================================

The fixes in this package resolve the following issues that existed in the Release
Process Manager 7.1.1 product:

* Association of a target configuration item (CI) to a Change or a Release 

  After an upgrade was performed from version 7.1 to version 7.1.1, a CI that you 
  associated with a Change or Release was not being saved as part of the Change or 
  Release record. After you install the 7.1.1.2 version, all associated CIs will be 
  saved with the Change or Release record.

* Loading of new Tivoli Provisioning Manager logical management operations (LMOs)

  When an upgrade was performed from version 7.1 to version 7.1.1 of Release 
  Process Manager, new LMOs that were added for the 7.1.1 version were not loaded.
  The fixes in this package ensure that these new LMOs are loaded and available
  for use.

* SoftwareImage_ImageName attribute for Rational Asset Manager CI

  After an upgrade from the 7.1 version to the 7.1.1 version, when a software
  image was imported from Rational Asset Manager, the SoftwareImage_ImageName
  attribute was not created. After you install the fixes in this package, this
  attribute is successfully created for the Rational Asset Manager software
  image CIs.

* Need to install Tivoli Provisioning Manager IM to run Tivoli Configuration
  Manager deployments

  In the 7.1.1 version of the product, errors were generated when you tried to
  perform Tivoli Configuration Manager deployments if you had not installed 
  the Tivoli Provisioning Manager IM. In other words, you were required to
  install the Tivoli Provisioning Manager IM before you could perform a Tivoli
  Configuration Manager deployment, even if you were not using Tivoli Provisioning
  Manager for deployments. After you install the fixes in this package, you can
  perform Tivoli Configuration Manager deployments (which use the Tivoli
  Configuration Manager IM) without having to also install the Tivoli Provisioning  
  Manager IM. 

* Duplication of CIs for a deployment task in the Deployments application

  In the previous product version, after you clicked the Start Assisted Workflow 
  button for a PMRELSWDST task, the source and target CIs were duplicated when 
  displayed in the Deployments application. In other words, each CI was listed twice 
  in the application, rather than only once. After you install the fixes in this 
  package, each CI specified for a deployment will be listed only once in the 
  Deployments application.


	
====================================================================================
5. Checksum information
====================================================================================

Use this information to verify that you have successfully downloaded and unpacked
the files in this update package.


release_pmp_7.1.1.2.zip - 8d83d426a53654759132d04c0de451af
imtpm_7.1.1.2.zip - b0e5e97d95757ce15d1efae1f796c48d

   

                      Date of                
Created/Revised by    Creation/Update  Summary of Changes               
 ------------------------------------------------------------------------
 DJ                       06/25/2008     Document created                 
 ------------------------------------------------------------------------
 FSC                      03/13/2009     Updated readme to 
                                            improve clarity with refresh2
 ------------------------------------------------------------------------
