Product SiteDocumentation Site

Chapter 2. Install Red Hat Enterprise Virtualization

2.1. Install Red Hat Enterprise Virtualization Manager
2.2. Install Hosts
2.2.1. Install Red Hat Enterprise Virtualization Hypervisor
2.2.2. Install Red Hat Enterprise Linux Host
2.3. Connect to Red Hat Enterprise Virtualization Manager
2.3.1. Log In to Administration Portal
The Red Hat Enterprise Virtualization platform consists of at least one 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.

2.1. Install Red Hat Enterprise Virtualization Manager

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 (see Section 1.1, “Prerequisites”).
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, remember to set the fully qualified domain name (FQDN) and IP for the server.
  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 2.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.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. The following message displays, indicating that the installation was successful.
    Example 2.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. 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 rhevm-manage-domains to attach new directories to the system. Use of this tool is covered in the Red Hat Enterprise Virtualization Installation Guide.