3.5. Configuring Red Hat Enterprise Virtualization Manager

⁠3.5. Configuring Red Hat Enterprise Virtualization Manager

Prerequisites:

Section 3.4, “Installing the Red Hat Enterprise Virtualization Manager Packages”

When installation of the packages is complete, the Red Hat Enterprise Virtualization Manager must be configured. The engine-setup script is provided to assist with this task. This script asks you a series of questions, and configures your environment based on your answers. After the required values have been provided, the updated configuration is applied and the Red Hat Enterprise Virtualization Manager services are started.

The engine-setup script guides you through several distinct configuration stages, each comprising several steps that require user input. At each step, suggested configuration defaults are provided in square brackets. When these default values are acceptable for a given step, you can press the Enter key to accept the default values and proceed to the next step or stage.

⁠

Procedure 3.4. Manager Configuration Overview

Packages Check
The engine-setup script 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
```
Network Configuration
A reverse lookup is performed on your host name, which is automatically detected. You can correct the auto-detected host name if it is incorrect, or if you are using virtual hosts. Your fully-qualified domain name should have both forward and reverse lookup records in DNS, especially if will also install the reports server.
```
Host fully qualified DNS name of this server [autodetected host name]:
```
The engine-setup script checks your firewall configuration, and offers to modify it for you to open the ports used by the Manager for external communications (for example, TCP ports 80 and 443). If you do not allow engine-setup script to modify your iptables configuration, you must manually open the ports used by the Red Hat Enterprise Virtualization Manager (see Red Hat Enterprise Virtualization Manager Firewall Requirements).
```
iptables was detected on your computer. Do you wish Setup to configure it? (yes, no) [yes]:
```

Database Configuration

You can use either a local or remote Postgres database. The engine-setup script can configure your database completely automatically, including adding a user and a database, or 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, or prefer to perform that manually? (Automatic, Manual) [Automatic]:

OVirt Engine Configuration
Set a password for the automatically created administrative user of the Red Hat Enterprise Virtualization Manager: admin@internal.
```
Engine admin password:
Confirm engine admin password:
```
Select Gluster, Virtualization, or Both. Both gives the greatest flexibility.
```
Data center (Both, Virt, Gluster) [Both]:
```
Choose the initial data center storage type. You can have many data centers in your environment, each with a different type of storage. Here, you are choosing the storage type of your first data center.
```
Default storage type: (NFS, FC, ISCSI, POSIXFS) [NFS]:
```
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]:
```
Apache Configuration
The Red Hat Enterprise Virtualization Manager uses the Apache web server to present a landing page to users. The engine-setup script 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]:
```
By default, external ssl (https) communications with the Manager are 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]:
```
System Configuration
The engine-setup script can create an NFS export 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 name [ISO_DOMAIN]:
```
Websocket Proxy Server Configuration
The engine-setup script 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]:
```

End of Configuration

The engine-setup script validates all of your answers, and warns you of any possible problem with them. User input is only required if some of the answers you provided may adversely impact your environment.

          --== END OF CONFIGURATION ==--
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

Preview, and Summary

During the preview phase, the engine-setup scripts shows you the configuration values you have entered, and gives you the opportunity to change your mind. If you choose to proceed, engine-setup configures your Red Hat Enterprise Virtualization Manager installation based on the answers you provided in the configuration stages.

          --== CONFIGURATION PREVIEW ==--
Database name                      : engine
Database secured connection        : False
Database host                      : localhost
Database user name                 : engine
Database host name validation      : False
Database port                      : 5432
NFS setup                          : True
PKI organization                   : Your Org
NFS mount point                    : /var/lib/exports/iso
Application mode                   : both
Firewall manager                   : iptables
Configure WebSocket Proxy          : True
Host FQDN                          : Your Manager's FQDN
Datacenter storage type            : nfs
Configure local database           : True
Set application as default page    : True
Configure Apache SSL               : True
         
Please confirm installation settings (OK, Cancel) [OK]:

When your environment is configured, the engine-setup script provides some details about accessing your environment and it's security details.

A default ISO NFS share has been created on this host.
If IP based access restrictions are required, edit: entry /var/lib/exports/iso in /etc/exports
SSH fingerprint: 87:af:b5:fe:7a:e5:1b:64:83:57:02:07:62:eb:8c:18
Internal CA SHA1 Fingerprint=7B:DF:2A:EE:18:C8:B1:CC:F7:6B:59:42:A3:96:BC:44:32:98:FF:A6
Web access is enabled at:
      http://manager.fqdn:80/ovirt-engine
      https://manager.fqdn:443/ovirt-engine
Please use the user "admin" and password specified in order to login into oVirt Engine

Clean up and Termination

The engine-setup script cleans up unnecessary 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

When the engine-setup script completes successfully, the Red Hat Enterprise Virtualization Manager is configured and running on your server. You can log in as the admin@internal user to continue configuring the Manager, by adding clusters, hosts, and more.

You may want to immediately link your Red Hat Enterprise Virtualization Manager to a directory server, so you can add additional users. Red Hat Enterprise Virtualization supports directory services from RHDS, IdM, and Active Directory. Add a directory server to your environment using the engine-manage-domains command.

The engine-setup script also saves the answers you gave during configuration to a file, to help with disaster recovery.

See Also:

Report a bug