Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 vCenter Orchestrator 5.2 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2012, 2013 VMware, Inc. All rights reserved. Copyright and trademark information. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.
Contents Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 4 VMware, Inc.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 provides information and instructions ® about configuring and using the VMware vCenter Orchestrator plug-in for VMware vCloud Automation Center 5.2. Intended Audience The information in Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 6 VMware, Inc.
Updated Information This Using the vCenter Orchestrator Plug-In for vCloud Automation Center is updated with each release of the product or when necessary. This table provides the update history of the Using the vCenter Orchestrator Plug-In for vCloud Automation Center . Revision Description 001079-01 In “Add a vCloud Automation Center Host,” on page 11, added information about the Workstation for NTLM and Domain for NTLM authentication text boxes. 001079 Initial release. VMware, Inc.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 8 VMware, Inc.
Introduction to the VMware vCenter Orchestrator Plug-In for vCloud Automation Center 1 The vCloud Automation Center plug-in (VMware vCenter Orchestrator plug-in for vCloud Automation Center) allows interaction between vCenter Orchestrator and vCloud Automation Center. You can use the vCloud Automation Center plug-in to provision vSphere and vCloud Director virtual machines, take post-provision actions, and run Create, Read, Update, and Delete (CRUD) operations on the vCloud Automation Center model.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 vCloud Automation Center Verify that you have access to a vCloud Automation Center server. Version 5.2 of the plug-in works with vCloud Automation Center 4.5, 5.1, and 5.2. For information about setting up vCloud Automation Center, see vCloud Automation Center Installation Guide. Install the vCloud Automation Center Plug-In To be able to use the vCloud Automation Center plug-in, you must download the .
Configuring the vCloud Automation Center Plug-In 2 To configure the vCloud Automation Center plug-in, you run configuration workflows in the Orchestrator client. Configuration Workflows You can use the workflows in the Configuration workflow category to manage vCloud Automation Center hosts. You can access these workflows from Library > vCloud Automation Center > Configuration in the Workflows view of the Orchestrator client.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 7 12 Select whether to install the SSL certificates automatically without user interaction. Option Description Yes Install the SSL certificates automatically without user interaction. No Install the SSL certificates after user confirmation. 8 (Optional) In the Connection timeout (seconds) and Operation timeout (secounds) text boxes, type the timeout interval. 9 Click Next. 10 Select a session mode.
Using the vCloud Automation Center Plug-In 3 The vCloud Automation Center plug-in workflow library contains workflows that you can use to provision virtual machines and take post-provision actions. You can use the scripting API of the plug-in to develop custom workflows. You can use custom HTTP headers, such as the vCloud Automation Center specific headers Tasks and Identity, and apply them in the CRUD, provisioning, and post-provisioning workflows.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 Workflow Name Description Await virtual machine state change Awaits a state change for a set of virtual machines. If all virtual machines get into the success state, a trigger is called and the workflow ends successfully. If one or more of the specified virtual machines get into fail state, or they do not exist, the workflow fails.
Chapter 3 Using the vCloud Automation Center Plug-In Read a vCloud Automation Center Model Entity You can run a workflow to read the vCloud Automation Center model entity. Prerequisites Verify that you have the permissions to perform this task. Procedure 1 From the drop-down menu in the Orchestrator client, select Run or Design. 2 Click the Workflows view. 3 In the hierarchical list of workflows, select Library > vCloud Automation Center and navigate to the Read a vCAC model entity workflow.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 Workflow Name Description Remove a menu operation from a blueprint and its virtual machines Removes a menu operation from a blueprint and its virtual machines. Remove a state change workflow from a blueprint and its virtual machines Removes a state change workflow from a blueprint and its virtual machines.
Chapter 3 Using the vCloud Automation Center Plug-In Table 3‑1. Input Variables Variable Type host vCAC:VcacHost var modelName = 'ManagementModelEntities.svc'; var entitySetName = 'HostNamePrefixes'; var links = null; var headers = null; //Create properties for prefix entity var prefixInputProperties = { MachinePrefix:'test-prefix', NextMachineNo:1, MachineNumberLength:3 }; //Save the prefix var prefixEntity = vCACEntityManager .createModelEntity(host.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 Table 3‑2. Input Variables Variable Type entity vCAC:Entity updatedDescription String var var var var var hostId = entity.hostId; modelName = entity.modelName; entitySetName = entity.entitySetName; entityIdString = entity.keyString; links = null; var headers = null; var updateProperties = new Properties(); updateProperties.put("UserNameDescription", updatedDescription); //Update the user description System.getModule("com.
Chapter 3 Using the vCloud Automation Center Plug-In 5 Invokes the action responsible for deleting the entity. Table 3‑4. Input Variables Variable Type entity vCAC:Entity var var var var hostId = entity.hostId; modelName = entity.modelName; entitySetName = entity.entitySetName; entityKeyString = entity.keyString; var headers = null; //Delete the entity System.getModule("com.vmware.library.vcac") .
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 Table 3‑6. Input Variables Variable Type host vCAC:VcacHost var var var var var var modelName = 'ManagementModelEntities.svc'; entitySetName = 'VirtualMachines'; filter = "VirtualMachineState eq 'Off' and IsComponent eq true"; orderBy = 'VirtualMachineName asc'; top = 10; { skip = 0;, var headers = null; var select = null; var entities = vCACEntityManager readModelEntitiesBySystemQuery(host.
Index A V adding a vCloud Automation Center host 11 adding a vCloud Automation Center model entity 14 API access 16 audience 5 vCloud Automation Center host adding 11 registering 11 vCloud Automation Center model entity adding 14 reading 15 C configuration 11 F functional prerequisites 9 H host configure 11 manage 11 W workflow library 13 workflows configuration 11 CRUD 13 extensibility workflows 15 model entity 13 standard workflows 13 I installation 9 installation process 10 introduction, vCloud
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 5.2 22 VMware, Inc.