Use the Migration wizard to migrate existing resource configurations from older releases to virtual apps collections, which are available in version 3.1.

About this task

You must migrate all existing resource configurations at the same time. For example, if you have Horizon Cloud and ThinApp applications configured, select both in the Migration wizard. The Migration wizard is intended to only be used once to migrate all the resources at the same time. After it is run once, it will no longer be available.

Note:

In a hosted environment, the migration process might take some time.

Prerequisites

Upgrade all VMware Identity Manager service and connector instances to version 3.1.

Procedure

  1. Select the Catalog > Virtual Apps Collection tab.
  2. Click Get Started.
  3. In the Migration wizard, for each resource type, select the connector worker that was used for the configuration in the old installation.

    The drop-down list for each resource type lists only the connectors that had that resource configured.

    If the resource was configured on multiple connectors for high availability, and multiple connectors appear in the list, select the connector that had a sync schedule set. This is also the default selection for each drop-down list.

    Important:

    Ensure that you make a selection for all the existing configurations. The Migration wizard is intended to only be used once to migrate all the resources at the same time. After it is run once, it will no longer be available.

  4. Click Migrate configurations.

    In a hosted environment, the migration process might take some time.

Results

The existing resource configurations are migrated. A virtual apps collection is created for each type of configuration. To view and edit the collections, click Catalog > Virtual Apps Collection and click each collection name.

You can now manage the collections from the Virtual Apps Collections page. The Manage Desktop Applications menu on the Application Catalog page is no longer available.

For troubleshooting information on virtual apps collections, view both the connector log file, connector.log, and the service log file, horizon.log. On Linux virtual appliances, the log files are in the /opt/vmware/horizon/workspace/logs directory. On Windows servers, the log files are in the install_dir\IDMConnector_or_VMwareIdentityManager\opt\vmware\horizon\workspace\logs directory.

What to do next

  • Only one connector, the one selected in the Migration wizard, is added to each new collection. If you had set up a connector cluster for high availability, edit the collections and add the other connectors in the cluster.

  • A single virtual apps collection is created for each migrated configuration. For large integrations, with many servers and apps, consider splitting the collection into multiple collections for easier management and faster sync. The virtual apps collection feature allows you to create multiple collections for each type of integration except ThinApp integrations.