IBM(R) WebSphere Commerce, APAR JR20227, README

Platform: IBM AIX

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.

Path variables
HttpServer_installdir
The installation path for the IBM HTTP Server. The default installation directory is:
/usr/WebSphere/IBMHttpServer

Contents

• What's in this README
• Installing JR20227 (Graphical User Interface)
• Installing JR20227 (Silent)
• Uninstalling JR20227 (Graphical User Interface)
• Uninstalling JR20227 (Silent)
• Trademarks and service marks

What's in this README

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

APAR JR20227 is to allow a contract using the Catalog Filter terms and conditions to be deployed to other stores.

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.

• Warning: WebSphere Application Server also has a similar update tool. Do not use it to install WebSphere Commerce APAR fixes..

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

Installing JR20227 (Graphical User Interface)

1. Ensure that you are logged in as the root user.
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 Installation Guide.

3. Using the command line, navigate to installer_dir and type the following command: updateWizard.sh
   
4. Click OK for English.
5. Click Next to continue.
6. Click Next to accept the WebSphere Commerce product found on your computer.
7. Select Install fixes. Click Next.
8. Click Browse. Navigate to and select the APARfix_dir directory, then click Open. Click Next.
9. Ensure that the fix you want to install is selected and click Next.
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. Click Finish.
12. If you do not have previously-created (existing) instances the installation is complete.

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

13. Using the command line, navigate to the installer_dir directory and type the following command: updateWizard.sh
14. Click OK for English.
15. Click Next to continue.
16. Click Specify product information, then click Browse.
17. Navigate to the directory WAS_installdir/installedApps/cell_name and click once on the WC_instance_name.ear folder to select it, then click Open.
    Click Next to continue.

18. Select Install fixes. Click Next.
19. Click Browse. Navigate to and select the APARfix_dir directory, then click Open. Click Next.
20. Ensure that the fix you want to install is selected and click Next.
21. Click Next to begin installing.
22. 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.
23. Click Finish to complete the installation.

Installing JR20227 (Silent)

1. Ensure that you are logged in as the root user.
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 Installation Guide.

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

   ./updateSilent.sh fix install WC_installDir JR20227 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. Using the command line, navigate to the installer_dir and type the following command. Replace, where appropriate, the options specific to your WebSphere Commerce installation.
        ./updateSilent.sh fix install WAS_installDir/installedApps/cell_name/WC_instance_name.ear JR20227 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 JR20227 (Graphical User Interface)

1. Ensure that you are logged in as the root user.
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 Installation Guide.

3. Using the command line, navigate to installer_dir and type the following command: updateWizard.sh

4. Click OK for English.
5. Click Next to continue.
   
6. Click Next to accept the WebSphere Commerce product found on your computer.
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. Click Finish to exit.
11. If you do not have previously-created instances the installation is complete.

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

12. Using the command line, navigate to the installer_dir directory and type the following command: updateWizard.sh
13. Click OK for English.
14. Click Next to continue.
15. Click Specify product information, then click Browse.
16. Navigate to the directory WAS_installdir/installedApps/cell_name and click once on the WC_instance_name.ear folder to select it, then click Open.

    Click Next to continue.

17. Select Uninstall fixes. Click Next.
18. Select the fix to be uninstalled. Click Next to continue.
19. Click Next to uninstall the fix.
20. 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.
21. Click Finish.

Uninstalling JR20227 (Silent)

1. Ensure that you are logged in as the root user.
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 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.sh fix uninstall WC_installDir JR20227

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. Using the command line, navigate to the installer_dir and type the following command. Replace, where appropriate, the options specific to your WebSphere Commerce installation.
        ./updateSilent.sh fix uninstall WAS_installDir/installedApps/cell_name/WC_instance_name.ear JR20227
   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.

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