Red Hat Enterprise Virtualization 3.2 Beta User Portal Guide en US

8/20/2019 Red Hat Enterprise Virtualization 3.2 Beta User Portal Guide en US

1/33

Jodi Biddle Zac Dover

Red Hat Enterprise Virtualization

3.2 Beta

User Portal Guide

Accessing and Using Virtual Machines from the User Portal


2/33


3/33

Red Hat Enterprise Virtualization 3.2 Beta User Portal Guide

Accessing and Using Virtual Machines from the User Portal

Jodi [email protected]

Zac [email protected]


4/33

Legal Notice

Copyright 2013 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under

a Creative Commons Att ribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-

BY-SA is available at . In accordance with CC-BY-SA, if you distribute this document or an adaptation of

it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the

right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by

applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the

Inf inity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other

countries. Linux is the registered t rademark of Linus Torvalds in the United States and other countries.

Java is a registered trademark of Oracle and/or its af filiates. XFS is a trademark of Silicon Graphics

International Corp. or its subsidiaries in the United States and/or other countries. MySQL is a registered

trademark of MySQL AB in the United States, the European Union and other countries. All other

trademarks are the property of their respective owners. 1801 Varsity Drive Raleigh, NC 27606-2072 USA

Phone: +1 919 754 37 00 Phone: 888 733 4281 Fax: +1 919 754 37 01Keywords

Abstract

Note: This document is under development, is subject to substantial change, and is provided only as a

preview. The included information and instructions should not be considered complete, and should be

used with caution.


5/33

44456667

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

88

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

99

1111121213

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

151515171718

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2020202224252526

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table of Contents

Preface1. Document Conventions

1.1. Typographic Conventions1.2. Pull-quote Conventions1.3. Notes and Warnings

2. Getting Help and Giving Feedback2.1. Do You Need Help?2.2. We Need Feedback!

Chapte r 1. Preface1.1. User Portal Preface

Chap ter 2. Gett ing Started2.1. Logging in to the User Portal2.2. L ogging out of the User Portal2.3. L ogging in for the First T ime2.4. In stalling the SPICE plug-in for Mozill a Firefox on Linux2.5. Installing the SPICE ActiveX component for Internet Explorer on Windows2.6. U ser Portal Graphical Interface

Chapt er 3. Running Virtua l Machines3.1. R unning Virtual Machines - Ov erview3.2. T urning On a Virtual Machine3.3. C onnecting to a Powered-on Virtual Machine3.4. Logging Out of a Virtual Machine3.5. What T o Do When You Exceed Your Quota

Chapte r 4 . Using Virtual Machines: Advanced4.1. In troduction to Connection Protocols4.2. C onfiguring SPICE Console Options4.3. U sing SPICE Connection O ptions4.4. Using USB Devices on Virtual Machines4.5. U sing USB Devices on Virtual Machines - Legacy Mode4.6. Configuring a Lin ux Client to Use USB Redirection in Legacy Mode4.7. Co nfiguring a Windows Client to Use USB Redirection in Legacy Mode

Revisio n History

Preface

5


6/33


6


7/33

Preface

1. Document ConventionsThis manual uses s everal conventions to highlight certain words and phrases and draw attention tospecific pieces of information.

In PDF and paper editions, this manual uses typefaces drawn from the Liberation Fonts set. TheLiberation Fonts set is also used in HTML editions if the set is ins talled on your sys tem. If not, alternativebut equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes theLiberation Fonts set by default.

1.1. Typographic Conventions

Four typographic conventions are used to call attention to specific words and phras es. Theseconventions, and the circumstances they apply to, are as follows.

Mono-spaced Bold

Used to highlight system input, including shell commands, file names and paths. Also used to highlightkeys and key combinations. For example:

To see the contents of the file my_next_bestselling_novel in your current workingdirectory, enter the cat my_next_bestselling_novel command at the shell promptand press Enter to execute the command.

The above includes a file name, a shell command and a key, all presented in mono-spaced bold and alldistinguishable thanks to context.

Key combinations can be distinguished from an individual key by the plus s ign that connects each part ofa key combination. For example:

Press Enter to execute the command.

Press Ctrl +Alt + F2 to switch to a virtual terminal.

The first example highlights a particular key to press. The second example highlights a key combination:a set of three keys pressed simultaneously.

If source code is discuss ed, class names, methods, functions, variable names and returned valuesmentioned within a paragraph will be presented as above, in mono-spaced bold . For example:

File-related classes include filesystem for file systems, file for files, and dir fordirectories. Each class has its own associated set of permissions.

