File:   4.5.1-TIV-TIM-WAS-IF0080.README For ITIM 4.5.1 using IBM WebSphere Application Server.
Date:   February 9, 2007
                                     
Interim fix 4.5.1-TIV-TIM-WAS-IF0080 for APARs IY92952 and IY93925. 

Components:
       enrole.ear for all supported platforms for WebSphere AppServer.
       enrolefc.ear for all supported platforms for WebSphere AppServer.

General Description:

This Interim fix provides fixes for APARs IY92952 and IY93925.

  Problems Fixed:
  
    APAR:    IY92952
    Symptom: Remove autocommit code entries from ITIM Reporting component.
    
    APAR:    IY93925
    Symptom: The password sync servlet doesn't correctly handle passwords including non-ascii characters.
             The non-ascii characters get corrupted. 

   Old Problems Fixed:
  
    APAR:    IY92526
    Symptom: The API WorkflowProcessEntity.getProcessContext() method always throws 
             "UnsupportedOperationException" exception.
  
    APAR:    IY93035
    Symptom: Too many instances of java.util.MissingResourceException are logged to WebSphere's 
             SystemErr.log unnecessarily when form contains a read-only attribute of type 
             checkbox without a value.
             
    APAR:    IY93223
    Symptom: ITIM doesn't enforce the policy correctly for NON-COMPLIANT accounts belonging to
             hosted service during a RECON.
  
    APAR:    IY93409
    Symptom: When submitting a request to create a person in ITIM when the person's name contains 
             a large number of extended ASCII characters, the request will fail to get created in 
             the ITIM database.
     
Architecture(s): Windows, Solaris, AIX, HPUX and Linux.

Fixes Superseded:  ITIM Interim Fix 4.5.1-TIV-TIM-IF0079.

Dependencies: ITIM 4.5.1-TIV-TIM-FP0078 Fixpack.

Database Changes: NONE.

JMS (Java Messaging Service) Changes: NONE

LDAP Changes: NONE

Files Replaced or Added or Modified by this Interim fix :

    <ITIM_HOME>/enrole.ear
    <ITIM_HOME>/enrolefc.ear
    
Patch Contents:
  - This README file
  - enrole.ear 
  - enrolefc.ear
  
MD5 Checksums:
e132135647d2628c634a07493dcb04ed  4.5.1-TIV-TIM-WAS-IF0080.zip

MD5 Checksums:

ceb12236c08984ec63b20d69bea03617  enrole.ear

640ecdc76d9899a96a2f8b1d0613753d  enrolefc.ear

Applying the Patch:

   1) Extract the Interim Fix zip file to a temporary directory on your hard drive:
     
         # jar xvf 4.5.1-TIV-TIM-WAS-IF0080.zip  

      NOTE:  You may also use any unzip equivalent to unpack the zip file.
             Back-level versions of jar, FastJar or PKZIP may report errors. 
             Use the jar executable supplied with java or another zip utility 
             to uncompress the file.
      
   2) Copy the file(s) to the appropriate directory.

      You will now need to copy the files to the appropriate directories.
NOTE: *************************************************************************       
      Always BACKUP your old files in a safe place in case an unforseen 
      event occurs.  It is recommended to backup ITIM_HOME/data directory.
      Especially, be sure to backup any configuration files you 
      may have modified  such as properties or xml files.
NOTE: *************************************************************************       
      IF YOU ARE USING JAVA 2 SECURITY:
      Backup up your was.policy file to a temporary holding directory.  During 
      the fix application you will be re-deploying enrole.ear, which removes the
      $WAS_HOME/config/cells/$CELL_NAME/applications/enRole.ear/deployments/enRole/META-INF
      directory and its contents. During the deployment, the was.policy is not 
      replaced and will need to be copied back during the COMMON TASKS section 
      of this document.  On a Cluster this needs to be done on the NDM as well.
      $WAS_HOME/DeploymentManager/config/cells/$CELL_NAME/applications/enRole.ear/deployments/enRole/META-INF
NOTE: *************************************************************************       
      IF YOU HAVE INSTALLED A CUSTOM LOGO:
      The logo is copied to:
      $WAS_HOME/installedApps/<machine_name>/enRole.ear/app_web.war/images
      The Fixpack and Interim fix process removes the enRole.ear and all subdirectories.  
      To make it easier to restore the custom logo, copy it to a backup directory of your 
      choosing to facilitate copying it back after the Interim fix is applied.
      The ui.properties is preserved so it will not need to be updated.
      After the Interim fix is installed copy the custom logo to:
         $WAS_HOME/installedApps/<machine_name>/enRole.ear/app_web.war/images
