Fix (APAR):  PQ87712

Status:  Test

Release:  4.0.7,4.0.6,4.0.5

Operating System:  Multi-Platform

Supersedes Fixes:  PQ80564

CMVC Defect:  None

Byte size of APAR:  3268619

Date: May 13, 2004

Abstract:  This fix prevents creation of orphaned application servers after adminserver restarts

Description/symptom of problem:  During a adminserver restart (by the nanny), the situation can occur where previously running application servers may be orphaned.  After the adminserver has restarted, it will not connect to these previously running application servers.  PQ62494 fixes this through exposing a new system property -- com.ibm.ejs.sm.adminServer.forceReconnect.  Even though this property corrected orphaning in most situations, orphaning could still occur with certain property combinations, one such being disableAutoServerStart=false/nodeStartState=stopped.  This fix now fully solves the problem of orphaned processes.  The application of PQ62494 is a prerequisite.

Directions to apply fix:  1) Create temporary "Fix" directory to store the jar file:
            UNIX: /tmp/WebSphere/Fix
         Windows: c:\temp\WebSphere\Fix

2) Copy jar file to the directory

3) Shutdown WebSphere

4) Run the jar file with the following command answering questions/prompts as they appear:
   java -jar 

5) Restart WebSphere

6) The temp directory may be removed but the jar file should be saved.  Do not remove any files created and stored in the /Fix/PQ87712 directories.  These files are required if a Fix is to be removed.

Directions to remove fix:  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 RE-APPLY 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) Change directory to the Fix location (/Fix/PQ87712).

2) Shutdown WebSphere

3) Run the backup jar file with the following command:
   java -jar PQ87712_Fix_backup.jar

4) Restart WebSphere

Directions to re-apply fix:  Follow the instructions for applying a Fix.  If the backup files still exist (from the previous Fix application), you will be prompted to overwrite.  Answer "yes" at the overwrite prompts.

Additional Information:  -----------------------
This APAR contains fixes packaged in different jar files for different releases:
WAS 4.0.5: PQ87712_Fix.jar
WAS 4.0.6: PQ87712_406_Fix.jar
WAS 4.0.7: PQ87712_407_Fix.jar