HCX - Unable to modify/update hostname

Products

• VMware HCX

Issue/Introduction

Customer may not be able to update hostname for a given HCX Connector/Cloud manager system using appliance-management 9443 UI.
Below error will be seen on the HCX 9443 Admin UI:

Navigate to HCX 9443 UI >> Administration >> General Network >> General Network Settings >> EDIT



Location of Appliance Management log:

• HCX Manager : /common/logs/appliance-management/appliance-management.log

Environment

VMware HCX

Resolution

When user deploy HCX Connector/Cloud system using OVA deployment, the initial hostname can be provided which later on interpreted as system name and hostname both.

Note: System Name is being used by a given HCX Connector/Cloud system for Site Pair and services perspective, whereas hostname gets appended with DNS suffix for resolution purposes at the appliance-management level.

 

At a later stage, System Name is allowed to be modified under General Settings tab in the HCX appliance-management 9334 UI. Refer to the HCX user guide

Note: Post system name update, the new name will reflect in existing Site Pair connections as well as under Administration/Support section of HCX VC plugin & Standalone UI. Whereas, hostname will remain unchanged.
 

As of now, we do not support modifications in the hostname using HCX appliance-management 9443 UI post OVA deployment.
However, user can follow below steps through HCX console to modify/update the hostname for a given HCX Connector/Cloud system:

• Login to HCX Connector/Cloud admin console
• Switch to "root" role
• Go to "/etc/hosts" directory and update the required hostname

root@<hostname> [ ~ ]# cat /etc/hosts
127.0.0.1 <hostname> localhost

Note: Use VI editor to edit and save the required hostname

• Go to "/etc/hostname" directory and update the required hostname

root@<hostname> [ ~ ]# cat /etc/hostname <hostname>

• Reboot HCX Connector/Cloud manager