Help Center>Foundation Help

Applies to:

Migrating Winshuttle Central

The following sections provide an overview and general guidance for migrating installations and related Winshuttle Server and Workflow data from one environment to another.

On this page

Migration best practice overview

  1. Perform a clean install of Winshuttle Central in the new SharePoint environment
  2. Activate the new license.
  3. Backup the original site using Winshuttle Central’s backup/restore feature (backup ALL ITEMS). See Backing up and restoring Winshuttle Central.
  4. Restore all items to the newly created Winshuttle Central site
  5. Ensure your desktop users (Transaction, etc.) are pointing to the new Winshuttle Central URL
  6. Validate and test scripts
  7. If validation is correct for the new site, un-assign user licenses from the old site
  8. Send Winshuttle Support a report of the un-assigned users from Winshuttle Central Admin reports to
  9. Retire the old Winshuttle Central site

Migrating content to SharePoint sites or farms

Back to top

The following steps can be used to apply Winshuttle Central content to separate SharePoint Sites or Farms.

NOTE: A new set of licenses will be required on the target Central site when migrating to a new Farm. You can request a new license set that matches the old environment from Winshuttle Support at

Before running the restore:

  1. On the target site, go to Central Administration.
  2. Click Remove CENTRAL Workflow.
  3. Ensure that all CENTRAL users have "Contribute" rights to the target site
  4. Restore "Roles" and "Licenses" to the target site
  5. Restore "Documents" and any remaining components to the target site
  6. Test any approved, production scripts to complete the migration steps

    Note: If you have Winshuttle Transaction, Query, or custom Winshuttle Central document libraries, you'll also need to manually remove the workflows from the content types (Shuttlefiledoc,Metainfoshuttlefiledoc,datafiledoc,Queryfiledoc and metainfoqueryfiledoc) from all Winshuttle Central document libraries.

Migrating from Winshuttle Central 10.6 to Winshuttle 10.6.1

Back to top
  • Contact Winshuttle Support to obtain the Winshuttle Central Migration Utility.
  • Make sure that Winshuttle Server 10.6.1 has already been installed in your environment.

Note: It is important to make sure that Winshuttle Server and Central are the same version within your environment.

Then do the following:

  1. Copy the Central Upgrade Utility folder (based upon your version of SharePoint) to the machine where SharePoint is installed.

    In a Sharepoint Farm configuration, copy this folder to the main (Parent) Web Front End server.

  2. Run the CentralUpgrade Utility as an administrator.
  3. Click Upgrade Now.
  4. Click OK.
  5. Run IIS Reset on all Front End servers.
  6. Open the Winshuttle Central Site.
  7. Navigate to Winshuttle Central Administration, and then click Transaction Services Configuration.
  8. In the Winshuttle Server for Transaction URL box, type the URL to your Winshuttle Server 10.6.1.
  9. Click Test Connection. The test should be successful and return the following message-‘Connection test was successful. Server version is 10.6.1.
  10. Click Save/Update to finish.

Migration Troubleshooting

Back to top

The following are some common issues that you may encounter during a migration or in an environment with 'mixed' versions (for example, Winshuttle Server 10.6 and Winshuttle Central 10.6.1).


Clicking Test Connection causes the following error:

"The provided Winshuttle Server version 10.6.1 is not compatible with Winshuttle Central version 10.6."

This occurs while saving Winshuttle Server Runner 10.6.1 URL on Winshuttle Central 10.6 Site.


The administrator needs to migrate Central version 10.6 to 10.6.1. Winshuttle Central and Winshuttle Server must the same version.


In the Winshuttle Transaction 10.6.1 Client, publishing a Transaction script with an IF condition embedded as a Web service generates the following error:

"The Script cannot be published as a Web Service. Winshuttle Server Version should be greater than or equal to 10.6.1 to use If Condition. Please contact the script creator."


The administrator needs to first migrate Winshuttle Server to 10.6.1, and then Winshuttle Central to 10.6.1.


If a 10.6.1 web service with an IF condition is used with Winshuttle Designer or Winshuttle Server 10.6 or earlier, then the IF condition fields are treated as False without telling the user.


Winshuttle Designer, Winshuttle Workflow Server, and Winshuttle Server need to be upgraded to 10.6.1.