Persist Staging Data through an upgrade to Commerce Server


Description

This KB article details the tasks you must perform to retain your staging environment through an upgrade to Commerce Server (CS) 10.1 and later.

By default, Commerce Server does not keep staging projects created from the previous versions during the upgrade.

Solution

Complete the following taskflow to migrate the Staging data to Commerce Server 10.1

  1. Prepare the Staging Data for Migration
  2. Perform one of the following:
    • Migrate from Commerce Server 2007, Commerce Server 2009, Ascentium Commerce Server 2009, Commerce Server 2009 R2, and Ascentium Commerce Server 9.0 R2.
    • Migrate from Commerce Server 10.
  3. Verify the staging projects.

Prepare the Staging Data for Migration

Back up the CS Staging projects, routes, and credentials in the system registry.

  1. Start the Registry Editor and browse to CSS
    • For Commerce Server 2007, Commerce Server 2009 R2, and Ascentium Commerce Server 9.0, browse to and expand the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\CSS.
    • For Commerce Server 10, browse to and expand the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS.
  2. Export the CSSCREDS key 
    1. Right-click the CSSCREDS node in the tree view and select Export.
    2. In the Export Registry File dialog, enter a save file path and a name for the file and click Save.

  3. Export the Projects key

    1. Right-click the PROJECTS node in the tree view and select Export.
    2. In the Export Registry File dialog, enter a enter a save file path and name for the file and click Save.
  4. Export the Routes key
    1. Right-click the ROUTES node in the tree view and select Export
    2. In the Export Registry File dialog, enter a enter a save file path and name for the file and click Save

Back up the CS Staging business data project configurations (This task is not required for Commerce Server 10).

  1. Open the Staging\Projects subdirectory in your Commerce Server Installation directory (eg c:\Program Files (x86)\ Ascentium Commerce Server 9.0\Staging\Projects\)
  2. Copy all files in the Projects directory to a save location.

Migrate from Commerce Server 2007, Commerce Server 2009, Ascentium Commerce Server 2009, Commerce Server 2009 R2, and Ascentium Commerce Server 9.0 R2

