Correcting or changing FQDNs for VCF 9.1 Management services

Products

• VCF Operations

Issue/Introduction

In VCF 9.1, it is not possible to rename or change the Fully Qualified Domain Name (FQDN) of VCF Management services (such as the License Service or Identity Broker) once they have been deployed. If an incorrect FQDN was provided during deployment, the components must be removed and redeployed with the correct values.

• User needs to switch or correct FQDNs for services like License Service and vIDB.
• VCF Operations UI does not provide an option to modify FQDNs post-deployment.

Environment

VCF Operations 9.1

Cause

Renaming of deployed management service components is not supported. This requires a manual cleanup and fresh redeployment.

Resolution

Follow these steps to remove the affected components and redeploy them with the correct FQDNs. Ensure a full backup of all management nodes is completed before proceeding.

1. Backup the environment: Complete a full backup of the SDDC Manager and VCF Management nodes.
2. Remove the License Server:
   • Follow the steps in Remove a License Server.
3. Delete SSO configurations (if applicable): If AD over LDAP/S, ADFS, or PING is configured, remove these entries. Skip this if using local accounts only.
4. Clean up VSP components:
   • Use the cleanup_component.py script from KB 441333.
   • List the components to identify the ID for the Identity Broker:

     python cleanup_component.py list vsp-component --fleet-fqdn <FLEET_FQDN> --vcf-services-runtime-fqdn <VSP_FQDN> --vcf-services-runtime-username admin

      

   • Delete the Identity Broker component using its ID:

     python cleanup_component.py delete vsp-component --component-id <COMPONENT_ID> --fleet-fqdn <FLEET_FQDN> --vcf-services-runtime-fqdn <VSP_FQDN> --vcf-services-runtime-username admin

5. Correct DNS Entries: Update the DNS server with the correct FQDN and IP mapping for the services.
6. Redeploy components:
   • Redeploy the License Server: Redeploy License Server.
   • Redeploy the Identity Broker as admin from VCF Operations UI.