9.2. Installing Red Hat Enterprise Virtualization Manager

⁠9.2. Installing Red Hat Enterprise Virtualization Manager

Figure 9.1. Install Red Hat Enterprise Virtualization Manager

The Red Hat Enterprise Virtualization 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.

⁠

Procedure 9.1. To install Red Hat Enterprise Virtualization Manager

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.
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 user name 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.
Subscribe the server to the required Red Hat Network channels. See the Red Hat Enterprise Virtualization Manager Release Notes for a list of required channels.
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.
When the packages have finished downloading, run the installer:
```
# engine-setup
```

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 9.1. Red Hat Enterprise Virtualization Manager installation

[ INFO  ] Stage: Initializing
[ INFO  ] Stage: Environment setup
          Configuration files: ['/etc/ovirt-engine-setup.conf.d/10-packaging.conf']
          Log file: /var/log/ovirt-engine/setup/ovirt-engine-setup-20131219122349.log
          Version: otopi-1.1.2 (otopi-1.1.2-1.el6ev)
[ INFO  ] Stage: Environment packages setup
[ INFO  ] Stage: Programs detection
[ INFO  ] Stage: Environment setup
[ INFO  ] Stage: Environment customization
         
          --== PACKAGES ==--
         
[ INFO  ] Checking for product updates...
[ INFO  ] No product updates found
         
          --== NETWORK CONFIGURATION ==--
          Host fully qualified DNS name of this server [localhost.localdomain]: 
          Setup can automatically configure the firewall on this system.
          Note: automatic configuration of the firewall may overwrite current settings.
          Do you want Setup to configure the firewall? (Yes, No) [Yes]: 
         
          --== DATABASE CONFIGURATION ==--
          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 ==--
          Engine admin password: 
          Confirm engine admin password: 
          Application mode (Both, Virt, Gluster) [Both]:
          Default storage type: (NFS, FC, ISCSI, POSIXFS) [NFS]:          

          --== PKI CONFIGURATION ==--
          Organization name for certificate [localdomain]:          

          --== APACHE CONFIGURATION ==--
          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 page of the web server? (Yes, No) [Yes]:
          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 ==--         
          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-20131219172449]: 
          Local ISO domain name [ISO_DOMAIN]: 
          Configure WebSocket Proxy on this machine? (Yes, No) [Yes]:          

          --== 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]:

Important points to note:

The default ports 80 and 443 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.

You are then presented with a summary of the configurations you have selected.

⁠

Example 9.2. Confirm Manager installation settings

          --== CONFIGURATION PREVIEW ==--
         
          Database name                      : engine
          Database secured connection        : False
          Database host                      : localhost
          Database user name                 : engine
          Database host name validation      : False
          Datbase port                       : 5432
          NFS setup                          : True
          PKI organization                   : localdomain
          Application mode                   : both
          Firewall manager                   : iptables
          Update Firewall                    : True
          Configure WebSocket Proxy          : True
          Host FQDN                          : localhost.localdomain
          NFS mount point                    : /var/lib/exports/iso-20131219172449
          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]:

The installation commences. The following message displays, indicating that the installation was successful.

⁠

Example 9.3. Successful installation

[ INFO  ] Stage: Transaction setup
[ INFO  ] Stopping engine service
[ INFO  ] Stopping websocket-proxy service
[ INFO  ] Stage: Misc configuration
[ INFO  ] Stage: Package installation
[ INFO  ] Stage: Misc configuration
[ INFO  ] Creating PostgreSQL database
[ INFO  ] Configuring PostgreSQL
[ INFO  ] Creating database schema
[ INFO  ] Creating CA
[ INFO  ] Configuring WebSocket Proxy
[ INFO  ] Generating post install configuration file '/etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf'
[ INFO  ] Stage: Transaction commit
[ INFO  ] Stage: Closing up
         
          --== SUMMARY ==--
          An ISO NFS share has been created on this host.
              If IP based access restrictions are required, edit:
              entry /var/lib/exports/iso-20131219172449 in /etc/exports
          SSH fingerprint: fingerprint
          Internal CA A9: certificate
          Web access is enabled at:
              http://localhost.localdomain:80/ovirt-engine
              https://localhost.localdomain:443/ovirt-engine
          Please use the user "admin" and password specified in order to login into oVirt Engine
         
          --== END OF SUMMARY ==--
         
[ INFO  ] Starting engine service
[ INFO  ] Restarting httpd
[ INFO  ] Restarting nfs services
[ INFO  ] Generating answer file '/var/lib/ovirt-engine/setup/answers/20131219122536-setup.conf'
[ INFO  ] Stage: Clean up
          Log file is located at /var/log/ovirt-engine/setup/ovirt-engine-setup-20131219122349.log
[ INFO  ] Stage: Pre-termination
[ INFO  ] Stage: Termination
[ INFO  ] Execution of setup 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 user name 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 Identity Management (IdM), Active Directory, RHDS, and OpenLDAP, and provides a utility called engine-manage-domains for attaching new directories to the system. Use of this tool is covered in the Red Hat Enterprise Virtualization Installation Guide.

Note

The Red Hat Enterprise Virtualization engine (that is, the Manager) can be hosted in a virtual machine controlled by the engine that hosts it. This setup is called a "self-hosted engine". In a self-hosted engine system, the virtual machine on which the Manager resides is defined as highly available. Two packages, ovirt-hosted-engine-setup and ovirt-hosted-engine-ha provide the setup and services necessary to deploy a self-hosted-engine Red Hat Enterprise Virtualization environment. For more on Red Hat Enterprise Virtualization Self-Hosted Engine, see the Red Hat Enterprise Virtualization Installation Guide.

Report a bug