Proportional Bold

This denotes words or phrases encountered on a sys tem, including application names; dialog box text;labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example:

Choose System → Preferences → Mouse from the main menu bar to launch MousePreferences . In the Buttons tab, click the Left-handed mouse check box and clickClose to switch the primary mouse button from the left to the right (making the mousesuitable for use in the left hand).

To insert a special character into a gedit file, choose Applications → Accessories →

Preface

7

https://fedorahosted.org/liberation-fonts/


8/33

Character Map from the main menu bar. Next, choose Search → Find… from theCharacter Map menu bar, type the name of the character in the Search field and clickNext . The character you sought will be highlighted in the Character Table . Double-clickthis highlighted character to place it in the Text to copy field and then click the Copybutton. Now switch back to your document and choose Edit → Paste from the gedit menubar.

The above text includes application names; system-wide menu names and items; application-specificmenu names; and buttons and text found within a GUI interface, all presented in proportional bold and alldistinguishable by context.

Mono-spaced Bold Italic or Proportional Bold Italic

Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variabletext. Italics denotes text you do not input literally or displayed text that changes depending oncircumstance. For example:

To connect to a remote machine using ss h, type ssh username @domain.name at a shell

prompt. If the remote machine is example.com and your username on that machine is john, type ssh john@ exam ple.com .

The mount -o remount file-system command remounts the named file system. Forexample, to remount the /home file system, the command is mount -o remount /home .

To see the vers ion of a currently installed package, use the rpm -q package command. It will return a result as follows: package-version-release .

Note the words in bold italics above — username, domain.name, file-system, package, version andrelease. Each word is a placeholder, either for text you enter when issuing a command or for text

displayed by the system.

Aside from standard usage for presenting the title of a work, italics denotes the first us e of a new andimportant term. For example:

Publican is a DocBook publishing system.

1.2. Pull-quote Conventions

Terminal output and source code listings are set off visually from the surrounding text.

Output sent to a terminal is set in mono-spaced roman and presented thus:

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads im ages notes scripts svgs

Source-code listings are also set in mono-spaced roman but add syntax highlighting as follows:


8


9/33

package org. jboss . book . jca . ex1 ;

import javax.naming.InitialContext;

public class ExClient{ public static void main (String args[])

throws Exception { InitialContext iniCtx = new InitialContext(); Object ref = iniCtx. lookup ( "EchoBean" ); EchoHome home = (EchoHome) ref; Echo echo = home. create ();

System. out . println ( "Created Echo" );

System. out . println ( "Echo.echo('Hello') = " + echo. echo ( "Hello" )); }}

1.3. Note s and Warnings

Finally, we use three visual styles to draw attention to information that might otherwise be overlooked.

Note

Notes are tips , shortcuts or alternative approaches to the tas k at hand. Ignoring a note shouldhave no negative consequences, but you might miss out on a trick that makes your life easier.

Important

Important boxes detail things that are easily miss ed: configuration changes that only apply to thecurrent sess ion, or services that need restarting before an update will apply. Ignoring a boxlabeled 'Important' will not cause data loss but may cause irritation and frustration.

Warning

Warnings should not be ignored. Ignoring warnings will most likely cause data loss .

2. Getting Help and Giving Feedback

2.1 . Do You Nee d Help?

If you experience difficulty with a procedure described in this documentation, visit the Red Hat CustomerPortal at http://access.redhat.com . Through the customer portal, you can:

search or browse through a knowledgebase of technical support articles about Red Hat products.

submit a support case to Red Hat Global Support Services (GSS).

access other product documentation.

Chap ter 2. Getting Started

9

http://access.redhat.com/


10/33

Red Hat also hosts a large number of electronic mailing lists for discussion of Red Hat software andtechnology. You can find a list of publicly available mailing lists at https://www.redhat.com/mailman/listinfo .Click on the name of any mailing list to s ubscribe to that list or to access the list archives.

2.2. We Nee d Feedback!

If you find a typographical error in this manual, or if you have thought of a way to make this manual

better, we would love to hear from you! Please submit a report in Bugzilla: http://bugzilla.redhat.com/against the product Red Hat Enterprise Virtualizat ion.

When submitting a bug report, be sure to mention the manual's identifier: User_Portal_Guide

If you have a sugges tion for improving the documentation, try to be as specific as poss ible whendescribing it. If you have found an error, please include the section number and some of the surroundingtext so we can find it easily.


10

http://bugzilla.redhat.com/https://www.redhat.com/mailman/listinfo


11/33

Chapter 1. Preface

1.1. User Portal PrefaceThe Red Hat Enterprise Virtualization platform is a virtualization management solution based on theleading open source virtualization platform.

About this Guide

This guide describes how users can access and use virtual desktops from the Red Hat EnterpriseVirtualization User Portal.

Audience

This document is for end users of Red Hat Enterprise Virtualization virtual machines. No special skills orknowledge is required.

Overview

This guide helps you to use virtual machines from the Red Hat Enterprise Virtualization User Portal asfollows:

Install the required SPICE plug-ins if you are logging in for the first time. Log in to the User Portal withyour server address , user name and pass word. Select a virtual machine and turn it on. Connect to thevirtual machine. After you have finished using the virtual machine, log out from the machine.

Report a bug


11

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=12586-376698+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+User+Portal+Preface%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


12/33

Chapter 2. Getting Started

2.1. Logging in to the User PortalLog in to the Red Hat Enterprise Virtualization User Portal directly from your web browser.

To log in to the User Porta l

1. Enter the provided User Porta l URL in the address bar of your web browser. The addressshould be in the format of https://server.example.com/UserPortal . The login screendisplays.

Alternately, enter the provided server address into the web browser, to access the welcomescreen. Click User Portal to be directed to the User Portal.

Figure 2 .1. The User Port al Login Select ion Scree n


12


13/33

2. Enter your User Name and Password . Use the Domain drop-down menu to select the correctdomain.

Figure 2 .2. The User Porta l Login Scree n

If you have only one running virtual machine in use, select the Connect Autom atically

checkbox and connect directly to your virtual machine.If you have more than one running virtual machine or do not wish to automatically connect to avirtual machine, do not select the Connect Autom atically checkbox.

Select the language in which the User Portal is presented by us ing the drop-down menu at thelower-right of the login window.

3. Click Login . The list of virtual machines ass igned to you displays.


13


14/33

Figure 2.3. User Portal

Report a bug

2.2. Logging out of the User PortalLogging out of the User Port al:

At the title bar of the User Portal, click Sign out . You are logged out and the User Portal login screendisplays.

Report a bug

2.3. Logging in for the First TimeBecause Red Hat Enterprise Virtualization requires a secure connection to log in to the User Portal, RedHat Enterprise Virtualization requires that you trust the site's identity the firs t time you log in. Confirm asecurity exception for the website or add the website to your browser's list of trusted sites , and your

web browser displays the login screen.

If you plan to use the SPICE protocol for connecting to virtual machines, install the appropriate pluginsfor your browser. You need to do this only once.

On a Linux client machine with Mozilla Firefox, install the SPICE Firefox plugin to access the User Portal.On a Windows client machine with Internet Explorer, add the SPICE ActiveX component to your webbrowser.

Mozilla Firefox on Windows does not support SPICE. Use Internet Explorer on Windows.


14

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=7369-335618+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Logging+out+of+the+User+Portal%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portalhttps://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=7368-429401+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Logging+in+to+the+User+Portal%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


15/33

Note

Add the URL for the Red Hat Enterprise Virtualization Manager to your lis t of trus ted sites.If Red Hat Enterprise Virtualization Manager is not in the list of trus ted sites of Internet Explorer 8and Internet Explorer 9, the SPICE Client window changes from full-screen to windowed-screen.

If Red Hat Enterprise Virtualization Manager is a Trusted Site, a full-screen SPICE windowremains open.

Report a bug

2.4. Installing the SPICE plug-in for Mozilla Firefox on LinuxThe SPICE plug-in is required to run the remote-viewer application, which opens a graphical consolefor connecting to virtual machines. remote-viewer is a SPICE client which is provided by the virt-viewer package available on Red Hat Enterprise Linux channels.

1. Open a terminal and run the following command as root:

# yum install spice-xpi

2. Check that the virt-viewer package has already been installed on your system.

# rpm -q virt-viewervirt-viewer-0.5.2-18.el6_4.2.x86_64

If it has not been installed, run the following command as root:

# yum install virt-viewer

3. Restart Mozilla Firefox for your changes to take effect.

4. The SPICE plug-in is now ins talled. You can now connect to your virtual machines us ing SPICE.

Report a bug

2.5. Installing the SPICE ActiveX component for Internet Explorer onWindowsThe SPICE ActiveX component is required to run the remote-viewer application, which opens agraphical console for connecting to virtual machines. remote-viewer is a SPICE client installed together

with the SPICE ActiveX component; both are provided in the spice.cab file.

1. The first time you attempt to connect to a virtual machine, an add-on notification bar displays in thebrowser prompting you to install the SPICE ActiveX component. This will download a spice.cabfile which, when launched, automatically installs the SPICE ActiveX component and the remote-viewer application.

2. When you accept the prompt to install the SPICE ActiveX component, Internet Explorer will issue asecurity warning. Confirm that you wish to proceed.

3. Restart Internet Explorer for your changes to take effect. You can now use SPICE to connect tovirtual machines.

Chapter 3. Running Virtual Machines

15

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=7375-431258+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Installing+the+SPICE+plug-in+for+Mozilla+Firefox+on+Linux%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portalhttps://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=8702-429436+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Logging+in+for+the+First+Time%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


16/33

Important

If you installed the SPICE ActiveX component without administrative permissions, you will receivea message stating that the usbclerk package was not installed. This means that you will be ableto connect to a virtual machine using SPICE, however you will not be able to use USB devices on

your virtual machine. Contact your systems administrator to install usbclerk if required.

Report a bug

2.6. User Portal Graphical InterfaceThe User Portal Graphical Interface enables you to view and use all the virtual machines that areavailable to you. The screen consists of three areas : the title bar, a virtual machines area, and a detailspane. A number of control buttons allow you to work with the virtual machines.

Figure 2.4 . The User Portal

The title bar (1) includes the name of the User logged in to the portal and the Sign out button .

In the virtual machines area, the names of the virtual machines or des ktop pools as signed to you display(2). The logo of the virtual machine's operating sys tem also displays (3). When a virtual machine ispowered up, you can connect to it by double-clicking on the virtual machine's logo.

On each virtual machine's icon, buttons allow you to play, stop or pause a virtual machine. The buttonsperform the same functions as buttons on a media player (4).

The green play button starts up the virtual machine. It is available when the virtual machine ispaused, stopped or powered off.

T he red s top button s tops the virtual machine. It is available when the virtual machine is running.


16

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=7379-429400+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Installing+the+SPICE+ActiveX+component+for+Internet+Explorer+on+Windows%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


17/33

T he orange pause button temporarily halts the virtual machine. To restart it, press the green playbutton.

The s tatus of the virtual machine is indicated by the text below the virtual machine's icon - Machine isReady or Machine is Down .

Clicking on a virtual machine displays the statis tics of the selected virtual machine on the details pane tothe right (5), including the operating system, defined memory, number of cores and size of virtual drives.You can also configure connection protocol options (6) such as enabling the use of USB devices or localdrives.

Report a bug


17

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=8557-341587+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+User+Portal+Graphical+Interface%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


18/33


3.1. Running Virtual Machines - OverviewOn the User Portal, virtual machines are represented by icons that indicate both type and status . Theseicons indicate whether a virtual machine is part of a des ktop pool, or is a s tand-alone Windows or Linuxvirtual machine. They also reflect whether the virtual machine is running or stopped.

The User Portal displays a list of the virtual machines assigned to you. You can then turn on one ormore virtual machines, connect, and log in. You can have access to virtual machines that are runningdifferent operating sys tems, and you can use multiple virtual machines s imultaneously.

In contrast, if you have only one running virtual machine and have enabled automatic connection, youcan bypass the User Portal and log in directly to the virtual machine, similar to how you log in to aphysical machine.

Report a bug

3.2. Turning On a Virtual MachineTo use a virtual machine in the User Portal, you must turn it on and then connect to it. If a virtual machineis turned off, it is grayed out and displays Machine is Down .

You can be assigned an individual virtual machine or a machine that is part of a virtual machine pool.Virtual machines in a pool have the same operating system and installed applications.

To t urn on a virtual machine

1. If you are using a stand-alone virtual machine, select the machine and click the button to turn iton.

Figure 3.1. Turn on virtua l machine

2. To use a virtual machine from a pool, select the pool icon and click the button.


18

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=12581-373388+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Running+Virtual+Machines+-+Overview%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


19/33

Figure 3.2. Ta ke virtua l machine from a pool

A powered on virtual machine from the pool will be assigned to you.

3. The virtual machine powers up.

Figure 3.3. Virtual machine powering up

4. When the virtual machine is powered up, the icon is no longer grayed out. The text displays asMachine is Ready . You are now ready to connect.

Figure 3.4. Virtual machine turned on

Note

You can only connect to a virtual machine after it has powered up.


19


20/33

Report a bug

3.3. Connecting to a Powered-on Virtual MachineAfter a virtual machine has been turned on, you can connect to it, log in, and start work in the same way

