2.4.3. Configuring the Red Hat Enterprise Virtualization Manager

After you have installed the rhevm package and dependencies, you must configure the Red Hat Enterprise Virtualization Manager using the engine-setup command. This command asks you a series of questions and, after you provide the required values for all questions, applies that configuration and starts the ovirt-engine service.

Note

The engine-setup command guides you through several distinct configuration stages, each comprising several steps that require user input. Suggested configuration defaults are provided in square brackets; if the suggested value is acceptable for a given step, press Enter to accept that value.

Procedure 2.4. Configuring the Red Hat Enterprise Virtualization Manager

  1. Packages

    The engine-setup command checks to see if it is performing an upgrade or an installation, and whether any updates are available for the packages linked to the Manager. No user input is required at this stage. 
    [ INFO  ] Checking for product updates...
[ INFO  ] No product updates found

  2. Network Configuration

    A reverse lookup is performed on the host name of the machine on which the Red Hat Enterprise Virtualization Manager is being installed. The host name is detected automatically, but you can correct this host name if it is incorrect or if you are using virtual hosts. There must be forward and reverse lookup records for the provided host name in DNS, especially if you will also install the reports server. 
    Host fully qualified DNS name of this server [autodetected host name]:
    The engine-setup command checks your firewall configuration and offers to modify that configuration for you to open the ports used by the Manager for external communication such as TCP ports 80 and 443. If you do not allow the engine-setup command to modify your firewall configuration, then you must manually open the ports used by the Red Hat Enterprise Virtualization Manager. 
    Do you want Setup to configure the firewall? (Yes, No) [Yes]:

  3. Database Configuration

    You can use either a local or remote PostgreSQL database. The engine-setup command can configure your database automatically (including adding a user and a database), or it can use values that you supply. 
    Where is the database located? (Local, Remote) [Local]: 
Setup can configure the local postgresql server automatically for the engine to run. This may conflict with existing applications.
Would you like Setup to automatically configure postgresql and create Engine database, or prefer to perform that manually? (Automatic, Manual) [Automatic]:

  4. oVirt Engine Configuration

    Select Gluster, Virt, or Both: 
    Application mode (Both, Virt, Gluster) [Both]:
    Both offers the greatest flexibility.
    Set a password for the automatically created administrative user of the Red Hat Enterprise Virtualization Manager: 
    Engine admin password:
Confirm engine admin password:

  5. PKI Configuration

    The Manager uses certificates to communicate securely with its hosts. You provide the organization name for the certificate. This certificate can also optionally be used to secure https communications with the Manager. 
    Organization name for certificate [autodetected domain-based name]:

  6. Apache Configuration

    By default, external SSL (HTTPS) communication with the Manager is secured with the self-signed certificate created in the PKI configuration stage to securely communicate with hosts. Another certificate may be chosen for external HTTPS connections, without affecting how the Manager communicates with hosts. 
    Setup can configure apache to use SSL using a certificate issued from the internal CA.
Do you wish Setup to configure that, or prefer to perform that manually? (Automatic, Manual) [Automatic]:
    The Red Hat Enterprise Virtualization Manager uses the Apache web server to present a landing page to users. The engine-setup command can make the landing page of the Manager the default page presented by Apache. 
    Setup can configure the default page of the web server to present the application home page. This may conflict with existing applications.
Do you wish to set the application as the default web page of the server? (Yes, No) [Yes]:

  7. System Configuration

    The engine-setup command can create an NFS share on the Manager to use as an ISO storage domain. Hosting the ISO domain locally to the Manager simplifies keeping some elements of your environment up to date. 
    Configure an NFS share on this server to be used as an ISO Domain? (Yes, No) [Yes]: 
Local ISO domain path [/var/lib/exports/iso]: 
Local ISO domain ACL [0.0.0.0/0.0.0.0(rw)]: 
Local ISO domain name [ISO_DOMAIN]:

  8. Websocket Proxy Server Configuration

    The engine-setup command can optionally configure a websocket proxy server for allowing users to connect to virtual machines via the noVNC or HTML 5 consoles. 
    Configure WebSocket Proxy on this machine? (Yes, No) [Yes]:

  9. Miscellaneous Configuration

    You can use the engine-setup command to allow a proxy server to broker transactions from the Red Hat Access plug-in. 
    Would you like transactions from the Red Hat Access Plugin sent from the RHEV Manager to be brokered through a proxy server? (Yes, No) [No]:
    [ INFO  ] Stage: Setup validation

  10. Configuration Preview

    Check the configuration preview to confirm the values you entered before they are applied. If you choose to proceed, engine-setup configures the Red Hat Enterprise Virtualization Manager using those values. 
    Engine database name                    : engine
Engine database secured connection      : False
Engine database host                    : localhost
Engine database user name               : engine
Engine database host name validation    : False
Engine database port                    : 5432
NFS setup                               : True
PKI organization                        : Your Org
Application mode                        : both
Firewall manager                        : iptables
Update Firewall                         : True
Configure WebSocket Proxy               : True
Host FQDN                               : Your Manager's FQDN
NFS export ACL                          : 0.0.0.0/0.0.0.0(rw)
NFS mount point                         : /var/lib/exports/iso
Datacenter storage type                 : nfs
Configure local Engine database         : True
Set application as default page         : True
Configure Apache SSL                    : True
         
Please confirm installation settings (OK, Cancel) [OK]:
    When your environment has been configured, the engine-setup command displays details about how to access your environment and related security details.

  11. Clean Up and Termination

    The engine-setup command cleans up any temporary files created during the configuration process, and outputs the location of the log file for the Red Hat Enterprise Virtualization Manager configuration process. 
    [ INFO  ] Stage: Clean up
          Log file is located at /var/log/ovirt-engine/setup/ovirt-engine-setup-installation-date.log
[ INFO  ] Stage: Pre-termination
[ INFO  ] Stage: Termination
[ INFO  ] Execution of setup completed successfully
Result

The Red Hat Enterprise Virtualization Manager has been configured and is running on your server. You can log in to the Administration Portal as the admin@internal user to continue configuring the Manager. Furthermore, the engine-setup command saves your answers to a file that can be used to reconfigure the Manager using the same values.

Report a bug