Renaming a vSphere Cluster configured with vSAN

Products

• VMware vSphere ESXi
• VMware vSAN 6.x
• VMware vSAN 7.x

Issue/Introduction

This article provides steps on how to rename vSphere Cluster configured with esxi host having  vSAN  datastore. Renaming a vSphere Cluster using vSphere Client only changes the display name, vSAN cluster configuration is associated with vSAN subcluster UUID.

Environment

vSAN 7.X

vSAN 8.X

Resolution

• Take a note of Sub-Cluster UUID (VSAN), to get  sub-Cluster UUID issue command "esxcli vsan cluster get" at esxi host command line. 
• Rename vSphere Cluster name with no downtime.

1. Log in to the vCenter vSphere Client.
2. Locate the vSphere Cluster in the inventory.
3. Right-click the vSphere Cluster and click Rename.

• To validate vSAN sub-cluster UUID, to get  sub-Cluster UUID issue command "esxcli vsan cluster get" at esxi host command line.

root@esx01] esxcli vsan cluster get
Cluster Information
Enabled: true
Current Local Time: 2025-04-01T17:09:04Z
Local Node UUID: #########-####-####-####-########
Local Node Type: NORMAL
Local Node State: MASTER
Local Node Health State: HEALTHY
Sub-Cluster Master UUID:#########-####-####-####-########
Sub-Cluster Backup UUID: #########-####-####-####-########
Sub-Cluster UUID: #########-####-####-####-########  <=====================vSAN cluster unique UUID
Sub-Cluster Membership Entry Revision: 1
Sub-Cluster Member Count: 5   Sub-Cluster Member UUIDs: #########-####-####-####-########, #########-####-####-####-########,#########-####-####-####-########, #########-####-####-####-########, #########-####-####-####-########0
Sub-Cluster Member HostNames: esx01,esx02,esx03,esx04,esx05
Sub-Cluster Membership UUID: #########-####-####-####-########
Unicast Mode Enabled: true
Maintenance Mode State: OFF
Config Generation: #########-####-####-####-######## 2024-04-01T10:11:03.006
Mode: REGULAR

 

Note: If vSphere Cluster and Vcenter are configured with any other application/plugin like backup,replication,storage etc then please contact application  vendor support prior to making changes.