as you would with a phys ical machine. The text "Machine is Ready" displays on virtual machines that arepowered up.

To C onnect to a Powered on Virtual Machine

1. Double click on the selected virtual machine to connect.

Figure 3.5. Connect t o Virtua l Machine

2. A console window of the virtual machine displays. You can now use the virtual machine in thesame way that you would use a physical desktop.

Note

If it is the first time you are connecting with SPICE, you will be prompted to install the appropriateSPICE component or plugin. If it is the first time you are connecting from a Red Hat EnterpriseLinux computer, install the SPICE plugin for Mozilla Firefox. If you are connecting from a Windowscomputer, install the ActiveX plugin.

Report a bug

3.4. Logging Out of a Virtual MachineIt is recommended that you log out from a virtual machine before shutting it down, to minimize the risk ofdata loss. If you attempt to forcefully shut down a virtual machine from the User Portal without logging outof it beforehand, its s tatus will be frozen at " Powering Down". To gracefully turn off a virtual machine,use the following steps.

To shut down a virtua l machine

1. Once you have finished using a virtual machine, log out according to the instructions specific to

the operating system.To log out from Windows, click Start → Log Off .

To log out from Red Hat Enterprise Linux, click System → Log Out .


20

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=7381-363474+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Connecting+to+a+Powered-on+Virtual+Machine%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portalhttps://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=7380-429402+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Turning+On+a+Virtual+Machine%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


21/33

2. If you were using your virtual machine in full screen mode, press Shift +F11 to exit full screenmode, and close the virtual machine's console window. You are now returned to the User Portal.

To shut down the virtual machine, click the button. The text below the virtual machine displaysas "Powering Down".

Figure 3.6. Shut down virtua l machine

The virtual machine is grayed out and displays as "Machine is Down" when it has been turned off.

3. When you have finished using the User Portal, you can log out as instructed in Logging out of theUser Portal: .

Report a bug

3.5. What To Do When You Exceed Your Quota Red Hat Enterprise Virtualization provides a resource-limitation tool called quota , which allows sys tem

administrators to limit the amount of CPU and storage each user can consume. Quota compares theamount of virtual resources consumed when you use the virtual machine to the s torage allowance andthe run-time allowance set by the sys tem administrator.

When you exceed your quota, a pop-up window informs you that you have exceeded your quota, andyou will no longer have access to virtual resources. For example, this can happen if you have too manyconcurrently running virtual machines in your environment.

Chapter 4. Using Virtual Machines: Advanced

21

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=8558-429403+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Logging+Out+of+a+Virtual+Machine%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


22/33

Figure 3.7. Quota exceede d error message

To regain access to your virtual machines, do one of the following:

Shut down the virtual machines that you do not need. This will bring your resource consumptiondown to a level at which it is not in excess of the quota, and you will be able to run virtual machinesagain.

If you cannot shut down any existing virtual machines, contact your system administrator to extendyour quota allowance or remove any unused virtual machines.

Report a bug


22

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=11500-364252+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+What+To+Do+When+You+Exceed+Your+Quota%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


23/33


4.1. Introduction to Connection ProtocolsConnection protocols facilitate the flow of information between virtual machines and Red Hat EnterpriseVirtualization's underlying architecture. They also provide an interface for access ing virtual machinesquickly and easily.

The Simple Protocol for Independent Computing Environments (SPICE) protocol is the recommendedconnection protocol for Red Hat Enterprise Virtualization. SPICE is installed and executed on the clientfor connecting to virtual machines. It provides features including USB redirection and multiple monitorsupport.

In addition to SPICE, Red Hat Enterprise Virtualization Manager also supports the VNC and RDPprotocols.

Remote Desktop Protocol (RDP) can be used for Windows virtual machines, however remote sharing

must first be enabled on the virtual machine before users can connect to it via the User Portal. SPICE iscurrently not supported on virtual machines running Windows 8. If a Windows 8 guest is configured touse the SPICE protocol, it will detect the absence of the required SPICE drivers and automatically fallback to using RDP.

Virtual Network Computing (VNC) can be used for Red Hat Enterprise Linux virtual machines. If a virtualmachine is configured to use VNC as its default protocol, you have to use a VNC client to connect to it.Connecting to a virtual machine using VNC is not possible from the User Portal.

Report a bug

4.2. Configuring SPICE Console OptionsA connection protocol enables you to see and interact with a virtual machine. The SPICE connectionprotocol is recommended for Red Hat Enterprise Linux and Windows virtual machines. You can enableadditional SPICE console options for your virtual machine including USB redirection and keyboardshortcuts.

