check-circle-line exclamation-circle-line close-line

VMware Integrated OpenStack 5.0 Release Notes

VMware Integrated OpenStack 5.0 | 03 JUL 2018 | Build 8909572
VMware Integrated OpenStack with Kubernetes 5.0 | 03 JUL 2018 | Build 8958925

Check for additions and updates to these release notes.

What's in the Release Notes

The release notes cover the following topics:

About VMware Integrated OpenStack

VMware Integrated OpenStack greatly simplifies deploying an OpenStack cloud infrastructure by streamlining the integration process. VMware Integrated OpenStack delivers out-of-the-box OpenStack functionality and an easy configuration workflow through a deployment manager vApp that runs directly in vCenter Server.

What's New

This release is based on OpenStack Queens and provides the following new features and enhancements:

VMware Integrated OpenStack

  • Support for the latest versions of VMware products: VMware Integrated OpenStack 5.0 supports and is fully compatible with VMware vSphere 6.7, NSX for vSphere 6.4.1, NSX-T 2.2, vSAN 6.7, vRealize Log Insight 4.6.0 and vRealize Operations Manager 6.7.
  • Increased scale validation: VMware Integrated OpenStack has been fully validated with 500 physical nodes and 15,000 virtual machines per region, with tests indicating support for even larger scale.  
  • Keystone federation: Identity can now be federated across multiple OpenStack regions, enabling unified identities across large-scale deployments.. 
  • DNS as a service: Inclusion of the Designate projects allows self-service DNS and simplified records management for tenants.
  • vGPU enablement: Workloads can now benefit from hardware acceleration by using GPU-enabled instances, increasing performance for HPC, machine learning, graphics processing, and streaming.
  • Accelerated data plane: Workloads running on VMware Integrated OpenStack can now take full advantage of the new enhanced mode of the NSX-managed virtual distributed switch (N-VDS), introduced in vSphere 6.7 and NSX-T 2.2.
  • Encryption enabled on HA deployments by default: In order to further secure in-flight data and protect sensitive information, VMware Integrated OpenStack can now configure encrypted control plane endpoints.
  • Telemetry improvements: The time series database Gnocchi has been added alongside Panko and Aodh to improve OpenStack telemetry performance.
  • Attached volume snapshots: Cinder now supports taking snapshots of attached volumes.

VMware Integrated OpenStack with Kubernetes

A container orchestration platform built on Kubernetes is included with VMware Integrated OpenStack, enabling the provisioning of full infrastructure stacks for application developers. The platform provides the following new features:

  • Updated Kubernetes release: VMware Integrated OpenStack 5.0 includes and fully supports Kubernetes version 1.9.8.
  • Heterogeneous clusters: Kubernetes clusters can now be created with a heterogeneous node composition, allowing pods to be deployed to and take advantage of specialized hardware or resources. 
  • N-VDS enhanced mode support for Kubernetes. The accelerated data plane networking introduced in VMware Integrated OpenStack 5.0 is also made available to workloads deployed as containers using the Multus plugin. 


See the VMware Product Interoperability Matrices for details about the compatibility of VMware Integrated OpenStack with other VMware products, including vSphere components.

VMware Integrated OpenStack is compatible with the vSphere Client (Flex or HTML5) of the following vCenter Server versions:

Version Build Date
6.5 4602587 November 15, 2016
6.5 Update 1 5973321 July 27, 2017 7119070 November 14, 2017
6.5.0.u1c 7119157 November 14, 2017
6.5.0.u1d 7312210 December 19, 2017
6.5.0.u1e 7515524 January 9, 2018
6.5.0.u1g 8024368 March 20, 2018
6.7 8217866 April 17, 2018

Upgrading to Version 5.0

Upgrading VMware Integrated OpenStack

You can upgrade directly to VMware Integrated OpenStack 5.0 from a VMware Integrated OpenStack 4.x deployment. See Upgrade VMware Integrated OpenStack in the installation guide for version 5.0.

If you are running VMware Integrated OpenStack 3.1 or an earlier version, upgrade to version 4.1 and then upgrade to version 5.0.

Upgrading VMware Integrated OpenStack with Kubernetes

To upgrade from VMware Integrated OpenStack with Kubernetes 4.1 to VMware Integrated OpenStack with Kubernetes 5.0, see Upgrade to VMware Integrated OpenStack with Kubernetes 5.0 in the VMware Integrated OpenStack with Kubernetes Getting Started Guide.

Deprecation Notices 

Some OpenStack Management Server lifecycle management APIs available in VMware Integrated OpenStack 4.1 and 5.0 will be changed or deprecated in a future major release of VMware Integrated OpenStack. 

The SDDC provider in VMware Integrated OpenStack with Kubernetes, intended for deployments without an existing VMware Integrated OpenStack instance, will be deprecated in a future major release. For new VMware Integrated OpenStack with Kubernetes deployments, use the OpenStack provider.


VMware Integrated OpenStack version 5.0 is available in English and seven additional languages: Simplified Chinese, Traditional Chinese, Japanese, Korean, French, German, and Spanish. ASCII characters must be used for all input and naming conventions of OpenStack resources (such as project names, user names, image names, and so on) and for the underlying infrastructure components (such as ESXi hostnames, virtual switch port group names, data center names, datastore names, and so on). 

Open Source Components for VMware Integrated OpenStack 5.0

The copyright statements and licenses applicable to the open source software components distributed in VMware Integrated OpenStack 5.0 are available on the Open Source tab of the product download page. You can also download the source files for the most recent available release of VMware Integrated OpenStack that are governed by the GPL, LGPL, or other similar licenses that require the source code or modifications to source code to be made available.

Known Issues

The known issues are grouped as follows.

