"could not be converged" error while performing convergence on vCenter server.

Products

• VMware vCenter Server

Issue/Introduction

Symptoms:

• While initiating convergence from system configuration UI, the task fails immediately with error <VCSA-FQDN> could not be converged.
• Under /var/log/vmware/converge/ directory, the converge.log does not get created.
• You will not observe any logs related to convergence task failure in vsphere_client_virgo.log file location: /var/log/vmware/vsphere-ui/logs. The only log entry you see is:

[2021-07-12T20:41:59.639Z] [INFO ] http-nio-5090-exec-1          c.vmware.vsphere.client.h5.admin.controllers.ConvergeController   POST /converge

• You will see "<VC-FQDN> does not exist in user session" from browser's Network tab under Developer Tools.

 

 

Environment

VMware vCenter Server Appliance 6.7.x

Cause

This issue is caused due to the case mismatch of vCenter Server FQDN in LookupService and the FQDN used by vSphere Client network call.

Resolution

This is a know issue currently affecting vCenter Server Appliance 6.7. Currently there is no resolution.

Workaround:

Please follow one of the following option to workaround the issue.

Option a: 

• Converging to an Embedded Platform Services Controller Node Using the Command-Line Utility.
• (Optional) You may need to use option "--skip-domain-handling" to skip any operation that joins to a domain.
  • Syntax of the Converge Command

Option b: 

1. Run the following command to get VCSA FQDN as registered in LookupService. 
   • /usr/lib/vmidentity/tools/scripts/lstool.py list --url https://localhost/lookupservice/sdk --no-check-cert --type vcenterserver | grep -i https://<FQDN of VCSA to be convrged>:443/sdk
2. Open VC in *Firefox browser* and navigate to System Configuration-UI
3. On the firefox browser application menu, launch "Web Developer Tools"

 

4. Right click on the convergence call in Network tab and click "Edit and resend".

5. Modify the FQDN of vcenter under "Query String" to match the case from output of 'step:1' and click Send.
6. This will trigger Convergence of vcenter but the progress of convergence wont be visible on UI. Instead, you will need to look at converge.log under /var/log/vmware/converge/ to monitor progress.
7. For a successful convergence you will see the following entries under converge.log

2021-06-30T09:30:58.583Z INFO converge Unsetting the converge running flag
2021-06-30T09:30:59.224Z INFO converge Cleanup successful with partial flag = False.
2021-06-30T09:30:59.225Z DEBUG converge Updating the DCUI console.
2021-06-30T09:30:59.234Z INFO converge Converged the external PSC to embedded PSC Successfully.
2021-06-30T09:30:59.234Z INFO converge Join AD domain if required.
2021-06-30T09:30:59.235Z INFO converge Skipping AD Domain joining.
2021-06-30T09:30:59.237Z INFO converge Collected end_time:1625045459.2373474 as a part of Telemetry
2021-06-30T09:30:59.237Z INFO converge Collected status:True as a part of Telemetry
2021-06-30T09:30:59.237Z INFO converge Collected @type:convergence_telemetry as a part of Telemetry
2021-06-30T09:30:59.241Z DEBUG converge Starting new HTTP connection (1): localhost
2021-06-30T09:30:59.363Z DEBUG converge http://localhost:15080 "POST /analytics/telemetry/ph/api/hyper/send?_c=vcebc.1_0 HTTP/1.1" 201 0
2021-06-30T09:30:59.364Z DEBUG converge Pushed the Collected Data to VMWare Analytics Service as a part of  Telemetry.