vCloud Automation Center 6.1 Version Update

April 24, 2016 Ricky Adams

vCloud Automation Center 6.1 Version Update h1,h2,h3,h4,h5,h6,.site-title{ font-family: ‘Open Sans’, sans-serif; }

VMware vCloud Automation Center® 6.1 Release Notes

vCloud Automation Center 6.1 | 09 SEP 2014 | Build 2077124

Updated on: 19 SEP 2014

Check for additions and updates to these release notes.

What’s in the Release Notes

The release notes cover the following topics:

What’s New

Migrating a vCloud Automation Center version 5.2.1 or 5.2.2 deployment to version 6.1

See Migrating to vCloud Automation Center 6.1 in the VMware vCloud Automation Center 6.1 Documentation Center.

Upgrading from vCloud Automation Center 6.0.1 to 6.1

To upgrade from vCloud Automation Center 6.0.1 to vCloud Automation Center 6.1, see Upgrading to vCloud Automation Center 6.1 in the VMware vCloud Automation Center 6.1 Documentation Center.

Platform Support

vCloud Automation Center now supports Windows Server 2012 SP1 R2 (.NET 4.5.1).

Improvements in Reporting

IaaS Chargeback by Allocated Resource by Group report displays cost for blueprint, CPU, memory, storage, days, and totals.

Bulk Imports

Machines are imported with defining data such as reservation, storage path, blueprint, owner, and any custom properties. The following administrative tasks are supported:

Import one or more unmanaged virtual machines so that they can be managed in a vCloud Automation Center deployment.
Migrate one or more managed virtual machines between vCloud Automation Center instances.
Make a global change to a virtual machine property, such as a storage path.

REST API

vCloud Automation Center 6.1 offers the following programmatic interfaces for integrating with external systems:

Verb-oriented REST API that is fully integrated with SSO by using a bearer token mechanism for authentication of requests
Java SDK that provides native Java bindings for the public REST interfaces
Command-line tool for developers that supports scripting and interactive API exploration and troubleshooting
Reference documentation for the API and scenario-based documentation for common use cases such as submitting a service request, approving a request, listing provisioned items, and so on

vCenter Orchestrator plug-in for vCloud Automation Center

The vCenter Orchestrator plug-in for vCloud Automation Center 6.1 includes the following capabilities:

Enables workflow developers to call vCloud Automation Center functions from vCenter Orchestrator workflows
Exposes inventory and enables entities such as catalog items, requests, entitlements, approvals, blueprints, Advanced Service Designer blueprints, and actions to be used in vCO workflows
Enables scripting of vCloud Automation Center maintenance and administration tasks and supports multiple vCloud Automation Center instances simultaneously
Enables creation of administration self-service
Enables transparent SSO authentication and token handling

User Interface Enhancements

The user interface includes the following enhancements:

Advanced search
Display links in tables
Reorder columns
Adjustable column width
Sort order selection
Columns display selection
Actions relocated from drop-down menu to toolbar

vApp Lease Synchronization Between vCloud Director or vCloud Air (formally vCloud Hybrid Service) and vCloud Automation Center

A new scheduled workflow verifies whether synchronization of the vApp lease length is required between vCloud Automation Center and vCloud Director or vCloud Air. If a lease length conflict is found, the lease value is synchronized to match the lease length defined in vCloud Automation Center. Machines provisioned on a vCloud Director or vCloud Air endpoint are prevented from expiring before the lease period specified in vCloud Automation Center is reached.

Advanced Service Designer

Advanced Service Designer includes the following updates:

State-Aware resource actions that allow a service architect to define how resource actions such as Discard, Provision, or Change, affect the lifecycle of a resource.
vCenter Orchestrator plug-in that enables scripting of vCloud Automation Center, including Catalog, Approvals, Entitlements, Advanced Service Designer, and other entities.
Any IaaS resource type can be extended with Advanced Service Designer resource actions.
Feedback is provided to the user on the state of their requests.

Application Services (Formerly VMware vCloud Application Director)

Application Services, is now a component of vCloud Automation Center 6.1. To upgrade from Application Director 6.0.1 to vCloud Automation Center Application Services 6.1, see Using Application Services in the VMware vCloud Automation Center 6.1 Documentation Center.

Marketplace access is not available in vCloud Automation Center Application Services 6.1.

Application Services includes the following updates:

Logical network mapping to vCloud Automation Center pre-existing networks
- Enables Application Services network mapping in a deployment profile to pre-existing networks in vCloud Automation Center reservations
- Displays network details from vCloud Automation Center to ensure proper selection for the application blueprint
- Enables mapping pre-existing networks to logical networks for each application
Composite deployment profiles let you perform the following actions:
- Model and manage composite application blueprints
- Model composite applications by linking Deployment Profiles of separate application blueprints
- Define the sequence for deployment and property bindings across different blueprints
Application Services catalog renamed to Application Services library
Enables scale out, scale in, and teardown for regular applications in the vCloud Automation Center service catalog
Artifact management
- Manages the physical build files and other software artifacts required by applications at different stages of deployment.
- Allows deployment settings to specify artifacts by name only rather than by location, which can change.
Leverages new property types, Integer, Boolean, and List of Values, when modeling application services and blueprints that allow user-friendly consumption in the vCloud Automation Center service catalog.
Multitenancy
- Application Services can be registered to a multitenant vCloud Automation Center server
- Different vCloud Automation Center tenants can be accessed from Application Services by using tenant-based URLs, similar to vCloud Automation Center
- Application Services dynamically fetches business groups, roles, and users from vCloud Automation Center
When Application Services fails a deployment, the user is provided with the following options to resume from deployment errors:

Re-execute the last failed component
Delete the failed node
Edit or review the configuration and resume

vCloud Automation Center and Application Services
- Allows consumers to own a requested application stack, including underlying machines
- Allows the management of actions for applications in the library
Puppet integration
- Provides actions for puppet-based deployments
- Enables Windows support for puppet applications
- Provides tighter Puppet integration by including the following updates:
  - Ability to create multi-tier applications in Windows blueprints
  - Enables deployments to be updated with Puppet content
  - Enables teardown of Puppet deployments to remove registered nodes from the Puppet server
  - Enables scale out and scale in deployments with Puppet content
  - Enables customization of the Puppet agent, which includes the environment variable and the frequency at which the puppet agent runs
  - Enables support up to Puppet Enterprise 3.2.3 and Puppet Open Source 3.6.2
Data refresh
- Duplicates the databases in production without increasing storage costs
- Refreshes the external database backups in a golden database node, masks data in the golden database, and clones any number of database nodes from the golden database node
Deployment

Provides the ability to stop an ongoing Application Services deployment

Run custom task update

Lets users run arbitrary custom tasks in an existing deployment without changing any component properties

NSX for vSphere Integration

NSX for vSphere integration includes the following updates:

Connectivity
- Connects the vCloud Automation Center multi-machine service to pre-created NSX for vSphere logical distributed router to optimize for east-west traffic
- Supports NSX for vSphere edge router, which adds overlapping IP addresses across applications and other benefits
Security
- Isolates multi-machine service to allow traffic only between virtual machines in a multi-machine service as a default option with NSX for vSphere.
- Selects pre-created NSX for vSphere security policies, including support for NSX for vSphere distributed firewall, NSX for vSphere data security and third-party endpoint and networking security solution, for each component blueprint in multi-machine service. An on-demand security group container is created, and specified security policies are applied at deployment time.
- Selects NSX for vSphere Security Tags for dynamic NSX for vSphere security group membership, for example, Database servers, PCI, and so on.
Availability
- Provides support for NSX for vSphere load balancer in addition to vCloud Networking and Security load balancer
- Allows the dynamic creation of on-demand NSX for vSphere load balancer instance in a one-armed model
- Supports third-party NSX for vSphere Partner Load Balancing services
Extensibility
- All NSX for vSphere and vCloud Networking and Security integration is now through vCenter Orchestrator (vCO) plug-in, including previously released and new functionality
- Improved extensibility through vCO enablement

NSX for vSphere and vCloud Networking and Security vCenter Orchestrator workflows can be defined as actions in vCloud Automation Center Advanced Service Designer.

Internationalization

Localization support in the user interface depends on your browser settings. See the documentation for your browser for details.

The following components are localized:

Self-service catalog
Consumer and administration user interfaces for date, time, number, and currency formats
Language preference for notifications

The following user interface components are not localized:

IaaS administrative user interface
Application deployment and update forms in Application Services are in English and not the language that is set in the browser
vCloud Automation Center Appliance management console

If the locale selected for the server is different from the locale selected in the browser, a mix of languages appears in the user interface. To avoid seeing multiple languages in the user interface after you log in as an administrator, set the administrator’s browser’s language to US English.

The following documents are localized:

Release Notes
Changes from vCloud Automation Center 5.2
Foundations and Concepts
Using Application Services

vClould Automation Center is available in the following languages:

Dutch
French
German
Italian
Japanese
Korean
Portuguese (Brazilian)
Simplified Chinese
Spanish
Traditional Chinese
Russian
US English

System Requirements and Installation

For information about supported host operating systems, databases, and Web servers, see the vCloud Automation Center Support Matrix.

For additional prerequisites and installation instructions, see vCloud Automation Center Installation and Configuration in the VMware vCloud Automation Center 6.1 Documentation Center.

Documentation

The vCloud Automation Center documentation set includes updates to support all of the new features and functionality introduced in version 6.1. This includes significant improvements in the installation process to deploy vCloud Automation Center in a distributed configuration, see Distributed Deployment Checklist in the VMware vCloud Automation Center 6.1 Documentation Center.

To access the full set of vCloud Automation Center 6.1 documentation, go to the VMware vCloud Automation Center 6.1 Documentation Center.

Resolved Issues

The resolved issues are grouped as follows:

Installation and Upgrade

Requirement for .NET 4.5 does not extend to .NET 4.5.1
.NET 4.5.1 is now supported.

This issue is resolved.
After patch upgrade, machines might need to be re-entitled
When the 6.0.1 upgrade is installed, the entitlement for the action Connect by Using Virtual Desktop is removed for virtual machines.

This issue is resolved.
Upgrading from vCloud Automation Center 6.0 to 6.0.1 resets the specified external vCenter Orchestrator to the embedded vCenter Orchestrator
When the system administrator ( administrator@vsphere.local This email address is being protected from spambots. You need JavaScript enabled to view it. ) configures an external vCenter Orchestrator, the configuration is erroneously reset to the embedded vCenter Orchestrator after the upgrade process completes.

This issue is resolved.
Modifications made to postgresql.conf are lost after upgrade to 6.0.1.1
Any modifications that you have made to the storage/db/pgdata/postgresql.conf file are lost when you upgrade from 6.0.1 to 6.0.1.1. Only the VA on which the database is installed is able to access it by using the localhost.

This issue is resolved.

Internationalization

The Windows Preinstallation Environment (WinPE) builder fails to build if the ISO name or path contains high or extended ASCII characters for German and French locales
The error message “The WinPE ISO failed to build. Please ensure there is enough disk space available for the build.” appears if the ISO name or path contains high or extended ASCII characters in German and French locales. The resulting file name contains characters that cannot be read.

This issue is resolved.

Advanced Service Designer

Advanced Service Designer conditions are not applied to or triggered for fields that contain a defined default value
When creating a conditional constraint between fields in Advanced Service Designer, the constraint is not triggered if a defined default value must be used when none of the conditions is met. As a result, some auto-calculated fields are not populated with their expected values. This behavior manifests somewhat differently depending on whether a field is added in the vCloud Orchestrator presentation or in Advanced Service Designer. This issue is resolved.

Configuration and Provisioning

Names of custom menu operations are displayed incorrectly on Entitlements page and Actions menu
When you register a new menu operation created by using vCloud Automation Center Designer, the display name for the new menu option appears in the Blueprint page, but the workflow name (for example, WF Machine Menu 1), rather than the display name, appears in the Entitlements page and the Actions menu in the catalog.

This issue is resolved.
Malformed security token error appears when you suspends and restores client machine
When a client machine is suspended and then restored after 7 or 8 hours of inactivity, an error message about a malformed security token shell appears.

This issue is resolved.
Hyper-V System Center Virtual Machine Manager (SCVMM) data collection fails on Windows Server 2012
Data collection fails when using the Microsoft System Center Virtual Machine Manager (SCVMM) on an installation of Windows Server 2012 that has been enabled for IaaS.

This issue is resolved.
Provisioning fails when the VirtualMachine.Host.TpmEnabled custom property is set to True
Provisioning fails when using the VirtualMachine.Host.TpmEnabled custom property set to True in a blueprint that is used to provision vSphere virtual machines on hosts that are TPM-enabled.

This issue is resolved.
Daily costs for vApps and multi-machine services do not appear in reclamation reports
vApp and multi-machine container blueprint daily costs are not accounted for in the IaaS reclamation reports. The daily cost values do not appear in the reclamation report savings column.

This issue is resolved.
Approval requests result in an error when the approver is not a member of any business group or is a member of a different business group
If an approval request is sent to a user who is not a member of the same business group as the requester, or is not a member of any business group, an Exception has been thrown error occurs when the approver clicks View Request on the Approval page. However, the approver should be able to see the request.

This issue is resolved.
Unable to dispose of multi-machine service when orphaned NSX edge is using network
If an NSX edge is not registered in the vCloud Automation Center environment, probably due to an NSX error, and if that edge is using the external network associated with the routed gateway of a multi-machine service, then an attempt to dispose of that service fails with multiple AppServiceDisposeVM workflow timeouts.

This issue is resolved.
DHCP must be enabled with Private or NAT networks
If DHCP is not enabled on a Private or NAT network profile within a multi-machine blueprint, the different multi-machine components cannot communicate with each other.

This issue is resolved.
Provisioning of multi-machine blueprint fails if security group is specified as a custom property
When working with multi-machine services, you cannot add machines to a security group if the security group name is specified as a custom property in the multi-machine blueprint. If you add a machine to a security group whose name is specified as a custom property in the multi-machine blueprint and attempt to provision the machine, the error message Request Failed: (machine name): Failed to assign one or more network and security settings. appears.

This issue is resolved.
Unable to differentiate between the different destroy approval policies
After navigating to Administration > Approval Policies and clicking the + icon, the different destroy action approval policy types are not classified according to the type of the endpoint.

This issue is resolved.
The custom property, VirtualMachine.Admin.OverrideVncConsole, is deprecated
The VirtualMachine.Admin.OverrideVncConsole that was used to specify how the consoles of virtual machines are accessed for KVM (RHEV) is no longer supported and was removed from the Custom Properties document. You can no longer select the type of console, and can use only the default of VNC.

This issue is resolved.
A tenant administrator cannot reclaim a machine
The Change Lease action does not appear to tenant administrators when they attempt to reclaim a machine.

This issue is resolved.
Machines are not properly destroyed in the provisioning platform when prematurely destroyed in vCloud Automation Center
If you start provisioning a machine in vCloud Automation Center, and before it is completely provisioned you destroy it, the machine might be destroyed and deleted from vCloud Automation Center without any errors or warnings. In some cases, the machine is provisioned in the provisioning platform although it is not under vCloud Automation Center management.

This issue is resolved.
Secure Shell (SSH) connection fails to connect without a fully qualified domain name (FQDN)
Making an SSH connection without a specified FQDN fails.

This issue is resolved.
Attempts to open the Infrastructure tab fail when the administrator is a member of several hundred groups
When using Active Directory and SSO, an IaaS administrator who is a member of many groups might be unable to view the Infrastructure tab. Attempting to do so might result in one of the following errors:
- Bad Request – Request Too Long – HTTP Error 400. The size of the request headers is too long.
- Service Unreachable – A required service cannot be reached at the expected address. Contact your system administrator for assistance. Reference error REPO404.

This issue is resolved.

The message that appears when a virtual machine import fails is ambiguous
When a business group manager with fabric administrator rights attempts to import a machine, if the import operation fails, the machine is not deleted from the hypervisor. However, the user event Machine name: has been destroyed! appears. In this situation, the machine is only destroyed in vCloud Automation Center, but remains viable on the hypervisor.

This issue is resolved.
Network configuration is not applied when cloning from a vApp template with network set to “None”
If a blueprint references a vApp template in vCloud Director or vCloud Air (formerly vCloud Hybrid Service) that has a network set to “None,” the vApp is provisioned successfully but does not connect to the network specified in the vCloud Automation Center blueprint or reservation.

This issue is resolved.

Known Issues

The known issues are grouped as follows:

Known issues not previously documented are marked with the * symbol.

Installation and Upgrade

No message to restart the Identity Appliance after upgrade
Workaround: Restart the identity virtual appliance after upgrade for identity virtual appliance to work properly.
Order of upgrade for vCloud Automation Center and Application Director or IT Business Management, Standard Edition
If you are using vCloud Automation Center with VMware Application Director or VMware IT Business Management Standard Edition, you must ensure that all products are at the same patch level. Install the vCloud Automation Center upgrade before you install upgrades for Application Director or IT Business Management Standard Edition.
The vCloud Automation Center database cannot be installed to a custom directory by using the installation wizard
In a distributed (custom) installation, the installer ignores changes you make to the default database and log directory. The database and logs are created in the default directory.

Workaround: To install your database to a non default location, install the database using the DBinstall scripts before installing vCloud Automation Center.
Manual clean up is required after a failed installation*
When you uninstall a partially installed IaaS component and run a new installation, you might see errors similar to the following:
- The application repository exists.
- The vcac application pools exist.
- The 443 port is already in use.

Workaround:

Uninstall IaaS and related components from the Programs and Features box on your Windows server.
Start IIS Manager and delete the repository, vcac, wapi, and vcacreports sites.
Delete vcac application pools from IIS.
From the IIS Manager, remove the port binding to port 443.

IaaS Authentication Fails During IaaS Web and Model Management Installation due to an issue in IIS*
When running the Prerequisite Checker, the message that the IIS authentication check failed because authentication is not enabled appears, but the IIS authentication check box is selected.

Workaround:
1. Clear the Windows authentication check box.
2. Click Save.
3. Select the Windows authentication check box.
4. Click Save.
5. Rerun the Prerequisite Checker.
Single Sign-On certificate validation fails if the common name contains an uppercase letter*
When you assign a certificate to a Single Sign-On appliance, all strings are converted to lowercase. Because the validation process is case sensitive, the process fails because the certificate name contains an uppercase letter and the validation process is searching for a name in all lowercase.

Workaround: When you specify the SSO host address at vCAC Appliance > vCAC Settings > SSO, enter the address with the capitalization used when the certificate was assigned to the SSO appliance.
Installation fails when an incorrect host name is specified*
Installation fails with an error similar to the following:
Info : 2014-06-17 10 42 32 059 AM : System.AggregateException: One or more errors occurred. —> System.Net.Http.HttpRequestException: An error occurred while sending the request. —> System.Net.WebException: The remote name could not be resolved: ‘po-va-rtq8c.sqa.local’Cause: Cause: An incorrect name was entered in the VCAC HostName field at vCAC Settings > Host Settings.

Workaround:
1. Edit the virtual appliance configuration file /etc/sysconfig/network/dhcp to include the correct host name.
2. Reboot the virtual appliance.
3. Log in to the virtual appliance management console.
4. Open the vCAC Settings tab and click Host Settings.
5. Enter the correct name in the vCAC Host Name text box.
6. Click Save Settings.
  Note: Do not click Resolve Host Name.
7. Complete the virtual appliance configuration steps and continue with the installation.

Migration

Pre-migration erroneously reports that agents are missing in target system
Pre-migration performs a check to verify that agent names in the source system are present in the target system and it generates a message in the report when there is a mismatch. The pre-migration report might include the message, No matching agent found on the target system. Install an agent with a matching name on the target system, even when a matching agent exists in the target system.

The message is generated, in error, if a matching agent is present in the target system but that agent has no endpoint configured.

Workaround: If the message appears in the pre-migration report and a matching agent does exist in the target system, configure an endpoint for the agent in the target system and then rerun pre-migration. Otherwise, ignore the message and configure an endpoint when migration finishes.

Internationalization

Guest agent custom scripts that contain unicode characters remain in an infinite loop*
If you use custom scripts with the guest agent that have unicode characters in the name of the script, the VM is not provisioned and the request remains in an infinite loop.

Workaround: Do not include unicode characters in the name of your script.
Non-ASCII job name for Jenkins artifact repository causes application deployment to fail*
If you assign a non-ASCII value to the JOB_NAME property of an artifact repository instance that is created from the supplied Jenkins artifact repository specification, and if you then deploy an application with a blueprint that uses an artifact located in that artifact repository instance, the deployment fails with an error message that starts with “Run failed due to failure of task….”

Workaround: Use only ASCII characters in a Jenkins job name.

Networking

Various issues exist with vCloud Automation Center and VMware NSX integrations.
If you are integrating vCloud Automation Center and VMware NSX, see KB 2088172 for more information on how to resolve known issues.
IP ranges in routed network profiles are listed as allocated although no IP addresses are in use
If a multi-machine blueprint contains the routed external network profile but not an assignment for the routed network to component network adapters, machines are provisioned successfully but an IP address range from the routed network profile is allocated and not actually in use.
Incorrect network setting displayed for virtual multi-machine component in vCloud Automation Center after network reconfigured in vCenter
You cannot reconfigure the vCloud Networking and Security (NSX) network of a virtual multi-machine component in vCloud Automation Center. Instead, you must use the vSphere Client to reconfigure the network in vCenter. Note that some network settings for the virtual multi-machine component do not appear correctly in vCloud Automation Center.

Workaround: Update the network in vCenter Sever to restore proper network settings.
vCloud Networking and Security inventory synchronization fails and an error message appears*
When you delete a transport zone that is assigned to a vCloud Automation Center reservation, a multi-machine blueprint, or a multi-machine instance from the VMware NSX user interface, vCloud Networking and Security inventory synchronization fails and an error message appears. The details of the error message depends on the entity that is using the transport zone.

Workaround:
1. Unassign the transport zone from the vCloud Automation Center reservation or multi-machine blueprint.
2. Delete the multi-machine instances provisioned with the transport zone.
3. Repeat the vCloud Networking and Security inventory synchronization process.
Renaming, editing, or viewing an existing VMware vCenter Orchestrator or VMware vSphere endpoint with configured custom properties causes vCloud Automation Center to remove the hidden custom properties from the database*
Without the endpoint hidden custom properties users cannot run the VMware vCloud Networking and Security plug-in workflows.

Workaround: Perform data collection process on the endpoint to restore all the hidden custom properties in the database for that endpoint.

Application Services

Unable to publish a blueprint from Application Director to vCloud Automation Center catalog by using vCloud Automation Center 6.1 version
If you upgrade to vCloud Automation Center 6.1 from 6.0.1 and then attempt to publish a blueprint to the vCloud Automation Center catalog, the error message An unexpected error has occurred. Please contact you system administrator appears. This problem does not occur for newly registered instances of Application Director with vCloud Automation Center 6.1 version.

Workaround: Unregister Application Director 6.0.1 from vCloud Automation Center 6.1 and then register Application Director again with vCloud Automation Center.
Access denied for fabric administrator destroying cross-tenant Physical, Application Service
Fabric administrators receive an Access Denied message when destroying cross-tenant Physical, Application Service.

Workaround: Log in as a fabric administrator of the fabric group in the tenant where the machine resides to destroy it.

vCloud Automation Center does not support multiple hosts in the system with the same name
Data collection updates hosts based on the host name. If two endpoints have identically named hosts, endpoints contend over ownership of the host.

Workaround: Ensure that all host names are unique.
In Application Services, you cannot add a description to a disk in a blueprint canvas*
If you are using Windows Internet Explorer 11, you cannot add a description to a disk on the Disks tab of a blueprint canvas.

Workaround: To add a description to a disk in a blueprint canvas, you must use Chrome or Firefox.
You cannot update nodes that use Puppet services deployed with Application Director 6.0.1*
Application Services 6.1 does not support the updating of nodes that use Puppet services that were deployed with Application Director 6.0.1. Application Services 6.1 creates a Puppet node manifest that allows you to update specific services, but it is not compatible with the node manifest files generated in Application Director 6.0.1.

Advanced Service Designer

Unable to find vSphere or vCloud Director virtual machines by unique identifier using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 or directly in vSphere API*
The Workflow Runner helper workflow might fail to locate the VC:VirtualMachine inventory object. As a result, custom workflows invoked by the Workflow Runner workflow might fail with the error: TypeError: Cannot read property “datastore” from null. The VMUniqueID virtual machine entity property is changed from BiosUUID to InstanceUUID.

Workaround: For more information on how to resolve this issue, see KB 2088838.
Number maximum value and String maximum length conditions are not populated from vCenter Orchestrator in the Advanced Service Designer form
When a service architect creates a blueprint form in Advanced Service Designer and loads a vCenter Orchestrator workflow that contains a number field with an associated maximum value condition or contains a string field with an associated maximum length condition, the restrictions applied to these fields do not appear in the Constraints tab on the blueprint.

Workaround: The service architect should re-enter the constraints manually as follows:
1. Click the Edit option for the input parameter.
2. Click the Constraints tab.
3. Insert a restriction for the Maximum value if the parameter is a number or Maximum length if the parameter is a string.

Cannot create a service blueprint or resource action in the Advanced Service Designer when selecting a workflow that has an input of a string array type with a predefined answers action that could return null*
In the Advanced Service Designer, during creating a service blueprint or resource action, if you select a vCenter Orchestrator workflow that has an input parameter of a string array type with a predefined answers property in the presentation that calls a scripting action that could return null, when you click Next, the procedure fails and the following error message is displayed:Internal ErrorAn internal error has occurred. If the problem persists, please contact your system administrator.When contacting your system administrator, use this reference: …

Workaround: From the Design perspective of the vCenter Orchestrator client, edit the predefined answers action by replacing null with an empty array. For example, if the action scripting code is:

if (someCondition) {

return [“a”, “b”, “c”];

} else {

return null;

}

You must change the code to:

if (someCondition) {

return [“a”, “b”, “c”];

} else {

return [];

}

Unable to refresh submission form fields when requesting some catalog items with detected cyclic dependencies published by using the Advanced Service Designer*
When all input parameters of a vCenter Orchestrator workflow have OGNL dependencies or validations, if you use this workflow to create and publish a service blueprint, when consumers request the catalog item, the form designer does not refresh the submission form fields because of detected cyclic dependencies. Example for cyclic dependency is when you have two input parameters and the value of every field depends on the value of the other field.

Workaround: Edit the service blueprint submission form by adding a hidden field.
Resource actions for Hyper-V, SCVMM, and XenServer virtual machines might fail if based on resource mapping workflows that query the EXTERNAL_REFERENCE_ID property*
If you create a resource mapping for a Hyper-V, SCVMM, or XenServer virtual machine based on a resource mapping workflow that queries the EXTERNAL_REFERENCE_ID property, when a resource action runs the workflow, it fails because the EXTERNAL_REFERENCE_ID property is not set in the Properties object passed to the workflow.

Workaround: When creating resource mapping workflows for Hyper-V, SCVMM, and XenServer virtual machines query one of the other properties that are passed for the individual machines such as name, description, and so on.

Configuration and Provisioning

Attempts to log in as the IaaS administrator with incorrect UPN format credentials fails with no explanation
If you attempt to log in to vCloud Automation Center as an IaaS administrator with UPN credentials that do not include the @yourdomain portion of the user name, you are logged out of SSO immediately and redirected to the login page with no explanation.

Workaround: The UPN entered must adhere to a yourname.admin@yourdomain format, for example if you log in using jsmith.admin@sqa.local This email address is being protected from spambots. You need JavaScript enabled to view it. as the user name but the UPN in the Active Directory is only set as jsmith.admin, the login fails. To correct the problem change the userPrincipalName value to include the needed @yourdomain content and retry login. In this example the UPN name should be jsmith.admin@sqa.local This email address is being protected from spambots. You need JavaScript enabled to view it. . This information is provided in the log file in the log/vcac folder.
Email template customization behavior has changed and extraneous templates are unusable
In vCloud Automation Center 6.0 or later, only notifications generated by the IaaS component can be customized by using the email template functionality from earlier versions.

Workaround: You can use the following XSLT templates:

ArchivePeriodExpired
EpiRegister
EpiUnregister
LeaseAboutToExpire
LeaseExpired
LeaseExpiredPowerOff
ManagerLeaseAboutToExpire
ManagerLeaseExpired
ManagerReclamationExpiredLeaseModified
ManagerReclamationForcedLeaseModified
ReclamationExpiredLeaseModified
ReclamationForcedLeaseModified
VdiRegister
VdiUnregister

Email templates are located in the \Templates directory under the server installation directory, typically %SystemDrive%\Program Files x86\VMware\vCAC\Server. The \Templates directory also includes XSLT templates that are no longer supported and cannot be modified. For more information about configuring notifications, see Configuring Notifications in VMware vCloud Automation Center Documentation.

Access to embedded vCloud Orchestrator server impacted by changes to its administration group
When the administration group of the embedded vCloud Orchestrator server is changed, the server can no longer be used in embedded mode.

Workaround: Use basic authentication to configure the vCloud Orchestrator server as an external server.

Actions on provisioned machines are marked complete before they finish
Actions such as Reprovision or Power Off might appear as Complete on the Requests page when the operation might still be in progress. The actual status of the machine is reflected on the Items page.
Guest agent file SCCMPackageDefinitionFile.sms needs to be updated
The guest agent file SCCMPackageDefinitionFile.sms contains outdated name and publisher information. This does not affect functionality.
Lease dates can be changed to fall outside of the Approval Policy value
Lease dates can be changed by using the Change Lease resource action to a date that is later than the maximum lease range specified on the blueprint.
Deleted custom groups are not removed from entitlements*
When a custom group that is linked to an entitlement is deleted, the custom group is not removed from the entitlement.

Workaround: To delete a custom group and to remove it from the entitlement:

Remove the custom group from the entitlement.
Delete the custom group.

Removing the business group role from a custom group does not revoke entitlements*
When a custom group that is linked to an entitlement is removed from the business group role, the custom group is not removed from the entitlement.

Workaround: To remove the business group role from a custom group and to delete it from the an entitlement:
1. Remove the custom group from the entitlement.
2. Remove the custom group from the business group role.
Hyper-V endpoint is incorrectly listed as an unmanaged machine in Infrastructure Organizer*
When a Hyper-V endpoint fails to provision, vCloud Automation Center reports the machine as destroyed, but it remains on the endpoint, and appears as an unmanaged machine in Infrastructure Organizer.
When provisioning a Citrix XenDesktop/Provisioning Service machine, the machine remains in the Unprovisioning state*
This issue can occur with the VMware VDI agent, and any version of the VMware EPI agent, such as, Citrix, BMC, Opsware, VBScripts, and so on. It can also occur at various points throughout the master workflow machine provision cycle.

It is possible that the agent was installed to use a specific server name rather than left blank to handle all third party server requests. If a specific server name is entered, this agent can handle requests only for a server that exactly matches that server name. vCloud Automation Center uses the value in the custom properies EPI.Server.Name or VDI.Server.Name to locate a corresponding agent to handle the request. If no matching agent is found, the machine remains in the EPIRegister/Machine Provisioned state during provisioning, or the Unprovisioning/DeactivateMachine state, until a corresponding agent is found.

Workaround: Install a new EPI/VDI agent where the server value is exactly what was entered in EPI.Server.Name/VDI.Server.Name, or leave the server name blank.
Optionally, you can update the agent config file of your current agent and change the server value by completing the following steps.
1. Back up your agent config file, typically located at C:\Program Files (x86)\VMware\vCAC\Agents\agentName\VRMAgent.exe.config.
2. Open a text editor as an administrator.
3. To make the change for any agent type, replace SERVER_NAME_VALUE with your server name, or delete it to leave it blank.
  epiIntegrationConfiguration epiType=”CitrixProvisioning” server=”SERVER_NAME_VALUE”
  vdiIntegrationConfiguration vdiType=”XenDesktop” server=””X
4. Save your changes.
5. Restart your agent service.

XenDesktop machine registration times out if not completed in under 2.5 minutes*
The value of $regTries in the XenDesktopFunctions script needs to be increased.

Workaround:
1. Back up your XenDesktopFunctions.ps1 script, typically located at C:\Program Files (x86)\VMware\vCAC\Agents\\Scripts\XenDesktopFunctions.ps1.
2. Open Notepad as an administrator.
3. Increase the value in $regTries to the number of minutes you want to wait before registration times out.
  For example, $regTries = 60 sets the time out to 30 minutes.
4. Save your changes.
5. Restart your VDI agent service.

Approvals that were active before upgrading to 6.1 do not appear after upgrade*
When you navigate to Inbox > Approvals, the default filter is set to Active and none of the active approvals appear. If you filter by any status other than All, none of the approvals that were active before upgrading to 6.1 appear.

Workaround:To view active approvals, filter by selecting All.

Upgrading to vCloud Automation Center 6.1

Upgrading to vCloud Automation Center 6.1 tells you how to download and install updates to upgrade VMware vCloud Automation Center 6.0.1.x to vCloud Automation Center 6.1.

vCloud Automation Center 6.0.1.x includes vCloud Automation Center 6.0.1 and subsequent hot fixes.

Note

Not all features and capabilities of vCloud Automation Center are available in all editions. For a comparison of feature sets in each edition, see https://www.vmware.com/products/vcloud-automation-center/.

Intended Audience

This information is intended for experienced Windows or Linux system administrators who are familiar with virtual machine technology and datacenter operations.

VMware Technical Publications Glossary

VMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions of terms as they are used in VMware technical documentation, go to http://www.vmware.com/support/pubs.

Updated Information

This Upgrading to vCloud Automation Center 6.1 guide for vCloud Automation Center is updated with each release of the product or when necessary.

This table provides the update history of the Upgrading to vCloud Automation Center 6.1 guide.

Revision	Description
EN-001443-01	Migration topics for Application Services have been moved to Using Application Services.
	Order of upgrade for vCloud Automation Center and VMware vCenter Orchestrator when using an external vCenter Orchestrator appliance in a deployment added to the topic Prerequisites for Upgrading to vCloud Automation Center 6.1.
	Add information on disconnecting some virtual appliances from a load balancer while updating multiple virtual appliances. See Install the Update on the vCloud Automation Center Appliance.
EN-001443-00	Initial release.

Upgrading to vCloud Automation Center 6.1

Upgrading is a multistage process in which procedures must be performed in a particular order. Follow the suggested processes to ensure a smooth upgrade with a minimum of system downtime.

Subtopics

Checklist for Upgrading to vCloud Automation Center 6.1

Prerequisites for Upgrading to vCloud Automation Center 6.1

Checklist for Upgrading to vCloud Automation Center 6.1

Upgrading is a multistage process in which you upgrade virtual appliances, vCloud Automation Center databases, and IaaS services.

The Upgrade to vCloud Automation Center 6.1 Checklist provides a high-level overview of upgrade tasks.

Print out a copy of this checklist and use it to track your work as you complete the upgrade. Complete the tasks in the order in which they are given.

Upgrade to vCloud Automation Center 6.1 Checklist
Notes	Task	Instructions
	Complete and verify all prerequisites for the upgrade.	See Prerequisites for Upgrading to vCloud Automation Center 6.1.
	If you are upgrading a distributed deployment that uses a load balancer, shut down the vco-service on each vCloud Automation Center Appliance.	See Shut Down Services on the vCloud Automation Center Appliance.
	Shut down services on your IaaS Windows Servers.	See Shut Down vCloud Automation Center Services on Your IaaS Windows Server.
	Check for updates to the Identity Appliance from the client management page.	See Downloading Updates.
	Install the 6.1 update on the Identity Appliance.	See Install the Update on the Identity Appliance.
	Check for updates to the vCloud Automation Center Appliance from the client management page.	See Downloading Updates.
	Install the 6.1 update on each vCloud Automation Center Appliance in your installation.	See Install the Update on the vCloud Automation Center Appliance.
	If your site uses clustering, reconfigure cluster settings for each vCloud Automation Center Appliance.	See Recreate vCloud Automation Center Appliance Clusters after Upgrading.

Prerequisites for Upgrading to vCloud Automation Center 6.1

Before you run the upgrade, check that your environment meets the prerequisites for upgrading.

■	Verify that vCloud Automation Center 6.0.1 is fully installed and configured. See the vCloud Automation Center Support Matrix on the VMware Web site.
■	Back up configuration files in the /etc/vcac and /etc/vco directories and all databases.
■	Create a snapshot of your virtual appliances and IaaS servers.
■	If you are using a vSphere SSO, verify that it is a supported version and at the correct patch level. See the vCloud Automation Center Support Matrix for information about supported versions.
■	If your site includes vCloud Automation Center Designer, uninstall it. After the upgrade is finished, install the 6.1 version provided on the VMware Appliance Install download page. See the Extensibility Guide for vCloud Automation Center 6.1.
■	If your deployment uses an external vCenter Orchestrator appliance and it is connected to the Identity Appliance, upgrade vCenter Orchestrator before you upgrade vCloud Automation Center.
■	If you are upgrading a high-availability deployment, a distributed installation that uses a load balancer, follow the instructions in Shut Down Services on the vCloud Automation Center Appliance.
■	Shut Down vCloud Automation Center Services on Your IaaS Windows Server.
■	Perform the upgrade at a time when the system is not in heavy use.

Preparing to Upgrade vCloud Automation Center

You must download updates for the virtual appliances and shut down services on instances of your vCloud Automation Center Appliance and IaaS servers before you begin the upgrade.

Subtopics

Shut Down Services on the vCloud Automation Center Appliance

Shut Down vCloud Automation Center Services on Your IaaS Windows Server

Downloading Updates

Shut Down Services on the vCloud Automation Center Appliance

For high-availability deployments, in which multiple appliances are deployed and configured behind a load balancer, ensure that the vco-server service is disabled on each vCloud Automation Center Appliance before you begin the upgrade.

Important

Do not perform these steps if you are upgrading a minimal deployment.

Prerequisites

All CD-ROM drives you use in your upgrade must be enabled. See the vSphere documentation center for information about adding a CD-ROM drive to a virtual machine in the vSphere client.

Procedure

Disable the vco-server service.

service vco-server stop

chkconfig vco-server off

Perform this step for all instances of vCloud Automation Center Appliance in your deployment.

Stop the vcac-server service on all instances of vCloud Automation Center Appliance except for the first instance you plan to upgrade.

service vcac-server stop

Do not reboot the appliance or start these services until after you have upgraded each vCloud Automation Center Appliance.

What to do next

Shut Down vCloud Automation Center Services on Your IaaS Windows Server.

Shut Down vCloud Automation Center Services on Your IaaS Windows Server

Before you begin the upgrade, shut down services on your IaaS Windows Server.

For distributed installations, shut down vCloud Automation Center services for all servers that are running IaaS services.

Procedure

Select Start > Administrative Tools > Services.

Shut down services in the following order.

a	All VMware vCloud Automation Center agents
b	All VMware DEM workers
c	VMware DEM orchestrator
d	VMware vCloud Automation Center Manager Service

What to do next

Choose a method for downloading the 6.1 update. See Downloading Updates for more information.

Downloading Updates

You can check for updates from the client management page for your appliance and download the updates by using one of several methods.

■

Download Updates from a VMware.com Repository

You can download the update for your virtual appliance from a public repository on the VMware.com Web site.

■

Download Updates from an Internal Repository

If your Internet access is restricted, you can set up your own internal repository for updates, instead of getting updates from a VMware public repository. You can download updates as a zipped update bundle.

■

Download Updates for a CD-ROM Drive

You can update your virtual appliance from an ISO file that the appliance reads from the virtual CD-ROM drive.

Download Updates from a VMware.com Repository

You can download the update for your virtual appliance from a public repository on the VMware.com Web site.

Procedure

1	Go to the management console for your virtual appliance by using its fully qualified domain name, https://va-hostname.domain.name:5480.
2	Log in with the user name root and the password you specified when the appliance was deployed.
3	Click the Update tab.
4	Click Settings.
5	(Optional) Set how often to check for updates in the Automatic Updates panel.
6	Select Use Default Repository in the Update Repository panel. The default repository is set to the correct VMware.com URL.
7	Click Save Settings.

What to do next

■	Install the Update on the Identity Appliance.
■	If you have completed the update to the Identity Appliance or if you use another VMware appliance to support Single Sign-On capabilities, go to Install the Update on the vCloud Automation Center Appliance.

Download Updates for a CD-ROM Drive

Download Updates from an Internal Repository

Procedure

1	Download the zipped update bundle from the VMware.com Web site.
2	Create a repository directory under the root directory on your chosen server.
3	Extract the zipped bundle to the repository directory.
4	Go to the management console for your virtual appliance by using its fully qualified domain name, https://va-hostname.domain.name:5480.
5	Log in with the user name root and the password you specified when the appliance was deployed.
6	Click the Update tab.
7	Click Settings.
8	Select Use Specified Repository in the Update Repository panel.
9	Enter the URL of the repository you created in the Repository URL text box. For example, if the repository directory is vcac_update_repo, the URL should be similar to http://web_server_name.your_company.com/vcac_update_repo.
10	Click Save Settings.

What to do next

■	Install the Update on the Identity Appliance.
■	If you have completed the update to the Identity Appliance or if you use another VMware appliance to support Single Sign-On capabilities, go to Install the Update on the vCloud Automation Center Appliance.

Download Updates for a CD-ROM Drive

Download Updates for a CD-ROM Drive

You can update your virtual appliance from an ISO file that the appliance reads from the virtual CD-ROM drive.

If your CD-ROM drive is not enabled, see the vSphere documentation center for information about adding a CD-ROM drive to a virtual machine in the vSphere client. All CD-ROM drives you use in your upgrade must be enabled before any vCloud Automation Center Appliances are updated.

