VMware vCenter Orchestrator 4.0.4 Release Notes

vCenter Orchestrator 4.0.4 | 18 Nov 2011 | Build 4744

Check frequently for additions and updates to these release notes.

What's in the Release Notes

The release notes cover the following topics:

Downloading and Installing VMware vCenter Orchestrator

If you have downloaded and installed VMware vCenter Server, Orchestrator is already installed on your system and only needs configuration.

Read the VMware vCenter Orchestrator Installation and Configuration Guide for step-by-step guidance on configuring vCenter Orchestrator.

Upgrading or Migrating to vCenter Orchestrator 4.0.4

You can migrate an existing Orchestrator 4.0 installation to Orchestrator 4.0.4 by following the instructions in the VMware vCenter Orchestrator Installation and Configuration Guide.


The vCenter Server 4.0 plug-in is fully supported for use with vCenter Server 4.0. However, you cannot use the vCenter Server 4.0 plug-in with VirtualCenter Server 2.5. To use Orchestrator 4.0 with VirtualCenter Server 2.5, you must install the VMware Infrastructure 3.5 plug-in.

Orchestrator provides the VMware Infrastructure 3.5 plug-in in the following locations after installation:

  • If you have installed Orchestrator by using the standalone installer:
  • If you have installed Orchestrator together with vCenter Server:

Internationalization (I18N) Support

vCenter Orchestrator 4.0.4 complies with I18N Level 1. Although Orchestrator is not localized, it can run on non-English operating systems and handle non-English text.

How to Provide Feedback

Your active feedback is appreciated. Provide your feedback through:

  • Support Requests (SRs)
  • Orchestrator Discussion Forum

Support Requests

File all issues that you find as Support Requests (SRs), even if you report them to VMware by other means.

VMware Support's commitment to SRs filed by customers and instructions on how to file an SR can be found at http://www.vmware.com/support/services/.

Experienced SR users can file support requests at http://www.vmware.com/support/sr/sr_login.jsp.

Use your registered VMware store account to log in.

Include log files in your SRs. To gather log files from Orchestrator:

  1. Go to the Orchestrator configuration interface at http://orchestrator_server_ip_address:8282.
  2. Log in with your username and password.
  3. Click Logs.
  4. Click Generate log report.
  5. Save the generated ZIP file.
  6. Upload the saved ZIP file to VMware Support.

For Orchestrator configuration issues, include an exported configuration file in your SRs. To export your configuration from the Orchestrator configuration interface:

  1. Go to the Orchestrator configuration interface at http://orchestrator_server_ip_address:8282.
  2. Log in with your username and password.
  3. Click General.
  4. Click the Export Configuration tab.
  5. Type your password and press Enter.
  6. Save the *.vmoconfig file.
  7. Upload the saved files to VMware Support.

Orchestrator Discussion Forum

View the Orchestrator forum at http://communities.vmware.com/community/vmtn/mgmt/orchestrator. Use your registered VMware store account to log in.

Prior Releases of vCenter Orchestrator

Features and issues from earlier releases of vCenter Orchestrator are described in the release notes for each release. To review release notes for earlier releases of vCenter Orchestrator, click one of the following links:

Resolved Issues

The following issues have been resolved in the Orchestrator 4.0.4 release:

  • The library used in the SSH plug-in is updated
    The library used in the SSH plug-in is updated (Jcraft jsch version from 0.1.29 to 0.1.42) to provide the following new capabilities
    • attribute Boolean property to SSHSession object
    • attribute string terminal to SSHSession object
    • method addEnvironment(string key, string value) to SSHSession object

Known Issues

The known issues in this Orchestrator release are grouped as follows:

Installation Issues
  • Restarting vCO server service after reinstalling plug-ins adds Java exceptions to the logs
    In the Troubleshooting tab of the Orchestrator configuration interface, if you reinstall plug-ins by clicking Reset current version and then restart the Orchestrator server, several Java exceptions are written to the Orchestrator server logs.

Internationalization Issues

  • Problems handling non-ASCII characters in certain contexts
    Using non-ASCII characters in input parameters results in incorrect behavior in the following contexts:
    • If you run the SCP put or SCP get workflows on a file with a name that contains non-ASCII characters, the workflow runs, but name of the resulting file on the destination machine is garbled.
    • If you try to insert non-ASCII characters into attribute names, the characters do not appear. The issue occurs for Web view attributes, workflow attributes and action attributes.
Upgrade Issues
  • Client-only upgrade shows incorrect version number in the configuration interface

    If you have an existing Orchestrator installation of both the client and the server on the same machine, and you use the standalone Orchestrator installer to upgrade the client by selecting Client-Only, after the upgrade the Orchestrator configuration interface shows the version number of the new client installation. This is incorrect. The server has not been upgraded.

  • SSL certificate is lost during upgrade from 4.0 to 4.0.1

    If you upgrade an existing Orchestrator 4.0 installation to 4.0.1, and import the configuration of the previous installation in the 4.0.1 installation, the SSL certificate from the old installation is not loaded. The Server Certificate tab shows red in the configuration interface.

    Workaround: You must import the certificate manually.

