Upgrading to Active Commerce 3.4 on Sitecore 9.0

Follow

This article provides general direction on the process to update from Active Commerce 3.3 Update-1 to Active Commerce 3.4 on Sitecore 9.0. Specifics of your implementation and environment may require you to adjust the process.

  1. Ensure that any adjustments you have made to stock Active Commerce and Sitecore E-commerce Services (SES) configuration files have been moved into configuration patches.
  2. Remove hotfix configurations and binaries for any issues which have been resolved in Active Commerce 3.4 (reference the Issues Resolve in the Release Notes).
  3. Delete all stock Active Commerce and SES configuration files from App_Config\Include:

Sitecore.Ecommerce.Apps.OrderManagement.config
Sitecore.Ecommerce.config
xActiveCommerce.Buckets.config
xActiveCommerce.config
xActiveCommerce.ContentSearch.config
xActiveCommerce.Data.config
xActiveCommerce.DisableStockFields.config(.example)
xActiveCommerce.Env.config
xActiveCommerce.GlassMapper.config
xActiveCommerce.Globalization.config
xActiveCommerce.Logging.config
xActiveCommerce.OrderProcessing.config
xActiveCommerce.Scheduling.config(.example)
xActiveCommerce.Skinning.config
xActiveCommerce.SwitchMasterToWeb.config(.example)
xActiveCommerce.xAvaTax.config
xActiveCommerce.xBraintree.config
xActiveCommerce.xFastTax.config
xActiveCommerce.xPersistentCarts.config

  1. If you are utilizing the original shared source Mobile Device Detector, disable it by deleting App_Config\Include\Sitecore.SharedSource.MobileDeviceDetector.config.
  2. Follow the instructions in the Upgrade Guide for Sitecore 9.0 Update-1 to upgrade your Sitecore installation.
  3. Disregard warnings from the Update Installation Wizard about Active Commerce and SES assemblies which need to be recompiled -- we will address these by installing the new version of Active Commerce.
  4. Install the SPEAK 1.0 and Active Commerce packages as directed by the Active Commerce Installation / Quick Start guide. We recommend using the "Merge/Merge" option for any installation conflicts.
  5. If the Sitecore upgrade overwrote your Web.config, reapply the needed changes for Active Commerce, as described in the Installation / Quick Start guide.
  6. Reinstall any plugins you are utilizing.
  7. Ensure the App_Config\Include folder does not contain any lingering base Active Commerce configuration files (they should now all be present in App_Config\Modules\Active Commerce).
  8. Publish, update links databases, and rebuild the Active Commerce indexes.
Have more questions? Submit a request

Comments