To enable migration of a Horizon Cloud on Microsoft Azure deployment to your next-gen environment, you must pair your first-generation environment with your Horizon Cloud - next-gen environment.

Note: To perform the steps in the next-gen console, you must have the Administrator role in the next-generation environment. Refer to the page Assigning Administrative Roles in the Horizon Cloud Service - next-gen using guide.
Remember: Currently the console provides the migration banner, the Next-Gen Migration wizard, the Migration menu and the Migration page only when your first-gen deployments are made eligible for migration by VMware.

About This Pairing Code

A pairing code is the system's way of associating your Horizon Cloud - next-gen environment with your first-generation environment for the purposes of migrating your first-gen deployments.

You obtain a pairing code from your first-gen environment, copy that pairing code, and paste it into the migration panel in your Horizon Cloud - next-gen environment.

Pairing Steps

Each time you generate the pairing code using the console, the code is valid for 30 minutes. If you do not complete Step 9 before 30 minutes has elapsed, simply repeat Step 5 to generate a new one to copy and paste in Step 9.

If you choose to view both consoles at the same time, a best practice is to use browser windows in private mode or incognito mode to avoid UI issues that might result from the browser cache of images or other cached page content.

  1. Obtain the pairing code using one of these methods.
    • If your console displays the migration banner, you can click the banner's LET'S GO to start the Next-gen Migration wizard and select Yes on the Get Started step to display the pairing code as depicted in the following screenshot.
      Note: The first-gen console displays this banner and wizard only when VMware has enabled them in your first-gen environment.

      Screenshot of the Next-gen Migration wizard for the Yes scenario.
    • Click your account name displayed in the console and select Pairing Code.
      Screenshot showing the user account menu and the pairing code choice.
  2. Copy the pairing code. The following screenshot illustrates the code redacted for privacy.
    Screenshot showing the console window and a redacted pairing code.

    This pairing code is valid for 30 minutes.

    If the code expires, the console has a refresh action for you to generate a new one.

  3. Go to the Migration page in your Horizon Cloud - next-gen environment.
    • From the Migration - Get Started wizard, you can click Start to launch the next-gen console displaying the Migration page.
    • Alternatively, you can open a browser window, log in to VMware Cloud services, and from the Services page, navigate into the Workspace ONE service, locate the Horizon Cloud Service card within your set of Workspace ONE Cloud services, and then click the action to open the next-gen console from there. Then navigate to the Migration page using the using the left hand navigation menu's Migration entry.
      Screenshot of the console and an arrow pointing to the location of the Migration choice.

      The following screenshot illustrates the console's Migration page.

    Screenshot of the Migration page in the Horizon Universal Console.
  4. Click the Pair Tenants link.
  5. In the Pair Tenants window that appears, paste your copied pairing code into the Pairing Code field.

    The following screenshot illustrates this step. The pasted code is redacted here for privacy.

    Screenshot of the Pair Tenants window with a redacted code in the Pairing Code field.
  6. Click Pair.

    When the system has successfully paired the tenants, the next-gen UI indicates that pairing is successful.

    Screenshot of the Migration page for a successful pairing.

Next Steps

Now that your first-gen tenant and next-gen tenant are paired, you can continue to the next step in the migration workflow, of configuring the required identity provider settings.

In this migration documentation, continue reading with Phase 3 - Configure the Required Identity Provider Settings in Your Next-Gen Environment.