To configure SPICE connection protocol options

1. Select a running virtual machine. On the details pane, for the Console option click Edit .


23

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=14178-429440+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Introduction+to+Connection+Protocols%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=jbiddle%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


24/33

Figure 4 .1. Select connection protocol

2. The Console Options dialog displays.

Figure 4.2. Configure Console Options

3. The SPICE Options display.

Pass Ctrl-Alt-Del to virtual machine : Tick this checkbox for this keystroke to beintercepted on the virtual guest. The use of this command depends on the operating system:


24


25/33

on Red Hat Enterprise Linux, it sends a signal to reboot the computer; and on Windows, itdisplays the task manager or Windows Security dialog.

Enable USB Auto-Share : Tick this checkbox to automatically redirect USB devices to thevirtual machine. If this option is not selected, the USB device will display on the client machineinstead, and to use the USB device on the guest you have to manually enable it using theSPICE client menu.

Open in Full Screen : Tick this checkbox for the virtual machine console to automaticallyopen in full screen when you connect to the virtual machine. Press SHIFTF11 to toggle fullscreen mode on or off.

4. Click OK. You are returned to the User Portal. Double click on your selected virtual machine toconnect to it.

Report a bug

4.3. Using SPICE Connection OptionsWhen using Windows clients to connect to virtual machines, remote-viewer provides a number ofSPICE options to send keystrokes and commands to the virtual machine.

Figure 4 .3. SPICE Connect ion menu


25

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=12583-429442+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Configuring+SPICE+Console+Options%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


26/33

Ta ble 4 .1. SPICE Console O ptions

Option Hotkey

FileScreenshot : Takes a screenshot of theactive window and saves it in a location of

your specification.USB device selection : If USB redirectionhas been enabled on your virtual machine, theUSB device plugged into your client machinecan be accessed from this menu.Quit : Closes the console. The hot key for thisoption is Shift +Ctrl + Q.

ViewFull screen : Toggles full screen mode onor off. When enabled, full screen mode

expands the virtual machine to fill the entirescreen. When disabled, the virtual machine isdisplayed as a window. The hot key forenabling or disabling full screen isSHIFT +F11 .Zoom : Zooms in and out of the console

window. Ctrl + + zooms in, Ctrl + - zoomsout, and Ctrl +0 returns the screen to itsoriginal size.Automatically resize : Tick to enable theguest resolution to automatically scaleaccording to the size of the console window.Displays : If you have multiple monitorsenabled on your virtual machine, this optionallows you to toggle between your differentmonitors.

Send keyCtrl +Alt + Del : Sends the Ctrl+Alt+Del keycombination to the virtual machine. On a RedHat Enterprise Linux virtual machine, it sendsa signal to reboot the machine. On a Windowsvirtual machine, it displays the task manageror Windows Security dialog.Ctrl +Alt + Backspace : Reboots virtualmachine console to regain control of thevirtual machine.Ctrl +Alt + F1Ctrl +Alt + F2Ctrl +Alt + F3Ctrl +Alt + F4Ctrl +Alt + F5Ctrl +Alt + F6Ctrl +Alt + F7Ctrl +Alt + F8


26


27/33

Ctrl +Alt + F9Ctrl +Alt + F10Ctrl +Alt + F11Ctrl +Alt + F12Printscreen : Passes the Printscreenkeyboard option to the virtual machine.

Help The About entry displays the vers ion details ofVirtual Machine Viewer that you are using.

Release Cursor from Virtual Machine SHIFT + F12

Report a bug

4.4. Using USB Devices on Virtual Machines

A virtual machine that is connected with the SPICE protocol can be configured to connect USB devices.To do so, the USB device has to be plugged into the client machine, which is the hardware you use toaccess a guest. The device is then redirected to appear on the gues t machine, which is the virtualdesktop or virtual server you access through the User Portal.

Native mode for USB redirection enables native KVM/ SPICE USB redirection for Red Hat EnterpriseLinux and Windows virtual machines. Virtual machines do not require any in-guest agents or drivers fornative USB. This option is used for virtual machines compatible with Red Hat Enterprise Virtualization 3.1and higher. Native USB mode is supported on the following clients and gues ts:

ClientRed Hat Enterprise Linux 6.0 and higher

Red Hat Enterprise Linux 5.5 and higher

Windows XP

Windows 7

Windows 2008

GuestRed Hat Enterprise Linux 6.0 and higher


Windows XP

