Workspace ONE® Access™ (formerly known as VMware Identity Manager™) provides a migration path from Workspace ONE Access connector versions 19.03 and 19.03.0.1 to version 21.08. The migration process includes installing new 21.08 connectors and migrating your existing directories and virtual apps collections to the new connectors. You cannot directly upgrade connector version 19.03 or 19.03.0.1 to version 21.08.

To migrate to the 21.08 connector, you migrate all your directories and supported virtual apps collections. When you migrate the directories, all data, including authentication methods and identity providers, is migrated. When you migrate virtual apps collections, the virtual apps configurations are migrated. Migration is a one-time process, and you must migrate directories and virtual apps collections together.

Note: You can upgrade Workspace ONE Access connector version 20.01 or 20.10 to version 21.08. See the Upgrading to VMware Workspace ONE Access Connector 21.08 guide.

About Workspace ONE Access Connector 21.08

Workspace ONE Access connector 21.08 is a collection of enterprise services that can be installed individually or together on Windows servers. It includes the following services:

  • Directory Sync service: Syncs users from Active Directory or LDAP directories to the Workspace ONE Access service
  • User Auth service: Provides connector-based authentication methods including Password (cloud deployment), RSA SecurID (cloud deployment), and RADIUS (cloud deployment)
  • Kerberos Auth service: Provides Kerberos authentication for internal users
  • Virtual App service: Syncs virtual apps from VMware Horizon® and Citrix® deployments to the Workspace ONE Access service
    Caution: The Virtual App service does not support integration with Horizon Cloud Service on IBM Cloud, Horizon Cloud Service on Microsoft Azure with Single-Pod Broker, or ThinApp. If your existing deployment includes these types of integrations, or you plan to configure these integrations in the future, do not migrate to connector version 21.08.

    Integration with Horizon Cloud Service on Microsoft Azure with Universal Broker is configured from the Horizon Cloud administration console and does not require the Virtual App service.

Compatibility with the Workspace ONE Access Service and Appliance

Workspace ONE Access connector 21.08 is compatible with the Workspace ONE Access Cloud service and with Workspace ONE Access virtual appliance version 21.08 and later versions only.

Use Cases for Migration to Connector 21.08

Migration from Workspace ONE Access connector version 19.03 or 19.03.0.1 to version 21.08 is applicable for certain use cases. Follow these guidelines to determine whether to migrate to version 21.08.

  • If your deployment includes VMware Horizon virtual apps, you can migrate to Workspace ONE Access connector 21.08. The 21.08 connector supports integration with Horizon 8 and Horizon 7.
    Caution: If you are using an earlier version of Horizon, do not migrate to the 21.08 connector.
  • If your deployment includes Citrix virtual apps, you can migrate to Workspace ONE Access connector 21.08 if:
    • You are using one of the following Citrix versions: Citrix Virtual Apps and Desktops 7 1912 LTSR, XenApp and XenDesktop 7.15 LTSR, or XenApp and XenDesktop 7.6 LTSR.
    • You are using Citrix StoreFront.
    Caution: If you are using an earlier version of Citrix or you are using the Citrix Web Interface SDK, do not migrate to the 21.08 connector.
  • If your deployment includes ThinApp packaged applications, do not migrate to the 21.08 connector. The 21.08 connector does not support ThinApp integrations.
  • If your deployment includes Horizon Cloud Service virtual apps, follow these guidelines:
    • If you are using Horizon Cloud Service on Microsoft Azure with Universal Broker, and you have a Workspace ONE Access cloud tenant, you can set up the integration between the Horizon Cloud and Workspace ONE Access tenants from the Horizon Cloud administration console. This integration method does not require you to set up a virtual apps collection in the Workspace ONE Access console. See Horizon Cloud Environment with Universal Broker - Integrate the Tenant with Workspace ONE Access and Intelligent Hub Services for information.
    • If you are using Horizon Cloud Service on IBM Cloud, do not migrate to the 21.08 connector. The 21.08 connector does not support this integration.
    • If you are using Horizon Cloud Service on Microsoft Azure with Single-Pod Broker, do not migrate to the 21.08 connector. The 21.08 connector does not support this integration.