Upgrade to CS10.1

  1. Uninstall your currently installed version of Commerce Server.
  2. Install Commerce Server 10.1 as detailed in the Install Guide on the Technical Resources page.
  3. Edit your backed-up registry file
    1. Edit the CSSCREDS key
      1. Open the CSSCREDS registry file in the notepad (e.g. c:\staging-backup\csscreds.reg).
      2. Replace all instances of the string “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\CSS” with “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS”
      3. Save and close the file. 
        Windows Registry Editor Version 5.00

        [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS\CSSCREDS]

        "DOMAIN\\StagingUser"="AQAAANCMnd8BFdERjHoAwE/Cl+sBAA..."
    2. Edit the Projects key
      1. Open the PROJECTS registry file in notepad (e.g. c:\staging-backup\csscreds.reg)
      2. Replace all instances of the string “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\CSS” with “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS”
      3. Save and close the file 
        Windows Registry Editor Version 5.00

        [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS\Projects]

        [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS\Projects\BizDataProject1]

        "BusinessProject"="1"
        "TransactionMethod"="NO"
        "LocalDirectory"="c:\\css\\BizDataProject1"
        "ReplicationMethod"="SENDINET"
        "Flags"="512"
        "Destination"="AQAAANCMnd8BFdERjHoAwE/Cl+sBAA..."
        "SkipLockedFiles"="YES"
    3. Edit the Routes key
      1. Open the ROUTES registry file in notepad (e.g. c:\staging-backup\csscreds.reg).
      2. Replace all instances of the string “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\CSS” with “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS”.
      3. Save and close the file. 
        Windows Registry Editor Version 5.00

        [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS\Routes]

        [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS\Routes\CS10Route1]

        "Destinations"="AQAAANCMnd8BFdERjHoAwE/Cl+sBAA..."
        "BaseDirectory"="c:\\css\\CS10Route1" 

        [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CommerceServer\CSS\Routes\CS10Route2]

        "Destinations"="AQAAANCMnd8BFdERjHoAwE/Cl+sBAA..."
        "BaseDirectory"="c:\\css\\CS10Route2"
  4. Import the edited registry files
    1. Import CSSCREDS
      1. Open Windows Explorer.
      2. Browse to the directory that contains your backup registry files (e.g. c:\staging-backup).
      3. Right click the CSSCREDS registry file (e.g. csscreds.reg) and select Merge.
        1. Click Yes on the popup dialog box that appears.
        2. Click Ok on the popup dialog that confirms the keys were successfully imported into the registry.
    2. Import PROJECTS
      1. Open Windows Explorer.
      2. Browse to the directory that contains your backup registry files (e.g. c:\staging-backup).
      3. Right click the PROJECTS registry file (e.g. csscreds.reg) and select Merge.
        1. Click Yes on the popup dialog box that appears.
        2. Click Ok on the popup dialog that confirms the keys were successfully imported into the registry.
    3. Import ROUTES
      1. Open Windows Explorer.
      2. Browse to the directory that contains your backup registry files (e.g. c:\staging-backup).
      3. Right click the ROUTES registry file (e.g. csscreds.reg) and select Merge.
        1. Click Yes on the popup dialog box that appears.
        2. Click Ok on the popup dialog that confirms the keys were successfully imported into the registry.
  5. Restore the backup CS Staging business data project configurations
    1. Open Windows Explorer by clicking Start -> Computer.
    2. Browse to the directory that contains your backup business data project configuration files (e.g. c:\staging-backup\Projects).
    3. Press Ctrl+A to select all of the files, and then Ctrl+C to copy the files.
    4. Browse to the Commerce Server 10.1 installation directory (e.g. c:\Program Files (x86)\Commerce Server 10).
    5. Browse to the Staging\Projects sub directory.
    6. Press Ctrl+V to paste the business data project configuration files into the Projects directory.

Migrate from Commerce Server 10

Upgrade to CS10.1

  1. Launch the Commerce Server 10.1 installer for an in-place upgrade.
  2. Import the backup registry files.
    1. Import CSSCREDS
      1. Open Windows Explorer.
      2. Browse to the directory that contains your backup registry files (e.g. c:\staging-backup).
      3. Right click the CSSCREDS registry file (e.g. csscreds.reg) and select Merge.
        1. Click Yes on the popup dialog box that appears.
        2. Click Ok on the popup dialog that confirms the keys were successfully imported into the registry.
    2. Import PROJECTS
      1. Open Windows Explorer.
      2. Browse to the directory that contains your backup registry files (e.g. c:\staging-backup).
      3. Right click the PROJECTS registry file (e.g. csscreds.reg) and select Merge.
        1. Click Yes on the popup dialog box that appears.
        2. Click Ok on the popup dialog that confirms the keys were successfully imported into the registry.
    3. Import ROUTES
      1. Open Windows Explorer.
      2. Browse to the directory that contains your backup registry files (e.g. c:\staging-backup).
      3. Right click the ROUTES registry file (e.g. csscreds.reg) and select Merge.
        1. Click Yes on the popup dialog box that appears.
        2. Click Ok on the popup dialog that confirms the keys were successfully imported into the registry.

Verify the Staging Projects

Verify the staging projects have been successfully restored.

  1. Open Commerce Server Staging Manager by clicking Start -> All Programs -> Commerce Server 10 -> Commerce Server Staging Manager.
  2. In the tree view, expand Console Root -> Commerce Server Staging -> (local system) and click on the Projects node.
  3. Verify that all projects have been properly restored.
    Note: you may not be able to view all properties of your business data staging projects until you use the Upgrade Wizard to migrate your site resource data.
  4. Click on the Routes node in the tree view.
  5. Verify that all routes have been properly restored.