WebSphere Commerce Developer

Installing WebSphere Commerce Developer interim fixes

WebSphere Commerce Developer interim fixes and cumulative interim fixes can be installed with the WebSphere Commerce Update Installer (UPDI).

Feature Pack 5WebSphere Commerce Version 7.0.0.7WebSphere Commerce Version 7.0.0.6Attention: IBM is aware that some interim fixes that were released for Feature Pack 5, Fix Pack 6, and Fix Pack 7 might cause issues when you install the fixes individually. As a result, IBM bundled the interim fixes and released the following cumulative interim fixes:JR53048 automatically resolves all conflicts and dependency issues that might occur if you were to install the interim fixes individually. If you are on Feature Pack 5, Fix Pack 6, or Fix Pack 7, it is highly recommended that you install the applicable cumulative interim fixes immediately.
Each individual iFix and cumulative iFix package contains a different readme file. Each readme file might include specific installation instructions. For example:
  • Some iFixes might require manual modifications to source code after you install the fix
  • For runtime environments, some iFixes might be applicable to the base WebSphere Commerce product only and not the instance.
You do not need database access to install an iFix because these fixes do not make any database changes during installation. However, some iFixes might require that you manually update the database to enable the fix after installation. Review the readme file to ensure that you install and enable the interim fix successfully.

About this task

There are individual interim fixes, and then there are cumulative interim fixes.
Note: A WebSphere Commerce cumulative interim fix is composed of every individual interim fix available up to the date that the cumulative interim fix is created. The following information applies to cumulative interim fixes:
  • You do not need to uninstall any previously installed interim fixes to apply a cumulative fix.
  • Any interim fixes that are released after a cumulative interim fix require the latest cumulative fix as a prerequisite.
  • Each cumulative fix contains all of the fixes from any previous cumulative fixes. Therefore, you can install the latest cumulative fix without installing earlier ones.
You can install interim fixes using the Update Installer (UPDI) graphical interface or silently using a response file. Both installation methods require the following steps before you can install in interim fix.

Procedure

  1. Obtain the necessary interim fix installation package (.pak) and place it in a location that is accessible to the WebSphere Commerce Update Installer.
    For example, the UPDI_installdir/maintenance/ directory.
  2. Optional: Verify the installation package.
    It is recommended that you verify the interim fix package before you proceed to install. IBM provides an MD5 file so that you can verify the install package by validating its MD5 checksum values. Most Unix and Linux operating systems include utilities to generate an MD5 hash. Microsoft Windows does not include an MD5 utility, but many third-party options are available. The following are high-level instructions to verify the download package:
    1. Obtain the MD5 file from a trusted IBM source. This is a text file that contains the MD5 hash signature of the interim fix package.
    2. View the MD5 file in a text editor. It contains one line of characters.
    3. Use your MD5 hash utility to generate a hash signature of your copy of the interim fix package (*.pak).
    4. Compare the signature hash in the IBM-provided MD5 file to the signature hash that you generated.

    If the values are identical, then proceed to install the package. If the values are not identical then the install package may be corrupted. Try to download the package again from the trusted IBM source. If the issue is not resolved, contact IBM Support.

  3. Ensure that WebSphere Commerce Developer is at the required feature pack or fix pack level before you apply the interim fix.
    For example, JR50553.fp requires you to be at the 7.0.0.8 (Fix Pack 8) level.
  4. Ensure that you are using the latest version of WebSphere Commerce Update Installer.
    Warning: If you need to install a newer version of Update Installer (UPDI), do not overwrite the original Update Installer that is in the WCDE_installdir/UpdateInstaller directory. Install the new version to a different directory and use the new UPDI version to install an interim fix. The original UPDI version is used by Installation Manager when you upgrade a fix pack in WebSphere Commerce Developer. If you overwrite the original UPDI version, Installation Manager will fail during a fix pack upgrade.
  5. Ensure that you have a Windows user ID that is a member of the Administrator group.
  6. Install any applicable prerequisite cumulative interim fixes.
    For example, before you can install Feature Pack 8 cumulative interim fix JR55049.fep, you must install the Fix Pack 9 cumulative interim fix JR55049.fp. Consult the readme file that is included in your interim fix package. The readme file provides special instructions that are required for your specific interim fix.
  7. Introduced in Feature Pack 1 If you are using the Aurora starter store, it is recommended that you create a back up your store archive file (Aurora.sar) before you apply a cumulative interim fix.
    You can find the .sar file in the ConsumerDirect or ExtendedSites sub-directory in WCDE_installdir/starterstores/
  8. Stop the WebSphere Commerce Developer Test server.

What to do next

You can now decide to install the interim fix using one of the following methods: