Fix (APAR):  PQ92379

Status:  Fix

Release:  5.1.1

Operating System:  All

Supersedes Fixes:  

CMVC Defect:  PQ92379

Byte size of APAR:  115529

Date: 2004-11-29

Abstract:  Exception after redeployment of a business process on a Deployment Manager

Description/symptom of problem:  1) Symptom:
   --------
   
   In a Network Deployment environment (a cell with mutliple application servers and a
   deployment manager), a business process is stopped and the correpsonding application
   is uninstalled.
   If the same business process application is installed again and the application servers
   are not restarted, any operation on this business process may lead to an exception   
   
   BPEA0010E: Unexpected exception during execution.
   com.ibm.bpe.util.ProcessAssertionError: 
   Assertion violation !(processTemplates.size() == 1)
   
2) Problem:
   --------
   
   The application servers maintain a cached version of the business processes
   in memory. In a Network Deployment environemnt, installation tasks are run on
   the deployment manager and the application servers cache for business processes
   is not notified about an uninstalled business process.
   When the same business process is installed again, two versions of the same 
   business process appear in the memory cache which leads to the described inconsistencies.

   
3) Solution:
   ---------
   
   Either restart the application server (this cleans the in-memory cache) or
   apply this interim fix which removes business processes from cache which
   are no longer valid.


Directions to apply fix:  

NOTE:  YOU MUST FIRST DOWNLOAD THE FIX INSTALLER TOOL IN ORDER TO INSTALL AN 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) Copy jar file 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 AN FIX UNLESS
     ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED.  YOU MAY REAPPLY ANY REMOVED FIX.

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) Copy jar file 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: