1. Register your system with the Content Delivery Network, entering your Customer Portal user name and password when prompted:

   # subscription-manager register

2. Find the Red Hat Enterprise Linux Server and Red Hat Virtualization subscription pools and note down the pool IDs.

   # subscription-manager list --available

3. Use the pool IDs located in the previous step to attach the entitlements to the system:

   # subscription-manager attach --pool=pool_id

   Note

   To find out what subscriptions are currently attached, run:

   # subscription-manager list --consumed

   To list all enabled repositories, run:

   # yum repolist

4. Disable all existing repositories:

   # subscription-manager repos --disable=*

5. Enable the required repositories:

   # subscription-manager repos --enable=rhel-7-server-rpms
   # subscription-manager repos --enable=rhel-7-server-supplementary-rpms
   # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms
   # subscription-manager repos --enable=jb-eap-7.0-for-rhel-7-server-rpms
   

Procedure 3.1. Installing the Red Hat Virtualization Manager Packages

1. To ensure all packages are up to date, run the following command on the machine where you are installing the Red Hat Virtualization Manager:

   # yum update

   Note

   Reboot the machine if any kernel related packages have been updated.
2. Run the following command to install the rhevm package and dependencies.

   # yum install rhevm

Procedure 3.2. Configuring the Red Hat Virtualization Manager

1. Run the engine-setup command to begin configuration of the Red Hat Virtualization Manager:

   # engine-setup

2. Press Enter to configure the Manager:

   Configure Engine on this host (Yes, No) [Yes]:

3. Optionally allow engine-setup to configure the Image I/O Proxy to allow the Manager to upload virtual disk images into storage domains. See Uploading a Disk Image to a Storage Domain in the Administration Guide for more information.

   Configure Image I/O Proxy on this host? (Yes, No) [Yes]:

4. Optionally allow engine-setup to 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]:

   To configure the websocket proxy on a separate machine, select No and refer to Appendix F, Installing a Websocket Proxy on a Separate Machine for configuration instructions.
5. Choose whether to configure Data Warehouse on the Manager machine.

   Please note: Data Warehouse is required for the engine. If you choose to not configure it on this host, you have to configure it on a remote host, and then configure the engine on this host so that it can access the database of the remote Data Warehouse host.
   Configure Data Warehouse on this host (Yes, No) [Yes]:

   To configure Data Warehouse on a separate machine, select No and see Installing and Configuring Data Warehouse on a Separate Machine in the Data Warehouse Guide for installation and configuration instructions.
6. Optionally allow access to a virtual machines's serial console from the command line.

   Configure VM Console Proxy on this host (Yes, No) [Yes]:

   Additional configuration is required on the client machine to use this feature. See Opening a Serial Console to a Virtual Machine in the Virtual Machine Management Guide.
7. Press Enter to accept the automatically detected hostname, or enter an alternative hostname and press Enter. Note that the automatically detected hostname may be incorrect if you are using virtual hosts.

   Host fully qualified DNS name of this server [autodetected host name]:

8. The engine-setup command checks your firewall configuration and offers to modify that configuration to open the ports used by the Manager for external communication such as TCP ports 80 and 443. If you do not allow engine-setup to modify your firewall configuration, then you must manually open the ports used by the Manager.

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

   If you choose to automatically configure the firewall, and no firewall managers are active, you are prompted to select your chosen firewall manager from a list of supported options. Type the name of the firewall manager and press Enter. This applies even in cases where only one option is listed.
