Migrating VMware Workspace Portal describes how to migrate from VMware Horizon Workspace™ 1.8.1 or 1.8.2, or VMware Workspace Portal 2.0 to VMware Workspace Portal 2.1.

Migrating VMware Workspace Portal is intended for enterprise administrators. This information is written for experienced Windows or Linux system administrators who are familiar with virtual machine technology, identity management, Kerberos, and directory services.

Use Migrating VMware Workspace Portal to upgrade your existing deployment, versions 1.8.1, 1.8.2, or 2.0, to version 2.1.

To migrate from VMware Horizon Workspace 1.5.x to VMware Workspace Portal 2.1, you must first upgrade Horizon Workspace 1.5.x to version 1.8.2 and then migrate 1.8.2 to 2.1.

If you would rather perform a fresh installation of Workspace 2.1, see the Installing and Configuring VMware Workspace Portal Guide. Remember that a new installation will not preserve your existing configurations.

This migration involves migrating a configuration spread across the multiple virtual appliances used in previous versions to the single virtual appliance, the workspace-va virtual machine, used in Workspace 2.1. The migration process requires you to manually move configuration information from the previous version to version 2.1.


The migration process does not transfer audit event information from the source deployment to Workspace 2.1.

To learn how to use and maintain your new Workspace 2.1 instance, see the VMware Workspace Portal Administrator's Guide.