Fix (APAR):  PK28814

Status:  Fix

Release:  6.0.2

Operating System:  AIX,HP-UX,Linux,Solaris,Windows

Supersedes Fixes:  

CMVC Defect:  PK28814

Byte size of APAR:  2080009

Date: 2006-09-14

Abstract:  The Long-running job submitter's credentials are not on the thread when recurring requests are submitted. Users may see a com.ibm.websphere. security.auth.WSLoginFailedException wh

Description/symptom of problem:  
 
PK28814 resolves the following problem:

ERROR DESCRIPTION:                                              
Currently, only server credentials are placed on the thread     
regardless of system code or user code execution.               

LOCAL FIX:                                                      

PROBLEM SUMMARY

USERS AFFECTED:
All users of WebSphere Extended Deployment
version 6.0.2.

PROBLEM DESCRIPTION:
The Long-running job submitter's
credentials are not on the thread
when recurring requests are submitted.
Users may see a com.ibm.websphere.
security.auth.WSLoginFailedException
when attempting to submit recurring
requests and/or delayed jobs.

RECOMMENDATION:
None

When Websphere Application Server security is enabled, the
Long-Running Execution Environment (LREE) will run the user code
under the submitter's credential. In order to do that, the LREE
will try to login as submitter's ID using the ContextManager
login() method. Users may experience a
com.ibm.websphere.security.auth.WSLoginFailedException
when trying to submit a recurring request and delayed jobs if
the submitter ID is not present on the thread.

PROBLEM CONCLUSION:                                             
Code changes were made such that the Long-Running Job Scheduler 
passes the submitter's ID to the Long-Running Execution         
Environment.                                                    

Directions to apply fix:  Installation instructions for ifix:

(assuming customer has installed update installer already)

1) Place 6.0.2-WS-XD-IFPK28814.pak (for XD 6.0.2 on WAS 6.0.2) or 6.1-WS-XD-IFPK28814.pak (for XD 6.0.2 on WAS 6.1) in updateinstaller/maintenance folder and launch update installer.

2) Install the ifix. The ifix updates:

   <was_root>/lib/batchruntime.jar
   <was_root>/lib/gridendpointselector.jar

   <was_root>/installableApps/LongRunnngScheduler.ear
   <was_root>/installableApps/LREE.ear

3) This ifix requires that the LongRunningScheduler.ear and LREE.ear applications be re-installed.

a) backup your configuration using the backupConfig command. For instructions refer to http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp and search for "backupConfig"

b) uninstall the LongRunningScheduler.ear and LREE.ear applications from the cell.

c) install the LongRunningScheduler.ear and LREE.ear applications located in <was_root>/installableApps. For instructions refer to:
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp and search for "Installing the long-running scheduler application EAR file" and "Installing the execution environment"

4) Start the Long Running Scheduler and LREE servers.

5) If you desire to uninstall the IFIX, use the update installer to uninstall the maintenance and use the restoreConfig command to restore your original configuration.

Directions to remove fix:  NOTE:  The user must have Administrative rights in Windows, or be the Actual Root User in a UNIX environments.

NOTE:  FIXES MUST BE REMOVED IN THE ORDER THEY WERE APPLIED.
DO NOT REMOVE A FIX UNLESS
ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED.
YOU MAY REAPPLY ANY REMOVED FIX.

Example:  If your system has fix1, fix2, and fix3 applied in that order and fix2 is to be removed, fix3 must be removed first, fix2 removed, and fix3 re-applied.

1) Shutdown WebSphere
Manually execute setupCmdLine.bat in Windows or . ./setupCmdLine.sh in Unix from the WebSphere instance that uninstall is being run against.

2) Start Update Installer

3) Enter the installation location of the WebSphere product you want to remove the fix.

4) Select  "Uninstall maintenance package" operation.

5) Enter the file name of the maintenance package to uninstall (PKxxxxx.pak).

6) UnInstall maintenance package.

7) Restart WebSphere

Directions to re-apply fix:  1) Shutdown WebSphere

2) Follow the Fix instructions to apply the fix.

3) Restart WebSphere

Additional Information:  This IFIX is also fixing the following APARs:
PK31087 : Close BDS (batch data stream) not being called
by the LREE (Long Running Execution Environment).
PK24302 : Status of runtime task on XD is showing up incorrectly.
PK28106 : Age-based health policy does not wait for the job
to complete.

Code changes were also made such that the LREE invokes the close
BDS method, the status of runtime task is now showing correctly
and age-based health policy now waits for the job to complete.