HCX - Reverting upgrade to version 4.3.0
search cancel

HCX - Reverting upgrade to version 4.3.0


Article ID: 314211


Updated On:


VMware HCX VMware Cloud on AWS


As part of HCX Connector or Cloud Manager upgrade to version 4.3.0, the database will be transitioned from MongoDB to PostgreSQL. The process will ensure the conversion is complete and data is validated.

Thorough verification of the configuration and services in the HCX deployment is strongly recommended immediately after the upgrade is completed.

If there is any problem during the process, the upgrade will be canceled and the previous version running will be left active in the system. There will be no indication in the HCX UI regarding the failed upgrade and log analysis may be required. 


As a best practice, a procedure is made available in the unlikely event that any data inconsistency issues are found after the upgrade to HCX 4.3.0 is completed. Reverting the upgrade should be considered only as a last resource, after a potential issue is fully validated and for which no workaround or other remediation process has been identified.
  • SSH into the Connector or Cloud Manager with "admin" credentials
  • Change the user to "root"
  • Verify if mount points for specific directories in alternate partitions
# mount -t ext3 /dev/sda1 /recovery
# findmnt --mountpoint / 
The above command should give one of the following outputs. 
( /dev/sda2 and /dev/sda3 are alternate partitions for / after upgrades )
/       /dev/sda3   ext3   
/        /dev/sda2   ext3
Run the command below if SOURCE from above command output is /dev/sda3
# mount -t ext3 /dev/sda2 /slot1
Run the command below if SOURCE from above command output is '/dev/sda2'
# mount -t ext3 /dev/sda3 /slot2
  •  Execute script to revert to the previous version
# sh /opt/vmware/bin/recover.sh

The system will reboot at the end of the restoration process.
Once the Connector or Cloud Manager is back online, verify the version running, all configuration and services.

Refer to KB 74869 (section 2 only) for instructions on how to remove the 4.3.0 plug-ins from vCenter and restart app-engine from the HCX Administration UI to reinstall the previous version plug-ins.

  • The above mentioned procedure must be performed within a day of the upgrade to 4.3.0 and above.
  • In case if  /common partition utilization reaches 100% customers must reach out to VMware Global Support Services  and DON'T  revert back to old version.
  • VMC on AWS customers must open a Service Request with VMware Global Support Services for any upgrade issues with the HCX Cloud Manager deployed in their SDDC.

Additional Information

KB 86523  HCX Connector or Cloud Manager restoration from backup
KB 86397  HCX Connector or Cloud Manager UI inaccessible after restoring a backup
KB 86462  Unable to upgrade HCX Connector or Cloud Manager after reverting a snapshot