IBM(R) WebSphere Commerce, APAR JR29659, README

Platform: Development Toolkit

This README file provides instructions for applying the APAR on WebSphere Commerce 5.6.1.

Terminology used in this book
instance_name
The name of a previously created WebSphere Commerce instance.

Path variables

Contents

• What's in this README
• Pre-Requisites
• Installing JR29659 (Graphical User Interface)
• Installing JR29659 (Silent)
• Uninstalling JR29659 (Graphical User Interface)
• Uninstalling JR29659 (Silent)
• Trademarks and service marks

What's in this README

This README file provides instructions for the proper installation and un-installation of the JR29659 interim fix. Please follow the instructions carefully.

APAR JR29659 is update end date values in SAR files and bootsrap files.

Pre-Requisites

No upgrades to any of the additional supported software are needed.

If you do not have the WebSphere Commerce 5.6.1 update installation tool, you may download it at the WebSphere Commerce Support Site.

If you are downloading the WebSphere Commerce 5.6.1 update installation tool please extract/unzip it to a temporary directory. The location of the WebSphere Commerce 5.6.1 update installation tool will be denoted by installer_dir in the remaining sections of this guide.

Installing JR29659 (Graphical User Interface)

1. Ensure that you are logged in with a Windows user ID that is a member of the Administrators group.
2. Stop the following processes (if running):
   • WebSphere Commerce Test Server. For example, server1 in WSAD.
   • WebSphere Commerce Configuration Manager server.

   For instructions on how to stop and start services, refer to the IBM WebSphere Commerce Version 5.6.1 Installation Guide.

3. Navigate to installer_dir and double-click on updateWizard.bat.
   
4. Click OK for English.
5. Click Next to continue.
6. Click Next to accept the WebSphere Commerce product found on your computer. Note you may have to manually navigate to the WCDE_installdir
7. Select Install fixes. Click Next.
8. Click Browse. Navigate to and click once on the APARfix_dir directory to select it. Click Open. Click Next.
9. Select the APAR to install by clicking the checkbox, then click Next to continue.
10. Click Next to begin installing.
11. Ensure that the installer displays the message The following fix was successfully installed. If you do not get this message the installer will indicate which log files to check.
12. Click Finish to complete the installation.
13. Identify the directory where the WebSphere Commerce classes are located. e.g. C:\WebSphere\WCToolkitPro561\AppServer\classes
14. Backup and save the following file. The backup will be needed if you ever must uninstall this fix. C:\WebSphere\WCToolkitPro561\AppServer\classes\wcs.jar
15. Update the C:\WebSphere\WCToolkitPro56\AppServer\classes\wcs.jar with the files in manual_patch.zip and make the file path stay the same as they were before.

Installing JR29659 (Silent)

1. Ensure that you are logged in with a Windows user ID that is a member of the Administrators group.
2. Stop the following processes (if running):
   • WebSphere Commerce Test Server. For example, server1 in WSAD.
   • WebSphere Commerce Configuration Manager server.

   For instructions on how to stop and start services, refer to the IBM WebSphere Commerce Version 5.6.1 Installation Guide.

3. Using the command line, navigate to installer_dir.
   
4. Type the following command replacing, where appropriate, options specific to your WebSphere Commerce installation.

   updateSilent.bat fix install WCDE_installdir JR29659 APARfix_dir

5. Press Enter.
6. Ensure that the installer displays the message Fix installation completed successfully. If you do not get this message the installer will indicate the log files to check.
   
7. Identify the directory where the WebSphere Commerce classes are located. e.g. C:\WebSphere\WCToolkitPro561\AppServer\classes
8. Backup and save the following file. The backup will be needed if you ever must uninstall this fix. C:\WebSphere\WCToolkitPro561\AppServer\classes\wcs.jar
9. Update the C:\WebSphere\WCToolkitPro56\AppServer\classes\wcs.jar with the files in manual_patch.zip and make the file path stay the same as they were before.

Uninstalling JR29659 (Graphical User Interface)

1. Ensure you are logged in with a Windows user ID that is a member of the Administrators group.
2. Stop the following processes (if running):

   • Web server and its respective administration processes,
   • WebSphere Commerce Application Servers. For example, WC_instance_name.
   • WebSphere Commerce Configuration Manager server.

   For instructions on how to stop and start services, refer to the IBM WebSphere Commerce Version 5.6.1 Installation Guide.

3. Using the command line (DOS window), navigate to installer_dir and type the following command: updateWizard.bat.

4. Click OK for English.
5. Click Next to continue.
   
6. Click Next to accept the WebSphere Commerce product found on your computer. Note you may have to manually navigate to the WCDE_installdir
7. Select Uninstall fixes. Click Next.
8. Select the fix to be uninstalled. Click Next to continue.
9. Click Next to uninstall the fix.
10. Ensure that the installer displays the message The following fix was successfully uninstalled. If you do not get this message the installer will indicate the log files to check.
11. Click Finish to complete the uninstallation.
12. Restore the C:\WebSphere\WCToolkitPro56\AppServer\classes\wcs.jar which was backed up before install.

Uninstalling JR29659 (Silent)

1. Ensure that you are logged in with a Windows user ID that is a member of the Administrators group.
2. Stop the following processes (if running):
   • Web server and its respective administration processes,
   • WebSphere Commerce Application Servers. For example, WC_instance_name.
   • WebSphere Commerce Configuration Manager server.

   For instructions on how to stop and start services, refer to the IBM WebSphere Commerce Version 5.6.1 Installation Guide.

3. Using the command line, navigate to installer_dir.
4. Type the following command, replacing where appropriate, options specific to your WebSphere Commerce installation.

   updateSilent.bat fix uninstall WCDE_installdir JR29659

5. Press Enter.
6. Ensure that the installer displays the message The following fix was successfully uninstalled. If you do not get this message the installer will indicate the log files to check.
   
7. Restore the C:\WebSphere\WCToolkitPro56\AppServer\classes\wcs.jar which was backed up before install.
8. Uninstallation is complete.

Trademarks and service marks

The following are trademarks or registered trademarks of IBM Corporation in the United States and other countries:

IBM      WebSphere

Windows and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

**************************************************************************

** © COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2004

** ALL RIGHTS RESERVED.

**************************************************************************

Note to US Government Users -- Documentation related to restricted rights -- Use, duplication, or disclosure is subject to restriction set forth in GSA ADP Schedule Contract with IBM Corp.

End of README File