IBM(R) WebSphere Commerce, APAR JR20223, README

Platform: IBM OS/400


This README file provides instructions for applying the APAR on WebSphere Commerce 5.6.0.1 fix pack.


Terminology used in this book
cell_name
This variable represents the name of the WebSphere Application Server cell.

host_name
The fully qualified host name of your WebSphere Commerce machine. For example, server.mydomain.ibm.com is fully qualified.

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.

APARfix_dir
The temporary directory to which the files for the APAR fix have been extracted.


Path variables
HttpServer_installdir
The installation path for the IBM HTTP Server. The default installation directory is:
/QIBM/UserData/CommerceServer56/instances/instance_name/conf

WAS_appdir
The installation path for WebSphere Application Server 5. The default installation directory is:
/QIBM/UserData/WebAS5/Base/instance_name

WC_installdir
The installation path for WebSphere Commerce 5.6. The default installation directory is:
/QIBM/ProdData/CommerceServer56


Contents


What's in this README

This README file describes the product changes found in the JR20223_os400 fix.

APAR JR20223_os400 is to correct a problem with the QuickCheckout feature. This problem only exists in pre-5601 stores that were upgraded to fix pack 5601.

Ensure that you have installed the WebSphere Commerce 5.6.0.1 fix pack before applying this fix. This fix is not applicable to any other fix pack versions. This fix does not require upgrades to any of additional supported software.

Required: The WebSphere Commerce 5.6 update installation tool, consisting of the updateSilent.sh script and supporting files, is required to install this APAR fix.
If you do not have the WebSphere Commerce 5.6 update installation tool, please go to the WebSphere Commerce Support Site to download WebSphere Commerce 5.6.0.1 fix pack. The update tool is included in the fix pack.

If you are downloading the WebSphere Commerce 5.6 update installation tool (with the 5.6.0.1 fix pack), please extract/unjar 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.

NOTE: The below listed instructions for the installation and uninstallation of fix JR20223 are required only on the server (iSeries) side - no action is needed on the client (Workstation) side.


Installing JR20223

  1. Ensure that you are logged in as a user that has QSECOFR authority.
  2. Stop the following processes (if running):

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

  3. Enter the QShell by typing QSH at the OS/400 command prompt. Navigate to installer_dir.
  4. Type the following command, replacing where appropriate, options specific to your WebSphere Commerce installation.
         ./updateSilent.sh fix install WC_installdir JR20223 APARfix_dir
  5. Press Enter.
  6. If you do not have any previously-created (existing) instances the APAR installation is complete. 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.

    Note: If you do have previously-created instances, then repeat steps 7 to 8 for each WebSphere Commerce instance you have configured on your system.

  7. Enter the QShell by typing QSH at the OS/400 command prompt. Navigate to installer_dir and do one of the following:

    Applying the APAR fix to your commerce instances.
    To apply this fix to a commerce instance, Type the following command, replacing where appropriate, options specific to your WebSphere Commerce installation.
         ./updateSilent.sh fix install WAS_appdir/installedApps/cell_name/WC_instance_name.ear JR20223 APARfix_dir

    where cell_name is the name of the WebSphere Application Server cell.
  8. 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.

Uninstalling JR20223

  1. Ensure that you are logged in as a user that has QSECOFR authority.
  2. Stop the following processes (if running):

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

  3. Enter the QShell by typing QSH at the OS/400 command prompt. Navigate to installer_dir.
  4. Type the following command, replacing where appropriate, options specific to your WebSphere Commerce installation.

    ./updateSilent.sh fix uninstall WC_installdir JR20223

  5. Press Enter.
  6. If you do not have any previously-created instances the APAR uninstallation is complete. 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.

    Note: If you do have previously-created instances, then repeat steps 7 to 8 for each WebSphere Commerce instance you have configured on your system.

  7. Enter the QShell by typing QSH at the OS/400 command prompt. Navigate to installer_dir and do one of the following:

    Remove the APAR fix from a commerce instance.
    To remove this fix from a commerce instance, Type the following command, replacing where appropriate, options specific to your WebSphere Commerce installation.
         ./updateSilent.sh fix uninstall WAS_appdir/installedApps/cell_name/WC_instance_name.ear JR20223

    where cell_name is the name of the WebSphere Application Server cell.

  8. 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.

  1. 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 2003
    
    ** 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