Product SiteDocumentation Site

Lab 9 - Install and Configure Minimal Setup

This lab demonstrates basic installation and configuration of Red Hat Enterprise Virtualization using minimal hardware. At the end of this lab the you will be able to create virtual machines up to the limit of a single host system, provision the virtual machines, and experience the management interface.
Note that this lab is designed for users with minimum resources for evaluation. If you have multiple servers for use as virtual machine hosts, or wish to use shared storage, please refer to Lab 1 - Install and Configure Basic Setup.
Lab 9 - Objectives
This lab takes you through the tasks necessary to install and set up Red Hat Enterprise Virtualization on a single host and using local storage. In addition, you will learn how to add ISOs in order to create virtual machines. This lab should take you about 60 minutes.
Section 1, “Install Red Hat Enterprise Virtualization Manager” shows you how to install the Red Hat Enterprise Virtualization Manager on a server running Red Hat Enterprise Linux. (12 minutes*)
Section 2, “Install Red Hat Enterprise Virtualization Hypervisor” shows you how to install and configure a Red Hat Enterprise Virtualization Hypervisor for use with Red Hat Enterprise Virtualization Manager. (13 minutes*)
Section 3, “Connect to Red Hat Enterprise Virtualization Manager” shows you how to configure a client machine to connect to the Red Hat Enterprise Virtualization Manager administration portal. (8 minutes)
Section 4, “Approve the Red Hat Enterprise Virtualization Hypervisor” shows you how to approve the host for use from the Red Hat Enterprise Virtualization Manager. (7 minutes)
Section 5, “Create Local Storage” shows you how to define NFS, iSCSI or FCP storage and attach the domains to the data center. (10 minutes)
Section 6, “Attach and Populate ISO Domain” shows you how to attach the predefined ISO domain to the data center and upload ISO images to the repository. (10 minutes)
* The time required to download packages from the Red Hat Network depends on the bandwidth of your connection to RHN, therefore it has not been included in the estimated time.
Lab 9 - Configuration
The following figure and table list the environment parameters and object names which will be used consistently throughout this lab. It is strongly recommended that you use these entities in your evaluation environment to ensure the names are resolvable. You may alter them if necessary, but make sure you have an equivalent name for each component.
Table 3. Lab component names
Component Name in the Red Hat Enterprise Virtualization Manager Setup IP (if applicable) Fully Qualified Domain Name
Domain Services - - demo.redhat.com
Red Hat Enterprise Virtualization Manager - - rhevm.demo.redhat.com
Domain Name System - 23.23.2.1 -
Management Network rhevm 10.35.3.0/24 -
Red Hat Enterprise Virtualization Hypervisor Atlantic - atlantic.demo.redhat.com
Administrator User Name admin - -
Local Storage Domain Local-images - -
ISO Storage Domain local-iso-share - -

1. Install Red Hat Enterprise Virtualization Manager

The Red Hat Enterprise Virtualization 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 (see Section 2.1, “Track B Requirements”).
To install Red Hat Enterprise Virtualization Manager
  1. 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.

    Important

    During installation, set the fully qualified domain name (FQDN) for the server as rhevm.demo.redhat.com.
  2. 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
    
  3. 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.
  4. Subscribe the server to the required channels for Red Hat Enterprise Virtualization Manager:
    • The Red Hat Enterprise Virtualization Manager (v.3 x86_64) channel, also referred to as rhel-x86_64-server-6-rhevm-3, provides Red Hat Enterprise Virtualization Manager.
    • The JBoss Application Platform (v 5 in rpm) channel, also referred to as jbappplatform-5-x86_64-server-6-rpm, provides the supported release of the application platform on which the manager runs.
    • The RHEL Server Supplementary (v. 6 64-bit x86_64) channel, also referred to as rhel-x86_64-server-supplementary-6, provides the supported version of the Java Runtime Environment (JRE).
    To do so, run the following command:
    # rhn-channel -v -u YOUR-RHN-USERNAME -a -c rhel-x86_64-server-6-rhevm-3 -c jbappplatform-5-x86_64-server-6-rpm -c rhel-x86_64-server-supplementary-6
  5. 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.
  6. When the packages have finished downloading, run the installer:
    # rhevm-setup

    Important — Supported Locales

    rhevm-setup supports the en_US.UTF-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 not one of these supported values.
  7. 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 4. Red Hat Enterprise Virtualization Manager installation
    Welcome to RHEV Manager setup utility
    HTTP Port  [8080] : 
    HTTPS Port  [8443] : 
    Host fully qualified domain name, note that this name should be fully resolvable  [rhevm.demo.redhat.com] :
    Password for Administrator (admin@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 Domain? ['yes'| 'no']  [no] : yes
    Mount point path: /data/iso
    Display name for the ISO Domain: local-iso-share
    Firewall ports need to be opened.
    You can let the installer configure iptables automatically 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 8443 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. However, at this stage it does not matter which one you choose, because you will be creating local storage on your host later.

  8. You are then presented with a summary of the configurations you have selected. Type yes to accept them.
    Example 5. Confirm Manager installation settings
    RHEV Manager will be installed using the following configuration:
    =================================================================
    http-port:                     8080
    https-port:                    8443
    host-fqdn:                     rhevm.demo.redhat.com
    auth-pass:                     ********
    db-pass:                       ********
    org-name:                      Red Hat
    default-dc-type:               ISCSI
    nfs-mp:                        /data/iso
    iso-domain-name:               local-iso-share
    override-iptables:             yes
    Proceed with the configuration listed above? (yes|no): yes
    

  9. The installation commences. It may take a few minutes. When complete, the following message displays, indicating that the installation was successful.
    Example 6. 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 Domain...                    [ DONE ]
    Starting JBoss Service...                                [ DONE ]
    Configuring Firewall (iptables)...                       [ DONE ]
    
     **** Installation completed 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 admin (the administrative user configured during installation) in the internal domain.

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 rhevm-manage-domains to attach new directories to the system. You will use this tool in subsequent labs.