Try our conversational search powered by Generative AI!

Upgrading Episerver Commerce from version 1.0 SP1 to 1 R2 SP1

Product version:Episerver Commerce 1.0 SP1/1 R2 SP1

Document last saved:


This document describes the procedure for upgrading EPiServer Commerce from version 1.0 SP1 to 1 R2 SP1 (for EPiServer CMS 6 R2). NOTE that this procedure only supports upgrade from EPiServer Commerce 1.0 SP1, meaning that if you have version 1.0 of EPiServer Commerce, you must first install version 1.0 SP1.


Check the following requirements and considerations before you start the upgrade:

  • The database server must have full text search service enabled.
  • After installing EPiServer Commerce 1.0 SP1, you need to open Commerce Manager from your browser and log in. When logging in to Commerce Manager the first time, the system will do some setup changes and generate new database tables. This step is necessary, otherwise the further upgrade process will fail.
  • If you use DisplayTemplate on Commerce Manager 1.0 SP1, you need to update the template file path to the correct path in the new version. Refer to the EPiServer Commerce 1 R2 installation documentation for more information on display templates.
  • If your site has Quartz Service installed, make sure to stop the service before upgrading.
  • If your site has custom business foundation objects, refer to the section  "Import and Export Business Foundation Objects" below.
  • If your order system has existing orders before the upgrade, refer to the section "Managing Existing Orders After the Upgrade" below.

Upgrading Procedure

Follow these steps to upgrade.

  1. Install EPiServer Commerce 1.0 SP1.
  2. Install the EPiServer Commerce 1.0 SP1 sample package.
  3. Browse to the website and navigate to Commerce Manager. Log in to the system.
  4. Do all the configuration steps according to the installation instructions for EPiServer Commerce 1.0 SP1.
  5. Stop the Quartz Service if this is installed on your site.
  6. Upgrade EPiServer CMS 6 on your site to version 6 R2.
  7. Upgrade to EPiServer Commerce version 1 R2.

  8. If your site has the EPiServer Commerce Sample Package installed, upgrade this to the EPiServer Commerce 1 R2 Sample package.
  9. From Deployment Center, execute the "Upgrade EPiServer Commerce Settings" feature.
  10. Clear the cache of your web browser.
  11. Browse to the site and verify the upgrade.

Import and Export Business Foundation Objects

Follow these steps to import/export customized business objects.

  1. Before the upgrade, navigate to Commerce Manager to export your custom business objects.

  2. Be sure to only export the custom object and NOT the system objects!

  3. Delete all of your custom business foundation objects by clicking the Delete button.
  4. After a successful upgrade, import the business foundation objects that you exported in the previous step.
  5. NOTE If your business objects have relations to other business objects, you must export the related objects as well.

Managing Existing Orders After the Upgrade

Read this section if you encounter problems with existing orders after upgrading to EPiServer Commerce 1 R2 SP1. This is a possible solution if you cannot release a shipment, if shipments do not appear in the pick list or cannot be completed.

  1. Open your order in Commerce Manager.

  2. Click Edit Information then click OK without any modification.
  3. Your order will be turned into Edit mode.

  4. Click Save to save your order.

Related Information