IBM(R) WebSphere Commerce Feature Pack 1, APAR JR27968, README


This README file provides instructions for applying the interim fix JR27968 on WebSphere Commerce Feature Pack 1.


Preparation

Software Versions:

Download and install the WebSphere Commerce Update Installer. The directory to which you install the Update Installer will be called UPDI_installdir through the rest of this document.

Obtain the interim fix package (.pak file) for APAR JR27968 and place it in a location accessible to the WebSphere Commerce Update Installer. For example UPDI_installdir/maintenance.

 


Installing WebSphere Commerce Feature Pack 1 Interim Fix JR27968

Important:

  • The WebSphere Application Developer  Test server must be stopped before applying the fixes.

Applying the WebSphere Commerce Feature Pack 1 fixes to the WebSphere Application Developer

Complete one of the following sections:

To uninstall the fixes, refer to Removing the WebSphere Commerce Feature Pack 1 fixes.


Applying the WebSphere Commerce Feature Pack 1 fixes using the graphical installer

Complete this section to install the WebSphere Commerce Feature Pack 1 interim fix.

Updating the WebSphere Application Developer installation directory

  1. Using the command line, navigate to the UPDI_installdir directory and type the following command based on your operating system:
    • update.bat
  2. On the Welcome panel, review the information and click Next to continue.
  3. Specify the WebSphere Application Developer installation directory.
  4. Ensure the correct directory is listed for the WebSphere Application Developer product. Enter the correct directory and click Next.
  5. Select Install maintenance package. Click Next.
  6. Select the appropriate .pak file from UPDI_installdir/maintenance directory and click Next.
  7. On the summary page, review the information and click Next to begin the installation.
  8. Ensure that the installer displays the message
    • Success:The following maintenance package was installed.
    • If you do not see this message the installer will indicate which log files to check. Click Finish.

9.      Backup the file: WCD_installdir /workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar.  The backup will be required if you ever need to uninstall JR27968.

10.  Copy WCD_installdir /components/Coremetrics/wc.ear/Stores.war/WEB-INF/lib/coremetrics.jar to WCD_installdir /workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar

Applying the WebSphere Commerce Feature Pack 1 fixes using the silent installer

Complete this section to silently install the WebSphere Commerce Feature Pack 1 interim fix.

Updating the WebSphere Application Developer installation directory

This section updates the WebSphere Commerce Feature Pack 1.

  1. Navigate to the UPDI_installdir/responsefiles directory and open the install.txt file in a text editor.
  2. Edit the install.txt file, ensuring the following sections are edited appropriately:
    • The -W maintenance.package contains the full path name for the interim fix. For example:
      • -W maintenance.package="C:\Program Files\IBM\WebSphere\UpdateInstaller\V61\UPDI\maintenance\APAR1.pak"
    • The -W product.location contains the full path name of the WebSphere Application Developer  installation directory. For example:
      • -W product.location="C:\Program Files\IBM\WebSphere\WCToolkitPro56 "

Verify that the -W update.instancename and -W update.db entries do not exist or are commented out. Save the file and exit.

  1. Run the following command from the UPDI_installdir:
    • update.bat -silent -options UPDI_installdir/responsefiles/install.txt
  2. Refer to the log files in the following directory to verify that your install was successful:
    • WCD_installdir/logs/update 
  3. Backup the file: WCD_installdir/workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar.  The backup will be required if you ever need to uninstall JR27968.
  4. Copy WCD_installdir/components/Coremetrics/wc.ear/Stores.war/WEB-INF/lib/coremetrics.jar to WCD_installdir/workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar

Removing the WebSphere Commerce Feature Pack 1 fixes

Important

  1. Ensure that you are logged in with a Windows user ID that is a member of the Administrator group.
  2. Complete one of the following steps:
    • To remove the fix from the WebSphere Application Developer  product:
      • Stop the following servers:
        • WebSphere Application Developer Test server.

Complete one of the following sections:


Uninstalling  the WebSphere Commerce Feature Pack 1 fixes using the graphical installer

Complete this section to uninstall the WebSphere Commerce Feature Pack 1 fix.

Removing the interim fix from the WebSphere Application Developer installation directory

  1. Using the command line, navigate to the UPDI_installdir directory and type the following command based on your operating system:
    • update.bat
  2. On the Welcome panel, review the information and click Next to continue.
  3. On the Product Selection panel ensure that the directory name is correct. This is the WebSphere Application Developer  installation directory.
  4. Click Next to accept the WebSphere Application Developer product found on your computer.
  5. Select Uninstall Maintenance package. Click Next.
  6. Select the appropriate .pak file and click Next.
  7. Ensure that the installer displays the message
    • Success:The following maintenance package was uninstalled.
    • If you do not see this message the installer will indicate which log files to check. Review the information and click Relaunch to start the Update Install wizard again or Finish to close the Update Installer.
  8. On the Summary page, review the information and click Next to begin the uninstall process.
  9. Refer to the log files in the following directory to verify that your uninstall was successful:
    • WCD_installdir/logs/update 

10.  Locate the backup of WCD_installdir /workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar that was manually made during installation.

11.  Replace the file WCD_installdir /workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar with the backup from step 10.


Uninstalling the WebSphere Commerce Feature Pack 1 fixes using the silent installer

Complete this section to uninstall the WebSphere Commerce Feature Pack 1 interim fix.

Removing the interim fix from the WebSphere Application Developer installation directory

  1. Navigate to the UPDI_installdir/responsefiles directory and open the uninstall.txt file in a text editor.
  2. To remove the fix from the WebSphere Application Developer  product:
    1. Update the -W backup.package entry with the name of the maintenance package that you want to uninstall.

Note:

If the -W backup.package is not specified, the most recently installed fix is uninstalled.

    1. Update the -W product.location with the location of the WebSphere Commerce Feature Pack 1 install.
    2. Ensure that the following line does not exist or is commented out of the uninstall.txt file:
      1. W update.instancename="instance_name"

 

  1. Run the following command:
    1. update.bat -silent -options UPDI_installdir/responsefiles/uninstall.txt
  1. Refer to the log files in the following directory to verify that your uninstall was successful:
    • WCD_installdir/logs/update

5.      Locate the backup of WCD_installdir /workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar that was manually made during installation.

6.      Replace the file WCD_installdir /workspace/Stores/Web Content/WEB-INF/lib/coremetrics.jar with the backup from step 5.

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 



 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 2006
 
** 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