Date: February 15, 2008

Patch: Interim Fix (1.2-TIV-ITDWB-IF0002) for IBM Tivoli Dynamic Workload Broker 1.2

Component: IBM Tivoli Dynamic Workload Broker, Version 1.2

Table of Contents:
  o Section 1. General Description
      - Section 1.1. General Description
      - Section 1.2. Operating Systems    
      - Section 1.3. Dependencies
      - Section 1.4. IF patches and Fix packs superseded by this
                     fix pack
      - Section 1.5. Files replaced or added by this fix pack
      - Section 1.6. IF Patch Contents

  o Section 2. Main Changes
      
  o Section 3. Database changes
      
  o Section 4. Problems Fixed

  o Section 5. Prerequisites
  o Section 6. Installation notes
      - Section 6.1. Installation procedure

  o Section 7. Known Problems and limitations  

  o Section 8. Additional Notes


########################################################################
# Section 1. General Description                                       #
########################################################################


  Section 1.1. General Description
  --------------------------------
  This interim fix fixes ITDWB agent problems on Windows platforms related
  to user impersonation.

    
  APARs and defects addressed by this IF Patch are listed in the
  "Problems Fixed" section of this README file. 
    
  Section 1.2. Operating Systems
  ------------------------------
    Windows (ITDWB Server and Agents on Windows platform only).
    Unix (ITDWB Server on Unix platforms)
        
  Section 1.3. Dependencies
  -------------------------
    IBM Tivoli Dynamic Workload Broker 1.2 (base product).
    
  Section 1.4. IF patches and fix packs superseded by this fix pack
  -----------------------------------------------------------------
    1.2-TIV-ITDWB-LA0001

  Section 1.5. Files replaced or added by this fix pack
  -----------------------------------------------------
    None.
    
  Section 1.6. IF Patch Contents
  ------------------------------
    - This README file
    - 1.2-TIV-ITDWB-IF0002-WIN-AGENT.zip
    - 1.2-TIV-ITDWB-IF0002.zip
    - 1.2-TIV-ITDWB-IF0002.tar

########################################################################
# Section 2. Main Changes                                              #
########################################################################
   In order to impersonate Windows Domain users the syntax to be used in
   JSDL definition is the following:
   domain_name\user_name

   Different syntaxes(like user_name@domain_name) are not supported and
   will generate a 1326 Windows error with domain user not recognized.

   As for Windows local users (when it is not necessary to specify a domain)
   it is still possible to use the syntax 'user_name'

   A sample of the related section of the JDSL definition is the following:
      <jsdle:credential>
        <jsdle:userName>domain_name\user_name</jsdle:userName>
        <jsdle:password>password</jsdle:password>
      </jsdle:credential>

########################################################################
# Section 3. Database Changes                                          #
########################################################################
  None.

########################################################################
# Section 4. Problems Fixed                                            #
########################################################################

The following is a list of all the APARS and defects fixed in this fix
pack.

    APAR:    IY99922
    Symptom: Unable to impersonate domain users running jobs on
             Active Directory nodes. Users are specified in the
             JSDL definition as: domainName\userName.
             The symmptom is that native job executor receives
             Windows error 1326

    Defect:  37666
    Symptom: Windows environment variables not set in case
             impersonation is not specified in the JSDL definition.

    Defect:  38434
    Symptom: In a Windows environment, if a process spawned by a non-
             interactive job opens a message window, this window will 
		 not appear on any desktop (since non-interactive jobs 
             are expected to run in background).
             The process will then remain in wait  for a user to 
             acknowledge the error message in the window and will not 
		 terminate. After this interim fix is applied, the ITDWB 
             Agent on Windows will monitor for message windows opened 
		 by processes belonging to its jobs, and will send a message 
		 to the application to close them automatically, so that 
		 the job could complete.
             All the strings present on the window being closed will
             be reported in the diagnostic information section on the 
             Web user interface.