9. Choose to use either a local or remote PostgreSQL database as the Data Warehouse database:

   Where is the DWH database located? (Local, Remote) [Local]:

   • If you select Local, the engine-setup command can configure your database automatically (including adding a user and a database), or it can connect to a preconfigured local database:

     Setup can configure the local postgresql server automatically for the DWH to run. This may conflict with existing applications.
     Would you like Setup to automatically configure postgresql and create DWH database, or prefer to perform that manually? (Automatic, Manual) [Automatic]:

     1. If you select Automatic by pressing Enter, no further action is required here.
     2. If you select Manual, input the following values for the manually-configured local database:

        DWH database secured connection (Yes, No) [No]:
        DWH database name [ovirt_engine_history]:
        DWH database user [ovirt_engine_history]:
        DWH database password:

        Note

        engine-setup requests these values after the Manager database is configured in the next step.
   • If you select Remote, input the following values for the preconfigured remote database host:

     DWH database host [localhost]:
     DWH database port [5432]:
     DWH database secured connection (Yes, No) [No]:
     DWH database name [ovirt_engine_history]:
     DWH database user [ovirt_engine_history]:
     DWH database password:

     Note

     engine-setup requests these values after the Manager database is configured in the next step.
10. Choose to use either a local or remote PostgreSQL database as the Manager database:

    Where is the Engine database located? (Local, Remote) [Local]:

    • If you select Local, the engine-setup command can configure your database automatically (including adding a user and a database), or it can connect to a preconfigured local database:

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

      1. If you select Automatic by pressing Enter, no further action is required here.
      2. If you select Manual, input the following values for the manually-configured local database:

         Engine database secured connection (Yes, No) [No]:
         Engine database name [engine]:
         Engine database user [engine]:
         Engine database password:

    • If you select Remote, input the following values for the preconfigured remote database host:

      Engine database host [localhost]:
      Engine database port [5432]:
      Engine database secured connection (Yes, No) [No]:
      Engine database name [engine]:
      Engine database user [engine]:
      Engine database password:

11. Set a password for the automatically created administrative user of the Red Hat Virtualization Manager:

    Engine admin password:
    Confirm engine admin password:

12. Select Gluster, Virt, or Both:

    Application mode (Both, Virt, Gluster) [Both]:

    Both offers the greatest flexibility. In most cases, select Both. Virt application mode allows you to run virtual machines in the environment; Gluster application mode only allows you to manage GlusterFS from the Administration Portal.
13. Set the default value for the wipe_after_delete flag, which wipes the blocks of a virtual disk when the disk is deleted.

    Default SAN wipe after delete (Yes, No) [No]:

14. The Manager uses certificates to communicate securely with its hosts. This certificate can also optionally be used to secure HTTPS communications with the Manager. Provide the organization name for the certificate:

    Organization name for certificate [autodetected domain-based name]:

15. Optionally allow engine-setup to make the landing page of the Manager the default page presented by the Apache web server:

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

16. By default, external SSL (HTTPS) communication with the Manager is secured with the self-signed certificate created earlier in the configuration to securely communicate with hosts. Alternatively, choose another certificate for external HTTPS connections; this does not affect 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]:

17. Optionally create an NFS share on the Manager to use as an ISO storage domain. The local ISO domain provides a selection of images that can be used in the initial setup of virtual machines:

    1. Configure an NFS share on this server to be used as an ISO Domain? (Yes, No) [Yes]:

    2. Specify the path for the ISO domain:

       Local ISO domain path [/var/lib/exports/iso]:

    3. Specify the networks or hosts that require access to the ISO domain:

       Local ISO domain ACL: 10.1.2.0/255.255.255.0(rw) host01.example.com(rw) host02.example.com(rw)

       The example above allows access to a single /24 network and two specific hosts. See the exports(5) man page for further formatting options.
    4. Specify a display name for the ISO domain:

       Local ISO domain name [ISO_DOMAIN]:

18. Choose how long Data Warehouse will retain collected data:

    Note

    This step is skipped if you chose not to configure Data Warehouse on the Manager machine.

    Please choose Data Warehouse sampling scale:
    (1) Basic
    (2) Full
    (1, 2)[1]:

    Full uses the default values for the data storage settings listed in the Data Warehouse Guide (recommended when Data Warehouse is installed on a remote host).
    Basic reduces the values of DWH_TABLES_KEEP_HOURLY to 720 and DWH_TABLES_KEEP_DAILY to 0, easing the load on the Manager machine (recommended when the Manager and Data Warehouse are installed on the same machine).
