Using the VMware vCenter Orchestrator Client vCenter Orchestrator 5.5 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 VMware vCenter Orchestrator Client 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 © 2008–2013 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents Using the VMware vCenter Orchestrator Client 5 1 The Orchestrator Client 7 Log in to the Orchestrator Client 7 Orchestrator Client Perspectives 8 Orchestrator Views in the Run Perspective 9 Orchestrator Views in the Design Perspective 9 Orchestrator Views in the Administer Perspective User Preferences 10 Access the Orchestrator API Explorer 12 10 2 Managing Workflows 13 Key Concepts of Workflows 14 Workflow User Permissions 14 Workflow Parameters 14 Workflow Attributes 15 Workflow Schema 15
Using the VMware vCenter Orchestrator Client Get a Remote Package 28 Synchronize a Remote Package Remove a Package 30 29 5 Using Authorizations 31 Create an Authorization Element 31 Configure an Authorization Element 31 Index 4 33 VMware, Inc.
Using the VMware vCenter Orchestrator Client Using the VMware vCenter Orchestrator Client provides information and instructions about performing tasks ® in the VMware vCenter Orchestrator client. Intended Audience This information is intended for advanced vSphere administrators and experienced system administrators who are familiar with virtual machine technology and datacenter operations. VMware, Inc.
Using the VMware vCenter Orchestrator Client 6 VMware, Inc.
The Orchestrator Client 1 The Orchestrator client is an easy-to-use desktop application. By using the Orchestrator client you can import packages, run and schedule workflows, and manage user permissions. In addition, by using the Orchestrator client you can also develop workflows and actions as well as create packages and resource elements. For more information, see Developing with VMware vCenter Orchestrator.
Using the VMware vCenter Orchestrator Client 5 In the Security Warning window select an option to handle the certificate warning. The Orchestrator client communicates with the Orchestrator server by using an SSL certificate. A trusted CA does not sign the certificate during installation. Because of this, you receive a certificate warning each time you connect to the Orchestrator server. Option Description Ignore Click Ignore to continue using the current SSL certificate.
Chapter 1 The Orchestrator Client Orchestrator Views in the Run Perspective From the Run perspective in the Orchestrator client, you can schedule tasks, manage policies, run workflows, access the inventory, and manage permissions. View Description My Orchestrator Summarizes the most recent activities on the Orchestrator server, such as recently modified elements, pending and running workflows, running policies, completed workflows, and workflows that are waiting for user interaction.
Using the VMware vCenter Orchestrator Client Orchestrator Views in the Administer Perspective From the Administer perspective in the Orchestrator client, you can access the inventory and manage authorizations, Web views, and packages. View Description Inventory Displays the objects of the plug-ins that are enabled in Orchestrator. You can use the Inventory view to run workflows on an inventory object. Policy Templates Displays a list of the available master policies.
Chapter 1 The Orchestrator Client Table 1‑1. Orchestrator Client Customization Options (Continued) Option Description Finder maximum size The maximum number of results that the searches return when you search for elements such as actions or workflows. The value must be greater than 0. Check usage when deleting an element (slow) Orchestrator checks whether the element you are trying to delete is referenced by other elements.
Using the VMware vCenter Orchestrator Client Script Editor Preferences You can customize the scripting engine. For example, you can disable automatic completion of lines, highlight selected lines and brackets, and change the options for default color code formatting. Access the Orchestrator API Explorer Orchestrator provides an API Explorer that you can use to search the Orchestrator API and see the documentation for JavaScript objects that you can use in scripted elements.
Managing Workflows 2 A workflow is a series of actions and decisions that you run sequentially. Orchestrator provides a library of workflows that perform common management tasks according to best practices. Orchestrator also provides libraries of the individual actions that the workflows perform. Workflows combine actions, decisions, and results that, when performed in a particular order, complete a specific task or a specific process in a virtual environment.
Using the VMware vCenter Orchestrator Client Key Concepts of Workflows Workflows consist of a schema, attributes, and parameters. The workflow schema is the main component of a workflow as it defines all the workflow elements and the logical connections between them. The workflow attributes and parameters are the variables that workflows use to transfer data. Orchestrator saves a workflow token every time a workflow runs, recording the details of that specific run of the workflow.
Chapter 2 Managing Workflows Workflow Attributes Workflow elements process data that they receive as input parameters, and set the resulting data as workflow attributes or output parameters. Read-only workflow attributes act as global constants for a workflow. Writable attributes act as a workflow’s global variables. You can use attributes to transfer data between the elements of a workflow.
Using the VMware vCenter Orchestrator Client Standard Workflows in the Workflow Library Orchestrator provides a standard library of workflows that you can use to automate operations in the virtual infrastructure. The workflows in the standard library are locked in the read-only state. To customize a standard workflow, you must create a duplicate of that workflow. Duplicate workflows or custom workflows that you create are fully editable.
Chapter 2 Managing Workflows n Add some elements to the workflow schema. Procedure 1 Click the Permissions tab. 2 Click the Add access rights link to define permissions for a new user or user group. 3 Search for a user or user group. The search results contain all the users and user groups from the Orchestrator LDAP server that match the search. 4 Select a user or user group and select the appropriate check boxes to set the level of permissions for this user or user group.
Using the VMware vCenter Orchestrator Client 6 7 Provide the infrastructure parameters. Option Description Host on which to create the virtual machine Click Not set for the Host on which to create the virtual machine value and navigate through the vCenter Server infrastructure hierarchy to a host machine. Resource pool Click Not set for the Resource pool value and navigate through the vCenter Server infrastructure hierarchy to a resource pool.
Chapter 2 Managing Workflows 3 Click the Waiting for Input tab. The Waiting for Input tab lists the workflows that are waiting for user inputs from you or from members of your user group that have permission. 4 Double-click a workflow that is waiting for input. The workflow token that is waiting for input appears in the Workflows hierarchical list with the following symbol: . 5 Right-click the workflow token and select Answer.
Using the VMware vCenter Orchestrator Client What to do next You can monitor the workflow run and delete the scheduled task from the Scheduler view. Edit the Workflow Recurrence Pattern A recurrence pattern is used to specify the way in which a given workflow is scheduled. You can edit the recurrence pattern of a workflow from the Scheduler view. Prerequisites A recurrent workflow that is scheduled. Procedure 1 From the drop-down menu in the Orchestrator client, select Run. 2 Click the Scheduler view.
Chapter 2 Managing Workflows 2 Select a workflow version and click Diff Against Current to compare the differences. A window displays the differences between the current workflow version and the selected workflow version. 3 Select a workflow version and click Revert to restore the state of the workflow. CAUTION If you have not saved the current workflow version, it is deleted from the version history and you cannot revert back to the current version.
Using the VMware vCenter Orchestrator Client 5 Browse to locate the workflow you want to import, and click Open. If the workflow already exists in your workflow library, a dialog box with version information appears. NOTE You cannot import a workflow with an earlier version number than the version number of the existing workflow. The imported workflow appears in the workflow folder that you selected. 22 VMware, Inc.
Managing Policies 3 Policies are event triggers that monitor the activity of the system. Policies respond to predefined events issued by changes in the status or performance of certain defined objects. Policies are a series of rules, gauges, thresholds and event filters that run certain workflows or scripts when specific predefined events occur in Orchestrator or in the technologies that Orchestrator accesses through plug-ins.
Using the VMware vCenter Orchestrator Client 5 Right-click the policy and select Edit. The policy editor opens. 6 On the General tab, edit the startup settings, priority, startup user, and description of the policy. 7 On the Scripting tab, add and remove policy elements, periodic tasks, and trigger events, as well as manage attributes. 8 On the Events and Logs tabs, view information about the policy. 9 On the Permissions tab, add and remove access rights for users or user groups.
Using Packages 4 You can use packages to transport content from one Orchestrator server to another. Packages can contain workflows, actions, policies, Web views, configurations, and resources. When you add an element to a package, Orchestrator checks for dependencies and adds any dependent elements to the package. For example, if you add a workflow that uses actions or other workflows, Orchestrator adds those actions and workflows to the package.
Using the VMware vCenter Orchestrator Client 2 Click the Packages view. 3 Right-click in the left pane and select Add package. 4 Type the name of the new package and click Ok. The syntax for package names is domain.your_company.folder.package_name. For example, com.vmware.myfolder.mypackage. 5 Right-click the package and select Edit. The package editor opens. 6 On the General tab, add a description for the package. 7 On the Workflows tab, add workflows to the package.
Chapter 4 Using Packages 3 Search for a user or user group. The search results show all of the users and user groups that match the search. 4 Select a user or user group. 5 Check the appropriate check boxes to set the level of permissions for this user and click Select. To allow a user to view the elements, inspect the schema and scripting, run and edit the elements, and change the permissions, you must check all check boxes. 6 Click Save and close to exit the editor.
Using the VMware vCenter Orchestrator Client What to do next You can use all of the workflows, actions, policies, and Web views from the exported package on another Orchestrator server. Import a Package To reuse workflows, actions, policies, Web views, and configuration elements from one Orchestrator server on another server, you can import them as a package. IMPORTANT Packages that Orchestrator 3.2 generates are upwardly compatible with Orchestrator 4.x and 5.x.
Chapter 4 Using Packages 2 Click the Packages view. 3 Right-click within the left pane and select Get remote package. 4 Log in to the remote server. The Orchestrator Synchronization dialog box opens. It displays the differences between the package elements. To view only elements that are different on the local and remote server, select Hide identical from the drop-down menu. 5 Select the package that you want and click Import. 6 View the remote package elements and select an option.
Using the VMware vCenter Orchestrator Client Option Description Update The version of the remote element is later. The local element is updated. If an element does not exist locally, it is imported from the remote server to the local server. Merge The local and remote packages are overwritten with a merged list of references. The referenced elements remain unchanged. NOTE If the remote server does not recognize your certificate, you cannot commit elements. 6 Click Synchronize.
Using Authorizations 5 With authorizations you can manage the permissions of users and user groups over elements of specific types. This chapter includes the following topics: n “Create an Authorization Element,” on page 31 n “Configure an Authorization Element,” on page 31 Create an Authorization Element You can create an authorization element to provide different permissions to users or user groups over elements or specific type.
Using the VMware vCenter Orchestrator Client 2 Click the Authorizations view. 3 Right-click the authorization element that you want to modify and select Edit. The authorization element editor opens. 32 4 (Optional) On the General tab, edit the description of the element. 5 On the References tab, create references to available element types from the tree. 6 On the Permissions tab, set the level of permissions for a user or user group. 7 Click Save and close to exit the editor. VMware, Inc.
Index A action, version 15 actions 14 Actions view 9 Administer perspective 10 API Explorer, accessing 12 attributes 14, 15 audience 5 authorization element configuration 31 creation 31 authorization elements 31 authorizations 31 Authorizations view 10 C configuration elements 15 Configurations view 9 D Design perspective 9 E export workflow 21 I import workflow 21 input parameters 14 Inventory view 9 M exporting 27 getting 28 importing 28 permissions 26 removing 30 restricting reuse 27 signature 25
Using the VMware vCenter Orchestrator Client import 21 version 15 workflow attributes 15 workflow parameters 14 workflow presentation 15 workflow token 15 workflow token attributes 15 workflows library 16 permissions 14, 16 recurrence 20 restoring deleted 21 running 17 scheduling 19 standard 16 version history 20 Workflows view 9 34 VMware, Inc.
