Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 vCenter Orchestrator 5.5.1 vCloud Automation Center 6.0.1 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 6.0.1 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–2014 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 6.0.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 4 VMware, Inc.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 provides information and ® instructions about configuring and using the VMware vCenter Orchestrator plug-in for VMware vCloud Automation Center 6.0.1. Intended Audience The information in Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 6 VMware, Inc.
Introduction to the VMware vCenter Orchestrator Plug-In for vCloud Automation Center 1 The VMware vCenter Orchestrator plug-in for vCloud Automation Center allows interaction between vCenter Orchestrator and vCloud Automation Center.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 Installing the vCloud Automation Center Plug-In You must use the Orchestrator configuration interface to install the vCloud Automation Center plug-in. You can use either the default vCenter Orchestrator server embedded in your vCloud Automation Center, or an external vCenter Orchestrator server.
Chapter 1 Introduction to the VMware vCenter Orchestrator Plug-In for vCloud Automation Center Install the vCloud Automation Center Plug-In in the Embedded vCenter Orchestrator Server Download the .vmoapp file that contains the plug-in and use the vCenter Orchestrator Configurator to install it.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 10 VMware, Inc.
Configuring the vCloud Automation Center Plug-In 2 You add vCloud Automation Center hosts and IaaS hosts to configure the plug-in. Configuration Workflows You can use the workflows in the Configuration workflow categories to manage vCloud Automation Center hosts. vCloud Automation Center Hosts You can access these workflows from the Configuration subdirectory of the plug-in library in the Workflows view of the Orchestrator client.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 Add a vCloud Automation Center Host You can run a workflow to a vCloud Automation Center host and configure the host connection parameters. Procedure 1 From the drop-down menu in the Orchestrator client, select Run or Design. 2 Click the Workflows view. 3 Select Library > vCloud Automation Center > Configuration. 4 Right-click the Add a vCAC host workflow and select Start workflow.
Chapter 2 Configuring the vCloud Automation Center Plug-In 10 Click Next. 11 Select a session mode. Option Description Shared Session Provide vCloud Automation Center credentials for the shared session. Per User Session The Orchestrator client retrieves credentials from the user who is logged in. 12 Click Next. 13 Enter the name of the Workstation machine in the Workstation for NTLM text box. 14 Enter the NetBIOS domain name in the Domain for NTLM authentication text box. 15 Click Submit.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 14 VMware, Inc.
Using the vCloud Automation Center Plug-In 3 The vCloud Automation Center plug-in workflow library contains workflows that you can use for common tasks such as interacting with the catalog, managing infrastructure, and creating tenants and services. 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 6.0.1 Table 3‑1. Approval Policies Workflow Description Activate an approval policy Activates an approval policy. After you activate an approval policy, it becomes read-only. Copy an approval policy Copies an approval policy. Deactivate an approval policy Deactivates an approval policy. You can also delete all existing entitlements associated with the approval policy.
Chapter 3 Using the vCloud Automation Center Plug-In Table 3‑5. Business Groups (Continued) Workflow Description Delete a custom property Removes a custom property from a business group. Update a business group Updates details for a business group, such as default machine prefix, active directory containers, and user roles. Update a custom property Updates a custom property for a business group. You can use the workflows in the Catalog Item subdirectory to manage catalog items. Table 3‑6.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 Table 3‑9. Tenants Workflow Description Add administrators Adds one or more tenant administrators and infrastructure administrators to a tenant. Add an identity store to a tenant Adds an identity store to a tenant of a vCloud Automation Center host. You can run this workflow only if you are a system administrator configuring a tenant.
Chapter 3 Using the vCloud Automation Center Plug-In Table 3‑10. Infrastructure Administration Workflow Name Description Create a vCAC model entity Creates and persists an entity for a specified vCloud Automation Center model. Delete a vCAC model entity Deletes a specified vCloud Automation Center model entity. Invoke a post-provisioning action Invokes a specified post-provisioning action on a virtual machine.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 Table 3‑11. Extensibility Workflow Name Description Install vCO customization Installs an Orchestrator customization including customized state change workflow stubs and Orchestrator menu operation workflows. Uninstall vCO customization Uninstalls an Orchestrator customization including customized state change workflow stubs and Orchestrator menu operation workflows.
Chapter 3 Using the vCloud Automation Center Plug-In Read a vCloud Automation Center Model Entity You can run a workflow to read a vCloud Automation Center model entity. Procedure 1 From the drop-down menu in the Orchestrator client, select Run or Design. 2 Click the Workflows view. 3 Select Library > vCloud Automation Center > Infrastructure Administration. 4 Right-click Read a vCAC model entity and select Start workflow. 5 Select a vCloud Automation Center host.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 Access the vCloud Automation Center Plug-In API Orchestrator provides an API Explorer to allow you to search the vCloud Automation Center plug-in API and see the documentation for JavaScript objects that you can use in scripted elements. For updated vCloud Automation Center API documentation, see https://www.vmware.com/support/pubs/vcac-pubs.html. Procedure 1 Log in to the Orchestrator client as an administrator.
Chapter 3 Using the vCloud Automation Center Plug-In user.setType(vCACCAFEApprovalPrincipalType.USER); var group = new vCACCAFEApprovalPrincipal(); group.setValue("group@domain.com"); group.setType(vCACCAFEApprovalPrincipalType.GROUP); // Set the level of the approval var level = new vCACCAFEApprovalLevel(); level.setName("IT Approval Level"); level.setDescription("IT Approval Level description"); level.setApprovalMode(vCACCAFEApprovalMode.ALL); System.getModule("com.vmware.library.vcaccafe.util").
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 var approvalPolicy = approvalPolicyService.createPolicy(spec); // Publish the approval policy approvalPolicy.setState(vCACCAFEApprovalPolicyState.PUBLISHED); approvalPolicy = approvalPolicyService.update(approvalPolicy); System.log("New approval policy id: " + approvalPolicy.
Chapter 3 Using the vCloud Automation Center Plug-In Example: Create a vCloud Automation Center Model Entity This example script performs the following actions: 1 Defines the model name and the entity set name. 2 Defines the properties of the host prefix. 3 Saves the host prefix entity. 4 Defines the properties of the provisioning group. 5 Defines the provisioning group as a link. 6 Saves the provisioning group entity, by linking it with the host name prefix. Table 3‑14.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 3 Gets the entity set name from the provided entity. 4 Gets the entity ID from the provided entity. 5 Defines a set of properties that will be updated. 6 Starts the action responsible for updating the entity. Table 3‑15. Input Variables Variable Type entity vCAC:Entity updatedDescription String var hostId = entity.hostId; var modelName = entity.modelName; var entitySetName = entity.
Chapter 3 Using the vCloud Automation Center Plug-In Example: Delete a vCloud Automation Center Model Entity This example script performs the following actions: 1 Gets the host ID from the provided entity. 2 Gets the model name from the provided entity. 3 Gets the entity set name from the provided entity. 4 Gets the entity ID from the provided entity. 5 Starts the action responsible for deleting the entity. Table 3‑17. Input Variables Variable Type entity vCAC:Entity var hostId = entity.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 2 Defines the system queries by which the entities are filtered and selects the top ten results of all virtual machines, filtered by the machine state and component flag. 3 Reads a list of entities. Table 3‑19. Input Variables Variable Type host vCAC:VcacHost var modelName = 'ManagementModelEntities.
Index A adding a vCloud Automation Center model entity 20 API access 22 audience 5 F functional prerequisites 8 H host configuring 11 managing 11 I vCloud Automation Center model entity adding 20 reading 21 W workflow library 15 workflows configuring 11 CRUD 15, 18, 21 extensibility workflows 18 IaaS 18 model entity 15, 18, 21 requests workflows 21 standard workflows 15, 18, 21 IaaS host, configuring 12 installing embedded vCenter Orchestrator server 9 external vCenter Orchestrator server 8 vCloud Au
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.0.1 30 VMware, Inc.