19. Review the installation settings, and press Enter to accept the values and proceed with the installation:

    Please confirm installation settings (OK, Cancel) [OK]:

20. If you intend to link your Red Hat Virtualization environment with a directory server, configure the date and time to synchronize with the system clock used by the directory server to avoid unexpected account expiry issues. See Synchronizing the System Clock with a Remote Server in the Red Hat Enterprise Linux System Administrator's Guide for more information.

1. In a web browser, navigate to https://your-manager-fqdn/ovirt-engine, replacing your-manager-fqdn with the fully qualified domain name that you provided during installation.

   Important

   The first time that you connect to the Administration Portal, you are prompted to trust the certificate being used to secure communications between your browser and the web server. You must accept this certificate. Refer to the instructions to install the certificate authority in Firefox, Internet Explorer, or Google Chrome.
2. Click Administration Portal. An SSO login page displays. SSO login enables you to log in to the Administration and User Portals at the same time.
3. Enter your User Name and Password. If you are logging in for the first time, use the user name admin in conjunction with the password that you specified during installation.
4. Select the domain against which to authenticate from the Domain list. If you are logging in using the internal admin user name, select the internal domain.
5. Click Log In.
6. You can view the Administration Portal in multiple languages. The default selection will be chosen based on the locale settings of your web browser. If you would like to view the Administration Portal in a language other than the default, select your preferred language from the drop-down list on the welcome page.

Procedure 4.1. Removing the Red Hat Virtualization Manager

1. Run the following command on the machine on which the Red Hat Virtualization Manager is installed:

   # engine-cleanup

2. You are prompted whether to remove all Red Hat Virtualization Manager components:
   • Type Yes and press Enter to remove all components:

     Do you want to remove all components? (Yes, No) [Yes]:

   • Type No and press Enter to select the components to remove. You can select whether to retain or remove each component individually:

     Do you want to remove Engine database content? All data will be lost (Yes, No) [No]: 
     Do you want to remove PKI keys? (Yes, No) [No]: 
     Do you want to remove PKI configuration? (Yes, No) [No]: 
     Do you want to remove Apache SSL configuration? (Yes, No) [No]:

3. You are given another opportunity to change your mind and cancel the removal of the Red Hat Virtualization Manager. If you choose to proceed, the ovirt-engine service is stopped, and your environment's configuration is removed in accordance with the options you selected.

   During execution engine service will be stopped (OK, Cancel) [OK]:
   ovirt-engine is about to be removed, data will be lost (OK, Cancel) [Cancel]:OK

4. Remove the Red Hat Virtualization packages:

   # yum remove rhevm* vdsm-bootstrap

1. Install Red Hat Enterprise Linux 7 Server on a system that has access to the Content Delivery Network. This system downloads all the required packages, and distributes them to your offline system(s).

   Important

   Ensure that the system used in this procedure has a large amount of free disk space available. This procedure downloads a large number of packages, and requires up to 50GB of free disk space.
2. Register your system with the Content Delivery Network, entering your Customer Portal user name and password when prompted:

   # subscription-manager register

3. Subscribe the system to all required entitlements:
   1. Find the Red Hat Enterprise Linux Server and Red Hat Virtualization subscription pools and note down the pool IDs.

      # subscription-manager list --available

   2. Use the pool IDs located in the previous step to attach the entitlements to the system:

      # subscription-manager attach --pool=pool_id

   3. Disable all existing repositories:

      # subscription-manager repos --disable=*

   4. Enable the required repositories:

      # subscription-manager repos --enable=rhel-7-server-rpms
      # subscription-manager repos --enable=rhel-7-server-supplementary-rpms
      # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms
      # subscription-manager repos --enable=jb-eap-7.0-for-rhel-7-server-rpms
      

   5. Ensure that all packages currently installed are up to date:

      # yum update

      Note

      Reboot the machine if any kernel related packages have been updated.
