Fix (APAR):  WAS_Security_03-14-2003_4.0.6-4.0.5-4.0.4-4.0.3-4.0.2-4.0.1_JCE_r2_cumulative_Fix

Status:  Fix

Release:  4.0.6,4.0.5,4.0.4,4.0.3,4.0.2,4.0.1

Operating System:  All

Supersedes Fixes:  WAS_Security_03-14-2003_4.0.6-4.0.5-4.0.4-4.0.3-4.0.2-4.0.1_JCE_cumulative_Fix
(This fix did not install correctly on Unix systems.)

CMVC Defect:  See APAR List.

Byte size of APAR:  2492792

Date: 2003-05-21

Abstract:  JCE Build 03-14-2003

Description/symptom of problem:  This fix contains IBM JCE 1.2.1 build 20030314.

Specific WebSphere APARs are listed below.  This only reflects issues reported
by WebSphere customers, however, and is not a comprehensive list of defects
resolved.


PQ69688 THE KEYSTORE HAS A "BAD" SERIALIZED OBJECT 

Keystores created using Sun's JCE implementation cannot be used 
with IBM's implementation.  The problem was caused by a version 
stamp in the serialized keys.                                   

PQ71581 Import of pkcs12 key into jks keystore fails.

IKeyMan cannot import keys saved in PKCS12 format.  The error
message received is:                                         
"The Specified database has been corrupted"                  



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

2) Copy jar file to the directory

3) Shutdown WebSphere

4)Create a <WASHOME>/Fix directory if one does not already exist

5) Run the jar file with the following command answering questions/prompts as they appear:
   java -jar <jarfile name> -backupJar <WASHOME>/Fix/<jar file name>_backup.jar

6) Restart WebSphere

7) The temp directory may be removed but the jar file should be saved.  Do not remove
	any files created and stored in the <WASHOME>/Fix directory.
   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 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) Change directory to the fix location (<WASHOME>/Fix).

2) Shutdown WebSphere

3) Run the backup jar file with the following command:
	java -jar <backup_fix#>

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: