You upgrade to VMware Integrated OpenStack 5.1 by installing the new version and migrating your existing deployment.


  • Download the VMware Integrated OpenStack 5.1 OVA from the VMware Integrated OpenStack download page. The file requires approximately 6 GB of storage space.
  • Verify that your environment meets the requirements for VMware Integrated OpenStack 5.1. See Hardware Requirements for VMware Integrated OpenStack and Software Requirements for VMware Integrated OpenStack.
  • Verify that the network ports required for VMware Integrated OpenStack 5.1 are open. See Required Network Ports.
    Important: The HAProxy web UI now uses port 1993. Update your firewall configuration accordingly.
  • Prepare sufficient resources to make a duplicate of every node in your current deployment. If you want to upgrade a compact deployment to an HA deployment, you will need additional resources. See Hardware Requirements for VMware Integrated OpenStack.
  • Record any custom changes made to the OpenStack deployment outside of the custom.yml and custom-playbook.yml files. Any customizations not included in these files will not take effect on the new version and must be configured again on the new deployment once the upgrade is complete.
  • If you have enabled Ceilometer, disable it before upgrading. You can enable Ceilometer again after the upgrade process is finished.
  • For NSX-T Data Center deployments, if you do not want to use Barbican as your key manager, modify your custom.yml file as follows:
    1. Under Barbican options, uncomment cert_manager_type.
    2. Set its value to vmware_nsxv3.
  • Ensure that no internal OpenStack management workloads are running.
  • Ensure that your current deployment is running VMware Integrated OpenStack 4.0 or 4.1. If you are running an older version, upgrade to version 4.1 first. If you are running VMware Integrated OpenStack 5.0, follow the procedure described in Patch VMware Integrated OpenStack.