For Horizon View and Citrix-published resources, you must configure the failover order of resources in both the primary and secondary data centers to make the appropriate resources available from any data center.

You use the hznAdminTool command to create a database table with the failover order for resources in your organization per service instance. The configured failover order is followed when a resource is launched. You run the hznAdminTool failoverConfiguration command in both data centers to set up the failover order.

Note: This procedure does not apply to environments using Horizon View Cloud Pod Architecture (CPA).


When VMware Identity Manager is deployed in multiple data centers, the same resources are also set up in each data center. Each application or desktop pool in the Horizon pods or Citrix XenFarms is considered as a different resource in the VMware Identity Manager catalog. To prevent duplication of the resource in the catalog, make sure that you enabled Do not sync duplicate applications in the Horizon and Citrix configuration pages in the VMware Identity Manager console.


  1. Using a ssh client, log in to the VMware Identity Manager appliance as the root user.
  2. To view a list of the service instances, type:
    hznAdminTool -j clusterInstances
    A list of service instances is displayed. The "id" value is the service instance ID. For example:
    "version" : " Build 8223322",
    "uuid" : "7451fe26-5b02-32ef-bfe6-6fe0a8710a14", 
    "status" : "Active", 
    "lastUpdated" : 1523372105701, 
    "hostname" : "", 
    "datacenterId" : 0, 
    "id" : 2, 
    "ipaddress" : ""}
  3. For each service instance in your organization, configure the failover order for Horizon and Citrix-based resources with the folllowing command:
    hznAdminTool failoverConfiguration -configType <configType> -configuration <configuration> -serviceInstanceId <serviceInstanceId>
    Option Description
    -configType Type the resource type being configured for failover. Values are either VIEW or XENAPP.
    -configuration Type the failover order. For VIEW configType, type as a comma separated list of the primary Horizon Connection Server host names that are listed in the Horizon View configuration page in the VMware Identity Manager console. For XENAPP configType, type as a comma separated list of XenFarm names.
    -serviceInstanceId Type the ID of the service instance for which the configuration is set. The ID can be found in the list displayed in Step 2, "id":
    For example:

    hznAdminTool failoverConfiguration -configType VIEW -configuration, -serviceInstanceId 1

    When you type this command for VMware Identity Manager instances in the secondary data center, reverse the order of the Horizon Connection Servers. In this example, the command would be hznAdminTool failoverConfiguration -configType VIEW -configuration, -serviceInstanceId 103.


The resources failover database table is set up for each data center.

What to do next

To see the existing failover configuration for each of the Horizon View and Citrix-published resources, run the command:

hznAdminTool failoverConfigurationList -configType <configtype>

The value for <configtype> is either VIEW or XENAPP. The following is an example output of hznAdminTool failoverConfigurationList with <configtype> VIEW.