Update Commerce Server Configuration Files
If you are migrating a Microsoft Commerce Server 2009 Web site, you must upgrade the Commerce Server 2009 Multi-Channel Foundation configuration files to support Commerce Server 2009 R2. The Commerce Server Site Migration Wizard automates the migration of the following configuration files to support Commerce Server 2009 R2:
Web.config
ChannelConfiguration.config
MetadataDefinitions.xml
Configuration files for each site being migrated are backed up to a separate subdirectory, based on the name of the site. Similarly, each migrated site will have its own log file, based on the name of the site.
This topic contains the following sections:
Farm Scenarios
Migration Tool
Farm Scenarios
For SharePoint-based farms, run the migration wizard from the primary node and the changes will automatically propagate to all nodes in the farm. You must perform post-migration cleanup tasks manually on each node of the farm.
For ASP.NET-based farms, the migration tool is run on each node of the farm. The post-migration cleanup tasks are completed manually on each node of the farm.
Migration Tool
The Migration tool supports the following translation operations:
The Site Migration Wizard detects duplicate nodes during the migration of configuration files. If the Migration tool detects a duplicate node, the tool comments out the original before installing the new node. The tool also comment configuration files and identify the nodes that are duplicates.
The Site Migration Wizard detects nodes that are only for SharePoint sites. The Site Migration Wizard will not add these nodes to an ASP.NET site.
The Site Migration Wizard detects nodes that are only for ASP.NET sites. The Site Migration Wizard will not add these nodes to a SharePoint site.
The Site Migration Wizard detects nodes that require a parent before being added to the configuration file. The Site Migration Wizard will create the parent node and populate it with the new node.
Note
The Site Migration Wizard does not detect Web sites based on earlier versions of Commerce Server (i.e., Commerce Server 2002 or 2007). If you have sites running on a version of Commerce Server that is earlier than Commerce Server 2009, you must perform manual migration. For more information see Migrating from Commerce Server 2000 or 2002 and Migrating from Commerce Server 2007.
Note
For farm implementations, ensure that each node's virtual directories are migrated by completing the Post Migration cleanup procedures for each node.
You must also update your Commerce Server 2009 site code to reference the new Commerce Server 2009 R2 assemblies and namespaces. See Commerce Server 2009 R2 Assembly and Namespace Changes for more information.
To update Commerce Server 2009 site configuration files
Launch the Site Migration Wizard (Start > All Programs > Microsoft Commerce Server 2009 R2 > Tools, and click Site Migration Tool.)
The Site Migration Wizard opens.
On the Welcome page, review the prerequisite guidance and click Next to begin site detection.
The Site Migration Wizard begins detection of Commerce Server sites for migration.
On the Site Selection page, do all of the following:
Select the Web sites that you want to migrate from the list of sites detected by the Site Migration Wizard.
Specify the backup location for any files updated during the migration.
Specify the path for the Commerce Server 2009 Site Migration Wizard log files.
Click Next.
On the Site Migration Summary page, review the sites that you have selected to migrate. If you want to make any changes, click Back and change your selections. Otherwise, click Next.
On the Site Migration Results page, review the changes made and optionally, view the log file by clicking the link, or click Finish to close the Site Migration Wizard.