Enabling store-related interim fixes

When you install a maintenance package, fixes that update you store (such as starter store JSP files) are not automatically enabled on your environment. The fixes are not automatically enabled to ensure that your store customizations are not overwritten.

If you need to enable a store-related fix, then merge the changes with the files that are currently on your environment. You do not have to complete this procedure if you do not want or need to enable store-related fixes.

Before you begin

Install the interim fix for the APAR you require.

Procedure

  1. Enable widget updates to your environment:
    OptionDescription
    If you customized any widgets that were included with WebSphere Commerce:
    1. Go to the following directory:
      • For IBM i OS operating systemSolarisLinuxAIXWindowsWC_installdir/components/store-enhancements/wc.ear/Stores.war/
      • WebSphere Commerce DeveloperWCDE_installdir/components/store-enhancements/wc.ear/Stores.war/
      This directory includes all the widgets that were updated in the interim fix.
    2. Review all subdirectories. Compare the updated widgets with your customized widgets:
    3. Update your customized widgets accordingly.
    If you did not customize any widgets that were included with WebSphere Commerce
    1. Zip the following directory:
      • For IBM i OS operating systemSolarisLinuxAIXWindowsWC_installdir/components/store-enhancements/wc.ear/Stores.war
      • WebSphere Commerce DeveloperWCDE_installdir/components/store-enhancements/wc.ear/Stores.war
    2. Deploy the compressed file. For more information, see Deploying.
  2. Enable store-level JSP updates to your environment.
    It is recommended that you make all your changes in the development environment first, and then deploy to your production environment.
    OptionDescription
    If you want to directly update your published store by merging changes from the maintenance package:
    1. Use an extraction utility to extract and view the updated version of Aurora.sar that is in the following directory:
      • For IBM i OS operating systemSolarisLinuxAIXWindowsWC_installdir/components/store-enhancements/starterstores/ConsumerDirect/
      • WebSphere Commerce DeveloperWCDE_installdir/components/store-enhancements/starterstores/ConsumerDirect/
      Tip: If your extraction utility does not recognize the .sar file as a compressed file, change the file extension from .sar to .zip.
    2. Compare the contents of the StoreAssetsDir folder of the updated Aurora.sar archive with your customized store.
    3. Merge the changes that were made to the updated Aurora.sar store version with your customized store files accordingly.
    4. Open the WEB-INF/stores/StoreAssetsDir/data/struts-config-update-common.tpl.xml of the updated Aurora.sar archive.
    5. Compare the contents with your Stores.war/WebContent/WEB-INF/struts-config-ext.xml file.
    6. Merge the changes with your customized store files accordingly.
    7. Deploy the changes.
    If you did not customize your store and you want to publish a new store:
    1. Copy the Aurora.sar file from the following directory:
      • For IBM i OS operating systemSolarisLinuxAIXWindowsWC_installdir/components/store-enhancements/starterstores/ConsumerDirect/
      • WebSphere Commerce DeveloperWCDE_installdir/components/store-enhancements/starterstores/ConsumerDirect/
    2. Paste the file to:
      • For IBM i OS operating systemSolarisLinuxAIXWindowsWC_installdir/instances/instance_name/starterstores/ConsumerDirect/
      • WebSphere Commerce DeveloperWCDE_installdir/starterstores/ConsumerDirect/
    3. Publish the Aurora.sar file through the Administration Console.
    If you want to publish a new store that includes the maintenance updates and your customizations:
    1. Extract the new Aurora.sar file to a temporary directory. You can find the new Aurora.sar file here:
      • For IBM i OS operating systemSolarisLinuxAIXWindowsWC_installdir/components/store-enhancements/starterstores/ConsumerDirect/
      • WebSphere Commerce DeveloperWCDE_installdir/components/store-enhancements/starterstores/ConsumerDirect/
    2. Compare and merge your customizations into the temporary directory.
    3. Repackage the temporary directory as Aurora.sar to produce a customized/updated store SAR file.
    4. Copy the updated Aurora.sar file to the following directory so that you can publish through the Administration Console.
      • For IBM i OS operating systemSolarisLinuxAIXWindowsWC_installdir/instances/instance_name/starterstores/ConsumerDirect/
      • WebSphere Commerce DeveloperWCDE_installdir/starterstores/ConsumerDirect/
    5. Publish the Aurora.sar file through the Administration Console.