Networking Issues
  • Loss of network connection to vCenter Server 4.0 can cause workflows to stop
    If Orchestrator loses the network connection to vCenter Server 4.0 while a workflow is running, and if the workflow attempts to access vCenter Server, that workflow stops and does not attempt to restart. Furthermore, the vCenter Server 4.0 plug-in flushes its cache if it loses the connection to vCenter Server. Consequently, when the Orchestrator server restarts, it fetches all running objects again from the vCenter Server rather than reloading them from the cache. Fetching the objects again can cause peaks in CPU usage, and increases the load on vCenter Server. An intermittent connection to vCenter Server causes frequent workflow failures. If the network connection to vCenter Server is intermittent, then constantly fetching the objects can consume vCenter Server memory, leading to drops in performance.

    Workaround: Ensure that the network connection to vCenter Server is stable.

Configuration Issues
  • Orchestrator does not work with forest and external trusts in Active Directory

    Multiple domains that have a two-way trust, but are not in the same tree, are not supported and do not work with Orchestrator. The only configuration supported for multi-domain Active Directory is domain tree. Forest and external trusts are unsupported.

  • SSL server certificate is overwritten if no new SSL server certificate was installed
    When you upgrade to Orchestrator 4.0.3, the SSL server certificate is overwritten in case you have not created a new self-signed certificate, or if you have not installed a certificate signed by a Certificate Authority. The certificate is overwritten with a newly generated certificate. For more information about replacing and installing certificates, see the VMware vCenter Orchestrator Installation and Configuration Guide.
  • Support for TNSNames missing when you connect to an Oracle database
    You cannot use TNSNames to connect to an Oracle database. You can connect to an Oracle database using an IP address or a DNS name.

    Workaround: Add support for RAC and TNS configuration for Oracle 11g Database instances to vCenter Orchestrator (KB 1022828).

  • Restricted access to vCenter Server inventory can cause errors if Session per user is set
    If you select the Session per user option in the vCenter Server tab of the configuration interface, accessing the vCenter Server inventory can result in some errors if the connected user has restricted access to inventory objects.
  • No error message is displayed on the Network tab of the Orchestrator configuration interface when a network port is already in use
    The Network configuration is saved successfully without errors even when the port numbers that you enter are already taken on your host.

    Workaround: Make sure the port numbers you enter on the Network tab are free.

Miscellaneous Issues
  • Possible loss of logs when using vmo.bat file to restart the Orchestrator server

    If you start the Orchestrator server as a service and you try to restart it by running the vmo.bat file directly, you can experience a potential loss of logs. The loss of logs is due to the Orchestrator server potentially running with different permissions.

    Workaround: Do not restart the server by using the vmo.bat file. Start the Orchestrator server as a service as follows:

    1. Right-click My Computer and select Manage > Services and Applications > Services
    2. Right-click VMware vCenter Orchestrator Server and select Start
  • Importing packages using the Orchestrator client might fails

    Occasionally, importing a package by using the Orchestrator client results in the error Unable to import a certificate, reason : Unable to save keystore.

    Workaround: Close the error message and attempt the import again.

  • The Revert option for the parameters table on the Scripting tab of the Edit Actions view does not revert to the last saved state
    When you add a parameter to an action script, you cannot remove it using the Revert option.

    Workaround: Right-click the parameter and click Delete Selected.

  • Characters are accepted as the input value for workflow attributes of number type
    Format validation has been disabled on workflow attributes that are of the number type. Invalid input values are accepted without any warning, and workflows are saved successfully, which can lead to unpredictable results.
  • The Find orphaned virtual machines workflow might detect VMDK files that are used by linked clones

    Some VMDK files that are associated with linked clones in the Orchestrator inventory might be listed as unused by the Find orphaned virtual machines workflow. If you remove these VMDK files, the linked clones become unusable.

  • Changes to input parameter descriptions are not propagated to the presentation
    If you change the description of an input parameter for a workflow, the change is not propagated to the description in the presentation.

    Workaround: Copy the description to the presentation manually.

  • You cannot export policies as templates

    The Export as policy template function is disabled in the Orchestrator client and cannot be used.

  • The Convert disks to thin provisioning workflow does not handle virtual machines with snapshots correctly and does not convert the thick-provisioned disks
    On completion, the Convert disks to thin provisioning workflow reports that the thick-provisioned disks of virtual machines with snapshots are successfully converted to thin-provisioned, when they are actually not.

    Workaround: Do not include virtual machines with snapshots in the workflow.