IBM Tivoli Intelligent Orchestrator(R) and IBM Tivoli Provisioning Manager(R)

IFIX Number: IF00003

APAR(s) Fixed in Previous Release(s): IY92887,IY93683,IY93742,IY93874,IY94084,IY94183,IY93218,IY95483

Required Release Level: 5.1.0.1

Date: (mm/dd/yy): 03/12/07

Abstract:

Contains fixes for several APARs. Please refer to description for APAR details.

Description:

APARs Fixed in IF00001
-----------------------
IY92887 - NEED AN ERROR MESSAGE WHEN A COMPILE ATTEMPT IS MADE ON A RUNNING WORKFLOW.   
IY93683 - NIM DISCOVERY IS ABLE TO DISCOVER IMAGES, BUT DISCOVERY FRAMEWORK IS UNABLE TO IMPORT IT INTO DCM.
IY93742 - DCMEXPORT.SH DOES'T EXPORT NETWORK-CARD AND NO CREDENTIAL ENTRIES FOR A FILE REPOSITORY                         
IY93874 - XMLIMPORT DOES NOT WORK AS DCMEXPORT FAILS TO USE PROPER FORMATTING ON DTD.                                     
IY94084 - DCMEXPORT.SH DOESN'T EXPORT SOFTWARE-STACKS
IY94183 - DCMEXPORT.SH DOESN'T EXPORT TERMINAL-SERVER ENTRIES

APARs Fixed in IF00002
-----------------------
IY93218 - INSTALL SOFTWARE, PATCH, STACK SOFTWARE TABLES SHOULD LIMIT THE DISPLAYED PRODUCTS TO 500

APARs Fixed in IF00003
----------------------
IY95483 - SECURITY COMPLIANCE SCAN WORKFLOW NOT COMPLETING ON SOME TARGETS, WHEN DEFAULT CONFIGURATION TEMPLATE MISSING 

-------------------------------------------------------------------------------

This README file contains the latest information about installing Tivoli
Intelligent Orchestrator and Tivoli Provisioning Manager updates.

Updates provided in this Interim Fix are Cumulative, that is, an Interim Fix
with a higher number replaces all previous versions.

-------------------------------------------------------------------------------

Contents

1.0 Update Installation Instructions
  1.1 Pre-Installation Steps
  1.2 Installation Instructions
  1.3 Post-Installation Instructions
  1.4 Un-Installation Instructions

2.0 Known Problems

3.0 Troubleshooting

------------------------------------------------------------------------------

1.0 Update Installation Instructions

