3.2. Configuration

Once package installation is complete the Red Hat Enterprise Virtualization Manager must be configured. The rhevm-setup command is provided to assist with this task. The script asks you a series of questions, the answers to which form the basis for system configuration. Once all required values have been provided the updated configuration is applied and the Red Hat Enterprise Virtualization Manager services are started.

  1. Start Setup Script

    To begin configuring the system run rhevm-setup as the root user. 
    # rhevm-setup

  2. Set Port for HTTP

    The script prompts for entry of the port to use for HTTP communication. To use the default value, 8080, press Enter. To use an alternative value enter it in the field, and then press Enter. 
    HTTP Port  [8080] :
    The port you select also appears in the URL that must be used to access the Red Hat Enterprise Virtualization Manager over HTTP.

    Example 3.2. Access Using HTTP

    For a machine with hostname manager.demo.redhat.com using the default HTTP port value, 8080, the URL to access the entry page over HTTP is http://manager.demo.redhat.com:8080/.

  3. Set Port for HTTPS

    The script prompts for entry of the port to use for HTTPS communication. To use the default value, 8443, press Enter. To use an alternative value enter it in the field, and then press Enter. 
    HTTPS Port  [8443] :
    Where a port other than 8443 is selected it changes the URL that must be used to access the Red Hat Enterprise Virtualization Manager over HTTPS.

    Example 3.3. Access Using HTTPS

    For a machine with hostname manager.demo.redhat.com using the default HTTPS port value, 8443, the URL to access the entry page over HTTPS is https://manager.demo.redhat.com:8443/.

  4. Set Fully Qualified Domain Name (FQDN)

    The script prompts for entry of the system's fully qualified domain name. This name should be resolvable via both forward and reverse DNS lookup. The script attempts to determine the fully qualified domain name automatically. The value identified is listed in square brackets as the default setting for the fully qualified domain name, based on your setup. 
    Host fully qualified domain name, note that this name should be fully resolvable  [manager.demo.redhat.com] :
    Where the automatically determined fully qualified domain name is correct, press Enter to use the value and continue. Where the automatically determined fully qualified domain name is not correct, enter the correct value and press Enter to use the new value and continue.

  5. Set Administrator Password

    The script creates an authentication domain internal to the Red Hat Enterprise Virtualization Manager for the default administrative account. The domain is named internal, the administrative user is called admin. External authentication domains are added as a post-installation step using the rhevm-manage-domains command.
    You must choose a password for the admin user. You will be asked to enter it a second time to confirm your selection. 
    Password for Administrator (admin@internal) :

  6. Set Database Password

    The script prompts for entry of a password to use for the Red Hat Enterprise Virtualization Manager database. You must enter a strong password. Strong passwords consist of a mix of uppercase, lowercase, numeric, and punctuation characters. They are six or more characters long and do not contain dictionary words. Enter the desired password and press Enter. You will be asked to enter the password again to confirm it. 
    Database password (required for secure authentication with the locally created database) :

  7. Set Organization Name

    The script prompts for entry of the Organization Name. The Organization Name appears in the Subject field of the certificate used to secure communications with the Red Hat Enterprise Virtualization Manager. 
    Organization Name for the Certificate :

  8. Configure Default Storage Type

    The script prompts for selection of the default storage type. This is the storage type that is used for the Default data center. You are able to add further data centers that use different storage types from the Administration Portal at any time. 
    The default storage type you will be using  ['NFS'| 'FC'| 'ISCSI']  [NFS] :
    The default selection is Network File System (NFS). The other available values are:
    • Fibre Channel (FC),
    • Internet Small Computer System Interface (ISCSI), and
    The NFS, FC, and ISCSI options are used to connect to remote storage. Red Hat Enterprise Virtualization also supports The LOCALFS storage type which allows the use of local storage attached to the virtualization hosts, but this storage type is not supported for the Default data center.
    To use the default selection, NFS, press Enter. To select FC, or ISCSI then enter the value and then press Enter.

  9. Configure NFS ISO Domain

    The script asks whether or not an NFS share should be configured on the server and used as an ISO storage domain. 
    Should the installer configure NFS share on this server to be used as an ISO Domain? ['yes'| 'no']  [yes] :
    An ISO storage domain is used to store copies of removable media for use when provisioning and using virtual machines. The Red Hat Enterprise Virtualization Manager is able to use either an ISO storage domain on the system it is installed to or one that exists on remote storage. In either case the ISO storage domain must be accessible via NFS. The ability to configure an ISO storage domain is also available from the Administration Portal after installation.
    To take the default action, which is to configure an NFS share for use as an ISO storage domain, press Enter. To skip this step type no and press Enter.
    If you chose to configure an NFS share then you will also need to provide both a path and a display name for it. The path is the location on the local file system where the NFS share must be created. The directory must not already exist. 
    Mount point path:
    The display name is the name the storage domain will appear under in the Red Hat Enterprise Virtualization Manager. The display name must not contain non-alphanumeric characters other than the underscore (_) and the hyphen (-). 
    Display name for the ISO domain:
    The ISO domain will be created and exported as an NFS share. It will be shown as active in the Red Hat Enterprise Virtualization Manager once the first active virtualization host has been added to the Default data center.

  10. Configure Firewall

    The Red Hat Enterprise Virtualization Manager requires that network traffic on a number of ports be allowed through the system's firewall. The rhevm-setup script is able to configure this automatically, but selecting this option overrides any existing firewall configuration. Where there is an existing firewall configuration that needs to be maintained you must manually configure the firewall to include the additional rules required by the Red Hat Enterprise Virtualization Manager. 
    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
