Page 1 AUTHORIZED DOCUMENTATION VM Client Guide and Reference Novell ® PlateSpin Orchestrate ® 2.0.2 June 17, 2009 www.novell.com PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 2 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.
Page 3 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.
Page 4 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 5: Table Of Contents
Contents About This Guide 1 Overview What Is the PlateSpin Orchestrate VM Client? ........11 Understanding the Virtual Machine Life Cycle .
Page 6 5.1.2 Using the Details Tabs..........68 Using Feedback to Manage VMs .
Page 7 Deleting Templates ............138 8 Managing Clones of Templates Cloning Templates .
Page 8 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 9: About This Guide
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.
Page 10 ® A trademark symbol ( , 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.
Page 11: Overview
® ® Review the following sections to understand the PlateSpin Orchestrate VM Client from Novell Section 1.1, “What Is the PlateSpin Orchestrate VM Client?,” on page 11 Section 1.2, “Understanding the Virtual Machine Life Cycle,” on page 12 Section 1.3, “Using This Guide to Manage VMs,” on page 13 1.1 What Is the PlateSpin Orchestrate VM Client?
Page 12: Understanding The Virtual Machine Life Cycle
The VM Client enhances the functionality of the PlateSpin Orchestrate Server, enabling it to control VMs in your data center. PlateSpin Orchestrate also provides the Development Client, where you can manage and control data center jobs and processes through the application of rules, policies, scheduling, utilization, and billing data center resources.
Page 13: Using This Guide To Manage Vms
Resynchronizing a VM to ensure that the state of the VM displayed in the Orchestrate Development Client is accurate Cloning a VM from a template To view the histories of life cycle events or why they might fail, simply review a VM’s logs. For more information, see Section 5.2, “Using Feedback to Manage VMs,”...
Page 14 Open the Progress View for a VM while a life cycle function is running. View a VM’s details. View a host server’s details. View a repository’s details. View a template’s details. Troubleshoot VMs. Find operating system installation sources for VMs. PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 15: Getting Started
Getting Started ® To get started with the PlateSpin Orchestrate VM Client, do the following: Section 2.1, “Starting and Logging In to the VM Client Interface,” on page 15 Section 2.2, “Logging In to Another Virtualization Grid,” on page 19 Section 2.3, “Registering VM Hosts,”...
Page 16 The first time you start the VM Client, the following Welcome page is displayed: The Welcome page does not display the next time you log in to the VM Client. The Welcome page can be accessed at any time by clicking View > Show Welcome Page. For more information, see Section 3.1, “Understanding and Navigating the Welcome Page,”...
Page 17: Starting The Interface On A Linux Workstation
2.1.2 Starting the Interface on a Linux Workstation 1 On your Linux workstation, open a command terminal, change to the /opt/novell/ directory (the default installation location), or to wherever zenworks/vmmanagement/bin/ you installed the client, then enter the following command: ./vmclient.sh...
Page 18 The first time you start the VM Client, the following Welcome page is displayed: The Welcome page does not display the next time you log in to the VM Client. The Welcome page can be accessed at any time by clicking View > Show Welcome Page. For more information, see Section 3.1, “Understanding and Navigating the Welcome Page,”...
Page 19: Logging In To Another Virtualization Grid
3 Specify the IP address or DNS name of a PlateSpin Orchestrate Server. The PlateSpin Orchestrate Server is associated with a virtualization grid, which can be associated with registered VM host servers. Therefore, logging in to an Orchestrate Server allows you to manage all VMs in the grid. 4 Enter a username and password to authenticate you as the administrator of the Orchestrate Server, then click Login to view the VM Client interface: 5 (Conditional) If this is the first time that anyone has logged in to the VM Client, continue with...
Page 20: Registering Vm Hosts
2.3 Registering VM Hosts After being installed on a computing node, having its credentials defined, and associating itself with the computing node, the Orchestrate Agent begins broadcasting the availability of its host as a potential computing resource. A host is defined as a machine running a supported hypervisor agent.
Page 21: Discovering Registered Vm Hosts
After the host server has been registered with the Orchestrate Server, it is listed with its operating system. If the host server doesn’t become registered after a few minutes, run the Discover Hosts job from the Action menu. 4 (Optional) To reject the registration of a host server, do one of the following: Select the server in the details view, then click the button.
Page 22: Discovering Vms Of The Registered Vm Hosts
All the registered VM hosts that are in the virtualization grid and that have hypervisors installed are displayed. 2 To discover any VMs belonging to the VM hosts that you discovered, continue with Section 2.5, “Discovering VMs of the Registered VM Hosts,” on page 2.5 Discovering VMs of the Registered VM Hosts You can use the VMs you have previously created or the VMs you have built by using other hypervisors in your data center.
Page 23 Discovered (#) is displayed below Virtual Machines, where # represents the number of VMs that are waiting to be registered with the Orchestrate Server. 2 Click Discovered (#) to display the unregistered VMs in the details section on the right. You can accept (see Step 3) or reject (see...
Page 24 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 25: Understanding The Vm Client Interface
Understanding the VM Client Interface ® The PlateSpin Orchestrate VM Client interface, built on an Eclipse-based rich client platform, uses a graphical user interface (GUI) to help you create, store, edit, and use VMs. This interface can be installed on both Windows and Linux administration devices. Review the following sections for tips on navigating and using the VM Client interface: Section 3.1, “Understanding and Navigating the Welcome Page,”...
Page 26: Understanding And Navigating The Welcome Page
3.1 Understanding and Navigating the Welcome Page The Welcome page provides basic information on the VM Client. By default, it is displayed when you first open the VM Client. Thereafter, you can access the Welcome page using View > Show Welcome Page.
Page 27: Welcome Page Main Menu Options
3.1.1 Welcome Page Main Menu Options The main VM Client menu options are available at the top of the Welcome page, but only those that are applicable are enabled: File > Exit: Closes the VM Client interface. Closing the VM Client interface does not affect the status of any VMs, meaning that the VMs that have processes running, such as cloning, starting, moving, and so on, continue to run those processes.
Page 28: Welcome
Help > How to Use This Guide: Opens a section of the product documentation in your default Web browser and provides a list of things you can do in the VM Client. The list is ordered in a tutorial fashion. Help >...
Page 29 “Latest Features” on page 30 “Manage Your VMs” on page 30 Overview The Overview button provides the following information: Welcome Page Overview Figure 3-2 To navigate to the other locations on the Welcome page, you can use the links in the upper right of the Overview page.
Page 30: Understanding The Vm Client Window
Latest Features The Latest Features button provides the following information: Welcome Page Latest Features Figure 3-3 Manage Your VMs The Manage Your VMs button opens the VM Client Login dialog box: The VM Client Login Dialog Box Figure 3-4 For more information on logging in to the VM Client, see Section 2.2, “Logging In to Another Virtualization Grid,”...
Page 31: Multiple Vm Operator Logins
Section 3.2.2, “Customizing the VM Client Sections,” on page 32 Section 3.2.3, “Navigating the VM Client Window,” on page 35 Section 3.2.4, “Sorting, Searching, and Filtering Lists,” on page 41 Section 3.2.5, “Viewing Additional Information in Fields or Cells,” on page 46 3.2.1 Multiple VM Operator Logins Multiple VM operators can each be running an instance of the VM Client that is logged in to the same VM virtualization grid.
Page 32: Customizing The Vm Client Sections
3.2.2 Customizing the VM Client Sections You can do several things to customize the sections in the VM Client. Any changes you make are remembered the next time you start the VM Client. Tiling: Multiple editors can be open at the same time. Select the status bar of an editor and drag it to a different position in the VM Client window to create the tiling effect.
Page 33 to display: To return to the previous unmaximzed view, double-click the VM or host server’s name again. You can also maximize or minimuze the Progress View or Error Log sections by double- clicking in the white area next to the Error Log or Progress View section’s title: Understanding the VM Client Interface...
Page 34 Dragging: You can drag sections (such as Progress View or Error Log) out of the VM Client window to another position on your desktop. You can also drag sections to different locations within the VM Client window. For example, the following illustrates that the Error Log section has been dragged outside of the VM Client window: To move sections around, click in the white area and drag the section to its new location, either within the VM Client window, or outside of it:...
Page 35: Navigating The Vm Client Window
Keystrokes and Mouse Clicks: The following functions are available in the VM Client: Function Action Minimize or maximize of a section in Double-click the status bar the VM Client window Press the Spacebar or Enter key Press the Left-arrow or Right-arrow key Go to the next or previous node Press the Left-arrow or Right-arrow key Go to the next or previous sibling...
Page 36 Storage Templates Each of these four links lists the available items, such as known VMs, known host servers, known repositories, and any templates that you have created from the VMs. By default, the Virtual Machines list is initially displayed when you log in. When you double-click an item in a list, its details tabs are displayed (see “Inventory Details”...
Page 37 The following describes the various features of the VM Client window: Inventory item’s title area: This area provides information for what is being viewed, including an icon to indicate which type of resource is being viewed, and square brackets to indicate any action or viewing condition that is in effect.
Page 38 Available Options: For each of the Inventory sections, items listed in the right panel have various main menu options, right-click menu options, and function buttons displayed, not displayed, enabled, or disabled according to the item’s status. Column Sorting: You can sort the various columns of information alphanumerically. Simply click a column heading to sort it in ascending or descending order.
Page 39 This is the same dialog box that clicking Help > Version Information accesses: This option is also available for the Inventory details views. Inventory Details In each of the four Inventory sections you can display detailed information by either double-clicking an item or right-clicking it and selecting Show Details.
Page 40 You can easily navigate between the different Inventory types’ details tabs. For example: While viewing the details of a VM, you can double-click a host server or repository name that is listed in the first section on the VM’s Summary tab to display the details tabs for the host or repository instead of the VM’s tabs.
Page 41: Sorting, Searching, And Filtering Lists
Event Log Tab with Event Log and Event Log Details Dialog Boxes Figure 3-8 For more information, see “Using Feedback to Manage VMs” on page For information on using and editing information in each of the details tabs, see the applicable sections in: Section 4.2, “Viewing and Editing Host Server Details,”...
Page 42 Sorting Lists Any list in the VM Client can be sorted alphanumerically in an ascending or descending order by clicking the column heading. You can sort rows of information by any column. Most lists default to sorting alphabetically on the first column. For example: VMs Sorted by Name Figure 3-9 VMs, host servers, repositories, and templates are sorted alphanumerically by default.
Page 43 Host Servers’ CPU or Memory columns: Sorting is a quick way to determine your host servers’ utilization if the Orchestrate Agent and Monitoring Agent are installed and running on them. Storage’s Stored VMs, Type, Capacity, and Free columns: Sorting might help you in selecting repositories for new VMs, viewing how many repositories you have by type, and determining which repositories are most or least utilized.
Page 44 Filtering Lists You can shorten any list by filtering on its items. This function is best used when you have a very long list and some of the items contain the same characters. This way, you can display only the few items that you want to focus on.
Page 45 If you enter a string that has no match, the list is empty. To redisplay the full list, click the icon to clear the filter string, or manually delete the filter string. Because the filter string is dynamically read, you can delete recently typed characters to redisplay previous hits. For any list in the VM Client, the filter strings that you enter are remembered when you return to those lists.
Page 46: Viewing Additional Information In Fields Or Cells
The up-arrow and down-arrow in the locator pop-up allow you to move from hit to hit in the list. The arrow keys on the keyboard also perform this action when the locator pop-up is visible. This arrow action is very useful in long lists where the hits might not all occur together. For example, typing might find hits that are scattered across an Event Log.
Page 47 Virtual Machines view: Name column: Displays the VM’s name, its host, and its repository. Status column: Displays the VM’s status. For the in-progress status ( ), it shows the action name, action detail, start time, elapsed time, a progress bar, and the latest three log entries (which are updated dynamically).
Page 48: Using The Error Log
3.3 Using the Error Log The Error Log section is displayed at the bottom of the interface window when you click View > Show Error Log. You can also double-click an error message in the lower left of the VM Client window to open this view.
Page 49 Use these menu options to do the following: Right-Click Menu Options for the Error Log Section Table 3-1 Option Function Copy Copies information about the error entry that you right-click to your computer’s clipboard. Clear Log Viewer Clears all entries from the Error Log section. Delete Log Clears all entries from the Error Log section and deletes the log file.
Page 50: Using The Progress View
3.4 Using the Progress View The Progress View section is useful for when you have actions occurring simultaneously for multiple VMs because you can keep track of which ones are still running. The Progress View section is displayed at the bottom of the interface window. When is not displayed, you click View > Show Progress View or double-click Show/Hide Progress View in the lower right of the VM Client window: Show/Hide Progress View Option...
Page 51: Resetting The Vm Client Perspectives
3.5 Resetting the VM Client Perspectives You can reset the various perspectives to their original configuration: 1 In the Client, click View > Reset Perspective. The following dialog box is displayed: 2 Click OK to reset the perspectives: The Inventory panel is reset to its original size and location, to the left of the VM Client window.
Page 52 Tahiti Ocean Classic Graphite Moon To change the VM Client’s color theme: 1 In the Client, click View > Change Theme to display the Change Theme dialog box: The currently selected theme has next to its name. (current) PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 53 This option is available on both the Welcome page as well as in the Inventory sections, so you can change the theme on the Welcome page before logging in to a host. 2 In the drop-down list, select a theme and click OK to display the Restart VM Client dialog box: If you select the theme with next to its name and click OK, the Restart VM Client (current)
Page 54 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 55: Managing Vm Host Servers
Managing VM Host Servers You can do the following with VM host servers: Section 4.1, “Understanding VM Host Servers,” on page 55 Section 4.2, “Viewing and Editing Host Server Details,” on page 55 Section 4.3, “Using Feedback to Manage Host Servers,” on page 64 Section 4.4, “Accessing a Host Server’s Console,”...
Page 56: Accessing Host Server Details
4.2.1 Accessing Host Server Details The details for each host server consist of a summary, configuration information, monitoring information, and an event log. 1 In the Client, click the Host Servers view. The host servers are displayed: 2 Do one of the following: Double-click one of the host servers.
Page 57: Summary Tab
Summary Tab This details tab is used by each Inventory panel type: Summary Tab for Host Servers Figure 4-1 You can do the following with the Summary tab for host servers: In the first section, right-click a group name under Groups, then select Remove to revoke the host server’s membership in the group.
Page 58: Configuration Tab
Right-click a listed VM, then select any of the available menu options. These are the same right-click menu options that are available for the VM in the Virtual Machines Inventory list. Double-click a listed VM to view its details tabs. Wherever N/A appears in the details, it means that the information is not available.
Page 59: Monitoring Tab
Click Storage to view information about storage availability on the host server: Click DNS and Routing to view the computer name and domain name for the host server: Monitoring Tab This details tab allows you to monitor many elements of both the virtual machines and physical host machines, aiding you in the overall management of your data center.
Page 60 Understanding Monitoring The Monitoring tab displays information about the VM or host server that you can use to monitor whether it is performing correctly, is overused or underused, its history, and details about its capacities. The default window size for the VM Client only allows one column of graphics to be displayed. The following is an example of the Monitoring tab’s information: Monitoring Tab for a Host Server Showing Default Single Column View of Graphics Figure 4-2...
Page 61 The following example shows that graphics can be displayed side-by-side when you expand the width of the VM Client window. Monitoring Tab for a Host Server Showing Multiple Column View of Graphics Figure 4-3 Monitoring VMs and Host Servers 1 In the Client, click the Virtual Machines view or the Host Servers view, then double-click a VM or host server that you want to monitor.
Page 62 The following illustrates the Monitoring tab maximized in the VM Client Window: Double-click the item’s title again to return the tab to its previous view. 6 To refresh the graphics, click the Get Fresh Data button. You can refresh the view at any time. PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 63: Event Log Tab
Event Log Tab This details tab is used by VMs and host servers: Event Log Tab for VMs Figure 4-4 This tab provides information from both the resource log messages and the action status history log, intermingled based on start times. Therefore, the log provides both information on the host server as well as actions for any VMs it is currently hosting.
Page 64: Using Feedback To Manage Host Servers
You can do the following with this tab: View the Event Log information. Double-click an event item that contains the icon to view the details of the event as reported by the Orchestrate Server. The following is an example of an event’s details: 4.3 Using Feedback to Manage Host Servers The VM Client is integrated with the Orchestrate Server and the Development Client...
Page 65: Resynchronizing A Host Server's State
Select the host, then click View > Show Console. Right-click the host, then select Show Console. 3 Provide the VNC password, then click OK. When attempting to make a VNC connection, VNC tests for a fully qualified domain name (FQDN), simple host name, or IP address. 4.5 Resynchronizing a Host Server’s State The Orchestrate Server is automatically updated to list the state of the hosted VMs after every provisioning...
Page 66 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 67: Managing Virtual Machines
Managing Virtual Machines ® You can do the following for hands-on management of virtual machines (VMs) in the PlateSpin Orchestrate VM Client: Section 5.1, “Viewing and Editing VM Details,” on page 67 Section 5.2, “Using Feedback to Manage VMs,” on page 70 Section 5.3, “Virtual Machine Actions,”...
Page 68: Using The Details Tabs
2 Do one of the following: Double-click one of the VMs. Right-click one of the VMs, then select Show Details. The tabs for the selected VM are displayed. 3 For details on the tabs, see: “Summary Tab” on page 57 “Monitoring Tab”...
Page 69: Monitoring Tab
View basic information about the VM: The VM’s operating system The virtual machine technology being used by the VM CPU and memory, including how it is used by the guest and host and the percentage of the host memory being used IP address and DNS name, if it is not DHCP Storage names and types associated with the host, storage capacity information, and how many VMs are stored on the host per storage name...
Page 70: Using Feedback To Manage Vms
You can do the following with this tab: View the Event Log information. Double-click an event item that contains the icon to view the details of the event as reported by the Orchestrate Server. The following is an example of an event’s details: 5.2 Using Feedback to Manage VMs The VM Client is integrated with the Orchestrate Server and the Development Client...
Page 71: Progress View
5.2.1 Progress View The Progress View displays the progress of all VM actions initiated by any VM operator. To use the Progress View: 1 The Progress View section is displayed by default; if it is not being displayed, do one of the following: In the VM Client, click View >...
Page 72 For more information, see Section 5.2.3, “Progress Bar in a Tool Tip,” on page 3 To view information specific to a progress task, mouse-over the name in the Status column of the Progress View section: For more information, see Section 5.2.5, “Event Logs,” on page PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 73: Progress Bar For Details Views
5.2.2 Progress Bar for Details Views If you start an action on a VM from within a details view, a progress bar is displayed in the upper right of the VM Client window. To view it: 1 To get a VM in an action state, in the host server’s Summary tab, right-click a VM and select an action.
Page 74 3 In the Virtual Machines view, double-click the VM. This changes the to details view to of the VM and displays the progress bar and progress description in the upper right of the VM Client window: The progress bar shows the percentage completed. It only displays for a selected VM that has an action in progress.
Page 75: Progress Bar In A Tool Tip
This opens the Event Log dialog box: You can click any icons that are displayed for more detailed log information. 5.2.3 Progress Bar in a Tool Tip There are two places where you can use the mouse-over function to view progress information: You can view the progress of an action by mousing over its icon in the Status column of the Virtual Machines view, or the Status column of the Summary tabs for host servers and...
Page 76: Event Log Tab
You can view the status log of the action by mousing over the entry in the Status column in the Progress View: 5.2.4 Event Log Tab You can view the progress of all actions for a VM by viewing its Event Log tab: 1 In the VM Client, click Virtual Machines to display the VMs, then do one of the following to open its details views: Double-click the VM, then click the Event Log tab.
Page 77: Event Logs
3 To quickly locate specific information, click anywhere in the list, then begin typing a search string. This opens the locator pop-up and selects the first match. You can modify the string to refine the search, and you can use the up-arrow and down-arrow to move from match to match. 4 To view more detailed information for an entry, double-click its icon.
Page 78 2 In the Progress View section, do one of the following: Double-click the entry that is displayed in the Status column. Right-click the entry that is displayed in the Status column and select Show Log. The following dialog box is displayed: These events are logged dynamically in the Event Log dialog box.
Page 79: Error Log
You can have multiple Event Log Details dialog boxes open simultaneously to monitor multiple tasks for the same VM or for multiple VMs. The Event Log Details dialog box provides the same information as the Job Details dialog box in the Development Client. 5.2.6 Error Log To use the Error Log section: 1 In the VM Client, click View >...
Page 80: Virtual Machine Actions
2 To view further information on an error, double-click the error to display its Event Details dialog box: 5.3 Virtual Machine Actions All of the actions that you can perform on a VM can be tracked during execution by viewing the logging messages in the Event Log tab for the VM, and in the Event Log and Event Details dialog boxes (see Section 5.2, “Using Feedback to Manage VMs,”...
Page 81: Understanding A Vm's Status
5.3.1 Understanding a VM’s Status In the Virtual Machines view, the Status column indicates the state of each VM: VM Status Icons Table 5-1 Icon VM’s Status Enabled Actions for the Selected VM Has been defined or is Show Details, Install, Edit, Resync State, Delete, New VM, and being defined.
Page 82: Starting A Vm
To cancel an action in the Development Client, go to the Explorer tree view. Under the Resources subsection, locate the VM in one of the Resources subsections (such as VMs), right- click the VM, then select Cancel Action. In the VM Client window, the Status column should now show the previous state of the VM. 5.3.3 Starting a VM In order to start a VM on a host server, the following conditions must exist: The VM’s files and image must be either:...
Page 83 To start a VM: 1 In the Client, click the Virtual Machines view. 2 Do one of the following: Click the VM that you want to start, then click the button. Click the VM that you want to start, then click Action > Start. Right-click the VM that you want to start, then select Start.
Page 84: Shutting Down A Vm
Click View > Show Progress View to open the Progress window. View its progress in the Jobs tab of the Development Client. 5.3.4 Shutting Down a VM Shutting down a VM is the same as shutting down any computer. Its current state is not saved. If you want to retain a VM’s state, use one of the following options instead: Section 5.3.6, “Pausing a VM,”...
Page 85: Pausing A Vm
5.3.6 Pausing a VM If you need to free up CPU cycles on the host machine, you can pause some of the VMs. This option writes the current state of the VM to the host machine’s RAM so that it can be recovered by resuming the VM.
Page 86: Resuming A Suspended Vm
When you select multiple VMs, each suspend operation is done according to how jobs handled by Orchestrate Server. WARNING: If you use the Restart option to reboot the VM, its previous state is lost. If you want to recover its previous state, use the Resume option, which reads that information from the host machine’s hard drive.
Page 87: Creating A Xen Vm
To resynchronize a VM: 1 In the Client, click the Virtual Machines view. 2 Right-click the VM to be resynchronized, then select Resync State. You cannot select multiple VMs for this operation. If the resync state is not automatically updated for the VM, open the VM’s details page for the VM in eigher of the following ways to get the updated status.
Page 88 SUSE Linux Enterprise Desktop 11 ® openSUSE openSUSE 11 ® Novell Open Enterprise Server 2 (Linux) Novell Open Enterprise Server 2 (NetWare) ® Novell NetWare 6.5 SP6 and earlier Red Hat* Enterprise Linux 3 Red Hat Enterprise Linux 4 Red Hat Enterprise Linux 5...
Page 89 Solaris* 9 and older Solaris 10 Microsoft Windows NT* Microsoft Windows XP, 2000, 2003 Microsoft Windows XP, 2003 (x64) Microsoft Windows Vista* Microsoft Windows Vista (x64) Microsoft Windows Server 2008 Microsoft Windows Server 2008 (x64) There is also an “(other)” option for the following: SUSE Red Hat Microsoft Windows...
Page 90 Use a PXE Install Source: This feature is only available when you select Full Virtualization in the Virtualization Mode field, and it works only if the host server that is selected for building this VM is on a network where PXE is running. If you select this option, it disables the Install Source, Auto Install File, and Additional Arguments fields.
Page 91 3 Click Next to display the following wizard page: 4 Fill in the fields to define the kind of hardware to be virtualized for the VM: Processors: The number of virtual processors the VM has. Memory Size: The amount of virtual RAM the VM has, or paravirtualized memory that can be used by the VM if it is paravirtualized.
Page 92 5 Click Next to display the following wizard page: The default for the Type field is Hard Disk. The other possible types are: iSCSI: PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 93 N_Port ID Virtualized Storage (NPIV): Network Attached Storage (NAS): The Storage Devices page is for defining the hard drives and CD or DVD drives that you want to include in the VM profile. The first device must always be a hard disk that cannot be removed unless another hard disk has been put into the first slot.
Page 94 6 To fill in the storage device information, select a task from the following table: Tasks Steps Additional Details Adding a hard disk to 1. Click Add Hard Disk. The following restrictions your VM apply per VM: 2. Fill in the following fields: Limit of 4 fully Name: The name is the number in the order virtualized disks...
Page 95 Tasks Steps Additional Details Adding a CD-ROM 1. Click Add CD-ROM. IMPORTANT: If you add or DVD ROM to your 2. Fill in the following fields: a CD-ROM or DVD- ROM, the VM can only Name: The name is the number in the order be moved, migrated, or the drive appears in its VM image list.
Page 96 7 Click Next to display the following wizard page: The network devices are added, deleted, and defined on the Network page, where you add specific information about your network connections or intended network connections for your VM. You can define more detailed NIC settings in your auto-install files or when performing a guest installation.
Page 97: Installing A Vm
9 To complete the wizard, click one of the following buttons: Install: Lists the VM in the Virtual Machines view, then immediately installs the configured VM. A VNC login dialog box is displayed so that you can view the progress of the installation from the VM’s console.
Page 98 Multiple valid hosts exist: The following dialog box is displayed if there are two or more target host candidates: Do one of the following: Select the Auto-Select the Target Host check box. The Auto-Select the Target Host option allows the Orchestrate Server to automatically select a host server from those that are available by using a ranking criteria, such as architecture similarity and available CPU and RAM resources.
Page 99: Installing The Platespin Orchestrate Agent On A Vm
7 If you want to cancel the installation before it finished, do one of the following: Select the VM being installed, then click Edit > Cancel Install. Right-click the VM being installed, then select Cancel Install. The VM’s status is returned to being configured but not installed. 5.6 Installing the PlateSpin Orchestrate Agent on a VM For instructions on installing the agent on a host server, see...
Page 100: Installing The Monitoring Agent On A Vm
5.7 Installing the Monitoring Agent on a VM In order to use the Monitoring feature on VMs or host servers, you must manually install the Monitoring Agent on them, then configure the agent. The Monitoring Agent is usually installed on host servers during installation of the PlateSpin Orchestrate Server product.
Page 101: Editing Vms
3e In YaST2, click the Filter drop-down menu, then select Patterns to display the install patterns available on the PlateSpin Orchestrate ISO. 3f Select only the Monitoring Agent installation pattern. This pattern installs the Ganglia Agent on each monitored node, which collects performance metrics and sends the data to the Orchestrate Monitoring Server.
Page 102 The following wizard page is displayed: The above example is for a stopped VM. 3 Fill in the available fields: Description: Note the purpose and any other specifics you might require of the VM. These notes apply to all versions of this VM. Guest Operating System: The operating system you want to install on your VM.
Page 103 4 Click Next to display the following wizard page: The above example is for a stopped VM. 5 Fill in the available fields to define the kind of hardware to be virtualized for the VM: Processors: The number of virtual processors the VM has. Memory Size: The amount of virtual RAM the VM has, or paravirtualized memory that can be used by the VM if it is paravirtualized.
Page 104 6 Click Next to display the following wizard page: The above example is for a stopped VM. The default for the Type field is Hard Disk. The other possible types are iSCSI, NPIV, and NAS. For more information, see Step 5 on page The Storage Devices page is for defining the hard drives and CD or DVD drives that you want to include in the VM profile.
Page 105 7 To fill in the storage device information, select a task from the following table: Tasks Steps Additional Details Adding a hard disk to 1. Click Add Hard Disk. The following restrictions your VM apply per VM: 2. Fill in the following fields: Limit of 4 fully Name: The name is the number in the order virtualized disks...
Page 106 Tasks Steps Additional Details Adding a CD-ROM 1. Click Add CD-ROM. IMPORTANT: If you add or DVD ROM to your 2. Fill in the following fields: a CD-ROM or DVD- ROM, the VM can only Name: The name is the number in the order be moved, migrated, or the drive appears in its VM image list.
Page 107 8 Click Next to display the following wizard page: The above example is for a stopped VM. The network devices are added, deleted, and defined on the Network page, where you add specific information about your network connections or intended network connections for your VM.
Page 108: Moving Vms
10 To complete and close the wizard, click Apply. You can click Back to make further changes before applying the edits. The wizard configuration changes are applied and the VM is saved in the Virtual Machines view. Focus is returned to the Virtual Machines view after you exit the wizard, with the edited VM selected in the list.
Page 109: Moving A Vm
5.9.2 Moving a VM 1 In the Client, click the Virtual Machines view, then make sure the VM you want to move is shut down. 2 Select the VM. 3 Do one of the following to move the VM: Click Edit > Move. Right-click the selected VM, then select Move.
Page 110: Migrating Vms
Xen must be configured to allow for migrating its VMs. For more information setting up Xen for a live migration, see Option 2 in Novell AppNotes (http://www.novell.com/communities/ node/5050/xen-virtual-machine-migration). For vCenter (ESX ) VM migrations, both the source and target machines must have VMotion enabled.
Page 111: Migrating A Vm
The host server cannot have met its maximum allowable VMs. This value is set in the Development Client in the Max Hosted VMs field. The default is 8. It doesn’t matter whether the maximum VMs it is already hosting are fully utilizing it. A host server cannot be disabled by having its Resource Enabled check box deselected in the Development Client.
Page 112 If only one host server is available, it is automatically used and you can continue with Step Otherwise, the following dialog box is displayed if there are two or more target host candidates: 3 If you have multiple host servers to select from, do one of the following: Leave the Auto-select the Target Host check box selected.
Page 113: Deleting Vms
Click View > Show Progress View to open the Progress window. View its progress in the Jobs tab of the Development Client. When the migration has completed, the VM continues to run on its new host. ESX migrations might take a bit longer because the ESX server must be suspended in order to migrate its RAM content.
Page 114 114 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 115: Managing Repositories
Managing Repositories You can do the following to manage the repositories for VM files: Section 6.1, “Understanding Repositories,” on page 115 Section 6.2, “Viewing and Editing Storage Details,” on page 117 Section 6.3, “Adding Repositories,” on page 120 Section 6.4, “Associating Repositories to Host Servers,” on page 122 Section 6.5, “Associating Host Servers to Repositories,”...
Page 116 Repository Adapters Image File Path Description Local The default paths are: The default repository on a host server. Each host server starts with its Physical location: (root), or own local repository, which has the var/xen/images , which is the same name as the server’s hostname. physical location of the VM’s files.
Page 117: Viewing And Editing Storage Details
6.2 Viewing and Editing Storage Details Review the following sections for information on the Details views: Section 6.2.1, “Accessing Storage Details,” on page 117 Section 6.2.2, “Using the Details Tabs,” on page 117 6.2.1 Accessing Storage Details The details for each storage item consist of a summary, VMs using this storage capacity, host servers providing the storage space, and an event log.
Page 118 Summary Tab This details tab is used by each Inventory panel type: Summary Tab for Storage Items Figure 6-1 You can do the following with the Summary tab for storage items: In the first section, the available options in the Type field are: Network Attached Storage (NAS) Local Storage Area Network (SAN)
Page 119 Virtual Machines Tab This details tab is used only by storage items: Virtual Machines tab for Storage Figure 6-2 You can do the following with this tab: View which VMs are associated with the storage item. View the status of each associated VM. Double-click a listed VM to view its details tabs.
Page 120: Adding Repositories
Event Log Tab This details tab is used by all Inventory types: Event Log Tab for Storage Figure 6-4 You can do the following with this tab: View actions related to the repository. View the Event Log information. Double-click an event item that contains the icon to view the details of the event as reported by the Orchestrate Server.
Page 121 4 Right-click the new repository, then select Show Details. The following is displayed: 5 On the Summary tab, from the drop-down list for the Type field, select one of the following: Network Attached Storage Local The following also display, but are not selectable. They must be created outside of the VM Client.
Page 122: Associating Repositories To Host Servers
8 (Optional) Provide any useful information in the Notes field. When you change focus from Notes field, the information that you entered is automatically saved. 9 (Optional) Control disk space usage as necessary: NOTE: By default, all repository sizes are set to unlimited (-1). 9a In the Development Client, browse for the repository in the Explorer panel.
Page 123: Associating Host Servers To Repositories
2 Right-click a repository in the storage section, then select Associate Repository. The following dialog box is displayed: 3 Select a repository, then click OK. The repository is listed with the others for the selected host server. 6.5 Associating Host Servers to Repositories You can associate host servers with a repository, which allows VMs using the repository to then be run by any of the host servers associated with the repository.
Page 124: Removing Repositories
If no hosts are available, the following dialog box is displayed, instead: 3 Select one or more host servers, then click OK. The host server is listed with the others for the selected storage item. 6.6 Removing Repositories You can remove repositories from being associated with a host server, or you can remove a repository altogether: Section 6.6.1, “Removing a Repository from a Host Server,”...
Page 125: Removing A Host Server From A Repository
2 Right-click any repository listed in the storage section, then select Remove Repository. The repository is removed from those listed for the selected host server and is no longer available to the host server. 6.6.2 Removing a Host Server from a Repository IMPORTANT: When you remove the repository from association with the host server, the VMs stored in the repository can no longer be managed through this host server.
Page 126 The following confirmation dialog box is displayed: 2 Click Yes to delete the repository. The repository is removed from those listed. 126 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 127: Managing Templates
Managing Templates You can do the following with templates: Section 7.1, “Viewing and Editing Template Details,” on page 127 Section 7.2, “Creating a Template from a VM,” on page 129 Section 7.3, “Editing Templates,” on page 131 Section 7.4, “Moving a Template,” on page 138 Section 7.5, “Deleting Templates,”...
Page 128: Using The Details Tabs
7.1.2 Using the Details Tabs The following sections provide information on the various details tabs: “Summary Tab” on page 128 “Event Log Tab” on page 129 Summary Tab Summary Tab for Templates Figure 7-1 You can do the following with the Summary tab for templates: In the first section, right-click a group name under Groups, then select Remove to revoke the template’s membership in the group.
Page 129: Creating A Template From A Vm
Double-click a listed VM to view its details tabs. These are the VMs that were cloned from the template. Right-click a listed VM, then select any of the available menu options. These are the same right-click menu options that are available for the VM in the Virtual Machines Inventory list. Wherever N/A appears in the details, it means that the information is not available.
Page 130 To create a template: 1 In the Client, click the Virtual Machines view, right-click the VM that you want to use to create the template, then select Shut Down. The VM cannot be running during creation of the template because the VM’s image is modified.
Page 131: Editing Templates
In the Templates view, double-click the template that is being created, click the Event Log tab, then double-click the entry related to the creation process that has the icon next to it. The Event Log Details dialog box is displayed and is automatically updated as events occur.
Page 132 11 ® Novell Open Enterprise Server 2 (Linux) ® Novell Open Enterprise Server 2 (NetWare Novell NetWare 6.5 SP6 and older Red Hat Enterprise Linux 3 Red Hat Enterprise Linux 4 Red Hat Enterprise Linux 5 Solaris 9 and older...
Page 133 There is also an “(other)” option for the following: SUSE Red Hat Microsoft Windows Additional Arguments: This field applies only to paravirtual installations. These are Linux install arguments, which are operating system parameters similar to the information entered in a GRUB boot loader when running on bare hardware in SUSE Linux Enterprise Server (SLES) and SUSE Linux Enterprise Desktop (SLED).
Page 134 6 Click Next to display the following wizard page: The example shown is for a template. The Storage Devices page is for defining the hard drives and CD or DVD drives that you want to include in the template profile. The first device must always be a hard disk that cannot be removed unless another hard disk has been put into the first slot.
Page 135 7 To fill in the storage device information, select a task from the following table: Tasks Steps Additional Details Adding a hard disk to 1. Click Add Hard Disk. The following restrictions your VM apply per VM: 2. Fill in the following fields: Limit of 4 fully Name: The name is the number in the order virtualized disks...
Page 136 Tasks Steps Additional Details Adding a CD-ROM 1. Click Add CD-ROM. IMPORTANT: If you add or DVD ROM to your 2. Fill in the following fields: a CD-ROM or DVD- ROM, any VMs created Name: The name is the number in the order from this template can the drive appears in its VM image list.
Page 137 8 Click Next to display the following wizard page: The example shown is for a template. The network devices are added, deleted, and defined on the Network page, where you add specific information about your network connections or intended network connections for your template.
Page 138: Moving A Template
10 To complete and close the wizard, click Apply. You can click Back to make further changes before applying the edits. Applies the wizard configuration changes and saves the template in the Templates view. Focus is returned to the Virtual Machines view after you exit the wizard with the edited template selected in the list.
Page 139 3 Click either Yes or No to delete the template: This completely removes the templates from the Templates view. It does not have any affect on any VMs cloned from these templates. Managing Templates 139...
Page 140 140 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 141: Managing Clones Of Templates
Managing Clones of Templates You can do the following with clones of templates: Section 8.1, “Cloning Templates,” on page 141 Section 8.2, “Detaching Clones from Templates,” on page 143 8.1 Cloning Templates Templates provide a method for quickly creating of a new VM. To create new VMs from a template, you first clone the template to create a new VM, then you edit the cloned VM’s configuration as needed.
Page 142 The following dialog box opens: 3 Specify a name for the template clone in the New VM Name field. This name must be unique. It cannot already exist in either the Virtual Machines or Templates lists. The name cannot be longer than 100 characters and cannot start with the letters “xen.” 4 To select a repository for the new template clone, simply click the repository.
Page 143: Detaching Clones From Templates
8.2 Detaching Clones from Templates To edit, delete, or move a template using the VM Client, you must first detach or delete its clones. The detaching process creates a complete VM image for the clone, which is then no longer considered to be a clone by the VM Client.
Page 144 144 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 145: Managing With Groups
Managing with Groups You use groups to manage the items listed in the Inventory panel: Section 9.1, “Understanding Groups,” on page 145 Section 9.2, “Creating a Group,” on page 146 Section 9.3, “Adding Members to an Existing Group,” on page 146 Section 9.4, “Removing Members from a Group,”...
Page 146: Creating A Group
9.2 Creating a Group 1 In the Client, do one of the following: Right-click a view in the Inventory perspective, then click New Group. Select a view in the Inventory perspective, the click File > New Group. This opens the New Group dialog box: 2 Specify a group name, then click OK.
Page 147: Removing Members From A Group
The item is still listed in the view if you do not have a group selected for the view. That way, you can assign an item membership in multiple groups. 4 After copying the members into a group, click the group in the Inventory panel to view its membership: 9.4 Removing Members from a Group 1 In the...
Page 148: Deleting A Group
9.5 Deleting a Group 1 In the Inventory perspective in the VM Client, click a view’s icon to expand the view. 2 Right-click the group that you want to delete, then select Delete to display the Delete Group dialog box: 3 Click Yes to delete the group.
Page 149: Troubleshooting Virtual Machine Management
Troubleshooting Virtual Machine Management The following sections provide solutions to the problems you might encounter while working with ® the PlateSpin Orchestrate VM Client: Section 10.1, “Adding Multiple NPIV Disks to a VM,” on page 149 Section 10.2, “Accessing VMs and Host Servers,” on page 149 Section 10.3, “Moving or Migrating the VMs,”...
Page 150: Moving Or Migrating The Vms
10.3 Moving or Migrating the VMs “VM is out of sync in the VM Client after it was moved” on page 150 “Moving or migrating VMs between two ESX hosts that are registered to a vCenter server by using the Orchestrate Development Client fails” on page 150 “Moving a VM from one ESX host local storage to another ESX host local storage might fail”...
Page 151: Registering Vm Hosts
Action: Restart the agent on the VM to reestablish the connection. 10.4 Registering VM Hosts “VM Hosts are not registered to the Orchestrate Server even after a considerable time” on page 151 VM Hosts are not registered to the Orchestrate Server even after a considerable time Source: The PlateSpin Orchestrate VM Client.
Page 152 152 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 153: A Vm Installation Sources
VM Installation Sources ® You have two sources from which to install VMs for the PlateSpin Orchestrate VM Client: Section A.1, “Disk Installation Sources,” on page 153 Section A.2, “Guest Operating System Installation Sources,” on page 153 A.1 Disk Installation Sources To install a fully virtualized machine, you can specify an installation source that must be mounted in such a way that the VM recognizes it as a mounted installation source.
Page 154: Suse
A.2.1 SUSE A remote directory containing the install files, specified by using the HTTP protocol: The HTTPS protocol is not supported. http://www.domain.com/install_sources/sles10sp2/ A remote directory containing the install files, specified by using the FTP protocol: ftp://www.domain.com/install_sources/sles10sp2/ A remote directory containing the install files, specified by using the NFS protocol: nfs://www.domain.com/install_sources/sles10sp2/ A.2.2 NetWare ®...
Page 155: B Npiv Terminology
NPIV Terminology Terms associated with N_Port ID Virtualized (NPIV) Storage: Fabric ID: A unique numeric identifier of the SAN repository. LUN: Logic Unit Number. A unique number used to identify a logical unit on the disk storage. The value can be between 0 and 254. Target ID: The port number of the storage disk provided by the SAN vendor.
Page 156 156 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 157: C Vm Client Preferences
Show\ Part\ Menu=false To prevent issues with the VM Client from not working properly, you should contact Novell Support for help when you edit the preferences file. However, there is one preference setting that you can change yourself. When you open a dialog box,...
Page 158 3 Open the file in a text editor. com.novell.vnos.prefs Windows: installation_path\PlateSpin Orchestrate VM Client 2.0.2\bin\workspace\.metadata\.plugins\org.eclipse.cor.runtime\.setti ngs\com.novell.vnos.prefs Linux: /home/user/.novell/nvmm/workspace/.metadata/.plugins/ org.eclipse.cor.runtime/.settings/com.novell.vnos.prefs 4 Edit the preferences file as necessary. Valid preference values are true false IMPORTANT: If you edit the preferences file, do not remove any backslashes (\) that accompany the key names, including the space after the backslash.
Page 159: D Adding User Logins For Vm Operators
Adding User Logins for VM Operators ® In a default setup, the PlateSpin Orchestrate infrastructure administrator is the only user who can log in to the VM Client and manage VMs. This section explains how you can add individual VM operator login IDs, so that they can also log in to and use the VM Client to manage VMs.
Page 160 To add individual user login IDs: 1 In the Development Client, click Actions > Create User. This opens the Create a New User dialog box: 2 In the New User Name field, specify the login name. 3 Make sure that the Target Groups section contains administrators. If not, select administrators in the Source Groups section, then click the Add button.
Page 161 6 On the Info/Groups tab, expand the Info section, then fill in the fields in the other subsections as necessary. IMPORTANT: In the Password field in the Personal Information subsection, the default password is the one that you created for the adminstrator login when you installed the PlateSpin Orchestrate Server software.
Page 162 162 PlateSpin Orchestrate 2.0 VM Client Guide and Reference...
Page 163: E Vm Client Documentation Quick Index
VM Client Documentation Quick Index ® This short index is designed to provide quick access to hard-to-find information in the PlateSpin Orchestrate VM Client Reference and Guide. Some index entries access other PlateSpin Orchestrate guides for information related to managing VMs. An extensive index is not intended here, so most of the section titles that are visible on the Contents page for this manual are not included.
Page 164 To use the feature, simply access this Index section (http://www.novell.com/documentation/ pso_orchestrate20/pso20_vmclient/data/bj2pd1o.html) on the documentation Web site and suggest new entries or corrections to existing entries in the User Comment field there.

This manual is also suitable for:

Platespin orchestrate 2.0.2 vm client

Novell PLATESPIN ORCHESTRATE 2.0.2 - VM CLIENT GUIDE AND REFERENCE 06-17-2009 Client Manual

Table of Contents

About this Guide

1 Overview

2 Getting Started

3 Understanding the VM Client Interface

4 Managing VM Host Servers

4.2.1 Accessing Host Server Details

5 Managing Virtual Machines

6 Managing Repositories

7 Managing Templates

8 Managing Clones of Templates

9 Managing with Groups

10 Troubleshooting Virtual Machine Management

A VM Installation Sources

B NPIV Terminology

C VM Client Preferences

D Adding User Logins for VM Operators

E VM Client Documentation Quick Index

Quick Links

Chapters

Related Manuals for Novell PLATESPIN ORCHESTRATE 2.0.2 - VM CLIENT GUIDE AND REFERENCE 06-17-2009

Summary of Contents for Novell PLATESPIN ORCHESTRATE 2.0.2 - VM CLIENT GUIDE AND REFERENCE 06-17-2009

This manual is also suitable for:

Table of Contents