Novell PLATESPIN ORCHESTRATE 2.0.2 - VIRTUAL MACHINE MANAGEMENT GUIDE... Programming manual

Novell®
www.novell.com
novdocx (en) 13 May 2009
AUTHORIZED DOCUMENTATION
PlateSpin Orchestrate 2.0 Virtual Machine Management Guide
PlateSpin Orchestrate
2.0.2
November 17, 2009
Virtual Machine Management Guide

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 © 2007-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 Virtual Machine Management Guide
novdocx (en) 13 May 2009

Contents 5
Contents
novdocx (en) 13 May 2009
About This Guide 7
1 Managing Virtual Machine Hosts 9
1.1 Configuring Policies for VM Provisioning Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.1.1 Configuring Policies for Virtual Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.1.2 Configuring Policies for Xen 3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.1.3 Configuring Policies for VMware Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.1.4 Configuring Policies for Hyper-V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.1.5 Configuring Policies for ESX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.2 Discovering VM Hosts and Repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.3 Discovering VM Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4 Resynchronizing the VM Host’s State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.5 Shutting Down VM Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.6 Restarting VM Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.7 Understanding VM Host Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2 Managing Virtual Machines 21
2.1 Provisioning a Virtual Machine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.2 Managing a Virtual Machine in Runtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.2.1 Using the Right-Click Menu for Provisioning Actions. . . . . . . . . . . . . . . . . . . . . . . . . 22
2.2.2 Prerequisites for Performing Provisioning Actions on ESX VMs . . . . . . . . . . . . . . . . 25
2.2.3 Releasing a Virtual Machine from Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.2.4 Managing Virtual Machine Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.2.5 Managed Virtual Machine Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
2.2.6 Virtual Machine Technology-Specific Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
2.3 Resynchronizing the State of All VMs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
2.4 Resynchronizing the State of All VMs of a Specific VM Host. . . . . . . . . . . . . . . . . . . . . . . . . . 29
2.5 Shutting Down Multiple VMs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
2.6 Destroying and Deleting a Virtual Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3 Managing VM Repositories 31
3.1 Deploying a VM to the Local Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.2 Deploying a VM to the Datagrid Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.3 Deploying a VM to the NAS Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.4 Deploying a VM to the SAN Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.5 Virtual Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4 Troubleshooting Provisioning Actions 35
5 Understanding Autoprep 41
5.1 Setting Autoprep Facts in the Development Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.1.1 Setting Linux Autoprep Config Facts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5.1.2 Setting Autoprep Network Adapter Facts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.2 Applying Autoprep Facts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5.2.1 Example Autoprep Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6PlateSpin Orchestrate 2.0 Virtual Machine Management Guide
novdocx (en) 13 May 2009
5.2.2 How Autoprep Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
5.3 Known Autoprep Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
A Virtual Machine Technologies and Actions 47
A.1 Virtual Machine Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
A.2 Xen Hypervisor on SLES 10 SP2 or SLES 11 Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
A.2.1 Additional Xen Provisioning Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
A.3 VMware Virtual Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
A.3.1 Additional VMware Virtual Center Provisioning Adapter Information. . . . . . . . . . . . . 51
A.4 Microsoft Hyper-V Hypervisor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
A.5 VMware ESX VM Hypervisor (Experimental). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
B Documentation Updates 55
B.1 November 17, 2009 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
B.2 July 9, 2009 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
B.3 June 17, 2009 (2.0.2 Release). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

About This Guide 7
novdocx (en) 13 May 2009
About This Guide
In addition to managing virtual machines (VMs) and host servers using the PlateSpin®Orchestrate
VM Client, you can do other management work using the PlateSpin Orchestrate Development
Client. This Virtual Machine Management Guide provides instructions on the management tasks
that you can do in the Development Client.
The guide is organized as follows:
Chapter 1, “Managing Virtual Machine Hosts,” on page 9
Chapter 2, “Managing Virtual Machines,” on page 21
Chapter 3, “Managing VM Repositories,” on page 31
Chapter 4, “Troubleshooting Provisioning Actions,” on page 35
Chapter 5, “Understanding Autoprep,” on page 41
Appendix A, “Virtual Machine Technologies and Actions,” on page 47
Appendix B, “Documentation Updates,” on page 55
For documentation on using Orchestrate jobs to further manage VMs, host machines, and physical
machines, see “Virtual Machine Job Development” in the PlateSpin Orchestrate 2.0 Developer
Guide and Reference.
Audience
This book is for data center administrators. It assumes that users of the product have the following
background:
General understanding of network operating environments and systems architecture
Knowledge of basic Linux* shell commands, the Windows* command prompt, 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.
Additional Documentation
In addition to this Virtual Machines Management Guide, PlateSpin Orchestrate 2.0 includes the
following additional guides that contain valuable information about the product:
PlateSpin Orchestrate 2.0 Getting Started Reference
PlateSpin Orchestrate 2.0 Installation and Configuration Guide
PlateSpin Orchestrate 2.0 Upgrade Guide
PlateSpin Orchestrate 2.0 High Availability Configuration Guide
PlateSpin Orchestrate 2.0 Administrator Reference
PlateSpin Orchestrate 2.0 Command Line Reference