4. Servers that are not connected to the Internet can access software repositories on other systems using File Transfer Protocol (FTP). To create the FTP repository, install and configure vsftpd:
   1. Install the vsftpd package:

      # yum install vsftpd

   2. Start the vsftpd service, and ensure the service starts on boot:

      # systemctl start vsftpd.service
      # systemctl enable vsftpd.service

   3. Create a sub-directory inside the /var/ftp/pub/ directory. This is where the downloaded packages will be made available:

      # mkdir /var/ftp/pub/rhevrepo

5. Download packages from all configured software repositories to the rhevrepo directory. This includes repositories for all Content Delivery Network subscription pools the system is subscribed to, and any locally configured repositories:

   # reposync -l -p /var/ftp/pub/rhevrepo

   This command downloads a large number of packages, and takes a long time to complete. The -l option enables yum plug-in support.
6. Install the createrepo package:

   # yum install createrepo

7. Create repository metadata for each of the sub-directories where packages were downloaded under /var/ftp/pub/rhevrepo:

   # for DIR in `find /var/ftp/pub/rhevrepo -maxdepth 1 -mindepth 1 -type d`; do createrepo $DIR; done;

8. Create a repository file, and copy it to the /etc/yum.repos.d/ directory on the offline machine on which you will install the Manager.
   The configuration file can be created manually or with a script. Run the script below on the system hosting the repository, replacing ADDRESS in the baseurl with the IP address or fully qualified domain name of the system hosting the repository:

   #!/bin/sh
   
   REPOFILE="/etc/yum.repos.d/rhev.repo"
   echo -e " " > $REPOFILE
   
   for DIR in `find /var/ftp/pub/rhevrepo -maxdepth 1 -mindepth 1 -type d`;
   do
       echo -e "[`basename $DIR`]"	>> $REPOFILE
       echo -e "name=`basename $DIR`" >> $REPOFILE
       echo -e "baseurl=ftp://ADDRESS/pub/rhevrepo/`basename $DIR`" >> $REPOFILE
       echo -e "enabled=1" >> $REPOFILE
       echo -e "gpgcheck=0" >> $REPOFILE
       echo -e "\n" >> $REPOFILE
   done;
   

9. Install the Manager packages on the offline system. See Section 3.2, “Installing the Red Hat Virtualization Manager Packages” for instructions. Packages are installed from the local repository, instead of from the Content Delivery Network.
10. Configure the Manager. See Section 3.3, “Configuring the Red Hat Virtualization Manager” for initial configuration instructions.
11. Continue with host, storage, and virtual machine configuration.

Procedure 6.1. Installing Red Hat Virtualization Host

1. Download the RHVH ISO image from the Customer Portal:
   1. Log in to the Customer Portal at https://access.redhat.com.
   2. Click Downloads in the menu bar.
   3. Click Red Hat Virtualization, scroll up, and click Download Latest to access the product download page.
   4. Choose the appropriate hypervisor image and click Download Now.
   5. Create a bootable media device. See Making Media in the Red Hat Enterprise Linux Installation Guide for more information.
2. Start the machine on which to install RHVH using the prepared installation media.
3. From the boot menu, select the Install option, and press Enter.

   Note

   You can also press the Tab key to edit the kernel parameters. Kernel parameters must be separated by a space, and you can boot the system using the specified kernel parameters by pressing the Enter key. Press the Esc key to clear any changes to the kernel parameters and return to the boot menu.
4. Select a language, and click Continue.
5. Select a time zone from the Date & Time screen and click Done.
6. Select a keyboard layout from the Keyboard screen and click Done.
7. Select the device on which to install RHVH from the Installation Destination screen. Optionally, enable encryption. Click Done.

   Important

   Red Hat strongly recommends using the Automatically configure partitioning option.

   Note

   For information on preserving local storage domains when reinstalling RHVH, see Upgrading to RHVH While Preserving Local Storage in the Upgrade Guide.
