You must add tenants in the target environment using the name of each tenant in the source environment.

About this task

For successful migration, it is mandatory that each tenant in the source environment is created in the target environment. You must also use a tenant-specific access URL for each tenant that you add using the tenant URL name from the source environment. If there are unused tenants in the source environment that you do not want to migrate, delete them from the source environment before migration.

Perform this procedure for each tenant in your source environment.

  • When you migrate from a vRealize Automation 6.2.x environment, you migrate your existing SSO2 tenants and identity stores on the source environment to the VMware Identity Manager on the target environment.

  • When you migrate from a vRealize Automation 7.x environment, you migrate your existing VMware Identity Manager tenants and identity stores on the source environment to the VMware Identity Manager on the target environment.

Prerequisites

  • Gather Information Required for Migration.

  • Log in to the target vRealize Automation console.

    1. Open the vRealize Automation console using the fully qualified domain name of the target virtual appliance: https://vra-va-hostname.domain.name/vcac.

      For a high-availability environment, open the console using the fully qualified domain name of the target virtual appliance load balancer: https://vra-va-lb-hostname.domain.name/vcac.

    2. Log in with the user name administrator@vsphere.local and the password that you entered when you deployed the target vRealize Automation.

Procedure

  1. Select Administration > Tenants.
  2. Click the New icon (Add).
  3. In the Name text box, enter a tenant name that matches a tenant name in the source environment.

    For example, if the tenant name in the source environment is DEVTenant, enter DEVTenant.

  4. (Optional) : Enter a description in the Description text box.
  5. In the URL Name text box, enter a tenant URL name that matches the tenant URL name in the source environment.

    The URL name is used to append a tenant-specific identifier to the vRealize Automation console URL.

    For example, if the URL name for DEVTenant in the source environment is dev, enter dev to create the URL https://vra-va-hostname.domain.name/vcac/org/dev.

  6. (Optional) : Enter an email address in the Contact Email text box.
  7. Click Submit and Next.

What to do next

Create an Administrator for Each Added Tenant.