Red Hat Enterprise Virtualization 3.0 Step by Step Guide

Prerequisites

• Minimum - Dual core server with 4 GB RAM, with 25 GB free disk space and 1 Gbps network
• interface.
• Recommended - Dual Sockets/Quad core server with 16 GB RAM, 50 GB free disk space on multiple disk spindles and 1 Gbps network interface.

• For the Red Hat Enterprise Linux 6 operating system: minimum 1 GB RAM and 5 GB local disk space.
• For the Manager: minimum 3 GB RAM, 3 GB local disk space and 1 Gbps network controller
• bandwidth.
• If you wish to create an ISO domain on the Manager server, you need minimum 15 GB disk space.

• The Red Hat Enterprise Virtualization Manager (v.3 x86_64 ) channel, also referred to as rhel-x86_64 -server-6-rhevm -3, which provides Red Hat Enterprise Virtualization Manager.

• The JBoss Application Platform (v 5) for 6Server x86_64 channel, also referred to as jbappplatform -5-x86_64 -server-6-rpm , which provides the supported release of the application platform on which the manager runs.

• The RHEL Server Supplem entary (v. 6 64 -bit x86_64 ) channel, also referred to as rhel-x86_64 -server-supplem entary-6, which provides the supported version of the Java Runtime Environment (JRE).

A client for connecting to Red Hat Enterprise Virtualization Manager.

• Microsoft Windows (7, XP, 2003 or 2008) with Internet Explorer 7 and above
• Microsoft .NET Framework 4

For each Host (Red Hat Enterprise Virtualization Hypervisor or Red Hat Enterprise Linux)

• Minimum - Dual core server, 10 GB RAM and 10 GB Storage, 1 Gbps network interface.

• Recommended - Dual socket server, 16 GB RAM and 50 GB storage, two 1 Gbps network interfaces.

The breakdown of the server requirements are as below:

• For each host: AMD-V or Intel VT enabled, AMD64 or Intel 64 extensions, minimum 1 GB RAM, 3GB free storage and 1 Gbps network interface.

• For virtual machines running on each host: minimum 1 GB RAM per virtual machine.

• Valid Red Hat Network subscriptions for each host. You can use either Red Hat Enterprise Virtualization Hypervisor or Red Hat Enterprise Linux hosts, or both.

For each Red Hat Enterprise Virtualization Hypervisor host:

• The Red Hat Enterprise Virtualization Hypervisor (v.6 x86-64 ) channel, also referred to as rhel-x86_64 -server-6-rhevh
• For each Red Hat Enterprise Virtualization Linux host: The Red Hat Enterprise Virt Management Agent (v 6 x86_64 ) channel, also referred to as rhel-x86_64 -rhevmgm t-agent-6.

Storage and Networking

• At leasTone of the supported storage types (NFS, iSCSI and FCP).
• For NFS storage, a valid IP address and export path is required.
• For iSCSI storage, a valid IP address and target information is required.
• Static IP addresses for the Red Hat Enterprise Virtualization Manager server and for each host server.
• DNS service which can resolve (forward and reverse) all the IP addresses.
• An existing DHCP server which can allocate network addresses for the virtual machines.

Virtual Machines

• Installation images for creating virtual machines, depending on which operating system you wish to use.
• Microsoft Windows XP, 7, 2003 or 2008.
• Red Hat Enterprise Linux 3, 4, 5 or 6.
• Valid licenses or subscription entitlements for each operating system.

Red Hat Enterprise Virtualization User Portal

• A Red Hat Enterprise Linux client running Mozilla Firefox 3.6 and higher or a Windows client running Internet Explorer 7 and higher.

Install Red Hat Enterprise Virtualization

The Red Hat Enterprise Virtualization platform consists of at leasTone Manager and one or more hosts.

Red Hat Enterprise Virtualization Manager provides a graphical user interface to manage the
physical and logical resources of the Red Hat Enterprise Virtualization infrastructure. The Manager is installed on a Red Hat Enterprise Linux 6 server, and accessed from a Windows client running
Internet Explorer.

Red Hat Enterprise Virtualization Hypervisor runs virtual machines. A physical server running
Red Hat Enterprise Linux can also be configured as a host for virtual machines on the Red Hat
Enterprise Virtualization platform.

Install Red Hat Enterprise Virtualization Manager

                                Figure 2.1. Install Red Hat Enterprise Virtualization Manager

The Manager is the control center of the Red Hat Enterprise Virtualization environment. It allows you to define hosts, configure data centers, add storage, define networks, create virtual machines, manage user permissions and use templates from one central location.

The Red Hat Enterprise Virtualization Manager must be installed on a server running Red Hat
Enterprise Linux 6, with minimum 4 GB RAM, 25 GB free disk space and 1 Gbps network interface.

Install Red Hat Enterprise Linux 6 on a server. When prompted for the software packages to
install, select the default Basic Server option. See the Red Hat Enterprise Linux Installation
Guide for more details.

Note: During installation, remember to set the fully qualified domain name (FQDN) and IP for the
server.

If the classpathx-jaf package has been installed, it must be removed because it conflicts with some of the components required to support JBoss in Red Hat Enterprise Virtualization Manager. Run:

# yum remove classpathx-jaf

If your server has not been registered with the Red Hat Network, run:

# rhn_register

To complete registration successfully you need to supply your Red Hat Network username and
password. Follow the onscreen prompts to complete registration of the system.
After you have registered your server, update all the packages on it. Run:

# yum -y update

Reboot your server for the updates to be applied.

Subscribe the server to the required channels using the Red Hat Network web interface.