8. Select a network from the Network & Host Name screen and click Configure... to configure the connection details. Enter a host name in the Host name field, and click Done.
9. Optionally configure Language Support, Security Policy, and Kdump. See Installing Using Anaconda in the Red Hat Enterprise Linux 7 Installation Guide for more information on each of the sections in the Installation Summary screen.
10. Click Begin Installation.
11. Set a root password and, optionally, create an additional user while RHVH installs.

    Warning

    Red Hat strongly recommends not creating untrusted users on RHVH, as this can lead to exploitation of local security vulnerabilities.
12. Click Reboot to complete the installation.

    Note

    When RHVH restarts, imgbase-motd.service performs a health check on the host and displays the result when you log in on the command line. The message imgbase status: OK or imgbase status: DEGRADED indicates the health status. Run imgbase check to get more information. The service is enabled by default.
13. Once the installation is complete, log in to the Cockpit user interface at https://HostFQDNorIP:9090 to subscribe the host to the Content Delivery Network. Click Tools > Subscriptions > Register System and enter your Customer Portal username and password. The system automatically subscribes to the Red Hat Virtualization Host entitlement.
14. Click Terminal, and enable the Red Hat Virtualization Host 7 repository to allow later updates to the Red Hat Virtualization Host:

    # subscription-manager repos --enable=rhel-7-server-rhvh-4-rpms

Procedure 7.1. Subscribing to Required Entitlements using Subscription Manager

1. Register your system with the Content Delivery Network, entering your Customer Portal Username and Password when prompted:

   # subscription-manager register

2. Find the Red Hat Enterprise Linux Server and Red Hat Virtualization subscription pools and note down the pool IDs.

   # subscription-manager list --available

3. Use the pool IDs located in the previous step to attach the entitlements to the system:

   # subscription-manager attach --pool=poolid

   Note

   To find out what subscriptions are currently attached, run:

   # subscription-manager list --consumed

   To list all enabled repositories, run:

   # yum repolist

4. Disable all existing repositories:

   # subscription-manager repos --disable=*

5. Enable the required repositories:

   # subscription-manager repos --enable=rhel-7-server-rpms
   # subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms

   If you are installing Red Hat Enterprise Linux 7 hosts, little endian on IBM POWER8 hardware, enable the following repositories instead:

   # subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-for-power-le-rpms # subscription-manager repos --enable=rhel-7-for-power-le-rpms

6. Ensure that all packages currently installed are up to date:

   # yum update

   Note

   Reboot the machine if any kernel related packages have been updated.

Procedure 9.1. Adding FCP Storage

1. Click the Storage resource tab to list all storage domains.
2. Click New Domain to open the New Domain window.
3. Enter the Name of the storage domain.
   

   Figure 9.1. Adding FCP Storage

4. Use the Data Center drop-down menu to select an FCP data center.
   If you do not yet have an appropriate FCP data center, select (none).
5. Use the drop-down menus to select the Domain Function and the Storage Type. The storage domain types that are not compatible with the chosen data center are not available.
6. Select an active host in the Use Host field. If this is not the first data domain in a data center, you must select the data center's SPM host.

   Important

   All communication to the storage domain is through the selected host and not directly from the Red Hat Virtualization Manager. At least one active host must exist in the system and be attached to the chosen data center. All hosts must have access to the storage device before the storage domain can be configured.
7. The New Domain window automatically displays known targets with unused LUNs when Data / Fibre Channel is selected as the storage type. Select the LUN ID check box to select all of the available LUNs.
8. Optionally, you can configure the advanced parameters.
   1. Click Advanced Parameters.
   2. Enter a percentage value into the Warning Low Space Indicator field. If the free space available on the storage domain is below this percentage, warning messages are displayed to the user and logged.
   3. Enter a GB value into the Critical Space Action Blocker field. If the free space available on the storage domain is below this value, error messages are displayed to the user and logged, and any new action that consumes space, even temporarily, will be blocked.
   4. Select the Wipe After Delete check box to enable the wipe after delete option. This option can be edited after the domain is created, but doing so will not change the wipe after delete property of disks that already exist.
9. Click OK to create the storage domain and close the window.