VMware Integrated OpenStack
  • Attempting to re-add a deleted compute node with tenant VDCS fails

    After successfully deleting a compute node with tenant VDCS, attempting to re-add it fails with a "Failed to create resource provider" error in /var/log/nova/nova-compute.log.

    Workaround: After deleting the compute node, perform the following steps to remove it from the database before re-adding it.

    1. Find the MOID of the deleted compute node.
    2. Log into to MYSQL on the database node.
    3. Switch to the nova_api database with the SQL command use nova_api and remove the resource_provider record with MOID of the deleted compute node and all its children from the "resource_providers" table.
  • Nova-compute service fails to start following upgrade to VIO 5.0

    A user deletes a nova compute node in VIO 4.x, then adds a new nova compute node with the same vCenter Server and same cluster. After upgrading to 5.0, the nova-compute service fails to start with "ERROR nova ResourceProviderCreationFailed" in /var/log/nova/nova-compute.log.

    Workaround: Perform the following steps to remove the nova compute node from the database.

    1. Find the MOID of the deleted compute node.
    2. Log into MySQL on the database node.
    3. Switch to the nova_api database with the SQL command use nova_api:
      1. In the "resource_providers" table, remove the resource_provider record with the MOID of the deleted compute node.
      2. In the "host_mappings" table, remove the host record for the deleted compute node.
  • Deleting compute nodes out of order then attempting to add a compute node results in an error

    Earlier VMware Integrated OpenStack versions only supported deletion of compute nodes in order of largest to smallest number. For example, with three compute nodes: VIO-compute-0, VIO-compute-1,VIO-compute-2, you would delete VIO-compute-2, VIO-compute-1 first. If you did not delete the nodes in this order, then adding a node later would generate an error.

    Workaround: The VMware Integrated OpenStack 5.0 UI supports node deletion in any order. However, the old node deletion and addition error checking code still exists. To work around the problem, delete nodes in order from largest to smallest node number.

  • Inaccessible OpenStack deployment due to failure in the data store where nodes are located

    In an HA deployment with nodes located in a single data store, if the data store fails, the entire deployment is not accessible.

    Workaround: To work around the problem, try to fix the failed data store and recover its data. After the node VMs are back in the vCenter Server, restart the OpenStack deployment. If data is not recoverable use the viocli recover command to restore the failed nodes.

  • Keystone endpoint health status appears with a red X

    After configuring internal_api_protocol in the custom.yml file to enable encryption, the Keystone endpoint does not reconnect with the new Keystone URL. On the OpenStack Configuration page in the vSphere Web Client, the state of the endpoint health is in error with a red X.

    Workaround: Select the Keystone endpoint and click the pencil icon to update the configuration. Scroll down to the Update Endpoint screen and perform the following steps:

    1. Change the URL to https.
    2. Enter the admin password.
    3. Click the Update button.
  • Unable to deploy OVA file using vCenter 6.7 H5 web client

    When attempting to deploy the VMware Integrated OpenStack OVA using the vCenter 6.7 HTML5 web client, the VMware Integrated OpenStack vApp fails to power on and the UI displays the error: "The virtual machine has a required vService dependency 'vCenter Extension Installation' which is not bound to a provider."    

    Workaround. Use the ovftool command to deploy the OVA files using the FLEX-vsphere-web-client. 
    NOTE: This is known issue for vCenter 6.7 HTML5 web client and is documented in the vSphere 6.7 Release Notes: Also, a KB for this issue is:

  • Failed to launch instances due to "ResourceProviderAggregateRetrievalFailed: Failed to get aggregates for resource provider with UUID xxxxxxxxxxxxxxxxxx"

    You cannot launch instances on a compute node where an existing tenant VDC was deleted. For example, the operation fails if you:

    1. Have tenant VDCs on a compute node before starting the nova-compute service.
    2. Start the nova-compute service, then delete one or more of the tenant VDCs.
    3. Attempt to launch an instance on the same compute node.

    Workaround: Restart nova-compute service on the compute node.

  • Hostname that starts with a number results in "" error

    The OMS server does not support any hostname that starts with number. The error " DNSName components must begin with a letter" appears if the hostname starts with a number.

    Workaround: None. For more information, see the JDK upstream issue:

  • E-W traffic does not travel between the VMs booted under the virtual-wire type provider network.

    If a user directly creates provider network using virtual-wire and does not create spoofguard policy, then E-W traffic will not travel between the VMs booted under this provider network.  

    Workaround: Create a spoofguard policy and add virtual-wire to this spoofguard policy. Then create a provider network of type virtual-wire.

  • Delete router interface ends with timeout

    When concurrent heat stacks are deployed with shared-type NSX routers which is the default deployment, router interface deletion can timeout. Timeouts may be: neutron_client_socket_timeout, haproxy_neutron_client_timeout, or haproxy_neutron_server_timeout.

    Workaround: While timeouts can be tuned or increased, do not use shared-type routers in environments with frequent changes to network resources, for example where resources are frequently added or deleted. Use either an exclusive-type router if NAT/FIP is required, or use a distributed-type router.

VMware Integrated Openstack with Kubernetes
  • Failed to delete cluster in ERROR state

    If the infrastructure is out of resources, cluster creation, healing, or scaling will fail and the cluster will fall into an ERROR state.

    Workaround: To correct this problem, perform the following steps:

    1. Run bash on the toolbox container
    2. Use the OpenStack client to delete hosts in the ERROR state.
    3. Re-run the command: vkube cluster delete
  • Authentication fails with a username or domain containing '\'.

    The Keystone authentication plugin uses the backslash character as a separator to encode the domain name and username in a single string . If there is an additional backslash in either the    domain name or username, the Keystone authentication plugin will not decode the domain name and username correctly.

    Workaround: Use domain names or usernames that do not include the backslash character.