To migrate to Workspace ONE Access Connector 21.08, you must follow these requirements.
- You need one or more Windows servers to install the 21.08 connector. The Directory Sync, User Auth, Kerberos Auth, and Virtual App services can be installed together on one server or separately on different servers. See the Installing Workspace ONE Access Connector 21.08 guide for requirements.
You can install the 21.08 connector either on a new server or on the legacy 19.03.x connector server. However, if Kerberos authentication is configured on your legacy connector, you must use a separate Windows server to install the 21.08 Kerberos Auth service. Do not install the new Kerberos Auth service on the 19.03.x connector server. Workspace ONE Access does not support multiple instances of Kerberos on the same server.
If you plan to install the 21.08 connector on a new Windows server, see the Installing Workspace ONE Access Connector 21.08 guide. If you plan to install the 21.08 connector on the 19.03.x connector server, see Migrating to Latest Connector on a Windows Server Running Workspace ONE Access 19.03.x.
- If your existing installation includes Citrix virtual apps, when you install the Virtual App service make sure that you follow the requirements and prerequisites for Citrix integration described in the Installing Workspace ONE Access Connector 21.08 guide. These include:
- The connector server must be joined to the directory domain.
- You must specify a domain user account to use to run the Virtual App service. That domain user must also be a Citrix server Read Only administrator who is able to load the Citrix PSSnapin.
- You must install Citrix Studio on the connector server. Citrix Studio includes the Citrix PowerShell SDK, which is required for the integration between Citrix and Workspace ONE Access. The Citrix Studio version must be compatible with your Citrix deployment version.
- During the migration process, you will switch between using the old connectors and the new connectors to test the migration. The 19.03.x legacy connector servers must be running during the migration process. Do not uninstall the 19.03.x connectors until the migration is complete.
- All existing connectors in your tenant must be version 19.03.x. If you have any older connectors, upgrade them to 19.03.x first.
- If you have an on-premises instance of the Workspace ONE Access service, upgrade the service to version 21.08 before migrating to 21.08 connectors.
- During migration, you must migrate all the directories and supported virtual apps collections in your tenant to the 21.08 connector. You cannot choose to migrate a subset of the directories or virtual apps, or choose to migrate only directories or only virtual apps.
- If you are installing the User Auth service, all the connectors on which the User Auth service is installed must be version 21.08. You cannot have a mix of 20.x and 21.08 User Auth service nodes in your environment.
- After migration, you can use only the new 21.08 connectors. You cannot have a mix of 19.03.x connectors and 21.08 connectors in your environment.
- Workspace ONE Access connector 21.08 supports the following types of proxies:
- Unauthenticated HTTP proxies
- Unauthenticated HTTPS (SSL) proxies
- Authenticated HTTPS (SSL) proxies
Migrating to Latest Connector on a Windows Server Running Workspace ONE Access Connector 19.03.x
When you cannot procure a new Windows server to migrate to Workspace ONE Access connector 21.08, you can install the 21.08 connector on a Windows server that is running the Workspace ONE Access 19.03.x connector. You can then migrate your legacy connector.
If you are using an existing Windows server that has the 19.03.x connector installed, make sure you follow these guidelines:
- Before you install the 21.08 connector, you must increase the CPU and memory on the server. Two versions of the connector will be running until the migration is complete.
You must increase the CPU and memory to meet the needs of both 19.03.x and 21.08 connectors. See the 21.08 Sizing Guidelines in Installing VMware Workspace ONE Access Connector 21.08.
- IMPORTANT: Take a snapshot of the machine before running the 21.08 connector installer. When you install the 21.08 connector, at the end of the installation process you might get a prompt to restart the connector host. Do not restart the host. If you do so, the migration process will fail and your 19.03.x connector will become unusable. It is critical that you do not restart the machine until the entire migration process is complete. When the migration is completed successfully, you can safely restart the machine.
- Do not stop or uninstall the 19.03.x connector until the entire migration process is complete.
After the migration is finished, you can stop the 19.03.x connector and uninstall it.