IBM(R) WebSphere Commerce, APAR JR20874, README
Platform: Linux
This README file provides instructions for applying the APAR on WebSphere Commerce 5.6.0.3 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.
Path variables
HttpServer_installdir
The installation path for the IBM HTTP Server. The default installation directory
is:
/opt/IBMHttpServer
WAS_installdir
The installation path for WebSphere Application Server 5. The default installation
directory is:
/opt/WebSphere/AppServer
WC_installdir
The installation path for WebSphere Commerce 5.6. The default installation directory
is:
/opt/WebSphere/CommerceServer56
APARfix_dir
The temporary directory to which the files for the APAR fix have been extracted.
Contents
This README file provides instructions for the proper installation and un-installation of the JR20874_linux
interim fix. Please follow the instructions carefully.
APAR JR20874 provides catalog access-control fixes, as well as a tool (fixDeploy) that you must use to update the deployed EJBs.
Please ensure that you complete the Additional Installation steps after applying JR20874.
Software Versions
Ensure that WebSphere Commerce 5.6 is at the 5.6.0.3 fix pack level before applying this interim fix.
This interim fix is not applicable to any other fix pack versions of WebSphere Commerce 5.6.
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: The update installation tool required for WebSphere Commerce 5.6 is distinct from versions used by the WebSphere
Application Server and other versions of WebSphere Commerce.
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.
Red Hat Linux - Additional Preparation
If you are using Red Hat Enterprise Linux AS or ES, Version 3.0, for xSeries systems, copy all of the files from Common/RHEL3/sr6_jdk_i386 on the WebSphere Application Server fixes CD to installer_dir/java_tmp directory.
If you are using Red Hat Enterprise Linux AS or ES, Version 3.0, for zSeries or S/390® systems, copy all of the files from Common/RHEL3/sr6_jdk_s390 on the WebSphere Application Server fixes CD to installer_dir/java_tmp directory.
Before you begin to install or uninstall the interim fix, please set the following environment variables by running these commands as the root user:
    LD_ASSUME_KERNEL=2.4.19
    RPM_FORCE_NPTL=1
    export LD_ASSUME_KERNEL RPM_FORCE_NPTL
Important: If you have existing WebSphere Commerce instances you will need to run the installation tool at least twice.
Please carefully follow the steps below to ensure that the fix is properly applied.
Update WebSphere Commerce Installation
Please follow these steps to update the WebSphere Commerce Installation at location: WC_installdir.
- Ensure that you are logged in as the root user.
- 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.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- Using the command line, navigate to installer_dir and type the following
command: updateWizard.sh
- 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 select the APARfix_dir directory, then click Open. Click Next.
- Ensure that the fix you want to install is selected and click Next.
- 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.
- Switch to the root user, navigate to the WC_installdir/bin directory, and run the following command: ./wcnonroot.sh.
- If you do not have previously-created (existing) instances the installation is complete.
Update Deployed WebSphere Commerce Applications
If you have previously-created instances, please repeat the following steps for each deployed WebSphere Commerce application at location: WAS_appdir/installedApps/cell_name/WC_instance_name.ear.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- Using the command line, navigate to the installer_dir directory
and type the following command: updateWizard.sh
- Click OK for English.
- Click Next to continue.
- Click Specify product information, then click Browse.
- 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.
- Select Install fixes. Click Next.
- Click Browse. Navigate to and select the APARfix_dir directory, then click Open. Click Next.
- Ensure that the fix you want to install is selected and click Next.
- 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.
- Complete the steps in the section Required Additional Installation steps.
Important: If you have existing WebSphere Commerce instances you will need to run the installation tool at least twice.
Please carefully follow the steps below to ensure that the fix is properly applied.
Update WebSphere Commerce Installation
Please follow these steps to update the WebSphere Commerce Installation at location: WC_installdir.
- Ensure that you are logged in as the root user.
- 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.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- Using the command line, navigate to installer_dir.
- Type following, replacing where appropriate, options specific to your
WebSphere Commerce installation.
./updateSilent.sh fix install WC_installDir JR20874 APARfix_dir
- Press Enter.
- 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.
- Switch to the root user, navigate to the WC_installdir/bin directory, and run the following command: ./wcnonroot.sh.
Update Deployed WebSphere Commerce Applications
If you have previously-created instances, please repeat the following steps for each deployed WebSphere Commerce application at location: WAS_appdir/installedApps/cell_name/WC_instance_name.ear.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- 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
JR20874
APARfix_dir
where cell_name is the name of the WebSphere Application Server cell.
- 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.
- Complete the steps in the section Additional Installation steps.
- Create a temporary directory with 100MB of free space. We will refer to this directory as temp_dir
- Ensure that you are logged in as the root user.
- Using the command line, navigate to the directory WC_installdir/bin.
- Type following, replacing where appropriate, options specific to your
WebSphere Commerce installation.
./fixDeploy.sh projectList.txt temp_dir WAS_installdir cell_name instance_name workstation WC_installdir
WC_installdir/xml/inputCommand.xml
Example:
./fixDeploy.sh projectList.txt /tmp /opt/WebSphere/AppServer MyCell MyWCInstance workstation /opt/WebSphere/CommerceServer56 /opt/WebSphere/CommerceServer56/xml/inputCommand.xml
- Check the following log file for errors: WC_installdir/logs/fixDeployFromFile.log
Important: If you have existing WebSphere Commerce instances you will need to run the uninstallation tool at least twice.
Please carefully follow the steps below to ensure that the fix is properly removed.
Remove from WebSphere Commerce Installation
Please follow these steps to remove the interim fix from the WebSphere Commerce Installation at location: WC_installdir.
- Ensure that you are logged in as the root user.
- 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.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- Using the command line, navigate to installer_dir and type the following command: updateWizard.sh
- 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 exit.
- If you do not have previously-created instances the installation is complete.
Remove from Deployed WebSphere Commerce Applications
If you have previously-created instances, please repeat the following steps for each deployed WebSphere Commerce application at location: WAS_appdir/installedApps/cell_name/WC_instance_name.ear.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- Using the command line, navigate to the installer_dir directory
and type the following command: updateWizard.sh
- Click OK for English.
- Click Next to continue.
- Click Specify product information, then click Browse.
- 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.
- 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.
Important: If you have existing WebSphere Commerce instances you will need to run the uninstallation tool at least twice.
Please carefully follow the steps below to ensure that the fix is properly removed.
Remove from WebSphere Commerce Installation
Please follow these steps to remove the interim fix from the WebSphere Commerce Installation at location: WC_installdir.
- Ensure that you are logged in as the root user.
- 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.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- Using the command line, navigate to installer_dir.
- Type the following command, replacing where appropriate, options specific to your
WebSphere Commerce installation.
./updateSilent.sh fix uninstall WC_installDir JR20874
- Press Enter.
- 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.
Remove from Deployed WebSphere Commerce Applications
If you have previously-created instances, please repeat the following steps for each deployed WebSphere Commerce application at location: WAS_appdir/installedApps/cell_name/WC_instance_name.ear.
- At the command line set and export the LD_ASSUME_KERNEL RPM_FORCE_NPT environment variables as specified above
- 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
JR20874
where cell_name is the name of the WebSphere Application Server cell.
- 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.
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