VMware HCX delivers secure and seamless app mobility and infrastructure hybridity across vSphere 6.0 and later versions, 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. The 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.
Updated on: 09 APR 2021
VMware HCX 4.0.1 | 09 APR 2021 | Build 17851353 (Connector), Build 17851340 (Cloud)
Check for additions and updates to these release notes.
What's in the Release NotesThe release notes cover the following topics:
For more information, see the VMware HCX User Guide in the VMware Documentation Center.
Starting with the HCX 4.0 release, software versioning adheres to X.Y.Z Semantic Versioning, where X is the major version, Y is the minor version, and Z is the maintenance version. For more information about HCX software support, lifecycles, and version skew policies, see VMware HCX Software Support and Version Skew Policy. This document includes the section HCX Support Policy for Vacating Legacy vSphere Environments, with more information available in VMware KB 82702.
For information regarding HCX interoperability, see VMware Product Interoperability Matrix.
Upgrading to 4.0.1 from HCX 3.5.3 R-Releases
Prior to Semantic Versioning, HCX 3.5.3 releases were identified as "R" releases, such as R147. Review the following information prior to upgrading from R-based releases to HCX 4.0.1:
- Upgrading to HCX 4.0.1 is supported only from the following HCX Service Updates: R147.
- Customers are required to move to R147 to support upgrading to HCX 4.0.
- Assistance with upgrading from out-of-support releases will be on a best-effort basis.
- VMware sends administrative messages to HCX systems that are running out of support and require upgrade.
Note: 3.5.3/R147 HCX Manager systems will display release code R149 as a prefix to the 4.0.1 version. This is a known condition during the transition.
Early Adoption Features
Early Adoption (EA) denotes an initial release phase where a feature has limited field exposure and it has strong dependencies on the deployment environment for its functionality. While the feature has completed the entire development process and it is fully supported, it is expected to reach maximum stability and performance through subsequent maintenance releases.
VMware HCX 4.0.1 is a maintenance release that provides only fixed issues and UI enhancements. For a list of features introduced in HCX 4.0, refer to the VMware HCX 4.0 Release Notes.
- The Network Extension configuration screen now displays the network container details for the selected VLAN networks. (2708342)
- The Uplink Network Profile screen in both the Compute Profile Wizard and Service Mesh Wizard includes a statement reminding users that for destination HCX systems (IX/NE) accessed over the Internet, you use the HCX Cloud Manager's Network Profile wizard to assign public IP addresses for the Uplink network. (2745039)
Resolved Interconnect Issues
- PR/2726031 – In some cases, HCX does not correctly parse the Syslog server URL, which caused the Service Mesh configuration to fail. HCX now correctly parses the Syslog server entries.
- PR/2740710 – Upgrading the HCX IX appliance fails with the error "InvalidGuestLogin: Failed to authenticate with the guest operating system." This was due to a race condition in the HCX boot process that has been fixed in this release.
Resolved Migration Issues
PR/2711273 – Unable to search for the NSX Logical Switch and Network Switch types in the Map Virtual Machine Networks dialog interface. HCX now identifies these types in the search results.
PR/2742013 – Fixed an issue affecting the Sentinel agent software on a long running guest Linux virtual machine, preventing it from appearing in the inventory.
PR/2723561 – Reverse Replication Assisted vMotion migration to vCenter 6.0 failed with the error, "Failed to create one or more destination disks.” This happened due to incorrect identification of the datastore version.
PR/2660990 – After the successful deployment of the Sentinel Gateway, the Sentinel Management UI might not display the inventory of guest virtual machines running the Sentinel agent software if there was some intermittent failure in the deployment of Service Mesh. The UI now properly displays the inventory.
PR/2672307 – When using PowerCLI, if the TargetStorageProfile is not passed as a parameter to the new HCXMigration cmdlet, the OS Assisted Migration generates the message “Switchover Error,” and the job might not complete. HCX no longer generates an error message and the migration job completes successfully.
PR/2734609 – RAV and Bulk migrations can fail in transfer phase if the VM is missing the config.extraConfig section.
Resolved User Interface Issues
- PR/2727181 – In VMware Cloud Director deployments, the Network Profile wizard displays the HCX Traffic Type checkboxes when only Org-VDC networks are shown, and are the only networks that can be used in the Compute Profile. The checkboxes are now removed for vSphere Director deployments.
- PR/2650815 – The Migration wizard displays a checkbox for migrations even after switching to the inventory browser for filtering the virtual machine VM inventory. The extraneous checkbox has been removed from the interface.
PR/2724039 and 2724024 – HCX is updated to use jackson-databind jar 2.11.0, RabbitMQ amqp-client version 5.10.0, and spring-rabbit version 2.2.15.