VMware vCloud Director 1.0 Release Notes

VMware vCloud Director 1.0 | 30 AUG 2010 | Build 285979

Last updated: 30 AUG 2010

What's in the Release Notes

The release notes cover the following topics:

Feature Highlights

VMware vCloud Director provides the interface, automation, and management required by enterprises and service providers to build private and public clouds. vCloud Director:

  • Supports multi tenancy/organizational isolation
  • Allows for the creation of central application catalogs and personalization of templates
  • Enables creation and deployment of vApps from catalogs/templates
  • Controls user resource usage through roles/rights, quotas and leases
  • Enables programmatic control through the RESTful vCloud API
  • Provides an additional level of abstraction from underlying hardware

System Requirements and Installation

For information about system requirements and installation instructions, see the VMware vCloud Director Installation and Configuration Guide.

Other Documentation

In addition to the Release Notes, the following vCloud Director documentation is available:

Known Issues

The following known issues have been discovered through rigorous testing and will help you understand some behavior you might encounter in this release.

The known issues are grouped as follows:

General Issues

"Too many open files" errors
vCloud Director can require high open file limits. Make sure that every cell in your vCloud Director environment allows processes to open more than 1024 files. To see what the current limit is for a cell, log in to the cell, and type ulimit -n. If it says 1024 or less, then take the following steps to increase the open files limit:

  1. Type su -.
  2. Edit /etc/security/limits.conf and make sure it includes the following lines:

    * soft nofile 65535
    * hard nofile 65535
  3. Edit /etc/pam.d/login to include the following line:

    session required pam_limits.so
  4. Type the following command to restart the cell:
    service vmware-vcd restart
  5. Log out of the cell and log back in.
  6. Type ulimit -n to verify your changes.

Cannot change vCloud Director database user name or password while services are running
If you change the vCloud Director database user name or password while services are running, vCloud Director will fail at the next database access and log a message of the form "java.sql.SQLException: ORA-01017: invalid username/password; logon denied". Use the following procedure if you need to change the vCloud Director database user or password:

  1. Stop all vCloud Director services, as described in the VMware vCloud Director Installation and Configuration Guide.
  2. Using database tools, change the vCloud Director database user or password.
  3. Run the vCloud Director configuration script, as described in the VMware vCloud Director Installation and Configuration Guide (see "Configuring Network and Database Connections").
    The script first asks for the Java keystore path and password and then prompts you for the new user name/password for the database.

After you complete the script, it updates the information in the vCloud Director database and properties files and re-starts vCloud Director services.

Unable to create a Microsoft Sysprep deployment package
If you get a permission denied error when running the createSysprepPackage.sh script on a cell, you should check to see if SELinux is enabled and running in enforcing mode. To check, run the following command: /usr/sbin/getenforce. If it returns "Enforcing", perform the following workaround to grant the appropriate permissions to run the tool.

Workaround: Enable text-relocation for the shared library used by the script. Run following command as root after vCloud Director is installed: chcon -t textrel_shlib_t '/opt/vmware/cloud-director/deploymentPackageCreator/libCreatePkg.so'

Cannot create local user accounts with Unicode characters
vCloud Director does not support Unicode characters in the user names for local user accounts. You can import LDAP users whose names include Unicode characters.

"Running VMs" count may include powered off virtual machines
The "Running VMs" column in the organizations list (Manage & Monitor > Organizations) displays the total number of virtual machines in started vApps. This may include virtual machines that are not running (for example, powered off virtual machines) and virtual machines that provide network services (vShield Edge VMs).

Error when importing media files from vSphere
If you get a "String index out of range: -1" error when you attempt to import a media file from the root of a vSphere datastore, make sure the path starts with "/" (for example, /media-cd.iso) and try again.

Accessing vCloud Director with a Web browser
vCloud Director does not support logging in to different user accounts from the same browser at the same time.

vSphere Issues

Empty folders in vSphere inventory
When you delete a provider vDC in vCloud Director, an empty folder representing the provider vDC continues to exist in the VMs and Templates inventory view in the vSphere Client. You can manually remove the folder to clean up the inventory.

Cannot import vSphere templates
vCloud Director does not support importing templates from vSphere, it only supports importing virtual machines. You can use the vSphere Client to convert a template to a virtual machine and then import it into vCloud Director. You can also use the vSphere Client to deploy a virtual machine from a template and then import the virtual machine into vCloud Director.

Organization vDC Issues

Cannot delete and organization vDC or catalog
If you are unable to delete an organization vDC or a catalog because it still contains vApps or vApp templates, make sure to check My Cloud > Expired Items. After you delete the expired vApps in an organization vDC, you can delete the organization vDC. After you delete the expired vApp templates in a catalog, you can delete the catalog.

Processor column incorrectly displays GHz
When you open an organization vDC and view the Processor column on the vApp tab, vCloud Director displays a number followed by "GHz" for each vApp. The numbers in this column actually represent the total number of virtual processors in the vApp, and not the total GHz used by those processors.

Deleting an organization vDC from the API versus from the UI
When you delete an organization vDC using the API, vCloud Director deletes any vApps, vApp templates, and media in the organization vDC. Make sure to move any objects you want to keep before you delete the organization vDC. When you delete an organization vDC using the UI, Cloud Director deletes any vApp templates in the organization vDC. Make sure to move any vApp templates you want to keep before you delete the organization vDC.

Cannot start a vApp in a Reservation Pool organization vDC
Users can set memory and CPU reservations for their virtual machines in a Reservation Pool organization vDC. As a result, it is possible for users to reserve all the available memory and CPU in the organization vDC for their virtual machines. In this case, they would not be able to start a vApp that requires a vShield Edge virtual machine to provide network services, since there would be no memory or CPU available.

Upload and Download Issues

Upload fails to transfer files
If you previously installed the beta version of vCloud Director may see a Java security warning or a "java.lang.ExceptionInInitializationError" in the Java plug-in console when attempting to upload a vApp template or media file. In this case, clear the Java applet / application cache.

  1. Navigate to Control Panel > Java.
  2. On the General tab, click Settings in the Temporary Internet Files section.
  3. Click Delete Files.
  4. Make sure that Applications and Applets is selected and click OK.

Java plug-in issues
In order to upload vApp templates and media to a catalog, the computer from which you are uploading must have Java Plug-in 1.6.0_10 or later installed. In some cases, even after you install the plug-in you will not be able to upload files until you restart your Web browser.

Paused or canceled upload times out
When you pause or cancel an upload media or upload vApp template task, that task is subject to an upload timeout (one hour, by default). If you do not resume the task before the timeout, the task fails. An upload task that is in progress is not affected by the timeout.

Paused downloads display as "Canceled"
When you pause a vApp template download, the Download Progess Window incorrectly displays "Canceled". You can click the Resume button to continue the download.

Cannot upload files without using the Browse button
If you type or paste the path to the source file when uploading a vApp template or media file, the upload may fail with no error message. In this case, click the Browse button to locate the source file instead.

Virtual Machine Issues

Virtual machine console page shows an empty box in Mozilla Firefox 3.6 on Linux
Some versions in Firefox 3.6 series strip executable permissions on files that are extracted from the XPI plug-in binary. The console plug-in does not load correctly and the console page appears blank. To resolve the issue, browse to the console plug-in installation folder at /<Firefox_profile_folder>/extensions/VMwareMKSNPRTPlugin@vmware.com/plugins/ and run the command chmod 755 * to manually enable permissions on the files of that folder.

Unable to hot add memory or CPU
Under certain circumstances, you may not be able to hot add memory or CPU to virtual machines running in Allocation Pool or Reservation Pool organization vDCs. In this case, you can power off the virtual machine, add the memory or CPU, and then power on the virtual machine.

Networking Issues

Unable to delete an organization network
Before you can delete an organization network, you must make sure that no virtual machines are connected to it. If a vApp template in a catalog requires the organization network, you can delete the vApp template (if you don't need it anymore) or take the following steps to create a new vApp template that does not use the network you want to delete:

  1. From the catalog, add the vApp template to My Cloud.
  2. Delete the vApp template from the catalog.
  3. In My Cloud, open the vApp and make sure that none of its virtual machines connect to the organization network you want to delete.
  4. Remove the organization network from the vApp.
  5. Add the vApp to the catalog.
  6. Delete the vApp.

You can now delete the organization network.

vCloud API Issues

  • A vApp that displays as "Fenced" in the UI may have its vApp network Configuration FenceMode displayed as "natRouted" when retrieved in the vCloud API. If the IP subnet on the vApp network overlaps the IP subnet on the external network, then the vApp is actually deployed fenced. If the IP subnets on the two do not overlap, it is natRouted.

  • When a cloneVapp or cloneVappTemplate request is made with the vCloud REST API, the value of the name attribute in the request body is ignored, and the cloned object retains the name of the Source object.

  • GET vmext:ResourcePoolList requests might fail with an XML validation error (Invalid content).

  • When a cloneVapp request is made with the vCloud REST API, the deploy and powerOn attributes in the request body are ignored.

  • Until a ProviderVdc has been created, a GET request for networkPoolReferences or externalNetworkReferences will return an empty list even though network pools and external networks exist.

  • The response to a registervimserver request might include an invalid content message of the form "Invalid content was found starting with element vmext:AssociatedVimServer." This response does not indicate that the request failed.

  • Attempts to use the vCloud API to specify a memory reservation or limit when editing the VirtualHardwareSection of a Vm are silently ignored when the Vm is in a vDC whose AllocationModel has the value AllocationPool or AllocationVapp.

  • If you encounter errors (for example, "OperationDeniedException - Operations not in users context") when using the vCloud API to import LDAP users into an organization, log out and log in, then try to import the users again.

  • When a system administrator uses the REST API to instantiate a vApp template from a shared Catalog in a vDC owned by an organization other than the one that owns the shared catalog, the vApp owner is set to a member of the organization that owns the catalog, not the organization that owns the vDC. When any other use performs this operation, the vApp owner is set correctly.

  • When you instantiate a vApp template and specify a FenceMode value of isolated, the vApp network is created with a FenceMode of natRouted.

  • The REST API XML validator might reject a valid request as invalid XML if the request contains incorrectly-encoded UTF-8 characters.

  • A Vdc response body can contain one or more Link elements with a rel attribute value of move. These links are inoperative, and will be removed in a future release.