Rename a cluster managed by SDDC Manager

Products

• VMware Cloud Foundation

Issue/Introduction

This article provides step-by-step instructions for renaming a vSphere cluster managed by SDDC Manager and outlines specific scenarios where renaming is not recommended.

Environment

VMware Cloud Foundation 4.x
VMware Cloud Foundation 5.x

Resolution

In VCF 4.5 and above perform the following steps in SDDC UI: 

1. On the SDDC Manager Dashboard, click Inventory > Workload Domains.
2. Click a workload domain.
3. Under the Clusters tab, click a cluster that you want to rename.
4. On the right side of the cluster's name, click ACTIONS > Rename Cluster OR You can also click the vertical ellipsis (three dots) in the clusters table for the cluster you want to rename and click Rename Cluster. The Rename Cluster window appears.
5. In the New Cluster Name textbox, enter a new name for the cluster and click RENAME.
6. Click DONE.

In VCF 4.1 to 4.4 perform the following steps:

1. In the navigation pane, click Inventory > Workload Domains.
2. Click a workload domain.
3. Click the Clusters tab.
4. Click the name of the cluster that you want to rename.
5. Click Actions > Open in vSphere Client.
6. In the vSphere Client, right-click the cluster and then click Rename.
7. Enter a new name for the cluster and click OK.

Note:

1.Change might take two minutes or more to reflect in the SDDC UI. 
2.Utilization details may show blank for the renamed cluster for several minutes.

Additional Information

References:

For VCF 4.1 to 4.5 refer Rename a vSphere Cluster

For 4.5 and above refer Rename a Cluster in the SDDC Manager UI

Impact/Risks:

Ensure that you do not perform a rename of a cluster in the following conditions:

• When the cluster belongs to a workflow that is in progress.
• When the cluster belongs to a failed VI workload domain workflow, cluster workflow or host workflow. If you try to rename a cluster that belongs to a failed workflow, restart of the failed workflow will not be supported.