Prerequisites

Shut Down Services on the vCloud Automation Center Appliance

Procedure

1	Download the update ISO file from the VMware.com Web site.
2	Connect the CD-ROM drive for the virtual appliance you are updating to the ISO file you downloaded.
3	Go to the management console for your virtual appliance by using its fully qualified domain name, https://va-hostname.domain.name:5480.
4	Log in with the user name root and the password you specified when the appliance was deployed.
5	Click the Update tab.
6	Click Settings.
7	Under Update Repository, select Use CD-ROM Updates.
8	Click Save Settings.

What to do next

■	Install the Update on the Identity Appliance.
■	If you have completed the update to the Identity Appliance or if you use another VMware appliance to support Single Sign-On capabilities, go to Install the Update on the vCloud Automation Center Appliance.

Download Updates from an Internal Repository

Installing the Virtual Appliance Updates

After you complete the prerequisites for upgrading and download the update, you install the update for theIdentity Appliance and for all instances of the vCloud Automation Center Appliance.

If you are using another VMware appliance for single sign-on capabilities in place of the Identity Appliance, you do not need to update it.

Subtopics

Install the Update on the Identity Appliance

Install the Update on the vCloud Automation Center Appliance

Install the Update on the Identity Appliance

You install the update on the Identity Appliance before you update the vCloud Automation Center Appliance.

Single sign-on (SSO) hosts are specified differently in vCloud Automation Center 6.0 and 6.1. In 6.0, the host name includes port information. In 6.1, port information is not included when you specify the host name.

Be certain to leave the 6.0 hostname form for remote SSO hosts when you upgrade. This form includes the SSO port suffix, :7444, as part of the name.

Prerequisites

■	Select a download method and download the update. See Downloading Updates.
■	For high-availability deployments, see Shut Down Services on the vCloud Automation Center Appliance.
■	Shut Down vCloud Automation Center Services on Your IaaS Windows Server.

Procedure

a	Go to the management console for your virtual appliance by using its fully qualified domain name, https://va-hostname.domain.name:5480.
b	Log in with the user name root and the password you specified when the appliance was deployed.
c	Click the Update tab.

Click Check Updates to verify that an update is accessible.

Click Install Updates.

Click OK to confirm that you want the update to proceed.

The time it takes for the update to finish is dependent on your site environment.

After the update is installed, reboot the virtual appliance.

a	Click the System tab.
b	Click Reboot and confirm your selection.

Clear the cache of the Web browser used to access the management console.

What to do next

Install the Update on the vCloud Automation Center Appliance.

Install the Update on the vCloud Automation Center Appliance

You install the update on the vCloud Automation Center Appliance after you upgrade and reboot the Identity Appliance. Apply the update to each instance of vCloud Automation Center Appliance that is part of your installation.

Repeat this procedure for each vCloud Automation Center Appliance in your installation. Wait for the reboot to complete on one appliance before starting the upgrade on another.

For deployments that use load balancers, make sure only the upgraded server is active in the load balancer pool and set the appliances you have not yet upgraded to offline or disabled in your load balancer.

For deployments that use clusters, make note of the order in which you upgrade the virtual appliances. The last virtual appliance you update must be the first virtual appliance you specify when you create a cluster after you upgrade the individual virtual appliances.

Prerequisites

■	Select a download method and download the update. See Downloading Updates.
■	For high-availability deployments, Shut Down Services on the vCloud Automation Center Appliance.
■	Verify that the identity server is running.

Procedure

a	Go to the management console for your virtual appliance by using its fully qualified domain name, https://va-hostname.domain.name:5480.
b	Log in with the user name root and the password you specified when the appliance was deployed.
c	Click the Update tab.

Click Status.

Click Check Updates to verify that an update is accessible.

(Optional) For instances of vCloud Automation Center Appliance, click Details in the Appliance Version area to see information about the location of release notes.

Click Install Updates.

Click OK.

An informational message stating that the update is in progress appears. The time it takes for the update to finish depends on your site environment.

Reboot the virtual appliance.

a	Click the System tab.
b	Click Reboot and confirm your selection.

Clear the cache of the Web browser that you use to access the management console.

Verify that services are running.

Click the Services tab on the console.

Click the Refresh tab to monitor the progress of service startup.

You should see a minimum of twenty-one services.

What to do next

If you are upgrading a distributed installation, see Recreate vCloud Automation Center Appliance Clusters after Upgrading.

If you are not upgrading a distributed installation, download and install the upgrade for the IaaS server. See Upgrading the IaaS Server.

Recreate vCloud Automation Center Appliance Clusters after Upgrading

Distributed installations support the use of more than one vCloud Automation Center Appliance. Each of these appliances must belong to a cluster. You must recreate the appliance cluster after you complete the vCloud Automation Center Appliance upgrade.

You join a vCloud Automation Center Appliance to a cluster from the management console. The join operation copies appliance configuration information for the cluster to the appliance you are adding to the cluster, including certificate, SSO, licensing, database, and messaging information.

To preserve messaging information, you must join virtual appliances to a cluster in the reverse order from which you shut them down before upgrading. If you do not know the order to use, or if you encounter errors, see Troubleshooting vCloud Automation Center messaging in the troubleshooting section of the vCloud Automation CenterInstallation and Configuration guide.

Prerequisites

Install the Update on the vCloud Automation Center Appliance.

Procedure

Navigate to the vCloud Automation Center Appliance management console by using its fully qualified domain name, https://vcac-va-hostname.domain.name:5480/.

Continue past any certificate warnings.

Select vCAC Settings > HA.

Enter the FQDN of a previously configured vCloud Automation Center Appliance in the Leading cluster node text box.

You can use the FQDN of the primary vCloud Automation Center Appliance, or any vCloud Automation Center Appliance that is already joined to the cluster.

Type the root password in the Password text box.

Click Join Cluster.

Continue past any certificate warnings.

Services for the cluster are restarted.

Verify that services are running.

Click the Services tab.

Click the Refresh tab to monitor the progress of service start up.

You should see a list of about twenty-one registered services.

What to do next

Download and install the upgrade for the IaaS server. See Upgrading the IaaS Server.

Upgrading the IaaS Server

A system administrator can upgrade the IaaS server components and the database from vCloud Automation Center 6.0.1 to vCloud Automation Center 6.1.

You upgrade the IaaS server components with the IaaS Installer. To upgrade earlier versions of IaaS components to vCloud Automation Center 6.1, you must upgrade them first to vCloud Automation Center 6.0.1. For information about how to upgrade IaaS components from 6.0 to 6.0.1, see Upgrading vCloud Automation Center from 6.0 to 6.0.1.

You upgrade the database with the DBUpgrade command.

Note

You must upgrade the database before you upgrade the IaaS server and its components.

■

Upgrade the Database

An administrator must upgrade the database with the DBUpgrade.exe command before upgrading the IaaS components.

■

Download the IaaS Installer

You download the IaaS installer to the machine where the IaaS components to be upgraded are installed.

■

Upgrade the IaaS Components

You must upgrade the database and configure all systems that have IaaS components installed. You can use these steps for minimal and distributed installations.

