IBM(R) WebSphere Commerce, APAR JR20469, README
Platform: Development Toolkit
This README file provides instructions for applying the APAR on WebSphere Commerce 5.6.
Terminology used in this book
instance_name
The name of a previously created WebSphere Commerce instance.
installer_dir
The directory to which the WebSphere Commerce 5.6 update installation tool has been extracted.
When you install fix pack 1 the update installation tool was downloaded and copied to your WSAD install directory.
We will refer to this directory as installer_dir. The default location is:
C:\Program Files\IBM\WebSphere Studio\Application Developer\v5.1.1\Installer
APARfix_dir
The temporary directory to which the files for the APAR fix have been extracted.
Path variables
WCDE_installdir
This is the installation directory for WebSphere Commerce Developer Edition. The default installation directories are:
For Business Edition: C:\WCToolkitBE56
For Professional Edition: C:\WCToolkitPro56
For Express Edition: C:\WCToolkitExpress56
Contents
This README file provides instructions for the proper installation and un-installation of the JR20469
interim fix. Please follow the instructions carefully.
APAR JR20469_WIN is to correct an issue causing the massloader to fail with a SAXParser exception when the database is a recent Oracle release.
Software Versions
This APAR may be installed on WebSphere Commerce 5.6 Developer Edition versions 5.6.0.0, 5.6.0.1, or 5.6.0.2.
This interim fix may not be applicable to any other fix pack versions of WebSphere Commerce 5.6 Developer Edition.
No upgrades to any of the additional supported software are needed.
Installation Tool
The WebSphere Commerce 5.6 update installation tool, consisting of the updateSilent.sh and updateWizard.sh scripts and supporting files,
is required to install this APAR fix.
    Warning: WebSphere Application Server also has a similar update tool. Do not use it to install WebSphere Commerce APAR fixes.
The WebSphere Commerce 5.6 update installation tool is included in the 5.6.0.1 fix pack download. When the 5.6.0.1 fix pack
was downloaded it copied the update installation tool to the WSAD directory. The default location is:
C:\Program Files\IBM\WebSphere Studio\Application Developer\v5.1.1\Installer
If you do not have the WebSphere Commerce 5.6 update installation tool, you may download it at the
WebSphere Commerce Support Site.
If you are downloading the WebSphere Commerce 5.6 update installation tool please extract/unzip
it to a temporary directory. The location of the WebSphere Commerce 5.6 update installation tool will be denoted by
installer_dir in the remaining sections of this guide.
- Ensure that you are logged in with a Windows user ID that is a member of the Administrators group.
- 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 Installation Guide.
- Navigate to installer_dir and double-click on updateWizard.bat.
- Click OK for English.
- Click Next to continue.
- Click Next to accept the WebSphere Commerce product found on your
computer.
- Select Install fixes. Click Next.
- Click Browse. Navigate to and click once on the APARfix_dir directory to select it. Click Open.
Click Next.
- Select the APAR to install by clicking the checkbox, then click Next to continue.
- Click Next to begin installing.
- 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.
- Click Finish to complete the installation.
- Ensure that you are logged in with a Windows user ID that is a member of the Administrators group.
- 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 Installation Guide.
- Using the command line, navigate to installer_dir.
- Type the following command replacing, where appropriate, options specific to your WebSphere Commerce installation.
updateSilent.bat fix install WCDE_installdir JR20469 APARfix_dir
- Press Enter.
- 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.
- Installation is complete.
- Ensure you are logged in with a Windows user ID that is a member of the Administrators group.
- 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 Installation Guide.
-
Using the command line (DOS window), navigate to installer_dir and type the
following command: updateWizard.bat.
- Click OK for English.
- Click Next to continue.
- Click Next to accept the WebSphere Commerce product found on your
computer.
- Select Uninstall fixes. Click Next.
- Select the fix to be uninstalled. Click Next to continue.
- Click Next to uninstall the fix.
- 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.
- Click Finish to complete the uninstallation.
- Ensure that you are logged in with a Windows user ID that is a member of the Administrators group.
- 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 Installation Guide.
- Using the command line, navigate to installer_dir.
- Type the following command, replacing where appropriate, options specific to your
WebSphere Commerce installation.
updateSilent.bat fix uninstall WCDE_installdir JR20469
- Press Enter.
- 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.
- Uninstallation is complete.
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