This article describes how to rename the CVM entity in Prism within the AHV environment. This does not change the hostname of the CVM displayed in a console/SSH session as the hostname is a value configured within the CMV OS and is independent of the Controller VM name entity recorded in the Prism entity DB (Insights Data Fabric).

It is the same name as in CVM’s XML definition on the AHV host. It can be checked by listing VMs on the host. The name displayed is the name that is shown in the Prism Wen console.

Starting from AOS 5.10.10, 5.15 and 5.16, change_cvm_display_name script is available on CVM that can be used to change the display name.

Following is the overview of the rename procedure:

• Complete the pre-checks: 

  • Name must start with NTNX- and end with -CVM. Only letters, numbers and "-" are supported in the name.

  • CVM should be able to receive a shutdown token. Once CVM has shutdown token it will be turned off. 

• The script does not put CVM/host into maintenance mode, so VMs will not be evacuated and will continue running with IO redirected while CVM is off.

• Then the name is changed, autostart enabled and CVM is started.

To take a detailed look at how to run the  command and what are the expected prompts, take a look at KB-2717

NOTE: This will not change the CVM hostname displayed in a console/SSH session. To change the CVM hostname seen in a console/SSH session, please refer to KB 3517.