########################################################################
# Section 5. Prerequisites                                             #
########################################################################

  IBM Tivoli Dynamic Workload Broker, Version 1.2 (base product).


########################################################################
# Section 6. Installation notes                                        #
########################################################################

  Section 6.1. Installation procedure

  This IF patch  contains fixes for TDWB Agents on Windows and can be installed 
  directly on those agents following procedure specified in 6.1.1. As an alter native it 
  could be installed on the  IBM Tivoli Dynamic Workload Broker server and deployed
  to the agents from the Tivoli Dynamic Workload Console.

 Section 6.1.1. Installation procedure on the ITDWB agent via InstallShield

    1. Unzip the zip file 1.2-TIV-ITDWB-IF0002-WIN-AGENT.zip  in any folder on the box 
       where the IBM Tivoli Dynamic Workload Broker 1.2 is installed.
       A folder TDWB_WIN will be created.
    2. Under the subfolder ITDWBAgent run setupwin32.exe. Run the installation wizard.
    3. You can run the installer silently by running setupwin32.exe -silent. If two or
       more instances are installed on the same machine you should you use the response
       file (you can use the template in the ResponseFiles directory) where you can specify
       the installation path of the instance to apply the IF Patch. In this case run
       setupwin32.exe -options <responsefile> -silent
 
  Section 6.1.2. Installation on a Windows Server

    1. Unzip the zip file 1.2-TIV-ITDWB-IF0002.zip under the installation path of the IBM
       Tivoli Dynamic Workload Broker 1.2 (default is C:\program Files\IBM\ITDWB\Server).
       A folder 1.2-TIV-ITDWB-IF0002 will be created. Move into it.
    2. Run the script checkVersion.bat to get the version of the ITDWB modules running
       on WebSphere Application Server and the version of the ITDWB agent bundles hosted
       by the server itself. 	
	 If the level of the following modules:
 		- Native Job Executor
 		- J2EE Job Executor 
		- Job Executor Agent 
		- Base System Scanners
		- Resource Advisor Agent 
		- Agent L10N Message Support 
	 is not 1.2.0.0 or 1.2.0.1 the patch should not be applied and the update process
	 ends here.
    3. Run the script install.bat to install the interim fix on the server.
    4. Run again the script checkVersion.bat to check if the version of the modules and
       bundles have been updated.
    5. Log on the Tivoli Dynamic Workload Console. Check that the features are at level 1.2.0.0
       for the agents you want to update. Update the agents. Check that the features are
       now at level 1.2.0.2

  Section 6.1.3. Installation on a Unix Server

    1. Untar the tar file 1.2-TIV-ITDWB-IF0002.tar under the installation path of the IBM
       Tivoli Dynamic Workload Broker 1.2 (default is /opt/IBM/ITDWB/Server).
       A directory 1.2-TIV-ITDWB-IF0002 will be created. Move into it.
    2. Run the script checkVersion.sh to get the version of the ITDWB modules running
       on WebSphere Application Server and the version of the ITDWB agent bundles hosted
       by the server itself.
	 If the level of the following modules:
 		- Native Job Executor
 		- J2EE Job Executor 
		- Job Executor Agent 
		- Base System Scanners
		- Resource Advisor Agent 
		- Agent L10N Message Support 
	 is not 1.2.0.0 or 1.2.0.1 the patch should not be applied and the update process
	 ends here.
    3. Run the script install.sh to install the interim fix on the server.
    4. Run again the script checkVersion.sh to check if the version of the modules and
       bundles have been updated.
    5. Log on the Tivoli Dynamic Workload Console. Check that the features are at level 1.2.0.0
       for the agents you want to updated. Update the agents. Check that the features are
       now at level 1.2.0.2

########################################################################
# Section 7. Known Problems and limitations                            #
########################################################################
   None.
    
########################################################################
# Section 9. Additional Notes                                          #
########################################################################
   None.
