Help Center>Foundation Help

Applies to:

Migrating Winshuttle Server Data

The follow steps describe how to Migrate Winshuttle Server data using the Winshuttle Server Data Migration Utility.

See the Winshuttle Server Database Migration Tool Guide for additional information.

The following steps require that the Winshuttle SAP Integration Server ("Winshuttle Server") has been installed on the new location prior to running the migration utility.

IMPORTANT: Before migration, backup the entire Winshuttle Server folder. A simple copy to a different directory will suffice.

Installing the Server Data Migration Tool

Back to top
  1. Download the Winshuttle Server Data Migration Utility provided by Winshuttle Support on the source Server
  2. Make a backup of the Winshuttle Server folder
  3. Run the Winshuttle Server Installer. On the Welcome page, click Next.
  4. Select I accept the terms in the License Agreement and then click Next.
  5. To install Winshuttle Server in the default location, click Next. To select a custom location, click Change, type or browse to the location, and then click Next.
  6. Enter the TCP Port to define the port on which Winshuttle Server installs. For the Application Pool Identity, specify the IIS Service Account to run the application pool. (Note: The Network User can be used, but is less secure than using the IIS Service Account). Click Next.
  7. When all the required information is entered into the wizard, Click Install.
  8. Click Finish to quit the installer.

Installation is complete.

Migrating Data with the Server Data Migration Tool

Back to top

Winshuttle provides the Winshuttle Server Data Migration Utility to migrate data from different versions or to different locations.

To migrate data between locations, do the following:

  1. Copy the Winshuttle Server backup source files to the target Server
  2. Double-click the file WinshuttleServer.ServerTools.DataImporter.exe to launch the Winshuttle Server Data Migration Tool.
  3. Select Create a new database file.
  4. Select SQLite (the default)
  5. In the Select new SQLite database path field, enter the location for the new Winshuttle Server database, and then give it a name.
  6. Click Next and wait for the Data Migration dialog box.
  7. Select Migrate data from old database to new database.
  8. Enter the path and location of the source database (from your copied backup location).
  9. Enter the name and location of the new database file, and then click Next.
    • To specify the new URL of the CENTRAL site, select Move all published services to new Winshuttle Server URL. Enter the URL for your new CENTRAL site.
    • If you are keeping the same site URL for CENTRAL, clear the "Move all published services…" option. The URL field for the site becomes unavailable.
  10. Select Update namespace of migrated services to update the namespace for Server-published services as from the old default namespace (
  11. Select Add RunWithSapCreds method to migrated services to enable this method in published web services for TRANSACTION and QUERY. When this option is enabled, you can use SAP credentials to publish web services.
  12. If the CENTRAL site URL has changed: Select Migrate Winshuttle CENTRAL URL in published services to update the URLs for existing web services.
  13. Click Migrate.