In this post we are exploring how to rename ESXi and vCenter hostnames as part of VxRail. In my scenario, I'm using an external DNS and internal vCenter. VxRail vCenter FQDN rename functionality was introduced with VxRail 7.0.400.

The table below outlines the current and new hostnames.

Current Hostname

New Hostname









1. Initially, create the target DNS records in addition to the existing ones.
2. Create a snapshot of VxRail Manager and vCenter Server.
3. If in use, disable Cluster Health Monitoring

4. Next we can start with the ESXi hostname change. From the VxRail - Hosts View, select the first host and change the hostname by clicking Edit.

5. Once the first host is completed, proceed with all remaining hosts.

6. Navigate to vCenter Server Management interface https://fqdn:5480 and update the vCenter Server hostname.

7. The target hostnames are now visible from vCenter Server, but we have some more work to do.

8. Next, renew ESXi certificates for each host and restart vxrail-platform-service. 

9. The vCenter Server hostname needs to be updated in VxRail Manager. SSH into VxRail Manager and execute the following API calls.
curl --location --request GET '' 
--header 'Content-Type: application/json' 
--unix-socket /var/lib/vxrail/nginx/socket/nginx.sock
curl --location --request PUT '' 
--header 'Content-Type: application/json' --unix-socket /var/lib/vxrail/nginx/socket/nginx.sock 
--data-raw '{"value": "vcsa.demo.local"}'

10. As a next step, the vCenter Server certificates need to be updated in VxRail Manager. Execute the following API call.
curl -k -X POST -H "Content-Type: application/json" --unix-socket
/var/lib/vxrail/nginx/socket/nginx.sock -d @- << EOF
"vc_info": {
"host": "fqdn",
"username": "administrator@vsphere.local",
"password": "password",
"port": 443
"auto_accept_vc_cert": true

11. Restart VxRail marvin services.
systemctl restart vmware-marvin
systemctl restart runjars

12. Flush cache to update VxRail vCenter Plugin.
echo -n "administrator@vsphere.local:password" | base64
curl --location --request POST
'' --header 'Content-Type:
application/json' --header 'Authorization: Basic
your_base64_auth_key' -k

13. VxRail Cluster Monitoring can be enabled again.
14. Clean up old DNS entries.

Always refer to Dell Solve for the latest procedures!