Upgrade the Database

An administrator must upgrade the database with the DBUpgrade.exe command before upgrading the IaaS components.

The DBUpgrade command requires the names of the SQL Server database instance and the vCloud Automation Center database. It can use Windows authentication or it accepts credentials to access the database using SQL authentication. It creates a log file named dbupgrade.log in the current directory if you do not provide a path name for a different log file.

Important

Run this command only once during an upgrade.

Prerequisites

■

Verify that the machine on which you run the DBUpgrade command meets the following Java-related requirements.

■	64-bit Java version 1.7 or later is installed. 32-bit versions are not supported.
■	Environment variable JAVA_HOME is set to the Java install folder.
■	The %JAVA_HOME%\bin\java.exe file is available.

Procedure

Navigate to the Windows installer download page by using https://vcac-va-hostname.domain.name:5480/installer/, the host name of the vCloud Automation Center Appliance.

Click database upgrade scripts in the manual database upgrade from 6.0.1 to 6.1 item under IaaS Installation.

Extract the contents of the DBUpgrade.zip archive file to a local folder on the vCloud Automation Center database host, or to another location with network access to the database host.

In a Windows command prompt window, set your current directory to the folder where you extracted the contents of the DBUpgrade.zip archive file.

Enter a DBUpgrade command string in the following format.

DBUpgrade [-S dbserver] [-d dbname] [{-E | -U username}] [-l logfilepath]

Option	Description
-S dbserver	Identifies the database server instance dbserver. Allowable values are localhost or a fully qualified domain name for the database server.
-d dbname	Identifies the vCloud Automation Center database dbname.
-E	Requires a Windows Authentication trusted connection to access the database.
-U username	Specifies the user name for the database owner account. When you specify this option, you are prompted for the account password when the tool runs.
-l logfilepath	Specifies the full path name of the upgrade log file. By default, the command creates the dbupgrade.log log file in the current directory.

(Optional) Enter the password for the database owner account.

You are prompted for this information only if you specified a username with the DBUpgrade command.

The command upgrades the database to vCloud Automation Center 6.1.

Example: DBUpgrade.exe

DBUpgrade

With no options, displays usage information.

DBUpgrade -S localhost-d VCAC -E

Upgrades the VCAC database in the database server instance running on the local host.

DBUpgrade -S dbhost\VCACinstance -d VCAC -U SqlUser -l %SystemDrive%\VCACDBUpgrade\Log_30Apr.log

Upgrades the VCAC database in VCACinstance running on dbhost, logs in as SqlUser with password SqlPassword, and creates the Log_30Apr.log upgrade log file in the VCACDBUpgrade folder on the system drive.

Download the IaaS Installer

You download the IaaS installer to the machine where the IaaS components to be upgraded are installed.

If you see certificate warnings during this procedure, you can ignore them.

Prerequisites

■	Verify that Microsoft .NET Framework 4.5.1 is installed on the IaaS installation machine. You can download the .NET installer from the vCloud Automation Center installer Web page.
■	If you are using Internet Explorer for the download, verify that Enhanced Security Configuration is not enabled. See res://iesetup.dll/SoftAdmin.htm.
■	Log in as a local administrator to the Windows server where one or more of the IaaS components to be upgraded are installed.
■	The IaaS components to be upgraded must be part of vCloud Automation Center 6.0.1. If they are from vCloud Automation Center 6.0, then you must upgrade them to vCloud Automation Center 6.0.1 before you can proceed with this upgrade.

Procedure

1	Open a Web browser.
2	Enter the URL for the Windows installer download page. For example, *https://vcac-va-hostname.domain.name:5480/installer, where vcac-va-hostname.domain.name* is the name of the vCloud Automation Center Appliance host.
3	Click the IaaS installer link.
4	When prompted, save the installer file, setup__vcac-va-hostname.domain.name@5480.exe, to the desktop. Do not change the file name. It is used to connect the installation to the vCloud Automation Center Appliance.

Upgrade the IaaS Components

You must upgrade the database and configure all systems that have IaaS components installed. You can use these steps for minimal and distributed installations.

If you have multiple IaaS servers, perform the upgrade so that services are upgraded in the following order.

1	Websites Finish the upgrade on one server before upgrading the next server that is running a Website service.
2	Manager services Upgrade the active manager service before you upgrade the passive manager service.
3	DEM orchestrator and workers
4	Agents. Finish the upgrade on one server before you upgrade the next server that is running an agent.

If you are using different services on one server, the upgrade updates the services in the proper order. For example, if your site has Website and Manager services on the same server, select both for update. The upgrade installer applies the updates in the proper order. You must complete the upgrade on one server before you begin an upgrade on another.

Prerequisites

■	Shut Down vCloud Automation Center Services on Your IaaS Windows Server
■	Download the IaaS Installer.
■	Upgrade the Database.

Procedure

Right-click the setup__vcac-va-hostname.domain.name@5480.exe setup file that you downloaded and select Run as administrator.

Click Next.

Accept the license agreement and click Next.

Type the administrator credentials for the vCloud Automation Center Appliance on the Log In page and click Next.

The user name is root and the password is the password that you specified when you deployed the vCloud Automation Center Appliance.

Select Upgrade on the Installation Type page and click Next.

Configure the upgrade settings.

Option	Action
If you are upgrading the Model Manager Data.	Select the Model Manager Data check box in the vCAC Server section. The check box is selected by default. Upgrade the Model Manager data only once. If you are running the setup file on multiple machines to upgrade a distributed installation, the Web servers stop functioning when versions 6.0.1 or 6.1 do not match the version of the Model Manager data. When you have upgraded the Model Manager data and all of the Web servers, all of the Web servers should function.
If you are not upgrading the Model Manager Data.	Unselect the Model Manager Data check box in the vCAC Server section.
To preserve customized workflows as the latest version in your Model Manager Data.	If you are upgrading the Model Manager Data, select the Preserve my latest workflow versions check box in the Extensibility Workflows section. The check box is selected by default. Customized workflows are always preserved. The checkbox determines version order only. If you used vCloud Automation Center Designer to customize workflows in the Model Manager, select this option to maintain the most recent version of each customized workflow before upgrade as the most recent version after upgrade. If you do not select this option, the version of each workflow provided with vCloud Automation Center Designer 6.1 becomes the most recent after upgrade, and the most recent version before upgrade becomes the second most recent. For information about vCloud Automation Center Designer, see Extensibility.
If you are upgrading a Distributed Execution Manager or a proxy agent.	Enter the credentials for the administrator account in the Service Account section. All of the services that you upgrade run under this account.
To specify your Microsoft SQL Server database.	If you are upgrading the Model Manager Data, enter the names of the database server and database instance in the Microsoft SQL Server Database Installation Information section. Use a fully qualified domain name (FQDN) for the database server name.

Click Next.

Confirm that all of the services to upgrade appear on the Ready to Upgrade page, and click Upgrade.

The Upgrading page and a progress indicator appear. When the upgrade process finishes, the Next button is enabled.

Click Next.

Click Finish.

Verify that all vCloud Automation Center services restarted.

All of the selected components are upgraded to vCloud Automation Center 6.1.