Novell PLATESPIN ORCHESTRATE 2.0.2 - DEVELOPMENT CLIENT REFERENCE... Service manual

Novell®
www.novell.com
novdocx (en) 13 May 2009
AUTHORIZED DOCUMENTATION
PlateSpin Orchestrate 2.0 Development Client Reference
PlateSpin ® Orchestrate
2.0.2
August 28, 2009
Development Client Reference

novdocx (en) 13 May 2009
Legal Notices
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose.
Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time,
without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims
any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc.
reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to
notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export or import deliverables. You agree not to export or re-export to entities on
the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws.
You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. See the
Novell International Trade Services Web page (http://www.novell.com/info/exports/) for more information on
exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export
approvals.
Copyright © 2008-2009 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied,
stored on a retrieval system, or transmitted without the express written consent of the publisher.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this
document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S.
patents listed on the Novell Legal Patents Web page (http://www.novell.com/company/legal/patents/) and one or
more additional patents or pending patent applications in the U.S. and in other countries.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the latest online documentation for this and other Novell products, see
the Novell Documentation Web page (http://www.novell.com/documentation).

novdocx (en) 13 May 2009
Novell Trademarks
For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/
trademarks/tmlist.html).
Third-Party Materials
All third-party trademarks are the property of their respective owners.

4PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009

Contents 5
Contents
novdocx (en) 13 May 2009
About This Guide 9
1 Layout 11
2 Orchestrate Development Client Menus and Tools 15
2.1 The Operations Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.1.1 File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.1.2 Edit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.1.3 View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.1.4 Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.1.5 Provision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.1.6 Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.1.7 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.1.8 Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.2 The Orchestrate Development Client Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3 The PlateSpin Orchestrate Job Scheduler 25
3.1 Understanding the Job Scheduler View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.1.1 Navigating The Job Schedules Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.1.2 Creating or Modifying a Job Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.1.3 Understanding Cron Syntax in the Job Scheduler. . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.2 Walkthrough: Scheduling a System Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3.2.1 Deploying a Sample System Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3.2.2 Creating a New Schedule for the Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.2.3 Defining the New Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
3.2.4 Activating the New Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.2.5 Running the New Schedule Immediately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4 The Policy Debugger 51
4.1 The Constraints Table View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
4.1.1 The Match Context Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4.1.2 The Constraint Type List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.1.3 The Verbose Check Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.1.4 The Capable Resources Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.1.5 The Constraints Column of the Constraints Table View . . . . . . . . . . . . . . . . . . . . . . 54
4.1.6 The Policy Column of the Constraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.2 The Facts Table View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.2.1 The All Facts Check Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.3 Policy Debugger Use Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.3.1 Use Case 1: Determining Why a Job is in a Waiting State . . . . . . . . . . . . . . . . . . . . 57
5 The Explorer Tree 59
5.1 The Orchestrate Server Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
5.1.1 The Orchestrate Server Info/Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
5.1.2 The Orchestrate Server Authentication Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
5.1.3 The Orchestrate Server Policies Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

6PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009
5.1.4 The Orchestrate Server Constraints/Facts Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
5.2 The Server Admin Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
5.3 The Job Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
5.3.1 Job Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
5.3.2 The Job Info/Groups Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
5.3.3 The JDL Editor Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
5.3.4 The Job Library Editor Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
5.3.5 The Job Policies Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.3.6 The Job Constraints/Facts Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.4 The Resource Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.4.1 Resource Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.4.2 The Resource Info/Groups Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.4.3 The Provision Info Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
5.4.4 The Resource Log Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
5.4.5 The Resource Policies Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
5.4.6 The Resource Health Debugger Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
5.4.7 The Resource Constraints/Facts Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
5.5 The VM Host Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
5.5.1 The VM Host Info Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
5.5.2 The VM Host Policies Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
5.5.3 The VM Host Health Debugger Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
5.5.4 The VM Host Constraints/Facts Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
5.5.5 The VM Host Action History Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
5.6 The Repository Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
5.6.1 Repository Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
5.6.2 The Repository Info/Groups Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
5.6.3 The Repository Policies Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
5.6.4 The Repository Health Debugger Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
5.6.5 The Repository Constraints/Facts Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
5.6.6 The Repository Action History Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
5.7 The User Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
5.7.1 User Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
5.7.2 The User Info/Groups Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
5.7.3 The User Policies Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
5.7.4 The User Health Debugger Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
5.7.5 The User Constraints/Facts Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
5.7.6 The User Action History Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
5.8 Other Displayed Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
5.8.1 The Policy Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
5.8.2 Computed Fact Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
5.8.3 Event Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
5.8.4 Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
6 The Health Debugger 127
6.1 The Constraints Table Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.1.1 The Match Context Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
6.1.2 The Verbose Check Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
6.1.3 The Capable Objects Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
6.1.4 The Constraints Column of the Constraints Table View . . . . . . . . . . . . . . . . . . . . . 129
6.2 The Facts Table View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
6.2.1 The All Facts Check Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
6.3 Health Debugger Use Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
6.3.1 Use Case 1: ?? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Contents 7
novdocx (en) 13 May 2009
A Grid Object Health Monitoring 133
A.1 Health Facts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
A.2 Health Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
B Understanding Policy Elements 137
B.1 Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
B.2 Facts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
B.3 Computed Facts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
C Events 141
C.1 Event Object Visualization and Management in the Development Client . . . . . . . . . . . . . . . 141
C.1.1 Deploying a New Rule-Based Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
C.1.2 Deploying a Pre-written Rule-Based Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
C.1.3 Undeploying an Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
C.1.4 The Event Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
C.2 The Event Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
C.2.1 The Constraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
C.2.2 The Facts Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
C.3 Understanding the PlateSpin Orchestrate Events System. . . . . . . . . . . . . . . . . . . . . . . . . . . 146
C.3.1 Event Notification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
C.3.2 Built-in Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
C.3.3 Rule-based Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
D Provisioning Actions and History 151
D.1 What are Provisioning Actions? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
D.2 How Actions Are Displayed in the Development Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
D.2.1 Action History in Monitor Views of the Development Client . . . . . . . . . . . . . . . . . . . 151
D.2.2 Action History in Admin Views of the Development Client. . . . . . . . . . . . . . . . . . . . 152
E Documentation Updates 155
E.1 August 28, 2009 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
E.2 August 7, 2009 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
E.3 July 20, 2009 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
E.4 June 17, 2009 (2.0.2 Release). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

8PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009

About This Guide 9
novdocx (en) 13 May 2009
About This Guide
This PlateSpin Orchestrate Development Client Reference introduces the Development Client of
PlateSpin®Orchestrate from Novell®, the product’s basic administration environment. The guide
provides an introductory overview of the Orchestrate Development Client interface. The guide is
organized as follows:
Chapter 1, “Layout,” on page 11
Chapter 2, “Orchestrate Development Client Menus and Tools,” on page 15
Chapter 3, “The PlateSpin Orchestrate Job Scheduler,” on page 25
Chapter 4, “The Policy Debugger,” on page 51
Chapter 5, “The Explorer Tree,” on page 59
Appendix A, “Grid Object Health Monitoring,” on page 133
Appendix B, “Understanding Policy Elements,” on page 137
Appendix C, “Events,” on page 141
Appendix D, “Provisioning Actions and History,” on page 151
Appendix E, “Documentation Updates,” on page 155
Audience
This book is intended for data center managers and IT or Operations administrators. It assumes that
users of the product have the following background:
General understanding of network operating environments and systems architecture.
Knowledge of basic UNIX* shell commands and text editors.
Feedback
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comments feature at the bottom of each page of the
online documentation, or go to www.novell.com/documentation/feedback.html (http://
www.novell.com/documentation/feedback.html) and enter your comments there.
Documentation Updates
For the most recent version of this Development Client Reference, visit the PlateSpin Orchestrate 2.0
documentation Web site (http://www.novell.com/documentation/pso_orchestrate20/).
Documentation Conventions
In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and
items in a cross-reference path.
A trademark symbol (®, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party
trademark.

10 PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009
When a single pathname can be written with a backslash for some platforms or a forward slash for
other platforms, the pathname is presented with a backslash. Users of platforms that require a
forward slash, such as Linux* or UNIX, should use forward slashes as required by your software.

Layout
1
11
novdocx (en) 13 May 2009
1
Layout
Both the grid administrator and the job developer need to have access to and use the PlateSpin®
Orchestrate Development Client. The administrator needs to use the console to perform any
management functions, such as creating user accounts and managing Orchestrator Server activities.
The developer uses the console to access the JDL editor for creating or modifying jobs and policies.
The following figure shows the general areas on the console interface that are referred to in this
guide.
Figure 1-1 The PlateSpin Orchestrate Development Client with Parts Identified
The following chart describes the functional areas of the main PlateSpin Orchestrate Development
Client display.

12 PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009
Table 1-1 Detailed Description of Console Areas
Area Description
Menu bar Provides operations categorized under menus such as File, Edit, View, Grid,
Server, Windows, and Help.
The File menu lets you save any changes you’ve made or exit the
console.
The Edit menu lets cut, copy, and paste items and choose general and
server preferences for console.
The View menu lets you manipulate the display of the different
components of the console and refresh the Explorer and Workspace
panels.
The Actions menu lets you launch specific tools that create and delete
users or user groups, computing resources, jobs, policies, and
computed facts.
The Server menu lets you start a local server, log in to the server, create
and display logs for logged in servers, log out from the server, and shut
down the server.
The Windows menu lets you select console windows to display when
you have more than one console window open. You can open the
Explorer panel and the two tabs of the Info panel (<Orchestrator> Log
and Console Output) in their own windows by right-clicking the tab and
choosing Open in window in the pop-up menu.
The Help menu provides access to the About box for the console. It also
provides a link to ZENworks Orchestrator documentation on the Web.
Main toolbar The main toolbar has buttons for executing common tasks. The basic tasks
are Go Back, Go Forward, Refresh the view, Hide or Show the Explorer
Panel, Cut, Copy, Paste, and Save changes in workspace view and Open the
Find Dialog.
The toolbar also includes buttons that open monitoring views for Jobs,
Resources, and Users.
To the far left of the toolbar, a pinwheel icon indicates when the console is
busy.
Explorer panel The Explorer panel displays a hierarchical tree. The tree lets you navigate to
different objects; you can click items in the tree to see their details. For
example, you can display computing resources for a selected grid. When you
click Computing Resources in the tree, its details appear in the Workspace
panel with a list of active computing resources. You can edit the Computing
Resource attributes in the workspace panel.
Workspace panel The Workspace panel displays a detailed view for an item you select in the
Explorer panel. For example, if you select a computing resource under
physical in the Explorer panel, the Workspace panel view changes to show
the details for that resource. You can edit the properties of an Orchestrator
object in the views displayed in the Workspace panel.
Info panel The Info panel displays a variety of information, such as validation and error
messages, log files, and query results. You can display or hide the Info panel
by clicking the Info panel button in the Status bar.

Layout 13
novdocx (en) 13 May 2009
For information about launching the console and using it for the first time, see “Walkthrough:
Launching the PlateSpin Orchestrate Development Client”in the PlateSpin Orchestrate 2.0
Installation and Configuration Guide.
For detailed information about the components, icons, and usage of the PlateSpin Orchestrate
Development Client, see Chapter 2, “Orchestrate Development Client Menus and Tools,” on
page 15.
Status bar The status bar displays general identity information about the Orchestrator
Server where you are logged in.
Area Description

14 PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009

Orchestrate Development Client Menus and Tools
2
15
novdocx (en) 13 May 2009
2
Orchestrate Development Client
Menus and Tools
A number of operations are available from the PlateSpin Orchestrate Development Client from
Novell®and can be accessed from its menu bar and toolbar.
Section 2.1, “The Operations Menu Bar,” on page 15
Section 2.2, “The Orchestrate Development Client Toolbar,” on page 23
2.1 The Operations Menu Bar
The Operations Menu Bar in the Orchestrate Development Client provides options that help you to
create and administer objects in the Explorer Tree.
Section 2.1.1, “File,” on page 15
Section 2.1.2, “Edit,” on page 16
Section 2.1.3, “View,” on page 19
Section 2.1.4, “Actions,” on page 19
Section 2.1.5, “Provision,” on page 19
Section 2.1.6, “Server,” on page 21
Section 2.1.7, “Windows,” on page 23
Section 2.1.8, “Help,” on page 23
2.1.1 File
The File menu (Alt+F) provides keyboard and mouse accessible methods for users to save changes
or to exit the application.
“Save” on page 15
“Exit” on page 15
Save
The Save operation provides a mouse and keyboard (File > Ctrl+S) accessible method for users to
save any changes made in the visible view.
Exit
The exit operation provides a mouse and keyboard (File > Alt+X) accessible method for users to
close all server connections and to exit the Orchestrate Development Client application.

16 PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009
2.1.2 Edit
The Edit menu (Alt+E) provides keyboard and mouse accessible methods for users to save changes
or to exit the application.
“Undo Addition” on page 16
“Redo” on page 16
“Cut” on page 16
“Copy” on page 16
“Paste” on page 16
“Find” on page 17
“Find Next” on page 17
“Find Previous” on page 17
“Enter Find String” on page 17
“Load Text” on page 17
“Save Text” on page 17
“Preferences” on page 17
Undo Addition
The Undo operation provides a mouse-accessible method for users to undo the action they have just
performed in the Orchestrate Development Client. The operation can also be executed from the
keyboard (Ctrl+Z).
Redo
The Redo operation provides a mouse-accessible method for users to redo the action they have just
performed in the Orchestrate Development Client. The operation can also be executed from the
keyboard (Ctrl+Y).
Cut
The Cut operation provides a mouse-accessible method for users to cut the selected object and move
it to the clipboard. The operation can also be executed from the keyboard (Ctrl+X).
Copy
The Copy operation provides a mouse-accessible method for users to copy the selected object to the
clipboard. The operation can also be executed from the keyboard (Ctrl+C).
Paste
The Paste operation provides a mouse-accessible method for users to paste the contents of the
clipboard to the desired location. The operation can also be executed from the keyboard (Ctrl+V).

Orchestrate Development Client Menus and Tools 17
novdocx (en) 13 May 2009
Find
The Exit operation provides a mouse-accessible method for users to open the Find and Replace
dialog box, where they can search for and replace (if necessary) editable strings located in logs and
editing views (for example, the Policy Editor).
Figure 2-1 The Find and Replace Dialog Box Invoked From the Policy Editor
The operation can also be executed from the keyboard (Ctrl+F).
Find Next
The Find Next operation provides a mouse-accessible method for users to find the next occurrence
of the string they previously searched for. The operation can also be executed from the keyboard
(F3).
Find Previous
The Find Previous operation provides a mouse-accessible method for users to find the previous
occurrence of the string they searched for. The operation can also be executed from the keyboard
(Shift+F3).
Enter Find String
The Enter Find String operation provides a mouse-accessible method for users to load the text of the
string they want to search for. The operation can also be executed from the keyboard (Ctrl+E).
Load Text
The Load Text operation provides a method for users to load text from an existing file into the open,
editable view. When selected, the operation opens a browse dialog box where the file can be
selected.
Save Text
The Save Text operation provides a method for users to save text in an editable, active view to a file.
When selected, the operation opens a save dialog box where you can browse to a network location
where you want to save the file. By default, the file is named according to the view and the context
within which you are viewing it. You can change the name of the file when you save it.
Preferences
The Preferences operation provides a method for users to change the preferences for the Orchestrate
Development Client display. When selected, the operation opens the Orchestrate Development
Client Preferences dialog box.

18 PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009
The dialog box has three tabbed pages.
General Page
Figure 2-2 General Page of the Orchestrate Development Client Preferences
Preference settings on this page that you can change are self-explanatory. If you click Initialize
Preferences, the preference settings (except Look and Feel settings) are initialized to installation
values.
Server Page
Figure 2-3 Server Page of the Orchestrate Development Client Preferences
Preference settings on this page that you can change are self-explanatory.

Orchestrate Development Client Menus and Tools 19
novdocx (en) 13 May 2009
Java Properties Page
Figure 2-4 The Java Properties Page of the Orchestrate Development Client Preferences
This page lists the Java property names and values that Novell uses to render the Orchestrate
Development Client interface in Java Swing. The list is for your information only.
2.1.3 View
The View menu includes various operations that let you manipulate the Orchestrate Development
Client display of the various PlateSpin Orchestrate component views. The function of the options
under this menu are self explanatory, and are a compilation of view operations that are also available
from the Operations toolbar.
For more information about the View operations, see Section 2.2, “The Orchestrate Development
Client Toolbar,” on page 23.
2.1.4 Actions
The multiple operations listed as options under the Actions menu provide a quick way for you to
perform operations that can also be performed (generally by right-clicking an object) in the Explorer
View.
For example, if you select a Create option from the Actions menu, the create dialog remains open
after you create each object. Here you can repeatedly create new objects in the dialog, pressing OK
or Create after each is created. Similarly, in the dialog boxes of some operations in the Actions
menu, you can select many objects and delete them at the same time.
2.1.5 Provision
The Provision menu is added to the menu bar only if you have installed Virtual Machine
Management. The multiple operations listed in the menu include two of the provisioning actions that
you can execute by right-clicking a VM object in the Explorer Tree.

20 PlateSpin Orchestrate 2.0 Development Client Reference
novdocx (en) 13 May 2009
Discover VM Hosts & Repositories
When you select this option, the Discover VM Hosts and Repositories dialog box is displayed.
Figure 2-5 VM Discovery Dialog Box
Using this dialog box, you can select a provisioning adapter ( esx , hyperv , vcenter , vmserver , or
xen30 ) that discovers all VM host machines where the PlateSpin Orchestrate Agent is installed and
creates objects in the model. The provisioning adapter also discovers the VM Repositories where
VM hosts reside.
Discover VM Images
When you select this option, the Discover VM Images dialog box is displayed.
Figure 2-6 VM Images Discover Dialog Box
Using this dialog box, you can select a provisioning adapter ( esx , hyperv , vcenter , vmserver , or
xen30 ) that discovers all VM images and creates objects in the model.
Other Provisioning Operations
The other operations listed in the menu are self-explanatory.
 Start VM Hosts
 Shutdown VM Hosts