Windows 7

Procedure 4 .1. Using USB devices on a Windows client

1. A. If the SPICE ActiveX component was installed by a user with administrative privileges, theusbclerk service has been automatically installed.

B. If the SPICE ActiveX component was installed by a user without administrative privileges , theusbclerk service must be manually installed by a user with administrative privileges.

The usbclerk setup file can be found in the directory where virt-viewer was installed, forexample: C:\Users\ username \AppData\Local\virt-viewer\bin\usbclerk-setup.exe .

Double click on the usbclerk-setup.exe file to launch the installer, and follow the promptsto install usbclerk .

2. When the usbclerk service is installed and running, select a virtual machine which has been


27

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=8734-432468+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Using+SPICE+Connection+Options%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


28/33

configured to use the SPICE protocol, and turn it on.

3. Click the Edit button on the details pane to open the Console Options window, and tick theEnable USB Auto-Share check box.

4. Double click on the running virtual machine to connect to it. When you plug your USB device intothe client machine, it will automatically be redirected to appear on your guest machine.

Procedure 4 .2. Using USB devices on a Red Hat Ent erprise Linux client

1. Select a virtual machine which has been configured to use the SPICE protocol, and turn it on.

2. Click the Edit button on the details pane to open the Console Options window, and tick theEnable USB Auto-Share check box.

3. Double click on the running virtual machine to connect to it. When you plug your USB device intothe client machine, it will automatically be redirected to appear on your guest machine.

Report a bug

4.5. Using USB Devices on Virtual Machines - Legacy ModeLegacy mode for USB redirection enables the SPICE USB redirection policy used in Red Hat EnterpriseVirtualization 3.0. This option will not be supported in future versions of Red Hat EnterpriseVirtualization. Legacy USB mode is supported on the following clients and guests:

ClientRed Hat Enterprise Linux 6.0 and higher


Windows XP

Windows 7

Windows 2008

GuestWindows XP

Windows 7

If your virtual machine is configured to use legacy USB redirection, you have to manually install severalpackages before you can use USB devices on your virtual machine.

Report a bug

4.6. Configuring a Linux Client to Use USB Redirection in LegacyModeIf you connect to a virtual guest from a Red Hat Enterprise Linux client machine, you have to installseveral SPICE packages before you can share USB devices between the client and the guest.

To use USB devices on Red Hat Ente rprise Linux client s

1. Install SPICE package s on client

On your Linux client machine, install the following packages:

spice-usb-share

kmod-kspiceusb-rhel60 for Red Hat Enterprise Linux 6 or

kmod-kspiceusb-rhel5u6 for Red Hat Enterprise Linux 5


28

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=8821-434073+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Using+USB+Devices+on+Virtual+Machines+-+Legacy+Mode%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portalhttps://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=8560-434071+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Using+USB+Devices+on+Virtual+Machines%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


29/33

These packages are available on the Red Hat Network , from the Red Hat Enterprise LinuxSupplementary Software channel for your version of Red Hat Enterprise Linux. To install thepackages, run:

# yum install spice-usb-share kmod-kspiceusb

2. Run SPICE USB services

Start the spiceusbsrvd service and load the kspiceusb module. Run:

# service spiceusbsrvd start# m odprobe kspiceusb

3. Install RHEV-Tools on guest

Locate the CD drive to access the contents of the Guest T ools ISO, and launch RHEV-ToolsSetup.exe . If the Guest Tools ISO is not available in your CD drive, contact your systemadministrator. After the tools have been installed, you will be prompted to restart the machine forchanges to be applied.

4. Open firewall portsAllow connections on T CP port 32023 on any firewalls between the guest machine and the clientmachine.

5. Enable USB Auto-Sha re

On the User Portal, select your guest machine. Ensure that you have enabled SPICE USB Auto-Share on the guest machine.

6. Atta ch USB device

Connect to your guest machine. Place the SPICE console window of your guest desktop in focus,then attach a USB device to the client. The USB device displays in your guest desktop.

When you close the SPICE session the USB device will no longer be shared with the guest.

Report a bug

4.7. Configuring a Windows Client to Use USB Redirection in LegacyModeIf you are connecting from a Windows client machine, and wish to use USB devices on your guest, youhave to enable SPICE USB redirection.

Note

Refer to the Red Hat Enterprise Virtualization Manager Release Notes for specific channel namescurrent to your sys tem.

To e nable USB re direction on Windows:

1. Install USB redirector package on client

