The October 2018 release of the Workspace Environment Management service included the Citrix WEM Migration Tool. The purpose of this tool is to allow customers to migrate their on-premise WEM deployment database to the Workspace Environment Management service in Citrix Cloud.

Note: Before using this article to troubleshoot migration issues, it is important that you first read through the Workspace Environment Management service Migrate section in the Citrix Product Documentation.

Instructions

Troubleshooting the migration process

Troubleshooting WEM database export

The Citrix WEM Migration Tool is a simple application to export the WEM database and schema to a SQL file on the local machine.

If an export failure occurs, a popup message box will display:

"There is an error while exporting data for the specified database! For more information, check debug logs."


If this occurs, analyze the Citrix WEM Migration Tool debug log.log file located in the same folder that the tool was downloaded to.

The aim of the debug log is to record the migration progress and identify failures. Here are two possible failure types:

1. Cannot connect to Sql Server: Exception -> InitConnections() : Microsoft.SqlServer.Management.Common.ConnectionFailureException: Failed to connect to server
2. Cannot find the specified database: Exception -> InitConnections() : System.Exception: Failed to connect to database

Product Documentation - Migrate .