Product SiteDocumentation Site

Chapter 3. Manager Installation

3.1. Installation
3.2. Configuration
3.3. Removing Red Hat Enterprise Virtualization Manager
3.4. Connect to the Administration Portal
Before proceeding with Red Hat Virtualization Manager installation you must ensure that all prerequisites, as listed in Chapter 2, System Requirements, are met. Once you have confirmed that all prerequisites are met you are ready to proceed with installation.
To perform initial installation and configuration of the Red Hat Enterprise Virtualization Manager follow the steps in Section 3.1, “Installation”. Once you have followed this procedure the Red Hat Enterprise Virtualization Manager and dependencies, including JBoss (http://www.jboss.com), will be installed and configured ready for your first login. Further action must be undertaken to complete configuration of the environment to the point that you can create virtual machines. These tasks will be described in the following chapters.
To complete installation of the Red Hat Enterprise Virtualization Manager successfully you must be able to determine:
  1. The ports to be used for HTTP, and HTTPS, communication. The defaults are 8080 and 8443 respectively.
  2. The Fully Qualified Domain Name (FQDN) of the system the manager is to be installed on.
  3. The password you will use to secure the Red Hat Enterprise Virtualization administration account.
  4. The password you will use to secure the database.
  5. The Organization Name to use when creating the manager's security certificates.
  6. The storage type to be used for the initial data center attached to the manager. The default is NFS.
  7. The path to use for the ISO share, if the manager is being configured to provide one. The display name, which will be used to label the domain in the Red Hat Enterprise Virtualization Manager also needs to be provided.
  8. The firewall rules, if any, present on the system that need to be integrated with the rules required for the manager to function.
Before installation is completed the values selected are displayed for confirmation. Once the values have been confirmed they are applied and the Red Hat Enterprise Virtualization Manager is ready for use.
Example 3.1. Completed Installation
RHEV Manager will be installed using the following configuration:
=================================================================
http-port:                     8080
https-port:                    8443
host-fqdn:                     manager.demo.redhat.com
auth-pass:                     ********
db-pass:                       ********
org-name:                      Red Hat
default-dc-type:               NFS
nfs-mp:                        /isodomain
iso-domain-name:               ISODomain
override-iptables:             yes
Proceed with the configuration listed above? (yes|no):

Note — Automated Installation

Automated installations are created by providing rhevm-setup with an answer file. An answer file contains answers to the questions asked by the setup command.
  • To create an answer file, use the --gen-answer-file parameter to set the location to which the answer file must be saved. The rhevm-setup command will record your answers to the file.
    # rhevm-setup --gen-answer-file=ANSWER_FILE
  • To use an answer file for a new installation, use the --answer-file parameter to set the location of the answer file that must be used. The command rhevm-setup command will use the answers stored in the file to complete installation.
    # rhevm-setup --answer-file=ANSWER_FILE
Run rhevm-setup --help for further information.

3.1. Installation

The Red Hat Enterprise Virtualization Manager and all of its dependencies are available via Red Hat Network. To install the manager you must ensure connectivity with either the Red Hat Network or a Red Hat Network Satellite Server is available. You must also ensure that you have access to all required Red Hat Network channels. See Section 2.2.3.1, “Required Channels” for further information.
  1. If installed, the classpathx-jaf package must be removed. It conflicts with some of the components installed to support JBoss.
    # yum remove classpathx-jaf
  2. Use yum to ensure that the most up to date versions of all installed packages are in use.
    # yum upgrade
  3. Use yum to initiate installation of the rhevm package and all dependencies. You must run this command as the root user.
    # yum install rhevm
Result:
All required packages and dependencies are installed. You must now configure the system.