Fix (APAR):  PQ76804

Status:  Fix

Release:  5.0.2,5.0.1,5.0.0

Operating System:  Unix (General)

Supersedes Fixes:  PQ74684

CMVC Defect:  PQ76804

Byte size of APAR:  92113

Date: 2003-07-30

Abstract:  rsh (remote shell)  execution of certain scripts within WebSphere hangs.

Description/symptom of problem:  When certain scripts are executed remotely through rsh, rsh will hang.  This occurs when the script in question leaves a running process on the system when it exists.  Examples of such scripts are addNode.sh, startServer.sh, and so on.  

Directions to apply fix:  

NOTE:  YOU MUST FIRST DOWNLOAD THE UPDATE INSTALLER TOOL IN ORDER TO INSTALL A FIX.
       The Fix Installer can be downloaded from the following link:
       http://www-3.ibm.com/software/webservers/appserv/support/index.html

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

2) Extract the PQ76804_unix.zip.  It contains single ifix jars for each UNIX style operating system.  The jarfiles are named based on the APAR # and the operating system name.

3) Copy jar file specific to your platform to the directory

3) Shutdown WebSphere

4) Follow the Fix installation instructions that are packaged with the Fix Installer on how to install the Fix.

5) Restart WebSphere

6) The temp directory may 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 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

2) Follow the instructions that are packaged with the Fix Installer on how to uninstall the Fix.

3) Restart WebSphere

Directions to re-apply fix:  
1) Shutdown WebSphere

2) Follow the Fix instructions that are packaged with the Fix Installer on how to uninstall and reinstall the Fix.

3) Restart WebSphere



Additional Information:  The hang was caused by an inadvertant inheritance of the 'stdin' file descriptor from rsh to the spawned process.  Since the descriptor remained in use, the rsh call would not exit even though the script it called had completed its task.

This fix is cumulative for HP-UX.  It contains the fix for PQ74684 as well.

It also contains a minor fix for Linux, to correct for LinuxThread behavior with getpid().  This should correct variences in the pid displayed in the runtime panel, or through the mbean call through scripting.