Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 vCenter Orchestrator 5.5.2 vCloud Automation Center 6.1.0 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.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.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 4 VMware, Inc.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 provides information and instructions ® about configuring and using the VMware vCenter Orchestrator plug-in for VMware vCloud Automation Center 6.1. Intended Audience The information in Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.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.1 Installing the vCloud Automation Center Plug-In The vCloud Automation Center plug-in is installed on the embedded vCenter Orchestrator instance in your vCloud Automation Center installation. You can use the configuration interface of an external vCenter Orchestrator server to install the vCloud Automation Center plug-in.
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 Workflows view of the Orchestrator client, in the Configuration subdirectory of the plug-in library.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 The embedded Orchestrator server in the vCloud Automation Center installation is registered in the vCloud Automation Center component registry by default. Workflow Name Description Add an IaaS host Adds a vCloud Automation Center IaaS host to the plug-in inventory. This workflow is functionally the same as Add the IaaS host of a vCAC host, but does not require a vCloud Automation Center host.
Chapter 2 Configuring the vCloud Automation Center Plug-In 3 Select Library > vCloud Automation Center > Configuration. 4 Right-click Add the IaaS host of a vCAC host and select Start workflow. 5 From the vCAC host drop-down menu, select the vCloud Automation Center host for which to configure an IaaS host and click Next. 6 Provide the required information and click Next. 7 From the Session mode drop-down menu, select the type of connection to the host.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 12 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.1 Using the vCloud Automation Center Plug-In Administration Workflows You can use the administration workflows to manage vCloud Automation Center services, tenants, approval policies, entitlements, business groups, catalog items, and advanced services custom resources, service blueprints, and resource actions.
Chapter 3 Using the vCloud Automation Center Plug-In Table 3‑4. ASD Service Blueprints (Continued) Workflow Description Delete a service blueprint Deletes an Advanced Services service blueprint. Publish a service blueprint Publishes an Advanced Services service blueprint. Unpublish a service blueprint Unpublishes an Advanced Services service blueprint. You can use the workflows in the Business Groups subdirectory to create and manage business groups. Table 3‑5.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 Table 3‑8. Service Workflow Description Activate a service Activates a service. Assign catalog items to a service Assigns one or more catalog items to a service. Copy a service Copies a service. Create a service Creates a service. Deactivate a service Deactivates a service. Delete a service Deletes a service. You can use the workflows in the Tenants subdirectory to create and manage tenants. Table 3‑9.
Chapter 3 Using the vCloud Automation Center Plug-In Using the vCloud Automation Center Plug-In Infrastructure Administration Workflows You can use the infrastructure administration workflows to provision virtual machines and run basic or CRUD operations. You use the extensibility package to customize vCloud Automation Center with the ability to call vCenter Orchestrator workflows either as part of the provisioning process, or by using custom operation menus.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 Table 3‑10. Infrastructure Administration (Continued) Workflow Name Description Read a vCAC entity by custom filter Reads a list of vCloud Automation Center entities by using a custom filter. If you do not specify a filter, all entities are returned as a result. Read a vCAC entity by system query Reads a list of vCloud Automation Center entities by using OData system filters. The system filters apply to the OData URI convention.
Chapter 3 Using the vCloud Automation Center Plug-In 3 Select Library > vCloud Automation Center > Infrastructure Administration. 4 Right-click the Create a vCAC model entity workflow and select Start workflow. 5 Select a vCloud Automation Center host. 6 In the Model name text box, enter the name of the model. 7 In the Entity set name text box, enter the name of the entity set. You use scripting or a REST API to set the Simple properties, Links to complex properties, and HTTP headers properties.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 Workflow Description Wait for resource action request Waits for a resource action request to complete. Wait for work item Waits for a work item to complete. Using the vCloud Automation Center Plug-In Sample Workflows You can use the sample workflows as examples, or as starting points for creating your own custom workflows.
Chapter 3 Using the vCloud Automation Center Plug-In 4 Defines the pre-provisioning approval phase. 5 Defines the post-provisioning approval phase. 6 Defines the approval policy specifications such as name, description, and type. 7 Creates the approval policy. 8 Publishes the approval policy. Once an approval policy is published, it becomes read-only. Table 3‑12. Input Variables Variable Type host vCACCAFE:VCACHost // Get the type of approval policy by ID var typeService = host.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 phase2Type.setDescription("Post-Provisioning type description"); phase2Type.setPhaseOrder(1); var phase2 = new vCACCAFEPhase(); phase2.setName("Post-Provisioning"); phase2.setDescription("Post provisioning phase"); phase2.setPhasetype(phase2Type); System.getModule("com.vmware.library.vcaccafe.util").addElementToList(phase2, "getLevels", level); // Create the approval policy specifications var spec = new vCACCAFEApprovalPolicy(); spec.
Chapter 3 Using the vCloud Automation Center Plug-In //Create the service blueprint var blueprintService = host.createAdvancedDesignerClient().getAdvancedDesignerServiceBlueprintService(); var uri = blueprintService.createServiceBlueprint(host.tenant , blueprint); //Publish the service blueprint var createdBlueprint = blueprintService.getServiceBlueprintByUri(uri); blueprintService.updateServiceBlueprintStatus(host.tenant, createdBlueprint.getId(), vCACCAFEDesignerPublishStatus.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 AdContainer:'AD', IsTestGroup:false, Flags:2, GroupType:1}; //Add a reference to the newly created prefix entity links = { HostNamePrefix:prefixEntity }; //Save the provisioning group var entity = vCACEntityManager.createModelEntity(host.
Chapter 3 Using the vCloud Automation Center Plug-In Table 3‑16. Input Variables Variable Type host vCAC:VcacHost blueprintID String var modelName = 'ManagementModelEntities.svc'; var entitySetName = 'VirtualMachineTemplates'; var links = null; var headers = null; //Create properties for the prefix entity var blueprintId = { VirtualMachineTemplateID:blueprintId, }; //Read the blueprint var entity = vCACEntityManager .readModelEntity(host.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 Table 3‑18. Input Variables Variable Type host vCAC:VcacHost templateName String var modelName = 'ManagementModelEntities.svc'; var entitySetName = 'VirtualMachineTemplates'; var headers = null; //Create properties for prefix entity var properties = { VirtualMachineTemplateName:templateName, }; //Read a list of entities var entities = vCACEntityManager .readModelEntitiesByCustomFilter(host.
Chapter 3 Using the vCloud Automation Center Plug-In Example: Find Catalog Resources Filtered by Name Table 3‑20. Input Variables Variable Type host vCAC:VcacHost You can use one the following examples: n This example script gets all catalog resources for the target host matching the query of name_of_the_resource by name and description. var items = vCACCAFEEntitiesFinder.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 Example: Find Catalog Resources Filtered by Name and Owner This example script combines the OData queries from the previous two examples into a single one condition by using the vCACCAFEFilterParam.and(array of conditions) logic operator. var conditions = new Array(); conditions[0] = vCACCAFEFilterParam.equal("name", vCACCAFEFilterParam.string("name_of_the_resource_here")); conditions[1] = vCACCAFEFilterParam.
Chapter 3 Using the vCloud Automation Center Plug-In System.log("resource type: " + resourceType); var providerBinding = resource.getProviderBinding(); var bindingId = providerBinding.getBindingId(); System.log("provider binding id: " + bindingId); var provider = providerBinding.getProviderRef(); System.log("provider id: " + provider.getId()); System.log("provider name: " + provider.getLabel()); if ((resourceType == "Virtual Machine") && (provider.getLabel() == "iaas-service")) { System.
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 System.log("Source tenant: " + sourceHost.tenant); var contentClientExport = sourceHost.createRestClient(CONTENT_MANAGEMENT_SERVICE); System.log("Exporting..."); content = contentClientExport.getFile("content"); System.log("Export successful"); System.log("Target host: " + targetHost.url); System.log("Target tenant: " + targetHost.tenant); var contentClientImport = targetHost.createRestClient(CONTENT_MANAGEMENT_SERVICE); System.
Index A V adding a vCloud Automation Center model entity 18 API access 20 audience 5 vCloud Automation Center host, configuring 10 vCloud Automation Center plug-in configuring 9 installing 8 installing in external vCenter Orchestrator server 8 introduction 7 vCloud Automation Center model entity adding 18 reading 19 E example 26, 28, 29 F finding catalog resources 26 functional prerequisites 8 G getting a provisioned virtual machine 28 H host configuring 9 managing 9 I W workflow library 13 workfl
Using the vCenter Orchestrator Plug-In for vCloud Automation Center 6.1 32 VMware, Inc.