These installation instruction apply to the Tivoli Intelligent Orchestrator or
Tivoli Provisioning Manager.

   1.1 Pre-Installation Steps

     1.  Before applying the update, ensure that JAVA_HOME is set:
         For AIX, Linux or Solaris:
             $TIO_HOME/tools/setupCmdLine.sh
         For Windows:
             %TIO_HOME%\tools\setupCmdLine.cmd
     2.  Before applying the update, ensure that the Tivoli Intelligent Orchestrator
         or Tivoli Provisioning Manager, WebSphere Application Server(WAS), and Tivoli Directory
         Server are stopped. Refer to the documentation provided with each of these
         products for detailed starting and stopping instructions.

   1.2 Installation Instructions

     1.  Installation user:
         For AIX, Linux or Solaris:
             Log on to the system as root as follows, su - root
         For Windows:
             Log on to the system with the tioadmin user.
     2.  Create a temp directory and download the update package into this directory, where <temp_dir> is the
         newly created directory. Ensure that you create this temp directory outside of TIO_HOME directory,
         in order for the install process to successfully complete.
     3.  Using the jar command, expand the package as follows:
             jar -xvf 5.1.0.1-TIV-TPM-IF00003.jar
     4.  If you are installing the update on AIX, Linux or Solaris:
         From the temp directory in which you have expanded the package, run the command:
         For AIX, Linux or Solaris:
             chmod -R 777 <temp_dir>/installer
             chown -R tioadmin:tioadmin <temp_dir>/installer
     5.  From the <temp_dir>/installer directory, run the updateWizard.bat/updateWizard.sh command,
         depending on your platform.
     6.  Ensure that the Installation Directory is correct and Click Next. If it is not correct
         then please update it using the Browse button.
     7.  Click Next through the panels and select Install Fixes.
     8.  On the "Specify the directory where fixes are located", the directory selected
         will contain the update. Click Next and then Finish.

   1.3 Post-Installation Instructions

     1.  Start the Tivoli Directory Server. Refer to the documentation provide for details
     2.  Stop the WebSphere Application Server. Refer to the documentation provide for details
     3.  Log in as tioadmin and deploy the application using the following command:
         For AIX, Linux or Solaris:
             <temp_dir>/installer/utils/postinstall.sh <WAS username> <WAS password> <servername> <base_DN suffix>
             For example, <temp_dir>/installer/utils/postinstall.sh wasadmin wasadmin server1 "dc=ibm,dc=com"         
         For Windows, using a CMD (**) prompt:
             <temp_dir>\installer\utils\postinstall.bat <WAS username> <WAS password> <servername> <base_DN suffix>
             For example, <temp_dir>\installer\utils\postinstall.bat wasadmin wasadmin server1 "dc=mycompany,dc=com"             
     4.  Start the Tivoli Intelligent Orchestrator or Tivoli Provisioning Manager server.
         Refer to the documentation provide for details.

     ** This step requires a Command Prompt. Do not use a Cygwin prompt

   1.4 Un-Installation Instructions

     1.  Start the Tivoli Directory Server. Refer to the documentation provide for details
     2.  Stop the WebSphere Application Server. Refer to the documentation provide for details
     3.  From the <temp_dir>/installer directory, run the updateWizard.bat/updateWizard.sh command,
         depending on your platform. After selecting the language and the installation directory, select
         "Uninstall fixes" and press next.
     4.  Deploy the application using the following command:
         For AIX, Linux or Solaris:
             <temp_dir>/installer/utils/postinstall.sh <username> <password> <servername> <base_DN suffix>
             For example, <temp_dir>/installer/utils/postinstall.sh wasadmin wasadmin server1 "dc=ibm,dc=com"
         For Windows, using a CMD (**) prompt:
             <temp_dir>\installer\utils\postinstall.bat <username> <password> <servername> <base_DN suffix>
             For example, <temp_dir>\installer\utils\postinstall.bat wasadmin wasadmin server1 "dc=mycompany,dc=com"
     5.  Start the Tivoli Intelligent Orchestrator or Tivoli Provisioning Manager server.
         Refer to the documentation provide for details.

     ** This step requires a Command Prompt. Do not use a Cygwin prompt
------------------------------------------------------------------------------
2.0 Known Problems

Changing the WebSphere Application Servers timeout value
In some situations, you may see a timeout if the command does not complete in a particular amount of time.
This situation is caused by the SOAP connection (which is needed in order to run the process) not successfully
connecting to the server. This is most likely caused by a network configuration problem or if the processor is
very slow. This section provides instructions on changing the com.ibm.SOAP.requestTimeout property of the
soap.client.props file, which would possibly provide a workaround to this situation.

The program default value for the request timeout is 180 seconds. Follow the instructions below to change the
value to 1800, only if you encounter an timeout related error while running the postinstall script.

Open the soap.client.props file located in the properties directory of the WebSphere Application Server.
Specify the value of 1800 seconds for the property, com.ibm.SOAP.requestTimeout as indicated below.

Note:
The value that you choose depends on a number of factors such as the size and the number of the applications
that are installed on the server, the speed of your machine, and the level of usage of your machine.


--------------------------------------------------------------------------------

2.0 Troubleshooting



--------------------------------------------------------------------------------

Trademarks and Service Marks
The following are trademarks or registered trademarks of IBM Corporation in the
United States and other countries:

IBM      WebSphere   Tivoli     DB2

Windows is a trademark of Microsoft Corporation in the United States, other
countries, or both.
Other company, product, or service names may be trademarks or service marks
of others.

**************************************************************************

** COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2003

** ALL RIGHTS RESERVED.

**************************************************************************
Note to US Government Users -- Documentation related to restricted rights
-- Use, duplication, or disclosure is subject to restriction set forth in
GSA ADP Schedule Contract with IBM Corp.

End of README File