8PlateSpin Orchestrate 2.0 Virtual Machine Management Guide
novdocx (en) 13 May 2009
PlateSpin Orchestrate 2.0 VM Client Guide and Reference
PlateSpin Orchestrate 2.0 Development Client Reference
PlateSpin Orchestrate 2.0 Developer Guide and Reference
PlateSpin Orchestrate 2.0 Server Portal Reference
Documentation Updates
For the most recent version of this guide, visit the PlateSpin Orchestrate 2.0 documentation Web site
(http://www.novell.com/documentation/ps_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.
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, should use forward slashes as required by your software.

Managing Virtual Machine Hosts
1
9
novdocx (en) 13 May 2009
1
Managing Virtual Machine Hosts
After installing the PlateSpin®Orchestrate Agent on the physical resource, you can discover for the
hypervisor technology residing on the resource by editing the appropriate policies and running the
Discover VM hosts job. Later on, you can discover and manage VMs residing on the VM hosts.
These launch the adapter job to connect to the appropriate hypervisor Web service.
Section 1.1, “Configuring Policies for VM Provisioning Adapters,” on page 9
Section 1.2, “Discovering VM Hosts and Repositories,” on page 15
Section 1.3, “Discovering VM Images,” on page 16
Section 1.4, “Resynchronizing the VM Host’s State,” on page 16
Section 1.5, “Shutting Down VM Hosts,” on page 17
Section 1.6, “Restarting VM Hosts,” on page 18
Section 1.7, “Understanding VM Host Failover,” on page 18
1.1 Configuring Policies for VM Provisioning
Adapters
This section contains information on the policies required to manage the Provisioning adapters.
Provisioning adapters are programs that provision (start, stop, snapshot, migrate, or pause) a VM.
They run just like regular jobs on the PlateSpin Orchestrate Server.
Section 1.1.1, “Configuring Policies for Virtual Center,” on page 9
Section 1.1.2, “Configuring Policies for Xen 3.0,” on page 12
Section 1.1.3, “Configuring Policies for VMware Server,” on page 12
Section 1.1.4, “Configuring Policies for Hyper-V,” on page 13
Section 1.1.5, “Configuring Policies for ESX,” on page 14
1.1.1 Configuring Policies for Virtual Center
Before provisioning and managing the Virtual Center provisioning adapter, you must configure
certain policies in the Development Client. However, before configuring the policies for the Virtual
Center, make sure that the following prerequisites are met:
Make sure that the Orchestrate Agent for Windows* is installed and started on the Windows
host running Virtual Center.
IMPORTANT: The PlateSpin Orchestrate Server supports only one VMware Virtual Center
server per grid.
Make sure that J2RE with version 1.4.2 for VCenter 1.x or version 1.5 for VCenter 2.x is
installed on the Windows system running Virtual Center.

10 PlateSpin Orchestrate 2.0 Virtual Machine Management Guide
novdocx (en) 13 May 2009
NOTE: In the 2.0.2 release of PlateSpin Orchestrate, the VMware Virtual Center Provisioning
Adapter supports only VMware Virtual Center 2.x. Virtual Center 1.x is not supported in this
release.
The JREs that ship with Virtual Center and with the Orchestrate Agent are version 1.5. Version
1.4.2_15 can be downloaded from the Sun* Download Center (https://sdlc4a.sun.com/ECom/
EComActionServlet;jsessionid=88B0E4E7E868F2F6C671427ACC9C0D13).
Make sure that the keystore is created on the server where Virtual Center is installed.
If the keystore is not created, do the following on the server where Virtual Center is installed to
generate it
1. Find the
rui.crt certificate.
On Windows, the default location is:
C:\Documents and Settings\All
Users\Application Data\VMware\VMware VirtualCenter\SSL\rui.crt
.
2. Create a
VCenter_Certs directory at the top level by entering mkdir
C:\VCenter_Certs\
.
3. Copy
rui.crt to C:\VCenter_Certs\ .
4. Run
keytool .
The default location is
C:\Program Files\VMware\VMware VirtualCenter
2.0\jre\bin\keytool.exe
.
5. Enter:
cd C:\VCenter_Certs
[path]keytool -import -keystore keystore -file rui.crt
6. Enter a password when prompted.
The following table provides detailed information about the policies associated with the Virtual
Center provisioning adapter that are used to manage the Virtual Center hosts and the VMs in the
grid. The policy settings are applied to all the Virtual Center VMs in the grid.
Table 1-1 Virtual Machine Management Policies for Virtual Center
Policy Name Explanation Additional Details
vcenter Contains the constraints used
to select the vCenter Server
resources.
Do not edit the policy.