Product SiteDocumentation Site

Lab 1 - Install and Configure Basic Setup

Lab 1 on Track A sets up the basic infrastructure to support virtualization, and shows you how to install and configure the hosts, storage and networks in readiness for the virtual machines. The goal of this lab is an environment that is ready for you to create and provision virtual machines.
This lab is intended for Track A, and requires three servers and shared storage. To successfully complete this lab, ensure that you have read Section 1.1, “Track A Requirements”, where the complete requirements for this lab are listed, and complied with its recommendations.
Lab 1 - Objectives
To achieve the goal of this lab, you will install and set up Red Hat Enterprise Virtualization with multiple hosts and shared storage, you will learn to configure networks and add ISOs. This lab should take you about 75 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 Red Hat Enterprise Virtualization Hypervisors for use with Red Hat Enterprise Virtualization Manager. (20 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 hosts for use from the Red Hat Enterprise Virtualization Manager. (10 minutes)
Section 5, “Configure Logical Networks” shows you how to define networks for the storage devices and add them to the hosts. (5 minutes)
Section 6, “Configure Storage” shows you how to define NFS, iSCSI or FCP storage and attach the domains to the data center. (10 minutes)
Section 7, “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 1 - 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 1. Lab component names
Component Name 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 -
Storage Network storage 10.23.1.0/24 -
Management Network rhevm 10.35.3.0/24 -
Red Hat Enterprise Virtualization Hypervisor 1 Atlantic - -
Red Hat Enterprise Virtualization Hypervisor 2 Pacific - -
Administrator User Name admin - -
NFS Storage Domain NFS-share - -
iSCSI Storage Domain iSCSI-share - -
FCP Storage Domain FCP-share - -
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 1.1, “Track A 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 1. 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. You will then be able to attach storage to these from the Administration Portal.

  8. You are then presented with a summary of the configurations you have selected. Type yes to accept them.
    Example 2. 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 3. 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.