Fix (APAR):  PQ95537

Status:  Fix

Release:  5.1.1

Operating System:  All

Supersedes Fixes:  

CMVC Defect:  PQ95537

Byte size of APAR:  16592

Date: 2005-03-28

Abstract:  This APAR provides a tool which can repair a broken WebSphere Business Integration Server Foundation instance which does not contain the required WebSphere Business Integration Server Foundation files.

Description/symptom of problem:  This fix is only applicable to WebSphere Business Integration Server Foundation.

If an instance is created using the wsinstance command and WebSphere Business Integration Server Foundation has been installed the instance may not function due to missing files. This APAR provides an ant based tool which can repair a broken instance. The tool can repair a WebSphere Application Server base installation. 
WebSphere Application Server Network Deployment installations are not supported. The tool will copy WebSphere Business Integration Server Foundation files to any instances which have been created. Existing files may be overwritten so it is recommended to create a backup of the configuration files. 

The fix also updates the template files so that any new instances will not have the problem (ie you do not have to run the tool a second time). 

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:  Running the tool : 

1) From a command prompt source, or execute the setupCmdLine script.
   UNIX    :  $ . [WebSphere installation directory]/bin/setupCmdLine.sh
   
   Windows :  C:\> [WebSphere installation directory]\bin\setupCmdLine.bat

2) Back up your configuration files. A basic way to do this is to create a jar file for each instance and your base configuration files. 
   For example, 
   UNIX    :   $ $JAVA_HOME/bin/jar -cvf ~/instanceBackups/instance1Backup.jar [path to instance 1]
               $ $JAVA_HOME/bin/jar -cvf ~/instanceBackups/instance2Backup.jar [path to instance 2]
               $ $JAVA_HOME/bin/jar -cvf ~/wasConfigBackups/wasConfigBackup.jar $WAS_HOME/config
               $ $JAVA_HOME/bin/jar -cvf ~/wasPropertiesBackups/wasPropertiesBackup.jar $WAS_HOME/properties
               
   Windows :   C:\> %JAVA_HOME%/bin/jar -cvf C:\instanceBackups\instance1Backup.jar [path to instance 1]
               C:\> %JAVA_HOME%/bin/jar -cvf C:\instanceBackups\instance2Backup.jar [path to instance 2]
               C:\> %JAVA_HOME%/bin/jar -cvf C:\wasConfigBackups\wasConfigBackup.jar %WAS_HOME%/config
               C:\> %JAVA_HOME%/bin/jar -cvf C:\wasPropertiesBackups\wasPropertiesBackup.jar %WAS_HOME%/properties
               
3) Run the tool :
   UNIX    :   $ $WAS_HOME/bin/ws_ant -f $WAS_HOME/bin/wsinstance/apars/PQ95537/PQ95537.xml 
   
   Windows :   C:\> %WAS_HOME%\bin\ws_ant.bat -f %WAS_HOME%\bin\wsinstance\apars\PQ95537\PQ95537.xml