NOTE: *************************************************************************       
      IF YOU HAVE INSTALLED A LANGUAGE PACK:
         Symptom - Fixpacks and Interim fixes partially overwrite Language Pack installation.
         Note - Before Fixpack or Interim fix installation, take a back-up of the following
         files/folder related to the language pack, located in the directory:
          $WAS_HOME/installedApps/<machine_name>/enRole.ear/app_web.war
            - AppletErrorMessages_<language code>.properties
            - AppletLabels_<language code>.properties
            - AppletMessages_<language code>.properties
            - The folder along with it's contents by the name as <language code>.
        
      The <language code> is generally a two letter word representing the language. 
      For example for English, the language code is 'en'.
        
      After applying the Fixpack or Interim Fix, restore all the language pack related files
      and folders, that were backed up, to their respective locations in the directory: 
      $WAS_HOME/installedApps/<machine_name>/enRole.ear/app_web.war
        
      Note that for WAS Cluster installation, the same steps will have to be followed on 
      each of the nodes. This procedure is needed only on the cluster member, not on the 
      Deployment Manager node.
NOTE: *************************************************************************       
      The enrole.ear and enrolefc.ear is installed in:
      <ITIM_HOME>/ directory
      Both files can be copied whether you are running in a single server, regular
      cluster or a functional cluster.  The file, enrole.ear, is used for single 
      server and regular cluster and enrolefc.ear is used when using a functional 
      cluster.
      For all instances of <server_name> below we are referring to the AppServer name in
      WebSphere, usually referred to as server1 in a single server environment.
    
      NOTE***  SINGLE SERVER INSTRUCTIONS:
      Please use the following instructions for a Single Server environment.  
      If this is a single server environment, only the enrole.ear is needed.         
          
      1. Log in to the App Server Administrator.
      
       a. Example:
               http://localhost:9090/admin .
      
      2. Uninstall enrole application       
      
       a. Select the enRole application
       
       b. Stop the enRole application
       
       c. Uninstall the enRole application
       
       d. Above this box, click on save the configuration...another panel will 
          come up and you will need to confirm this by pressing the save configuration
          button.
          
       e. You are now finished with the App Server Administrator
       
      3. Restart WAS.
      
       a. Stop the AppServer (stopServer.sh)
       
       b. Start the AppServer (startServer.sh)  
      
      4. In the <ITIM_HOME>/bin directory run 
               SetupEnrole install server:<server_name>  (e.g. server1)
               
          If you have WAS Security setup then:
         
               SetupEnrole install server:<server_name> user:<userid> password:<password>
               
      5. Perform the COMMON TASKS listed below these instructions.
      
      6. After you are done with the COMMON TASKS, then:
      
      7. Restart WAS and you are done.
             
       a. Stop the AppServer (stopServer.sh)
              
       b. Start the AppServer (startServer.sh)
               
         
      NOTE***  CLUSTER INSTRUCTIONS:
      Please use the following instructions for a Cluster environment.  
      If this is a regular cluster, only the enrole.ear is needed.         
      If this is a functional cluster, only the enrolefc.ear is needed.         
         
      1C. Ensure all node agents are up and can communicate with the NDM.
      
      2C. Uninstall the ITIM Application from WebSphere.
      
       a. Stop the cluster. Use "ssCluster.sh stop" or from NDM admin console, 
          navigate to Servers -> Clusters. Select the cluster (s) where ITIM 
          is installed, and stop. 
       
       b. Uninstall the enrole enterprise app. 
       
       c. Save the config ensuring that it is synched with all the nodes. 
       
       d. Logout from the NDM admin console.       
       
      3C. Re-Install ITIM.
      
       a. From NDM, run <ITIM_HOME>/bin/setupEnrole install. This is same as 
          in single server case, except, you don't need the "server" argument 
          here because the app will be deployed onto a cluster.
      
          If you have WAS Security setup then:
         
               SetupEnrole install user:<userid> password:<password>
               
      4C. Perform the COMMON TASKS listed below these instructions.
               
      5C. Start the cluster. Use "ssCluster.sh start" or do it from the NDM 
          admin console. 
          
NOTE: *****************************************************************************
       The following are COMMON TASKS that you may need to perform prior to restarting 
       the AppServer or Cluster. 
NOTE: *****************************************************************************

      1. Copy the itim_api.jar, itim_server.jar and the api_ejb.jar from:
         $WAS_HOME/installedApps/$MACHINE_NAME/enrole.ear  directory to
         $ITIM_HOME/lib  directory.
          
      2. If you are using the JAVA 2 Security, replace the was.policy file you saved
         earlier.  Copy it back to:
         $WAS_HOME/config/cells/$CELL_NAME/applications/enRole.ear/deployments/enRole/META-INF
         For Cluster in the NDM:
         $WAS_HOME/DeploymentManager/config/cells/$CELL_NAME/applications/enRole.ear/deployments/enRole/META-INF
         Where $CELL_NAME is either the $MACHINE_NAME or $CLUSTER_NAME.
         For additional information on using JAVA 2 Security with ITIM, please review the ITIM
         Installation Guide, Appendix C.
 
       END OF COMMON TASKS

End of Readme
