Share via


Supported Migration Paths

You can migrate sites based on Microsoft Commerce Server 2000 and onward to Commerce Server 2009 R2. The level of effort required to migrate an existing site to Commerce Server 2009 R2 depends on the version of Commerce Server that you are migrating from:

  • Commerce Server 2000

  • Commerce Server 2002

  • Commerce Server 2007

  • Commerce Server 2009

Note   Microsoft Solution for Internet Business (MSIB) is not supported in Commerce Server 2009 R2.

See the following table for a summary of the site migration tasks required for each version of Commerce Server:

Commerce Server version

Site functional after migration?

Site migration tasks

Commerce Server 2000

No

  • Migrate data (Commerce Server Upgrade Wizard)

  • Re-write site code to use Commerce Server Foundation API (manual)

Commerce Server 2002

No

  • Migrate data (Commerce Server Upgrade Wizard)

  • Re-write site code to use Commerce Server Foundation API (manual)

Commerce Server 2007

Yes

  • Migrate data (Commerce Server Upgrade Wizard)

Commerce Server 2009

Yes

  • Migrate data (Commerce Server Upgrade Wizard)

  • Update application configuration files (Commerce Server Site Migration Wizard)

  • Update site code to use Commerce Server 2009 R2 assemblies (manual)

  • Upgrade Web Parts solution for SharePoint (SharePoint Commerce Services Configuration Wizard)

Commerce Server 2000

ASP-based sites are not supported in Commerce Server 2009 R2. All Commerce Server 2009 R2 sites must be ASP.NET or based on Microsoft SharePoint. For information about how to convert a site from ASP to ASP.NET, see https://go.microsoft.com/fwlink/?LinkId=196237. Your site code must make calls against the Commerce Server 2009 Foundation API to take full advantage of Commerce Server 2009 R2 features.

You can use the Commerce Server Upgrade Wizard to migrate your data and Commerce Server schema to Commerce Server 2009 R2.

Commerce Server 2002

The Commerce Server 2002 API is not supported in Commerce Server 2009 R2. When migrating an ASP.NET site, you must rewrite your site code to make calls against the Commerce Server 2009 Foundation API to take full advantage of Commerce Server 2009 R2 features. Migration of ASP-based sites is not supported.

You can use the Commerce Server Upgrade Wizard to migrate your data and Commerce Server schema to Commerce Server 2009 R2.

Commerce Server 2002 customers must have Commerce Server Service Pack 3 (SP3) or Commerce Server Feature Pack 1 (FP1) installed before migrating to Commerce Server 2009 R2.

Commerce Server 2007

The Commerce Server 2007 API is supported in Commerce Server 2009 R2, so sites developed on Commerce Server 2007 continue to function on Commerce Server 2009 R2. However, you must migrate your data and Commerce Server schema using the Commerce Server Upgrade Wizard.

It is recommended that you modify your site code to make calls to the Commerce Server 2009 Foundation API to take full advantage of Commerce Server 2009 R2 features.

Commerce Server 2009

The original Commerce Server 2009 Foundation API is supported in Commerce Server 2009 R2, so sites developed on Commerce Server 2009 continue to function, but you must migrate your data and Commerce Server schema using the Commerce Server Upgrade Wizard. 

The Commerce Server 2009 Foundation API has been enhanced in Commerce Server 2009 R2, and includes a reorganization of Commerce Server assemblies. You can use the Commerce Server Site Migration Wizard to update your configuration files for Commerce Server 2009 R2, but you must update your site code manually to reference the new Commerce Server assemblies.

Commerce Server 2009 R2 supports both ASP.NET and SharePoint-based sites. All SharePoint-based sites must be deployed on a SharePoint 2010 platform in Commerce Server 2009 R2, and the Commerce Server 2009 Web Parts solution must be upgraded to the Commerce Server 2009 R2 version.

Commerce Server 2009 with Template Pack

The Commerce Server 2009 Foundation API has been enhanced in Commerce Server 2009 R2, and includes a reorganization of Commerce Server assemblies. You can use the Commerce Server Site Migration Wizard to update your configuration files for Commerce Server 2009 R2, but you must update your site code manually to reference the new Commerce Server assemblies.

Custom ASP.NET Sites

If you are migrating a custom ASP.NET from Commerce Server 2009, you must update your Commerce Server configuration files (using the Site Migration Tool), and update your site code manually to reference the new Commerce Server 2009 R2 assemblies.

SharePoint Sites

Commerce Server 2009 R2 only supports SharePoint 2010-based sites. If you are migrating a SharePoint site that uses Commerce Server 2009 Web Parts including:

  • Commerce Server 2009 default site

  • Commerce Server 2009 contemporary site

  • Commerce Server 2009 Template Pack for SharePoint 2010

You must upgrade the WebParts solution to the Commerce Server 2009 R2 version (using the SharePoint Commerce Services Configuration Wizard).

In addition, you must update your Commerce Server configuration files (using the Site Migration Tool) and update your site code to use the new Commerce Server 2009 R2 assemblies.

Note

If you are migrating the default site or contemporary site to Commerce Server 2009 R2 and have used the extensibility kit to apply customization, any custom changes you have made will be lost when you migrate your site to Commerce Server 2009 R2. You must re-apply your customization after you have updated the Commerce Server configuration files and updated your site code to use the new Commerce Server 2009 R2 assemblies.