a. Log on to Red Hat Network (http://rhn.redhat.com/).
b. Click System s at the top of the page.
c. Select the system to which you are adding channels from the list presented on the screen,
by clicking the name of the system.
d. Click Alter Channel Subscriptions in the Subscribed Channels section of the
screen.
e. Select the following channels from the list presented on the screen.
Red Hat Enterprise Virtualization Manager (v.3 x86_64 )
RHEL Server Supplem entary (v. 6 64 -bit x86_64 )
JBoss Application Platform (v 5) for 6Server x86_64 (note that this
channel is listed under "Additional Services Channels for Red Hat Enterprise Linux 6 for
x86_64")
Click the Change Subscription button to finalize the change.

You are now ready to install the Red Hat Enterprise Virtualization Manager. Run the following
command:

# yum -y install rhevm

This command will download the Red Hat Enterprise Virtualization Manager installation software
and resolve all dependencies.

When the packages have finished downloading, run the installer:

# rhevm -setup

Note: rhevm -setup supports the en_US.UT F-8, en_US.utf8, and en_US.utf-8 locales.
You will not be able to run this installer on a system where the locale in use is noTone of
these supported values.

The installer will take you through a series of interactive questions as listed in the following
example. If you do not enter a value when prompted, the installer uses the default settings which
are stated in [ ] brackets.

Example: Red Hat Enterprise Virtualization Manager installation

Welcom e to RHEV Manager setup utility
HTTP Port [8080] :
HTTPS Port [8443] :
Host fully qualified Dmain Name, note that this Name should be fully
resolvable [rhevm .dem o.redhat.com ] :
Password for Adm inistrator (adm in@ internal) :
Database password (required for secure authentication with the locally
created database) :
Confirm password :
Organization Name for the Certificate: Red Hat
The default storage type you will be using ['NFS'| 'FC'| 'ISCSI'] [NFS] :
ISCSI
Should the installer configure NFS share on this server to be used as an ISO
Dmain? ['yes'| 'no'] [no] : yes
Mount point path: /data/iso
Display Name for the ISO Dmain: local-iso-share
Firewall ports need to be opened.
You can let the installer configure iptables autom atically overriding the current configuration. The old configuration will be backed up.
Alternately you can configure the firewall later using an example iptables file found under /usr/share/rhevm /conf/iptables.example
Configure iptables ? ['yes'| 'no']: yes

Important points to note:

• The default ports 8080 and 84 4 3 must be available to access the manager on HTTP and HTTPS respectively.
• If you elect to configure an NFS share it will be exported from the machine on which the manager is being installed.
• The storage type that you select will be used to create a data center and cluster. You will then be able to attach storage to these from the Administration Portal.

You are then presented with a summary of the configurations you have selected. Type yes to
accept them.

Example: Confirm Manager installation settings

RHEV Manager will be installed using the following configuration:
=================================================================
http-port: 8080
https-port: 8443
host-fqdn: rhevm .dem o.redhat.com
auth-pass: * * * * * * * *
db-pass: * * * * * * * *
org-Name: Red Hat
default-dc-type: ISCSI
nfs-m p: /data/iso
iso-Dmain-Name: local-iso-share
override-iptables: yes
Proceed with the configuration listed above? (yes|no): yes

The installation commences. The following message displays, indicating that the installation was
successful.

Example: Successful installation

Installing:
Creating JBoss Profile... [ DONE ]
Creating CA... [ DONE ]
Setting Database Security... [ DONE ]
Creating Database... [ DONE ]
Updating the Default Data Center Storage Type... [ DONE ]
Editing JBoss Configuration... [ DONE ]
Editing RHEV Manager Configuration... [ DONE ]
Configuring the Default ISO Dmain... [ DONE ]
Starting JBoss Service... [ DONE ]
Configuring Firewall (iptables)... [ DONE ]

* * * * Installation com pleted successfully * * * * * *

Your Red Hat Enterprise Virtualization Manager is now up and running. You can log in to the Red Hat Enterprise Virtualization Manager's web administration portal with the username adm in (the
administrative user configured during installation) in the internal domain. Instructions to do so are
provided at the end of this chapter.

Important: The internal domain is automatically created upon installation, however no new users can be added to this domain. To authenticate new users, you need an external directory service. Red Hat
Enterprise Virtualization supports IPA and Active Directory, and provides a utility called rhevmmanage-domains to attach new directories to the system.

Install Hosts

                       Figure 2.2. Install Red Hat Enterprise Virtualization Hosts

After you have installed the Red Hat Enterprise Virtualization Manager, install the hosts to run your
virtual machines. In Red Hat Enterprise Virtualization, you can use either Red Hat Enterprise
Virtualization Hypervisor or Red Hat Enterprise Linux as hosts.

Install Red Hat Enterprise Virtualization Hypervisor

To prepare a Red Hat Enterprise Virtualization Hypervisor installation CD

• Download the latest version of the rhev-hypervisor* package from Red Hat Network. The lisTof hypervisor packages is located at the Red Hat Enterprise Virtualization Hypervisor
  (v.6 x86_64 ) channel.

a. Log on to Red Hat Network (http://rhn.redhat.com/).
b. Click System s at the top of the page.
c. From the list presented on the screen, select the system on which the Red Hat Enterprise
Virtualization Manager is installed by clicking on its name.
d. Click Alter Channel Subscriptions in the Subscribed Channels section of the screen.
e. Select the Red Hat Enterprise Virtualization Hypervisor (v.6 x86_64 ) channel from the list presented on the screen, then click the Change Subscription button to finalize the change.

Log in to the system on which the Red Hat Enterprise Virtualization Manager is installed. You must log in as the root user to install the rhev-hypervisor package. Run the following command:

# yum install "rhev-hypervisor* "

The hypervisor ISO image is installed into the /usr/share/rhev-hypervisor/ directory.

Insert a blank CD into your CD writer. Use the cdrecord utility to burn the hypervisor ISO image
onto your disc. Run:

# cdrecord dev=/dev/cdrw /usr/share/rhev-hypervisor/rhev-hypervisor.iso

Install Red Hat Enterprise Linux Host

Log In to Administration Portal

Configure Red Hat Enterprise Virtualization

Configure Data Centers

Configure Cluster

Configure Networking

Configure Hosts

Approve Red Hat Enterprise Virtualization Hypervisor Host

The Hypervisor you installed in Section “Install Red Hat Enterprise Virtualization Hypervisor” is automatically registered with the Red Hat Enterprise Virtualization platform. It displays in the Red Hat Enterprise Virtualization Manager, and needs to be approved for use.

To set up a Red Hat Enterprise Virtualization Hypervisor host
On the Tree pane, click Expand All and select Hosts under the Default cluster. On the Hosts tab, select the name of your newly installed hypervisor.

   Figure 3.8. Red Hat Enterprise Virtualization Hypervisor pending approval

Click the Approve button. The Edit and Approve Host dialog displays. Accept the defaults
or make changes as necessary, then click OK.

               Figure 3.9. Approve Red Hat Enterprise Virtualization Hypervisor

The host status will change from Non Operational to Up.

Attach Red Hat Enterprise Linux Host

In contrast to the hypervisor host, the Red Hat Enterprise Linux host you installed in Section,
“Install Red Hat Enterprise Linux Host” is not automatically detected. It has to be manually attached to the Red Hat Enterprise Virtualization platform before it can be used.

To attach a Red Hat Enterprise Linux host
On the Tree pane, click Expand All and select Hosts under the Default cluster. On the Hosts
tab, click New.
The New Host dialog displays.

             Figure 3.10. Attach Red Hat Enterprise Linux Host

Enter the details in the following fields:

• Data Center: the data center to which the host belongs. Select the Default data center.
• Host Cluster: the cluster to which the host belongs. Select the Default cluster.
• Name: a descriptive name for the host.
• Address: the IP address, or resolvable hostname of the host, which was provided during installation.
• Root Password: the password of the designated host; used during installation of the host.
• Configure iptables rules: This checkbox allows you to override the firewall settings on the host with the default rules for Red Hat Enterprise Virtualization.

If you wish to configure this host for OuTof Band (OOB) power management, select the Power Managem ent tab. T ick the Enable Power Managem ent checkbox and provide the required information in the following fields:

• Address: The address of the host.
• User Name: A valid user name for the OOB management.
• Password: A valid, robust password for the OOB management.
• Type: The type of OOB management device. Select the appropriate device from the drop down list.

alom Sun Advanced Lights Out Manager
apc American Power Conversion Master
MasterSwitch network power switch
bladecenter IBM Bladecentre Remote Supervisor Adapter
drac5 Dell Remote Access Controller for Dell
computers
eps ePowerSwitch 8M+ network power switch
ilo HP Integrated Lights Out standard
ilo3 HP Integrated Lights Out 3 standard
ipmilan Intelligent Platform Management Interface
rsa IBM Remote Supervisor Adaptor
rsb Fujitsu-Siemens RSB management interface
wti Western T elematic Inc Network PowerSwitch
cisco_ucs Cisco Unified Computing System Integrated
Management Controller

• Options: Extra command line options for the fence agent. Detailed documentation of the options available is provided in the man page for each fence agent.

Click the Test button to test the operation of the OOB management solution.

If you do not wish to configure power management, leave the Enable Power Management checkbox unmarked.

Click OK. If you have not configured power management, a pop-up window prompts you to confirm if you wish to proceed without power management. SelecToK to continue.

The new host displays in the lisTof hosts with a status of Installing. Once installation is complete, the status will update to Reboot and then Awaiting. When the host is ready for use, its status changes to Up.

You have now successfully configured your hosts to run virtual machines. The next step is to prepare data storage domains to house virtual machine disk images.

Configure Storage

                                Figure 3.11. Configure Storage

After configuring your logical networks, you need to add storage to your data center.

Red Hat Enterprise Virtualization uses a centralized shared storage system for virtual machine disk
images and snapshots. Storage can be implemented using Network File System (NFS), Internet Small
Computer System Interface (iSCSI) or Fibre Channel Protocol (FCP). Storage definition, type and function, are encapsulated in a logical entity called a Storage Dmain. Multiple storage domains are
supported.

For this guide you will use two types of storage domains. The first is an NFS share for ISO images of installation media. You have already created this ISO domain during the Red Hat Enterprise Virtualization Manager installation

The second storage domain will be used to hold virtual machine disk images. For this domain, you need at leasTone of the supported storage types. You have already set a default storage type during
installation as described in Section, “Install Red Hat Enterprise Virtualization Manager”. Ensure that you use the same type when creating your data domain.

Select your next step by checking the storage type you should use:

1. Navigate to the Tree pane and click the Expand All button. Under System, click Default. On
   the results list, the Default data center displays.
2. On the results list, the Storage T ype column displays the type you should add.
3. Now that you have verified the storage type, create the storage domain:

For NFS storage, refer to Section, “Create an NFS Data Domain”.
For iSCSI storage, refer to Section, “Create an iSCSI Data Domain”.
For FCP storage, refer to Section, “Create an FCP Data Domain”.

Create an NFS Data Domain

Because you have selected NFS as your default storage type during the Manager installation, you will
now create an NFS storage domain. An NFS type storage domain is a mounted NFS share that is
attached to a data center and used to provide storage for virtual machine disk images.

To add NFS storage:

Navigate to the Tree pane and click the Expand All button. Under System, select the Default
data center and click on Storage. The available storage domains display on the results list. Click
New Domain.

The New Storage dialog box displays.

    Figure 3.12. Add New Storage

Configure the following options:

• Name: Enter a suitably descriptive name.
• Data Center: The Default data center is already pre-selected.
• Dmain Function / Storage T ype: In the drop down menu, select Data → NFS. The storage domain types not compatible with the Default data center are grayed out. After you select your domain type, the Export Path field appears.
• Use Host: Select any of the hosts from the drop down menu. Only hosts which belong in the pre-selected data center will display in this list.
• Export path: Enter the IP address or a resolvable hostname of the chosen host. The export path should be in the formaTof 192.168.0.10:/data or domain.example.com :/data

Click OK. The new NFS data domain displays on the Storage tab. It will remain with a Locked status while it is being prepared for use. When ready, it is automatically attached to the data center.

You have created an NFS storage domain. Now, you need to attach an ISO domain to the data center
and upload installation images so you can use them to create virtual machines. Proceed to Section, “Attach and Populate ISO domain”.

Create an iSCSI Data Domain

Because you have selected iSCSI as your default storage type during the Manager installation, you will now create an iSCSI storage domain. Red Hat Enterprise Virtualization platform supports iSCSI storage domains spanning multiple pre-defined Logical Unit Numbers (LUNs).

To add iSCSI storage:

On the side pane, select the Tree tab. On System , click the + icon to display the available data
centers.
Double click on the Default data center and click on Storage. The available storage domains
display on the results list. Click New Domain.
The New Dmain dialog box displays.

    Figure 3.13. Add iSCSI Storage

Configure the following options:

• Name: Enter a suitably descriptive name.
• Data Center: The Default data center is already pre-selected.
• Domain Function / Storage Type: In the drop down menu, select Data → iSCSI.
• The storage domain types which are not compatible with the Default data center are grayed out. After you select your domain type, the Use Host and Discover T argets fields display.
• Use host: Select any of the hosts from the drop down menu. Only hosts which belong in this data center will display in this list.

To connect to the iSCSI target, click the Discover Targets bar. This expands the menu to
display further connection information fields.

  Figure 3.14 . Attach LUNs to iSCSI domain

Enter the required information:

• Address: Enter the address of the iSCSI target.
• Port: Select the port to connect to. The default is 3260.
• User Authentication: If required, enter the username and password.

Click the Discover button to find the targets. The iSCSI targets display in the results list with a
Login button for each target.

Click Login to display the lisTof existing LUNs. Tick the Add LUN checkbox to use the selected
LUN as the iSCSI data domain.

Click OK. The new NFS data domain displays on the Storage tab. It will remain with a Locked
status while it is being prepared for use. When ready, it is automatically attached to the data
center.

You have created an iSCSI storage domain. Now, you need to attach an ISO domain to the data center
and upload installation images so you can use them to create virtual machines. Proceed to Section ,“Attach and Populate ISO domain”.

Create an FCP Data Domain

Because you have selected FCP as your default storage type during the Manager installation, you will
now create an FCP storage domain. Red Hat Enterprise Virtualization platform supports FCP storage domains spanning multiple pre-defined Logical Unit Numbers (LUNs).

To add FCP storage:

On the side pane, select the Tree tab. On System , click the + icon to display the available data
centers.

Double click on the Default data center and click on Storage. The available storage domains
display on the results list. Click New Domain.

The New Dmain dialog box displays.

   Figure 3.15. Add FCP Storage

Configure the following options:

• Name: Enter a suitably descriptive name.
• Data Center: The Default data center is already pre-selected.
• Domain Function / Storage Type: Select FCP.
• Use Host: Select the IP address of either the hypervisor or Red Hat Enterprise Linux host.
• The lisTof existing LUNs display. On the selected LUN, tick the Add LUN checkbox to use it as the FCP data domain.

Click OK. The new FCP data domain displays on the Storage tab. It will remain with a Locked
status while it is being prepared for use. When ready, it is automatically attached to the data
center.

You have created an FCP storage domain. Now, you need to attach an ISO domain to the data center
and upload installation images so you can use them to create virtual machines. Proceed to Section, “Attach and Populate ISO domain”.

Attach and Populate ISO domain

You have defined your first storage domain to store virtual guest data, now it is time to configure your second storage domain, which will be used to store installation images for creating virtual machines. You have already created a local ISO domain during the installation of the Red Hat Enterprise Virtualization Manager. To use this ISO domain, attach it to a data center.

To attach the ISO domain
Navigate to the Tree pane and click the Expand All button. Click Default. On the results list,
the Default data center displays.

On the details pane, select the Storage tab and click the Attach ISO button.

The Attach ISO Library dialog appears with the available ISO domain. Select it and click OK.

   Figure 3.16. Attach ISO Library

The ISO domain appears in the results lisTof the Storage tab. It displays with the Locked status
as the domain is being validated, then changes to Inactive.

Select the ISO domain and click the Activate button. The status changes to Locked and then to
Active.

Media images (CD-ROM or DVD-ROM in the form of ISO images) must be available in the ISO repository for the virtual machines to use. To do so, Red Hat Enterprise Virtualization provides a utility that copies the images and sets the appropriate permissions on the file. The file provided to the utility and the ISO share have to be accessible from the Red Hat Enterprise Virtualization Manager.

Log in to the Red Hat Enterprise Virtualization Manager server console to upload images to the ISO
domain.

To upload ISO images

Create or acquire the appropriate ISO images from boot media. Ensure the path to these images
is accessible from the Red Hat Enterprise Virtualization Manager server.

The next step is to upload these files. First, determine the available ISO domains by running:

# rhevm -iso-uploader list

You will be prompted to provide the admin user password which you use to connect to the
administration portal. The tool lists the name of the ISO domain that you attached in the previous
section.

ISO Storage Dmain List:
local-iso-share

Now you have all the information required to upload the required files. On the Manager console,
copy your installation images to the ISO domain. For your images, run:

# rhevm -iso-uploader upload -i local-iso-share [file1] [file2] .... [fileN]

You will be prompted for the admin user password again, provide it and press Enter.
Note that the uploading process can be time consuming, depending on your storage performance.

After the images have been uploaded, check that they are available for use in the Manager
administration portal.

• Navigate to the Tree and click the Expand All button.
• Under Storage, click on the name of the ISO domain. It displays in the results list. Click on it to display its details pane.
• On the details pane, select the Im ages tab. The lisTof available images should be populated with the files which you have uploaded. In addition, the RHEV-toolsSetup.iso and virtio-win.vfd images should have been automatically uploaded during installation.

    Figure 3.17. Uploaded ISO images

Now that you have successfully prepared the ISO domain for use, you are ready to start creating virtual machines.

Manage Virtual Machines

The final stage of setting up Red Hat Enterprise Virtualization is the virtual machine lifecycle - spanning the creation, deployment and maintenance of virtual machines; using templates; and configuring user permissions. This chapter will also show you how to log in to the user portal and connect to virtual machines.

Create Virtual Machines
                   Figure 4 .1. Create Virtual Machines

On Red Hat Enterprise Virtualization, you can create virtual machines from an existing template, as a
clone, or from scratch. Once created, virtual machines can be booted using ISO images, a network boot (PXE) server, or a hard disk. This document provides instructions for creating a virtual machine using an ISO image.

In your current configuration, you should have at leasTone host available for running virtual machines, and uploaded the required installation images to your ISO domain. This section guides you through the creation of a Red Hat Enterprise Linux 6 virtual server. You will perform a normal attended installation using a virtual DVD.

To create a Red Hat Enterprise Linux server

Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Server.

    Figure 4 .2. Create New Linux Virtual Machine

You only need to fill in the Name field and select Red Hat Enterprise Linux 6.x as your
Operating System . You may alter other settings but in this example we will retain the defaults.
Click OK to create the virtual machine.

A New Virtual Machine - Guide Me window opens. This allows you to add networks and
storage disks to the virtual machine.

                                 Figure 4 .3. Create Virtual Machines

Click Configure Network Interfaces to define networks for your virtual machine. The parameters in the following figure are recommended, but can be edited as necessary. When you have configured your required settings, click OK.

                                             Figure 4 .4 . New Network Interface configurations

You are returned to the Guide Me window. This time, click Configure Virtual Disks to add
storage to the virtual machine. The parameters in the following figure are recommended, but can
be edited as necessary. When you have configured your required settings, click OK.

                                           Figure 4 .5. New Virtual Disk configurations

Close the Guide Me window by clicking Configure Later. Your new RHEL 6 virtual machine will
display in the Virtual Machines tab.

You have now created your first Red Hat Enterprise Linux virtual machine. Before you can use your
virtual machine, install an operating system on it.

To install the Red Hat Enterprise Linux guesToperating system

Right click the virtual machine and select Run Once. Configure the following options:

                                          Figure 4 .6. Run Red Hat Enterprise Linux Virtual Machine

• Attach CD: Red Hat Enterprise Linux 6
• Boot Sequence: CD-ROM
• Display protocol: SPICE

Retain the default settings for the other options and click OK to start the virtual machine.

Select the virtual machine and click the Console icon. As this is your first time connecting to
the virtual machine, allow the installation of the Spice Active X and the SPICE client.

After the SPICE plugins have been installed, select the virtual machine and click the Console icon
again. This displays a window to the virtual machine, where you will be prompted to begin installing the operating system.

After the installation has completed, shut down the virtual machine and reboot from the hard drive.

You can now connect to your Red Hat Enterprise Linux virtual machine and start using it.

Create a Windows Virtual Machine

You now know how to create a Red Hat Enterprise Linux virtual machine from scratch. The procedure of creating a Windows virtual machine is similar, except that it requires additional virtio drivers. This example uses Windows 7, but you can also use other Windows operating systems. You will perform a normal attended installation using a virtual DVD.

To create a Windows desktop

Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Desktop.

   Figure 4 .7. Create New Windows Virtual Machine

You only need to fill in the Name field and select Windows 7 as your Operating System . You
may alter other settings but in this example we will retain the defaults. Click OK to create the virtual
machine.

A New Virtual Machine - Guide Me window opens. This allows you to define networks for
the virtual machine. Click Configure Network Interfaces. See Figure 4.4, “New Network
Interface configurations” for details.

You are returned to the Guide Me window. This time, click Configure Virtual Disks to add
storage to the virtual machine. See Figure 4.5, “New Virtual Disk configurations” for details.

Close the Guide Me windows. Your new Windows 7 virtual machine will display in the Virtual
Machines tab.

To install Windows guesToperating system

Right click the virtual machine and select Run Once. The Run Once dialog displays as in
Figure 4.6, “Run Red Hat Enterprise Linux Virtual Machine”. Configure the following options:

• Attach Floppy: virtio-win
• Attach CD: Windows 7
• Boot sequence: CD-ROM
• Display protocol: SPICE

Retain the default settings for the other options and click OK to start the virtual machine.

Select the virtual machine and click the Console icon. This displays a window to the virtual
machine, where you will be prompted to begin installing the operating system.

Accept the default settings and enter the required information as necessary. The only change you must make is to manually install the VirtIO drivers from the virtual floppy disk (vfd) image. To do so, select the Custom (advanced) installation option and click Load Driver. Press Ctrl and select:

• Red Hat VirtIO Ethernet Adapter
• Red Hat VirtIO SCSI Controller

The installation process commences, and the system will reboot itself several times.

Back on the administration portal, when the virtual machine's status changes back to Up, right click on it and select Change CD. From the lisTof images, select RHEV-toolsSetup to attach the Guest Tools ISO which provides features including USB redirection and SPICE display optimization.

Click Console and log in to the virtual machine. Locate the CD drive to access the contents of the Guest Tools ISO, and launch the RHEV-toolsSetup executable. After the tools have been installed, you will be prompted to restart the machine for changes to be applied.

You can now connect to your Windows virtual machine and start using it.

Using Templates

                    Figure 4 .8. Create Templates

Now that you know how to create a virtual machine, you can save its settings into a template. This template will retain the original virtual machine's configurations, including virtual disk and network interface settings, operating systems and applications. You can use this template to rapidly create replicas of the original virtual machine.

Create a Red Hat Enterprise Linux Template

To make a Red Hat Enterprise Linux virtual machine template, use the virtual machine you created in Section, “Create a Red Hat Enterprise Linux Virtual Machine” as a basis. Before it can be used, it has to be sealed. This ensures that machine-specific settings are not propagated through the template.

To prepare a Red Hat Enterprise Linux virtual machine for use as a template

Connect to the Red Hat Enterprise Linux virtual machine to be used as a template. Flag the
system for re-configuration by running the following command as root:

# touch /.unconfigured

Remove ssh host keys. Run:

# rm -rf /etc/ssh/ssh_host_*

Shut down the virtual machine. Run:

# poweroff

The virtual machine has now been sealed, and is ready to be used as a template for Linux virtual
machines.

To create a template from a Red Hat Enterprise Linux virtual machine

In the administration portal, click the Virtual Machines tab. Select the sealed Red Hat
Enterprise Linux 6 virtual machine. Ensure that it has a status of Down.

Click Make Template. The New Virtual Machine Template displays.

Click Make Template. The New Virtual Machine Template displays.

   Figure 4 .9. Make new virtual machine template

Enter information into the following fields:

• Name: Name of the new template
• Description: Description of the new template
• Host Cluster: The Host Cluster for the virtual machines using this template.
• Make Private: If you tick this checkbox, the template will only be available to the template's creator and the administrative user. Nobody else can use this template unless they are given permissions by the existing permitted users.

Click OK. The virtual machine displays a status of "Image Locked" while the template is being
created. The template is created and added to the Templates tab. During this time, the action
buttons for the template remain disabled. Once created, the action buttons are enabled and the
template is ready for use.

Clone a Red Hat Enterprise Linux Virtual Machine

In the previous section, you created a Red Hat Enterprise Linux template complete with pre-configured storage, networking and operating system settings. Now, you will use this template to deploy a preinstalled virtual machine.

To clone a Red Hat Enterprise Linux virtual machine from a template

Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Server.

   Figure 4 .10. Create virtual machine based on Linux template

On the General tab, select the existing Linux template from the Based on Template
list.
Enter a suitable Name and appropriate Description, then accept the default values
inherited from the template in the resTof the fields. You can change them if needed.
Click the Resource Allocation tab. On the Provisioning field, click the drop down
menu and select the Clone option.

          Figure 4 .11. Set the provisioning to Clone

Retain all other default settings and click OK to create the virtual machine. The virtual machine
displays in the Virtual Machines list.

Create a Windows Template

To make a Windows virtual machine template, use the virtual machine you created in Section,
“Create a Windows Virtual Machine” as a basis.

Before a template for Windows virtual machines can be created, it has to be sealed with sysprep. This ensures that machine-specific settings are not propagated through the template.

Note that the procedure below is applicable for creating Windows 7 and Windows 2008 R2 templates.

To seal a Windows virtual machine with sysprep

In the Windows virtual machine to be used as a template, open a command line terminal and type
regedit.

The Registry Editor window displays. On the left pane, expand HKEY_LOCAL_MACHINE →
SYSTEM → SETUP.

On the main window, right click to add a new string value using New → String Value. Right click
on the file and select Modify. When the Edit String dialog box displays, enter the following
information in the provided text boxes:

• Value name: UnattendFile
• Value data: a:\sysprep.inf

Launch sysprep from C:\Windows\System 32\sysprep\sysprep.exe

• Under System Cleanup Action, select Enter System Out-of-Box-Experience (OOBE).
• Tick the Generalize checkbox if you need to change the computer's system identification number (SID).
• Under Shutdown Options, select Shutdown.

Click OK. The virtual machine will now go through the sealing process and shut down
automatically.

To create a template from an existing Windows machine

In the administration portal, click the Virtual Machines tab. Select the sealed Windows 7
virtual machine. Ensure that it has a status of Down and click Make Template.

The New Virtual Machine Template displays. Enter information into the following fields:

• Name: Name of the new template
• Description: Description of the new template
• Host Cluster: The Host Cluster for the virtual machines using this template.
• Make Public: Check this box to allow all users to access this template.

Click OK. In the T em plates tab, the template displays the "Image Locked" status icon while it is
being created. During this time, the action buttons for the template remain disabled. Once created,
the action buttons are enabled and the template is ready for use.

You can now create new Windows machines using this template.

Create a Windows Virtual Machine from a Template

This section describes how to create a Windows 7 virtual machine using the template created in
Section, “Create a Windows Template”.

To create a Windows virtual machine from a template
Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Desktop.

• Select the existing Windows template from the Based on Template list.
• Enter a suitable Name and appropriate Description, and accept the default values inherited from the template in the resTof the fields. You can change them if needed.

Retain all other default setting and click OK to create the virtual machine. The virtual machine
displays in the Virtual Machines list with a status of "Image Locked" until the virtual disk is created.
The virtual disk and networking settings are inherited from the template, and do not have to be
reconfigured.

Click the Run icon to turn iTon. This time, the Run Once steps are not required as the
operating system has already been installed onto the virtual machine hard drive. Click the green
Console button to connect to the virtual machine.

You have now learned how to create Red Hat Enterprise Linux and Windows virtual machines with and without templates. Next, you will learn how to access these virtual machines from a user portal.

Using Virtual Machines

Now that you have created several running virtual machines, you can assign users to access them from the user portal. You can use virtual machines the same way you would use a physical desktop.

Assign User Permissions
                    Figure 4 .12. Assign Permissions

Red Hat Enterprise Virtualization has a sophisticated multi-level administration system, in which
customized permissions for each system component can be assigned to different users as necessary.
For instance, to access a virtual machine from the user portal, a user must have either UserRole or
PowerUserRole permissions for the virtual machine. These permissions are added from the manager
administration portal.

To assign PowerUserRole permissions
Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, select the virtual machine you would like to assign a user to.

On the Details pane, navigate to the Perm issions tab. Click the Add button.

The Add Perm ission to User dialog displays. Enter a Name, or User Name, or part thereof in
the Search textbox, and click Go. A lisTof possible matches display in the results list.

      Figure 4 .13. Add PowerUserRole Permission

Select the check box of the user to be assigned the permissions. Scroll through the Assign
role to user list and select PowerUserRole. Click OK.

Log in to the User Portal

                    Figure 4 .14 . Connect to the User Portal

Now that you have assigned PowerUserRole permissions on a virtual machine to the user named admin, you can access the virtual machine from the user portal. To log in to the user portal, all you
need is a Linux client running Mozilla Firefox or a Windows client running Internet Explorer.

If you are using a Red Hat Enterprise Linux client, install the SPICE plug-in before logging in to the User Portal. Run:

# yum install spice-xpi

To log in to the User Portal

Open your browser and navigate to https://Dmain.exam ple.com :84 4 3/UserPortal.
Substitute domain.example.com with the Red Hat Enterprise Virtualization Manager server
address.

The login screen displays. Enter your User Name and Password, and click Login.

You have now logged into the user portal. As you have PowerUserRole permissions, you are taken by
default to the Extended User Portal, where you can create and manage virtual machines in addition to
using them. This portal is ideal if you are a system administrator who has to provision multiple virtual machines for yourself or other users in your environment.

    Figure 4 .15. The Extended User Portal

You can also toggle to the Basic User Portal, which is the default (and only) display for users with
UserRole permissions. This portal allows users to access and use virtual machines, and is ideal for
everyday users who do not need to make configuration changes to the system.

    Figure 4 .16. The Basic User Portal

You have now completed the Quick Start Guide, and successfully set up Red Hat Enterprise
Virtualization. However, this is just the first step for you to familiarize yourself with basic Red Hat
Enterprise Virtualization operations. You can further customize your own unique environment based on your organization's needs by working with our solution architects.

Introduction

Prerequisites

• Minimum - Dual core server with 4 GB RAM, with 25 GB free disk space and 1 Gbps network
• interface.
• Recommended - Dual Sockets/Quad core server with 16 GB RAM, 50 GB free disk space on multiple disk spindles and 1 Gbps network interface.

• For the Red Hat Enterprise Linux 6 operating system: minimum 1 GB RAM and 5 GB local disk space.
• For the Manager: minimum 3 GB RAM, 3 GB local disk space and 1 Gbps network controller
• bandwidth.
• If you wish to create an ISO domain on the Manager server, you need minimum 15 GB disk space.

• The Red Hat Enterprise Virtualization Manager (v.3 x86_64 ) channel, also referred to as rhel-x86_64 -server-6-rhevm -3, which provides Red Hat Enterprise Virtualization Manager.

• The JBoss Application Platform (v 5) for 6Server x86_64 channel, also referred to as jbappplatform -5-x86_64 -server-6-rpm , which provides the supported release of the application platform on which the manager runs.

• The RHEL Server Supplem entary (v. 6 64 -bit x86_64 ) channel, also referred to as rhel-x86_64 -server-supplem entary-6, which provides the supported version of the Java Runtime Environment (JRE).

A client for connecting to Red Hat Enterprise Virtualization Manager.

• Microsoft Windows (7, XP, 2003 or 2008) with Internet Explorer 7 and above
• Microsoft .NET Framework 4

For each Host (Red Hat Enterprise Virtualization Hypervisor or Red Hat Enterprise Linux)

• Minimum - Dual core server, 10 GB RAM and 10 GB Storage, 1 Gbps network interface.

• Recommended - Dual socket server, 16 GB RAM and 50 GB storage, two 1 Gbps network interfaces.

The breakdown of the server requirements are as below:

• For each host: AMD-V or Intel VT enabled, AMD64 or Intel 64 extensions, minimum 1 GB RAM, 3GB free storage and 1 Gbps network interface.

• For virtual machines running on each host: minimum 1 GB RAM per virtual machine.

• Valid Red Hat Network subscriptions for each host. You can use either Red Hat Enterprise Virtualization Hypervisor or Red Hat Enterprise Linux hosts, or both.

For each Red Hat Enterprise Virtualization Hypervisor host:

• The Red Hat Enterprise Virtualization Hypervisor (v.6 x86-64 ) channel, also referred to as rhel-x86_64 -server-6-rhevh
• For each Red Hat Enterprise Virtualization Linux host: The Red Hat Enterprise Virt Management Agent (v 6 x86_64 ) channel, also referred to as rhel-x86_64 -rhevmgm t-agent-6.

Storage and Networking

• At leasTone of the supported storage types (NFS, iSCSI and FCP).
• For NFS storage, a valid IP address and export path is required.
• For iSCSI storage, a valid IP address and target information is required.
• Static IP addresses for the Red Hat Enterprise Virtualization Manager server and for each host server.
• DNS service which can resolve (forward and reverse) all the IP addresses.
• An existing DHCP server which can allocate network addresses for the virtual machines.

Virtual Machines

• Installation images for creating virtual machines, depending on which operating system you wish to use.
• Microsoft Windows XP, 7, 2003 or 2008.
• Red Hat Enterprise Linux 3, 4, 5 or 6.
• Valid licenses or subscription entitlements for each operating system.

Red Hat Enterprise Virtualization User Portal

• A Red Hat Enterprise Linux client running Mozilla Firefox 3.6 and higher or a Windows client running Internet Explorer 7 and higher.

Install Red Hat Enterprise Virtualization

The Red Hat Enterprise Virtualization platform consists of at leasTone Manager and one or more hosts.

Red Hat Enterprise Virtualization Manager provides a graphical user interface to manage the
physical and logical resources of the Red Hat Enterprise Virtualization infrastructure. The Manager is installed on a Red Hat Enterprise Linux 6 server, and accessed from a Windows client running
Internet Explorer.

Red Hat Enterprise Virtualization Hypervisor runs virtual machines. A physical server running
Red Hat Enterprise Linux can also be configured as a host for virtual machines on the Red Hat
Enterprise Virtualization platform.

Install Red Hat Enterprise Virtualization Manager

                                Figure 2.1. Install Red Hat Enterprise Virtualization Manager

The Manager is the control center of the Red Hat Enterprise Virtualization environment. It allows you to define hosts, configure data centers, add storage, define networks, create virtual machines, manage user permissions and use templates from one central location.

The Red Hat Enterprise Virtualization Manager must be installed on a server running Red Hat
Enterprise Linux 6, with minimum 4 GB RAM, 25 GB free disk space and 1 Gbps network interface.

Install Red Hat Enterprise Linux 6 on a server. When prompted for the software packages to
install, select the default Basic Server option. See the Red Hat Enterprise Linux Installation
Guide for more details.

Note: During installation, remember to set the fully qualified domain name (FQDN) and IP for the
server.

If the classpathx-jaf package has been installed, it must be removed because it conflicts with some of the components required to support JBoss in Red Hat Enterprise Virtualization Manager. Run:

# yum remove classpathx-jaf

If your server has not been registered with the Red Hat Network, run:

# rhn_register

To complete registration successfully you need to supply your Red Hat Network username and
password. Follow the onscreen prompts to complete registration of the system.
After you have registered your server, update all the packages on it. Run:

# yum -y update

Reboot your server for the updates to be applied.

Subscribe the server to the required channels using the Red Hat Network web interface.

a. Log on to Red Hat Network (http://rhn.redhat.com/).
b. Click System s at the top of the page.
c. Select the system to which you are adding channels from the list presented on the screen,
by clicking the name of the system.
d. Click Alter Channel Subscriptions in the Subscribed Channels section of the
screen.
e. Select the following channels from the list presented on the screen.
Red Hat Enterprise Virtualization Manager (v.3 x86_64 )
RHEL Server Supplem entary (v. 6 64 -bit x86_64 )
JBoss Application Platform (v 5) for 6Server x86_64 (note that this
channel is listed under "Additional Services Channels for Red Hat Enterprise Linux 6 for
x86_64")
Click the Change Subscription button to finalize the change.

You are now ready to install the Red Hat Enterprise Virtualization Manager. Run the following
command:

# yum -y install rhevm

This command will download the Red Hat Enterprise Virtualization Manager installation software
and resolve all dependencies.

When the packages have finished downloading, run the installer:

# rhevm -setup

Note: rhevm -setup supports the en_US.UT F-8, en_US.utf8, and en_US.utf-8 locales.
You will not be able to run this installer on a system where the locale in use is noTone of
these supported values.

The installer will take you through a series of interactive questions as listed in the following
example. If you do not enter a value when prompted, the installer uses the default settings which
are stated in [ ] brackets.

Example: Red Hat Enterprise Virtualization Manager installation

Welcom e to RHEV Manager setup utility
HTTP Port [8080] :
HTTPS Port [8443] :
Host fully qualified Dmain Name, note that this Name should be fully
resolvable [rhevm .dem o.redhat.com ] :
Password for Adm inistrator (adm in@ internal) :
Database password (required for secure authentication with the locally
created database) :
Confirm password :
Organization Name for the Certificate: Red Hat
The default storage type you will be using ['NFS'| 'FC'| 'ISCSI'] [NFS] :
ISCSI
Should the installer configure NFS share on this server to be used as an ISO
Dmain? ['yes'| 'no'] [no] : yes
Mount point path: /data/iso
Display Name for the ISO Dmain: local-iso-share
Firewall ports need to be opened.
You can let the installer configure iptables autom atically overriding the current configuration. The old configuration will be backed up.
Alternately you can configure the firewall later using an example iptables file found under /usr/share/rhevm /conf/iptables.example
Configure iptables ? ['yes'| 'no']: yes

Important points to note:

• The default ports 8080 and 84 4 3 must be available to access the manager on HTTP and HTTPS respectively.
• If you elect to configure an NFS share it will be exported from the machine on which the manager is being installed.
• The storage type that you select will be used to create a data center and cluster. You will then be able to attach storage to these from the Administration Portal.

You are then presented with a summary of the configurations you have selected. Type yes to
accept them.

Example: Confirm Manager installation settings

RHEV Manager will be installed using the following configuration:
=================================================================
http-port: 8080
https-port: 8443
host-fqdn: rhevm .dem o.redhat.com
auth-pass: * * * * * * * *
db-pass: * * * * * * * *
org-Name: Red Hat
default-dc-type: ISCSI
nfs-m p: /data/iso
iso-Dmain-Name: local-iso-share
override-iptables: yes
Proceed with the configuration listed above? (yes|no): yes

The installation commences. The following message displays, indicating that the installation was
successful.

Example: Successful installation

Installing:
Creating JBoss Profile... [ DONE ]
Creating CA... [ DONE ]
Setting Database Security... [ DONE ]
Creating Database... [ DONE ]
Updating the Default Data Center Storage Type... [ DONE ]
Editing JBoss Configuration... [ DONE ]
Editing RHEV Manager Configuration... [ DONE ]
Configuring the Default ISO Dmain... [ DONE ]
Starting JBoss Service... [ DONE ]
Configuring Firewall (iptables)... [ DONE ]

* * * * Installation com pleted successfully * * * * * *

Your Red Hat Enterprise Virtualization Manager is now up and running. You can log in to the Red Hat Enterprise Virtualization Manager's web administration portal with the username adm in (the
administrative user configured during installation) in the internal domain. Instructions to do so are
provided at the end of this chapter.

Important: The internal domain is automatically created upon installation, however no new users can be added to this domain. To authenticate new users, you need an external directory service. Red Hat
Enterprise Virtualization supports IPA and Active Directory, and provides a utility called rhevmmanage-domains to attach new directories to the system.

Install Hosts

                       Figure 2.2. Install Red Hat Enterprise Virtualization Hosts

After you have installed the Red Hat Enterprise Virtualization Manager, install the hosts to run your
virtual machines. In Red Hat Enterprise Virtualization, you can use either Red Hat Enterprise
Virtualization Hypervisor or Red Hat Enterprise Linux as hosts.

Install Red Hat Enterprise Virtualization Hypervisor

To prepare a Red Hat Enterprise Virtualization Hypervisor installation CD

• Download the latest version of the rhev-hypervisor* package from Red Hat Network. The lisTof hypervisor packages is located at the Red Hat Enterprise Virtualization Hypervisor
  (v.6 x86_64 ) channel.

a. Log on to Red Hat Network (http://rhn.redhat.com/).
b. Click System s at the top of the page.
c. From the list presented on the screen, select the system on which the Red Hat Enterprise
Virtualization Manager is installed by clicking on its name.
d. Click Alter Channel Subscriptions in the Subscribed Channels section of the screen.
e. Select the Red Hat Enterprise Virtualization Hypervisor (v.6 x86_64 ) channel from the list presented on the screen, then click the Change Subscription button to finalize the change.

Log in to the system on which the Red Hat Enterprise Virtualization Manager is installed. You must log in as the root user to install the rhev-hypervisor package. Run the following command:

# yum install "rhev-hypervisor* "

The hypervisor ISO image is installed into the /usr/share/rhev-hypervisor/ directory.

Insert a blank CD into your CD writer. Use the cdrecord utility to burn the hypervisor ISO image
onto your disc. Run:

# cdrecord dev=/dev/cdrw /usr/share/rhev-hypervisor/rhev-hypervisor.iso

Install Red Hat Enterprise Linux Host

Log In to Administration Portal

Configure Red Hat Enterprise Virtualization

Configure Data Centers

Configure Cluster

Configure Networking

Configure Hosts

Approve Red Hat Enterprise Virtualization Hypervisor Host

The Hypervisor you installed in Section “Install Red Hat Enterprise Virtualization Hypervisor” is automatically registered with the Red Hat Enterprise Virtualization platform. It displays in the Red Hat Enterprise Virtualization Manager, and needs to be approved for use.

To set up a Red Hat Enterprise Virtualization Hypervisor host
On the Tree pane, click Expand All and select Hosts under the Default cluster. On the Hosts tab, select the name of your newly installed hypervisor.

   Figure 3.8. Red Hat Enterprise Virtualization Hypervisor pending approval

Click the Approve button. The Edit and Approve Host dialog displays. Accept the defaults
or make changes as necessary, then click OK.

               Figure 3.9. Approve Red Hat Enterprise Virtualization Hypervisor

The host status will change from Non Operational to Up.

Attach Red Hat Enterprise Linux Host

In contrast to the hypervisor host, the Red Hat Enterprise Linux host you installed in Section,
“Install Red Hat Enterprise Linux Host” is not automatically detected. It has to be manually attached to the Red Hat Enterprise Virtualization platform before it can be used.

To attach a Red Hat Enterprise Linux host
On the Tree pane, click Expand All and select Hosts under the Default cluster. On the Hosts
tab, click New.
The New Host dialog displays.

             Figure 3.10. Attach Red Hat Enterprise Linux Host

Enter the details in the following fields:

• Data Center: the data center to which the host belongs. Select the Default data center.
• Host Cluster: the cluster to which the host belongs. Select the Default cluster.
• Name: a descriptive name for the host.
• Address: the IP address, or resolvable hostname of the host, which was provided during installation.
• Root Password: the password of the designated host; used during installation of the host.
• Configure iptables rules: This checkbox allows you to override the firewall settings on the host with the default rules for Red Hat Enterprise Virtualization.

If you wish to configure this host for OuTof Band (OOB) power management, select the Power Managem ent tab. T ick the Enable Power Managem ent checkbox and provide the required information in the following fields:

• Address: The address of the host.
• User Name: A valid user name for the OOB management.
• Password: A valid, robust password for the OOB management.
• Type: The type of OOB management device. Select the appropriate device from the drop down list.

alom Sun Advanced Lights Out Manager
apc American Power Conversion Master
MasterSwitch network power switch
bladecenter IBM Bladecentre Remote Supervisor Adapter
drac5 Dell Remote Access Controller for Dell
computers
eps ePowerSwitch 8M+ network power switch
ilo HP Integrated Lights Out standard
ilo3 HP Integrated Lights Out 3 standard
ipmilan Intelligent Platform Management Interface
rsa IBM Remote Supervisor Adaptor
rsb Fujitsu-Siemens RSB management interface
wti Western T elematic Inc Network PowerSwitch
cisco_ucs Cisco Unified Computing System Integrated
Management Controller

• Options: Extra command line options for the fence agent. Detailed documentation of the options available is provided in the man page for each fence agent.

Click the Test button to test the operation of the OOB management solution.

If you do not wish to configure power management, leave the Enable Power Management checkbox unmarked.

Click OK. If you have not configured power management, a pop-up window prompts you to confirm if you wish to proceed without power management. SelecToK to continue.

The new host displays in the lisTof hosts with a status of Installing. Once installation is complete, the status will update to Reboot and then Awaiting. When the host is ready for use, its status changes to Up.

You have now successfully configured your hosts to run virtual machines. The next step is to prepare data storage domains to house virtual machine disk images.

Configure Storage

                                Figure 3.11. Configure Storage

After configuring your logical networks, you need to add storage to your data center.

Red Hat Enterprise Virtualization uses a centralized shared storage system for virtual machine disk
images and snapshots. Storage can be implemented using Network File System (NFS), Internet Small
Computer System Interface (iSCSI) or Fibre Channel Protocol (FCP). Storage definition, type and function, are encapsulated in a logical entity called a Storage Dmain. Multiple storage domains are
supported.

For this guide you will use two types of storage domains. The first is an NFS share for ISO images of installation media. You have already created this ISO domain during the Red Hat Enterprise Virtualization Manager installation

The second storage domain will be used to hold virtual machine disk images. For this domain, you need at leasTone of the supported storage types. You have already set a default storage type during
installation as described in Section, “Install Red Hat Enterprise Virtualization Manager”. Ensure that you use the same type when creating your data domain.

Select your next step by checking the storage type you should use:

1. Navigate to the Tree pane and click the Expand All button. Under System, click Default. On
   the results list, the Default data center displays.
2. On the results list, the Storage Type column displays the type you should add.
3. Now that you have verified the storage type, create the storage domain:

For NFS storage, refer to Section, “Create an NFS Data Domain”.
For iSCSI storage, refer to Section, “Create an iSCSI Data Domain”.
For FCP storage, refer to Section, “Create an FCP Data Domain”.

Create an NFS Data Domain

Because you have selected NFS as your default storage type during the Manager installation, you will
now create an NFS storage domain. An NFS type storage domain is a mounted NFS share that is
attached to a data center and used to provide storage for virtual machine disk images.

To add NFS storage:

Navigate to the Tree pane and click the Expand All button. Under System, select the Default
data center and click on Storage. The available storage domains display on the results list. Click
New Domain.

The New Storage dialog box displays.

    Figure 3.12. Add New Storage

Configure the following options:

• Name: Enter a suitably descriptive name.
• Data Center: The Default data center is already pre-selected.
• Dmain Function / Storage Type: In the drop down menu, select Data → NFS. The storage domain types not compatible with the Default data center are grayed out. After you select your domain type, the Export Path field appears.
• Use Host: Select any of the hosts from the drop down menu. Only hosts which belong in the pre-selected data center will display in this list.
• Export path: Enter the IP address or a resolvable hostname of the chosen host. The export path should be in the formaTof 192.168.0.10:/data or domain.example.com :/data

Click OK. The new NFS data domain displays on the Storage tab. It will remain with a Locked status while it is being prepared for use. When ready, it is automatically attached to the data center.

You have created an NFS storage domain. Now, you need to attach an ISO domain to the data center
and upload installation images so you can use them to create virtual machines. Proceed to Section, “Attach and Populate ISO domain”.

Create an iSCSI Data Domain

Because you have selected iSCSI as your default storage type during the Manager installation, you will now create an iSCSI storage domain. Red Hat Enterprise Virtualization platform supports iSCSI storage domains spanning multiple pre-defined Logical Unit Numbers (LUNs).

To add iSCSI storage:

On the side pane, select the Tree tab. On System , click the + icon to display the available data
centers.
Double click on the Default data center and click on Storage. The available storage domains
display on the results list. Click New Domain.
The New Dmain dialog box displays.

    Figure 3.13. Add iSCSI Storage

Configure the following options:

• Name: Enter a suitably descriptive name.
• Data Center: The Default data center is already pre-selected.
• Domain Function / Storage Type: In the drop down menu, select Data → iSCSI.
• The storage domain types which are not compatible with the Default data center are grayed out. After you select your domain type, the Use Host and Discover T argets fields display.
• Use host: Select any of the hosts from the drop down menu. Only hosts which belong in this data center will display in this list.

To connect to the iSCSI target, click the Discover Targets bar. This expands the menu to
display further connection information fields.

  Figure 3.14 . Attach LUNs to iSCSI domain

Enter the required information:

• Address: Enter the address of the iSCSI target.
• Port: Select the port to connect to. The default is 3260.
• User Authentication: If required, enter the username and password.

Click the Discover button to find the targets. The iSCSI targets display in the results list with a
Login button for each target.

Click Login to display the lisTof existing LUNs. Tick the Add LUN checkbox to use the selected
LUN as the iSCSI data domain.

Click OK. The new NFS data domain displays on the Storage tab. It will remain with a Locked
status while it is being prepared for use. When ready, it is automatically attached to the data
center.

You have created an iSCSI storage domain. Now, you need to attach an ISO domain to the data center
and upload installation images so you can use them to create virtual machines. Proceed to Section ,“Attach and Populate ISO domain”.

Create an FCP Data Domain

Because you have selected FCP as your default storage type during the Manager installation, you will
now create an FCP storage domain. Red Hat Enterprise Virtualization platform supports FCP storage domains spanning multiple pre-defined Logical Unit Numbers (LUNs).

To add FCP storage:

On the side pane, select the Tree tab. On System , click the + icon to display the available data
centers.

Double click on the Default data center and click on Storage. The available storage domains
display on the results list. Click New Domain.

The New Dmain dialog box displays.

   Figure 3.15. Add FCP Storage

Configure the following options:

• Name: Enter a suitably descriptive name.
• Data Center: The Default data center is already pre-selected.
• Domain Function / Storage Type: Select FCP.
• Use Host: Select the IP address of either the hypervisor or Red Hat Enterprise Linux host.
• The lisTof existing LUNs display. On the selected LUN, tick the Add LUN checkbox to use it as the FCP data domain.

Click OK. The new FCP data domain displays on the Storage tab. It will remain with a Locked
status while it is being prepared for use. When ready, it is automatically attached to the data
center.

You have created an FCP storage domain. Now, you need to attach an ISO domain to the data center
and upload installation images so you can use them to create virtual machines. Proceed to Section, “Attach and Populate ISO domain”.

Attach and Populate ISO domain

You have defined your first storage domain to store virtual guest data, now it is time to configure your second storage domain, which will be used to store installation images for creating virtual machines. You have already created a local ISO domain during the installation of the Red Hat Enterprise Virtualization Manager. To use this ISO domain, attach it to a data center.

To attach the ISO domain
Navigate to the Tree pane and click the Expand All button. Click Default. On the results list,
the Default data center displays.

On the details pane, select the Storage tab and click the Attach ISO button.

The Attach ISO Library dialog appears with the available ISO domain. Select it and click OK.

   Figure 3.16. Attach ISO Library

The ISO domain appears in the results lisTof the Storage tab. It displays with the Locked status
as the domain is being validated, then changes to Inactive.

Select the ISO domain and click the Activate button. The status changes to Locked and then to
Active.

Media images (CD-ROM or DVD-ROM in the form of ISO images) must be available in the ISO repository for the virtual machines to use. To do so, Red Hat Enterprise Virtualization provides a utility that copies the images and sets the appropriate permissions on the file. The file provided to the utility and the ISO share have to be accessible from the Red Hat Enterprise Virtualization Manager.

Log in to the Red Hat Enterprise Virtualization Manager server console to upload images to the ISO
domain.

To upload ISO images

Create or acquire the appropriate ISO images from boot media. Ensure the path to these images
is accessible from the Red Hat Enterprise Virtualization Manager server.

The next step is to upload these files. First, determine the available ISO domains by running:

# rhevm -iso-uploader list

You will be prompted to provide the admin user password which you use to connect to the
administration portal. The tool lists the name of the ISO domain that you attached in the previous
section.

ISO Storage Dmain List:
local-iso-share

Now you have all the information required to upload the required files. On the Manager console,
copy your installation images to the ISO domain. For your images, run:

# rhevm -iso-uploader upload -i local-iso-share [file1] [file2] .... [fileN]

You will be prompted for the admin user password again, provide it and press Enter.
Note that the uploading process can be time consuming, depending on your storage performance.

After the images have been uploaded, check that they are available for use in the Manager
administration portal.

• Navigate to the Tree and click the Expand All button.
• Under Storage, click on the name of the ISO domain. It displays in the results list. Click on it to display its details pane.
• On the details pane, select the Im ages tab. The lisTof available images should be populated with the files which you have uploaded. In addition, the RHEV-toolsSetup.iso and virtio-win.vfd images should have been automatically uploaded during installation.

    Figure 3.17. Uploaded ISO images

Now that you have successfully prepared the ISO domain for use, you are ready to start creating virtual machines.

Manage Virtual Machines

The final stage of setting up Red Hat Enterprise Virtualization is the virtual machine lifecycle - spanning the creation, deployment and maintenance of virtual machines; using templates; and configuring user permissions. This chapter will also show you how to log in to the user portal and connect to virtual machines.

Create Virtual Machines
                   Figure 4 .1. Create Virtual Machines

On Red Hat Enterprise Virtualization, you can create virtual machines from an existing template, as a
clone, or from scratch. Once created, virtual machines can be booted using ISO images, a network boot (PXE) server, or a hard disk. This document provides instructions for creating a virtual machine using an ISO image.

In your current configuration, you should have at leasTone host available for running virtual machines, and uploaded the required installation images to your ISO domain. This section guides you through the creation of a Red Hat Enterprise Linux 6 virtual server. You will perform a normal attended installation using a virtual DVD.

To create a Red Hat Enterprise Linux server

Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Server.

    Figure 4 .2. Create New Linux Virtual Machine

You only need to fill in the Name field and select Red Hat Enterprise Linux 6.x as your
Operating System . You may alter other settings but in this example we will retain the defaults.
Click OK to create the virtual machine.

A New Virtual Machine - Guide Me window opens. This allows you to add networks and
storage disks to the virtual machine.

                                 Figure 4 .3. Create Virtual Machines

Click Configure Network Interfaces to define networks for your virtual machine. The parameters in the following figure are recommended, but can be edited as necessary. When you have configured your required settings, click OK.

                                             Figure 4 .4 . New Network Interface configurations

You are returned to the Guide Me window. This time, click Configure Virtual Disks to add
storage to the virtual machine. The parameters in the following figure are recommended, but can
be edited as necessary. When you have configured your required settings, click OK.

                                           Figure 4 .5. New Virtual Disk configurations

Close the Guide Me window by clicking Configure Later. Your new RHEL 6 virtual machine will
display in the Virtual Machines tab.

You have now created your first Red Hat Enterprise Linux virtual machine. Before you can use your
virtual machine, install an operating system on it.

To install the Red Hat Enterprise Linux guesToperating system

Right click the virtual machine and select Run Once. Configure the following options:

                                          Figure 4 .6. Run Red Hat Enterprise Linux Virtual Machine

• Attach CD: Red Hat Enterprise Linux 6
• Boot Sequence: CD-ROM
• Display protocol: SPICE

Retain the default settings for the other options and click OK to start the virtual machine.

Select the virtual machine and click the Console icon. As this is your first time connecting to
the virtual machine, allow the installation of the Spice Active X and the SPICE client.

After the SPICE plugins have been installed, select the virtual machine and click the Console icon
again. This displays a window to the virtual machine, where you will be prompted to begin installing the operating system.

After the installation has completed, shut down the virtual machine and reboot from the hard drive.

You can now connect to your Red Hat Enterprise Linux virtual machine and start using it.

Create a Windows Virtual Machine

You now know how to create a Red Hat Enterprise Linux virtual machine from scratch. The procedure of creating a Windows virtual machine is similar, except that it requires additional virtio drivers. This example uses Windows 7, but you can also use other Windows operating systems. You will perform a normal attended installation using a virtual DVD.

To create a Windows desktop

Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Desktop.

   Figure 4 .7. Create New Windows Virtual Machine

You only need to fill in the Name field and select Windows 7 as your Operating System . You
may alter other settings but in this example we will retain the defaults. Click OK to create the virtual
machine.

A New Virtual Machine - Guide Me window opens. This allows you to define networks for
the virtual machine. Click Configure Network Interfaces. See Figure 4.4, “New Network
Interface configurations” for details.

You are returned to the Guide Me window. This time, click Configure Virtual Disks to add
storage to the virtual machine. See Figure 4.5, “New Virtual Disk configurations” for details.

Close the Guide Me windows. Your new Windows 7 virtual machine will display in the Virtual
Machines tab.

To install Windows guesToperating system

Right click the virtual machine and select Run Once. The Run Once dialog displays as in
Figure 4.6, “Run Red Hat Enterprise Linux Virtual Machine”. Configure the following options:

• Attach Floppy: virtio-win
• Attach CD: Windows 7
• Boot sequence: CD-ROM
• Display protocol: SPICE

Retain the default settings for the other options and click OK to start the virtual machine.

Select the virtual machine and click the Console icon. This displays a window to the virtual
machine, where you will be prompted to begin installing the operating system.

Accept the default settings and enter the required information as necessary. The only change you must make is to manually install the VirtIO drivers from the virtual floppy disk (vfd) image. To do so, select the Custom (advanced) installation option and click Load Driver. Press Ctrl and select:

• Red Hat VirtIO Ethernet Adapter
• Red Hat VirtIO SCSI Controller

The installation process commences, and the system will reboot itself several times.

Back on the administration portal, when the virtual machine's status changes back to Up, right click on it and select Change CD. From the lisTof images, select RHEV-toolsSetup to attach the Guest Tools ISO which provides features including USB redirection and SPICE display optimization.

Click Console and log in to the virtual machine. Locate the CD drive to access the contents of the Guest Tools ISO, and launch the RHEV-toolsSetup executable. After the tools have been installed, you will be prompted to restart the machine for changes to be applied.

You can now connect to your Windows virtual machine and start using it.

Using Templates

                    Figure 4 .8. Create Templates

Now that you know how to create a virtual machine, you can save its settings into a template. This template will retain the original virtual machine's configurations, including virtual disk and network interface settings, operating systems and applications. You can use this template to rapidly create replicas of the original virtual machine.

Create a Red Hat Enterprise Linux Template

To make a Red Hat Enterprise Linux virtual machine template, use the virtual machine you created in Section, “Create a Red Hat Enterprise Linux Virtual Machine” as a basis. Before it can be used, it has to be sealed. This ensures that machine-specific settings are not propagated through the template.

To prepare a Red Hat Enterprise Linux virtual machine for use as a template

Connect to the Red Hat Enterprise Linux virtual machine to be used as a template. Flag the
system for re-configuration by running the following command as root:

# touch /.unconfigured

Remove ssh host keys. Run:

# rm -rf /etc/ssh/ssh_host_*

Shut down the virtual machine. Run:

# poweroff

The virtual machine has now been sealed, and is ready to be used as a template for Linux virtual
machines.

To create a template from a Red Hat Enterprise Linux virtual machine

In the administration portal, click the Virtual Machines tab. Select the sealed Red Hat
Enterprise Linux 6 virtual machine. Ensure that it has a status of Down.

Click Make Template. The New Virtual Machine Template displays.

Click Make Template. The New Virtual Machine Template displays.

   Figure 4 .9. Make new virtual machine template

Enter information into the following fields:

• Name: Name of the new template
• Description: Description of the new template
• Host Cluster: The Host Cluster for the virtual machines using this template.
• Make Private: If you tick this checkbox, the template will only be available to the template's creator and the administrative user. Nobody else can use this template unless they are given permissions by the existing permitted users.

Click OK. The virtual machine displays a status of "Image Locked" while the template is being
created. The template is created and added to the Templates tab. During this time, the action
buttons for the template remain disabled. Once created, the action buttons are enabled and the
template is ready for use.

Clone a Red Hat Enterprise Linux Virtual Machine

In the previous section, you created a Red Hat Enterprise Linux template complete with pre-configured storage, networking and operating system settings. Now, you will use this template to deploy a preinstalled virtual machine.

To clone a Red Hat Enterprise Linux virtual machine from a template

Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Server.

   Figure 4 .10. Create virtual machine based on Linux template

On the General tab, select the existing Linux template from the Based on Template
list.
Enter a suitable Name and appropriate Description, then accept the default values
inherited from the template in the resTof the fields. You can change them if needed.
Click the Resource Allocation tab. On the Provisioning field, click the drop down
menu and select the Clone option.

          Figure 4 .11. Set the provisioning to Clone

Retain all other default settings and click OK to create the virtual machine. The virtual machine
displays in the Virtual Machines list.

Create a Windows Template

To make a Windows virtual machine template, use the virtual machine you created in Section,
“Create a Windows Virtual Machine” as a basis.

Before a template for Windows virtual machines can be created, it has to be sealed with sysprep. This ensures that machine-specific settings are not propagated through the template.

Note that the procedure below is applicable for creating Windows 7 and Windows 2008 R2 templates.

To seal a Windows virtual machine with sysprep

In the Windows virtual machine to be used as a template, open a command line terminal and type
regedit.

The Registry Editor window displays. On the left pane, expand HKEY_LOCAL_MACHINE →
SYSTEM → SETUP.

On the main window, right click to add a new string value using New → String Value. Right click
on the file and select Modify. When the Edit String dialog box displays, enter the following
information in the provided text boxes:

• Value name: UnattendFile
• Value data: a:\sysprep.inf

Launch sysprep from C:\Windows\System 32\sysprep\sysprep.exe

• Under System Cleanup Action, select Enter System Out-of-Box-Experience (OOBE).
• Tick the Generalize checkbox if you need to change the computer's system identification number (SID).
• Under Shutdown Options, select Shutdown.

Click OK. The virtual machine will now go through the sealing process and shut down
automatically.

To create a template from an existing Windows machine

In the administration portal, click the Virtual Machines tab. Select the sealed Windows 7
virtual machine. Ensure that it has a status of Down and click Make Template.

The New Virtual Machine Template displays. Enter information into the following fields:

• Name: Name of the new template
• Description: Description of the new template
• Host Cluster: The Host Cluster for the virtual machines using this template.
• Make Public: Check this box to allow all users to access this template.

Click OK. In the T em plates tab, the template displays the "Image Locked" status icon while it is
being created. During this time, the action buttons for the template remain disabled. Once created,
the action buttons are enabled and the template is ready for use.

You can now create new Windows machines using this template.

Create a Windows Virtual Machine from a Template

This section describes how to create a Windows 7 virtual machine using the template created in
Section, “Create a Windows Template”.

To create a Windows virtual machine from a template
Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, click New Desktop.

• Select the existing Windows template from the Based on Template list.
• Enter a suitable Name and appropriate Description, and accept the default values inherited from the template in the resTof the fields. You can change them if needed.

Retain all other default setting and click OK to create the virtual machine. The virtual machine
displays in the Virtual Machines list with a status of "Image Locked" until the virtual disk is created.
The virtual disk and networking settings are inherited from the template, and do not have to be
reconfigured.

Click the Run icon to turn iTon. This time, the Run Once steps are not required as the
operating system has already been installed onto the virtual machine hard drive. Click the green
Console button to connect to the virtual machine.

You have now learned how to create Red Hat Enterprise Linux and Windows virtual machines with and without templates. Next, you will learn how to access these virtual machines from a user portal.

Using Virtual Machines

Now that you have created several running virtual machines, you can assign users to access them from the user portal. You can use virtual machines the same way you would use a physical desktop.

Assign User Permissions
                    Figure 4 .12. Assign Permissions

Red Hat Enterprise Virtualization has a sophisticated multi-level administration system, in which
customized permissions for each system component can be assigned to different users as necessary.
For instance, to access a virtual machine from the user portal, a user must have either UserRole or
PowerUserRole permissions for the virtual machine. These permissions are added from the manager
administration portal.

To assign PowerUserRole permissions
Navigate to the Tree pane and click Expand All. Click the VMs icon under the Default cluster.
On the Virtual Machines tab, select the virtual machine you would like to assign a user to.

On the Details pane, navigate to the Perm issions tab. Click the Add button.

The Add Perm ission to User dialog displays. Enter a Name, or User Name, or part thereof in
the Search textbox, and click Go. A lisTof possible matches display in the results list.

      Figure 4 .13. Add PowerUserRole Permission

Select the check box of the user to be assigned the permissions. Scroll through the Assign
role to user list and select PowerUserRole. Click OK.

Log in to the User Portal

                    Figure 4 .14 . Connect to the User Portal

Now that you have assigned PowerUserRole permissions on a virtual machine to the user named admin, you can access the virtual machine from the user portal. To log in to the user portal, all you
need is a Linux client running Mozilla Firefox or a Windows client running Internet Explorer.

If you are using a Red Hat Enterprise Linux client, install the SPICE plug-in before logging in to the User Portal. Run:

# yum install spice-xpi

To log in to the User Portal

Open your browser and navigate to https://Dmain.exam ple.com :84 4 3/UserPortal.
Substitute domain.example.com with the Red Hat Enterprise Virtualization Manager server
address.

The login screen displays. Enter your User Name and Password, and click Login.

You have now logged into the user portal. As you have PowerUserRole permissions, you are taken by
default to the Extended User Portal, where you can create and manage virtual machines in addition to
using them. This portal is ideal if you are a system administrator who has to provision multiple virtual machines for yourself or other users in your environment.

    Figure 4 .15. The Extended User Portal

You can also toggle to the Basic User Portal, which is the default (and only) display for users with
UserRole permissions. This portal allows users to access and use virtual machines, and is ideal for
everyday users who do not need to make configuration changes to the system.

    Figure 4 .16. The Basic User Portal

You have now completed the Quick Start Guide, and successfully set up Red Hat Enterprise
Virtualization. However, this is just the first step for you to familiarize yourself with basic Red Hat
Enterprise Virtualization operations. You can further customize your own unique environment based on your organization's needs by working with our solution architects.