How to Resolve Error - Unable to update vIDM FQDN

When you use vRealize Suite Lifecycle Manager to enable multi-tenancy on your VMware Identity Manager 3.3.7 appliance and you get the error Unable to update vIDM FQDN, use the following steps to update the FQDN URL in the VMware Identity Manager appliance.

Procedure

1. Log in to the VMware Identity Manager appliance.
2. Stop the horizon workspace service. Enter service horizon-workspace stop
3. SSH in to the VMware Identity Manager appliance as the root user.
4. Open the /usr/local/horizon/conf/runtime-config.properties file to edit.
5. Replace the gateway.hostname value with the new load balancer FQDN.
6. Save the runtime-config.properties file.
7. Restart the horizon workspace service. Enter service horizon-workspace start
   Wait for the services to come back up.
8. Run the following REST API to update the FQDN value, URL, and end user catalog URL.
   1. Refresh the connector metadata with new FQDN URL.
      Obtain the connector UUID value from the browser network trace and replace <CONNECTOR_UUID> with the actual UUID value and replace <LB_FQDN> with the new URL.

      PUT : https://<LB_FQDN>/SAAS/jersey/manager/api/connectormanagement/connectors/<<Connector UUID>>/managerhostRequest 
      
      Headers: 
        Authorization: HZN <Token>
        Accept: application/vnd.vmware.horizon.v1.0+json
        Content-Type: application/json
      
      Payload: {}

   2. Replace <LB_FQDN> in the PUT endpoint and Payload lines with the new FQDN URL. In the PUT line, replace endUserCatalogUrl with the new FQDN URL.

      PUT: https://<LB_FQDN>/SAAS/jersey/manager/api/system/config/endUserCatalogUrl
      
      Headers:
        Authorization: HZN <Token>
        Accept: application/vnd.vmware.horizon.manager.systemconfigparameter+json
        Content-Type: application/vnd.vmware.horizon.manager.systemconfigparameter+json
      
      Payload: {"values": {"values": ["https://<LB_FQDN>:443/catalog-portal"]}, "name": "endUserCatalogUrl"}

9. In the VMware Identity Manager console Appliance Settings tab, select VA Configuration.
   Note: You can also directly access the VA Configuration page from https://WS1AccessHostnameFQDN:8443/cfg/
10. Click Identity Manager FQDN and enter the new URL in the Identity Manager FQDN field. Use the format https://WS1AccessHostnameFQDN:port. Specifying a port is optional. The default port is 443.
11. Click SAVE.

What to do next

Next, use vRealize Suite Lifecycle Manager to enable multi-tenancy on VMware Identity Manager with vRealize Automation 8.4. See Enable Tenant-In-Host Name Multi-Tenancy with vRealize Automation 8.x.