IBM(R) WebSphere Commerce, APAR JR19116, README

Platform: Linux

This README file provides instructions for applying the APAR on WebSphere Commerce 5.5.0.2 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.

pay_instance_name
The name of a previously-created WebSphere Commerce payments instance.

installer_dir
The temporary directory to which the UpdateInstaller 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:
/opt/IBMHttpServer

WC_installdir
The installation path for WebSphere Commerce 5.5. The default installation directory is:
/opt/WebSphere/CommerceServer55


Contents

What's in this README

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

APAR JR19116_LINUX is to fix a virtual host defect that occurs in multiple-instance configurations

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

Installing JR19116 (Graphical User Interface)

  1. The UpdateInstaller installation tool is required to install this APAR fix. If you do not already have the UpdateInstaller, it is available as part of the fixpack 2 bundle. Please download the WebSphere Commerce 5.5.0.2 fix pack from the WebSphere Commerce Support site and extract/unzip it into a temporary directory. This temporary directory will be denoted by: installer_dir in the remaining sections of this guide.

  2. Download the JR19116_LINUX.jar fix from the WebSphere Commerce Support site and extract the files into a temporary directory. This temporary directory will be denoted by: APARfix_dir in the remaining sections of this guide.

  3. Ensure that you are logged in as the root user in Linux.

  4. Stop the following:

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

  5. Using the command line, navigate to installer_dir and type the following command: updateWizard.sh
  6. Click OK for English.
  7. Click Next to continue.
  8. Click Next to accept the WebSphere Commerce product found on your computer.
  9. Select Install fixes. Click Next.
  10. Click Browse. Navigate to the APARfix_dir directory. Click on wc once to select the wc folder, then click Open. Click Next.
  11. Click Next to accept the fix found.
  12. Click Next to begin installing.
  13. 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.
  14. The installation is complete.

Installing JR19116 (Silent)

  1. The UpdateInstaller installation tool is required to install this APAR fix. If you do not already have the UpdateInstaller, it is available as part of the fixpack 2 bundle. Please download the WebSphere Commerce 5.5.0.2 fix pack from the WebSphere Commerce Support site and extract/unzip it into a temporary directory. This temporary directory will be denoted by: installer_dir in the remaining sections of this guide.
  2. Download the JR19116_LINUX.jar fix from the WebSphere Commerce Support site and extract the files into a temporary directory. This temporary directory will be denoted by: APARfix_dir in the remaining sections of this guide.
  3. Ensure that you are logged in as the root user in Linux.
  4. Stop the following:

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

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

    ./updateSilent.sh fix install WC_installDir JR19116 APARfix_dir/wc

    Please note the /wc appended to APARfix_dir.

  7. Press Enter.
  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.
  9. Installation is complete.

Post-Installation Steps

  1. Start up WebSphere Application Server, server1. For starting up WebSphere Application Server please refer to IBM WebSphere Commerce Version 5.5 Installation Guide.
  2. Launch WebSphere Application Server adminconsole. The adminconsole default URL is http://host_name:9090/admin.
  3. Enter your user ID to log in.
  4. In the left window pane, expand Environment.
  5. Under Environment, click Virtual Hosts.
  6. In the right window pane, under the heading Name, click default_host.
  7. Under Additional Properties click Host Aliases.
  8. Note: Do not remove the * entry for port 80.
    Under Host Name, if there any entries for port 80 with a host name and/or fully qualified host name select those and click delete.
  9. Save your configuration changes.
  10. In the left window pane, expand Environment.
  11. Click Update Web Server Plugin.
  12. In the right window click the OK button to update the plugin configuration file.
  13. Restart the WebServer, the Websphere Application Server, and Websphere Commerce instances

Uninstalling JR19116 (Graphical User Interface)

  1. The UpdateInstaller installation tool is required to uninstall an APAR fix. If you do not already have the UpdateInstaller, it is available as part of the fixpack 2 bundle. Please download the WebSphere Commerce 5.5.0.2 fix pack from the WebSphere Commerce Support site and extract/unzip it into a temporary directory. This temporary directory will be denoted by: installer_dir in the remaining sections of this guide.
  2. Ensure that you are logged in as the root user in Linux.
  3. Stop the following:

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

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

  5. Click OK for English.
  6. Click Next to continue.
  7. Click Next to accept the WebSphere Commerce product found on your computer.
  8. Select Uninstall fixes. Click Next.
  9. Select the fix to be uninstalled. Click Next to continue.
  10. Click Next to uninstall the fix.
  11. 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.
  12. Uninstallation is complete.

Uninstalling JR19116 (Silent)

  1. The UpdateInstaller installation tool is required to uninstall an APAR fix. If you do not already have the UpdateInstaller, it is available as part of the fixpack 2 bundle. Please download the WebSphere Commerce 5.5.0.2 fix pack from the WebSphere Commerce Support site and extract/unzip it into a temporary directory. This temporary directory will be denoted by: installer_dir in the remaining sections of this guide.
  2. Ensure that you are logged in as the root user in Linux.
  3. Stop the following:

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

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

    ./updateSilent.sh fix uninstall WC_installDir JR19116

  6. Press Enter.
  7. 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.
  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 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