Should the installer configure iptables now? ['yes'| 'no']  [yes] :
    • To proceed with automatic firewall configuration type yes and then press Enter.
    • To skip automatic firewall configuration type no and then press Enter. You will need to add rules equivalent to those found in /usr/share/rhevm/conf/iptables.example to your iptables configuration.

  11. Confirm Configuration

    You have now provided the script with all the information required to complete configuration of the Red Hat Enterprise Virtualization Manager. The values which you entered are displayed for confirmation.

    Example 3.4. Configuration Confirmation Screen

    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:                        /isoshare
iso-domain-name:               ISODomain
override-iptables:             yes
Proceed with the configuration listed above? (yes|no):

    • To permanently apply the configuration values listed type yes and then press Enter to apply the configuration.
    • If one or more of the configuration values listed is incorrect type no and then Enter to revisit the configuration.
    The configuration values are applied. A number of services need to be started and as a result this step takes some time. Do not terminate the installation once application of the configuration values has commenced.
    Once the script has completed successfully take note of the additional information it provides. In particular note down the SSH Certificate fingerprint, SSH Public key fingerprint, and Red Hat Enterprise Virtualization Manager URL for your records.

    Example 3.5. Successful Configuration

    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 ]
Configuring Firewall (iptables)...                       [ DONE ]
Starting JBoss Service...                                [ DONE ]

 **** Installation completed successfully ******

     (Please allow RHEV Manager a few moments to start up.....)


Additional information:
 * SSL Certificate fingerprint: 4C:A4:8F:93:62:50:C1:63:C8:09:70:77:07:90:FD:65:5B:3C:E8:DD
 * SSH Public key fingerprint: fa:71:38:88:58:67:ae:f0:b1:17:fe:91:31:6c:66:6e
 * A default ISO share has been created on this host.
   If IP based access restrictions are required, please edit /isoshare entry in /etc/exports
 * The firewall has been updated, the old iptables configuration file was saved to /usr/share/rhevm/conf/iptables.backup.103654-09092011_866
 * The installation log file is available at: /var/log/rhevm/rhevm-setup_2011_09_09_10_32_56.log
 * Please use the user "admin" and password specified in order to login into RHEV Manager
 * To configure additional users, first configure authentication domains using the 'rhevm-manage-domains' utility
 * To access RHEV Manager please go to the following URL: http://manager.demo.redhat.com:8080

Result:
The Red Hat Enterprise Virtualization Manager has been installed and configured successfully. You are now able to connect to the Administration Portal for the first time, see Section 3.4, “Connect to the Administration Portal” for further information.

Note — Periodic Updates

Red Hat periodically provides updates to the Red Hat Enterprise Virtualization Manager. For information on upgrading to newer releases, refer to Chapter 5, Upgrades between Minor Releases.