On a Windows client machine, install the RHEV-USB-Client.exe . This package can be obtainedfrom the Red Hat Enterpr ise Virtualization Manager ( version.number x86_64)channel on the Red Hat Network, under the Downloads list.

2. Install RHEV-Tools on guest

Revision History

29

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=12584-376032+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Configuring+a+Linux+Client+to+Use+USB+Redirection+in+Legacy+Mode%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portalhttps://rhn.redhat.com/rhn/software/channels/All.do


30/33

Locate the CD drive to access the contents of the Guest T ools ISO, and launch RHEV-ToolsSetup.exe . If the Guest Tools ISO is not available in your CD drive, contact your systemadministrator. After the tools have been installed, you will be prompted to restart the machine forchanges to be applied.

3. Open firewall ports

Allow connections on T CP port 32023 on any firewalls between the guest machine and the clientmachine.

4. Enable USB sharing

On the User Portal, select your guest machine. Ensure that you have enabled SPICE USB sharingon the guest machine.

5. Atta ch USB device

Connect to your guest machine and attach a USB device to the client. If the required USB devicedoes not appear directly on the guest desktop, right click on the SPICE frame and select USBDevices . Choose your device from the list displayed.

Figure 4 .4 . List of connected USB devices

Important

When some USB devices are connected on Windows clients, the autoplay window will appear andthe client will take control of the device, making it unavailable to the guest. To avoid this issue,disable USB autoplay on your Windows clients.


30


31/33

Note

You can also define additional USB policies for Windows clients, to allow or block access tocertain USB devices. For details, see the sections on USB Filter Editor in the Red Hat EnterpriseVirtualization Administration Guide .

Report a bug

Revision History

31

https://bugzilla.redhat.com/enter_bug.cgi?cf_environment=Instance+Name%3A+Not+Defined%0ABuild%3A+CSProcessor+Builder+Version+1.8%0ABuild+Name%3A+12697%2C+User+Portal+Guide-3.2-1%0ABuild+Date%3A+17-04-2013+15%3A09%3A05&cf_build_id=12585-432696+17+Apr+2013+15%3A09+en-US+%5BLatest%5D&comment=Title%3A+Configuring+a+Windows+Client+to+Use+USB+Redirection+in+Legacy+Mode%0A%0ADescribe+the+issue%3A%0A%0A%0ASuggestions+for+improvement%3A%0A%0A%0AAdditional+information%3A&assigned_to=zdover%40redhat.com&product=Red+Hat+Enterprise+Virtualization+Manager&component=Guides-User+Portal


32/33

Revision History

Revision 3.2-07 Wed Apr 17 2013 Jodi BiddleBrewing for Beta 2.

Revision 3.2-07 Wed Apr 10 2013 Jodi BiddleRe-brewed due to an XML error.

Revision 3.2-06 Wed Apr 10 2013 Jodi BiddleUpdated screenshots for 3.2. Updated some SPICE content according to technical review.

Revision 3.2-05 Wed Apr 03 2013 Jodi BiddleUpdated outdated SPICE content.

Revision 3.2-04 Mon Mar 25 2013 Jodi BiddleNo major changes; re-brewing for Beta release just in case.

Revision 3.2-03 Fri Mar 01 2013 Andrew BurdenBrewing for beta

Revision 3.2-02 Thurs Feb 28 2013 Jodi BiddleFixed topic error, removed USB legacy mode as per BZ#916411

Revision 3.2-01 Wed Feb 27 2013 Jodi BiddleStaging for 3.2

Revision 1-29 Wed Dec 12 2012 Zac DoverRemoving obsolete SPICE sections

Revision 1-28 Wed Dec 12 2012 Zac DoverRemoving outdated SPICE content

Revision 1-27 Fri Nov 16 2012 Zac DoverUpdating to new RHN channel names

Revision 1-26 Fri Nov 16 2012 Zac DoverUpdated relevant channel names in xi:included topic

Revision 1-25 Wed Oct 31 2012 Zac DoverBrew test - no docs impact, no translation impact

Revision 1-24 Thu Oct 25 2012 Zac DoverUpdated UP's condition to facilitate staging

Revision 1-23 Mon 15 Oct 2012 Zac DoverFinal staging.Removed draft watermarks.

Revision 1-22 Mon 15 Oct 2012 Zac Dover


32


33/33

Final staging.

Revision 1-21 Thu 11 Oct 2012 Zac DoverRemoved a redundant tag in the Book_Info.xml file that was causing the version number to appear at3.13.1

Revision History

Documents

Red Hat Enterprise Virtualization 3.2 Beta User Portal Guide en US