VMware HCX 4.8.2 | 14 FEB 2024 | Build 23247196 (Connector), 23247145 (Cloud)

Check for additions and updates to these release notes.

About VMware HCX

VMware HCX delivers secure and seamless application mobility and infrastructure hybridity across both on-premises and in the cloud. HCX abstracts the distinct private or public vSphere resources and presents a Service Mesh as an end-to-end entity. HCX Interconnect can then provide high-performance, secure, and optimized multi-site connectivity to achieve infrastructure hybridity and present multiple options for bi-directional virtual machine mobility with technologies that facilitate the modernization of legacy data centers.

System Requirements and Compatibility

For HCX deployment requirements, see Preparing for HCX Installation.

The following resources provide information related to HCX deployments:

Early Adoption Features

Early Adoption (EA) denotes an initial release phase of a critical service feature with limited field exposure. While the feature has completed its entire development cycle and it is fully supported in production, due to strong dependencies on the deployment environment, thorough validation and qualification is recommended before activating it.

Installation and Upgrade

Installing HCX 4.8.2

For sample installation workflows by deployment type, see Installing HCX Manager.

Upgrading to HCX 4.8.2

  • Requirements for HCX deployments:

    • Upgrading to HCX 4.8.2 from HCX 4.4 and above is supported using online upgrade notification from HCX Manager standalone (:443)/VC Plugin UI.

    • Upgrading to HCX 4.8.2 from all versions less than 4.4 requires offline upgrade using HCX Manager appliance management UI (:9443).


      Refer to Upgrade HCX Manager for Local Sites to download the HCX 4.8.2 Connector and Cloud Manager upgrade bundle and use the HCX Manager appliance management interface, https://hcx-ip-or-fqdn:9443, to perform the upgrade.

      For HCX deployed in VMware Cloud on AWS infrastructure, the HCX Manager appliance management UI (:9443) interface won't be accessible for the end user. VMware Cloud on AWS customers running less than HCX 4.4 versions must open a support request with Broadcom to help assist with the HCX Cloud Manager upgrade.

    • All site paired systems must be upgraded.

    • All Service Mesh appliances including Network Extension (NE) must be upgraded to 4.8.2.


VMware HCX 4.8 introduces PhotonOS version 4, which is unsupported for new installation and upgrade for vSphere infrastructure enabled with AMD EPYC CPU families. For more information, refer to VMware Knowledge Base 95172.

  • Upgrade snapshots:

    • During upgrades to HCX 4.8.2, HCX Manager snapshots are taken automatically.

    • Upgrade snapshots are only taken when an HCX Manager is deployed on the same vCenter Server registered to it. For other deployments, manual snapshots can be taken.

    • HCX retains automatic snapshots for 24 hours before deleting them.

      Note: To restore the HCX Manager from a snapshot, contact VMware Support.

  • VMware sends administrative messages to HCX systems that are running out of support and require upgrade.

  • Upgrade compatibility information is available as a table in VMware Product Interoperability Matrix - Upgrade Path.


HCX 4.5.0 and later releases have new security requirements for OS Assisted Migration (OSAM). If you use OSAM in your environment, you must upgrade HCX Connector, HCX Cloud Manager, and HCX OSAM data plane appliances (Sentinel Gateway, Sentinel Data Receiver) to HCX 4.5.0 or later. Additionally, you must upgrade Sentinel agents running on the source workloads. For compatibility with HCX 4.8.0, the Sentinel agents, Sentinel Gateway, and Sentinel Data Receiver must be running HCX 4.5.0 or later. If not all appliances are compatible, migrations can stall and must be started again after upgrade.

What's New

VMware HCX version 4.8.2 is a maintenance release that resolves important issues regarding product migration, network extension, and system services.

Resolved Issues

Resolved Migration Issues

PR/3331097 - OS Assisted Migrations for Linux workload VMs may become stuck in the state, "Starting initial sync”.

Resolved Network Extension Issues

PR/3331519 - After upgrading HCX Manager and Network Extension (NE) Appliance to 4.8.0, the Network Extension Appliance configured with High Availability (HA) experiences intermittent failover events. Refer VMware Knowledge Base 96352 for more information.

Resolved System Issues

PR/3322139 - During Interconnect (IX) Appliance upgrade/redeploy, the addition of Mobility Agent (MA) host fails with the error, "Unable to push CA certificates and CRLs".

PR/3323263 – After upgrading HCX Manager to 4.8.0, IX/NE Appliance upgrade to 4.8.0 fails with the error “Given final block not properly padded. Such issues can arise if a bad key is used during decryption”. Refer VMware Knowledge Base 96193 for more information.

Product Support Notices

About NSX for vSphere systems in Extended Support

  • NSX for vSphere General Support ended on January 16, 2022.

  • NSX for vSphere systems in Technical Guidance (under Extended Support contracts) are only supported at the evacuation site (source), with HCX Connector.

  • To determine the HCX Connector version for evacuation, refer to VMware KB articles 82702 and 71398.

Note that HCX Cloud installations require current (Generally Available) VMware software components.  NSX for vSphere is not suitable or supported for HCX Cloud installations.

check-circle-line exclamation-circle-line close-line
Scroll to top icon