Installing the Engine

To install Oracle Linux Virtualization Manager, you perform a fresh installation of Oracle Linux 7 Update 7 on the host, install the ovirt-engine package, and then run the engine-setup command to configure the Manager.

Note

You can install the Manager in a virtual machine as long as it is not managing that virtual machine, or in a self-hosted engine configuration. For more information, see Self-Hosted Engine Deployment.

You can download the installation ISO for the latest Oracle Linux 7 Update 7 from the Oracle Software Delivery Cloud at https://edelivery.oracle.com.

  1. Install Oracle Linux 7 Update 7 on the host using the Minimal Install base environment.

    Follow the instructions in the Oracle® Linux 7: Installation Guide.

    Important

    Do not install any additional packages until after you have installed the Manager packages, because they may cause dependency issues.

  2. (Optional) If you use a proxy server for Internet access, configure Yum with the proxy server settings. For more information, see Configuring Use of a Proxy Server in Oracle® Linux 7: Managing Software.

  3. Subscribe the system to the required channels OR install the Release 4.3.6 package and enable the required repositories.

    • For ULN registered hosts only: If the host is registered on ULN, subscribe the system to the required channels.

      1. Log in to https://linux.oracle.com with your ULN user name and password.

      2. On the Systems tab, click the link named for the host in the list of registered machines.

      3. On the System Details page, click Manage Subscriptions.

      4. On the System Summary page, select each required channel from the list of available channels and click the right arrow to move the channel to the list of subscribed channels. Subscribe the system to the following channels:

        • ol7_x86_64_latest

        • ol7_x86_64_optional_latest

        • ol7_x86_64_kvm_utils

        • ol7_x86_64_ovirt43

        • ol7_x86_64_ovirt43_extras

        • ol7_x86_64_gluster6

        • (For VDSM) ol7_x86_64_UEKR5

      5. Click Save Subscriptions.

    • For Oracle Linux yum server hosts only: Install the Oracle Linux Virtualization Manager Release 4.3.6 package and enable the required repositories.

      1. (Optional) Make sure the host is using the modular yum repository configuration. For more information, see Getting Started with Oracle Linux Yum Server.

      2. Enable the ol7_latest yum repository.

        # yum-config-manager --enable ol7_latest
        Important

        Before you execute yum-config-manager ensure the yum-utils package is installed on your system. For more information, see Using Yum Utilities to Manage Configuration in the Oracle® Linux 7: Administrator's Guide

      3. Install the Oracle Linux Virtualization Manager Release 4.3.6 package.

        # yum install oracle-ovirt-release-el7
      4. Use the yum command to verify that the required repositories are enabled.

        1. Clear the yum cache.

          # yum clean all
        2. List the configured repositories and verify that the required repositories are enabled.

          # yum repolist

          The following repositories must be enabled:

          • ol7_latest

          • ol7_optional_latest

          • ol7_kvm-utils

          • ol7_gluster6

          • ol7_UEKR5

          • ovirt-4.3

          • ovirt-4.3-extra

        3. If a required repository is not enabled, use the yum-config-manager to enable it.

          # yum-config-manager --enable repository
  4. Unsubscribe to the 4.2 channels OR disable the 4.2 repositories.

    • For ULN registered hosts only: If the host is registered on ULN, unsubscribe to the following channels.

      • ol7_x86_64_ovirt42

      • ol7_x86_64_ovirt42_extras

    • For Oracle Linux yum server hosts only: Run the following commands.

      # yum-config-manager --disable ovirt-4.2
      # yum-config-manager --disable ovirt-4.2-extra
  5. Install the Manager using the ovirt-engine command.

    # yum install ovirt-engine

    Proceed to Configuring the Engine.

Configuring the Engine

After you install the Oracle Linux Virtualization Manager, you run the engine-setup command (the Setup program) to configure Manager. You are prompted to answer a series of questions whose values are used to configure Manager. Some of these questions relate to features that are in technology preview; Oracle recommends that you accept the default values for these features. For more information, see Technology Preview in the Oracle Linux Virtualization Manager: Release Notes Guide.

The Manager uses two PostgreSQL databases: one for the engine and one for the data warehouse. By default, Setup creates and configures the engine database locally on the engine host. Alternatively, you can configure the engine host to use a manually-configured local or remote database. If you choose to use a manually-configured local or remote database, you must set it up before running engine-setup. Currently, running the engine or data warehouse database on a remote host is a technology preview feature.

To configure the Manager:

  1. Run the engine-setup command on the host where you installed the Manager.

    Note

    Run engine-setup --accept-defaults to automatically accept all questions that have default answers.

    The Setup program prompts you to configure the Manager.

  2. Enter Yes to configure the Manager

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

    If you enter No, the configuration stops. To restart, rerun the engine-setup command.

  3. For the remaining configuration questions, provide input or accept default values, which are in square brackets after each question. To accept the default value for a given question, press Enter.

    Note

    Setup asks you for the fully qualified DNS name (FQDN) of the Manager host. Although Setup tries to automatically detect the name, you must ensure the FQDN is correct.

    For detailed information on the configuration options, see Engine Configuration Options.

  4. Once you have answered all the questions, Setup displays a list of the values you entered. Review the list carefully and then press Enter to configure the Manager.

    Your answers are saved to a file that can be used to reconfigure the Manager using the same values. Setup also displays the location of the log file for the configuration process.

  5. When the configuration is complete, details about how to log in to the Administration Portal are displayed. To verify that the configuration was successful, log into the Administration Portal, as described in Logging in to the Administration Portal.

Engine Configuration Options

The following information describes the options for configuring Oracle Linux Virtualization Manager when you run the engine-setup command.

Note

Some of the configuration option are in technology preview; Oracle recommends that you accept the default values for these features. For more information, see Technology Preview in the Oracle Linux Virtualization Manager: Release Notes Guide.

Image I/O Proxy

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

The Image I/O Proxy (ovirt-imageio-proxy) enables you to upload virtual disks into storage domains.

WebSocket Proxy

Configure WebSocket Proxy on this machine? (Yes, No) [Yes]:

The WebSocket Proxy enables you to connect to virtual machines using the noVNC or HTML 5 consoles.

For security and performance reasons, you can configure the WebSocket Proxy on a remote host.

Data Warehouse

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

The Data Warehouse feature can run on the Manager host or on a remote host. Running Data Warehouse on a remote host reduces the load on the Manager host.

Running the Data Warehouse on a remote host is a technology preview feature.

VM Console Proxy

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

The VM Console Proxy enables you to access virtual machine serial consoles from a command line. To use this feature, serial consoles must be enabled in the virtual machines.

OVN Provider

Configure ovirt-provider-ovn (Yes, No) [Yes]:

Install the Open Virtual Network (OVN) provider on the Manager host and add it as an external network provider. The default cluster is automatically configured to use OVN as its network provider.

OVN is an OVS (Open vSwitch) extension which enables you to configure virtual networks.

Using external providers, including the OVN provider, is a technology preview feature.

Manager DNS Name

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

The fully qualified DNS name of the Manager host. Check that the automatically detected DNS name is correct.

Automatic Firewall Configuration

Setup can automatically configure the firewall on this system.
Note: automatic configuration of the firewall may overwrite current settings.
NOTICE: iptables is deprecated and will be removed in future releases
Do you want Setup to configure the firewall? (Yes, No) [Yes]:

Configure the firewall on the host to open the ports used for external communication between Oracle Linux Virtualization Manager and the components it manages.

If Setup configures the firewall, and no firewall managers are active, you are prompted to select a firewall manager from a list.

If you enter No, you must manually configure the firewall. When the Manager configuration is complete, Setup displays a list of ports that need to be opened, see for details.

Data Warehouse Database

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

The Data Warehouse database (the history database) can run on the Manager host or on a remote host. Running the database on a remote host reduces the load on the Manager host.

Running the database on a remote host is a technology preview feature.

Caution

In this step you configure the name of the database, and the user name and password for connecting to it. Make a note of these details.

Enter Local to connect to a local PostgreSQL server, or Remote to connect to an existing PostgreSQL server running on a remote host.

If you enter Local, you can choose whether to set up a local PostgreSQL server automatically, or to connect to an existing local PostgreSQL server.

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

Enter Automatic to have Setup configure a local database server, or Manual to connect to an existing local database server. If you enter Manual, you are prompted for the details for connecting to the database:

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

If you enter Remote to connect to an existing PostgreSQL server running on a remote host, you are prompted for the details for connecting to the database:

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:

Engine Database

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

The Oracle Linux Virtualization Manager database (the engine database) can run on the Manager host or on a remote host. Running the database on a remote host reduces the load on the Manager host.

Running the database on a remote host is a technology preview feature.

Caution

In this step you configure the name of the database, and the user name and password for connecting to it. Make a note of these details.

Enter Local to connect to a local PostgreSQL server, or Remote to connect to an existing PostgreSQL server running on a remote host.

If you enter Local, you can choose whether to set up a local PostgreSQL server automatically, or to connect to an existing local PostgreSQL server.

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

Enter Automatic to have Setup configure a local database server, or Manual to connect to an existing local database server. If you enter Manual, you are prompted for the details for connecting to the database:

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

If you enter Remote to connect to an existing PostgreSQL server running on a remote host, you are prompted for the details for connecting to the database:

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:

Admin User Password

Engine admin password:
Confirm engine admin password:

Enter a password for the default administrative user (admin@internal). Make a note of the password.

Application Mode

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

The Manager can be configured to manage virtual machines (Virt) or manage Gluster clusters (Gluster) , or Both.

OVN Provider Credentials

Use default credentials (admin@internal) for ovirt-provider-ovn (Yes, No) [Yes]:
oVirt OVN provider user[admin@internal]:
oVirt OVN provider password:

If you installed the OVN provider, configure the credentials for connecting to the OVN (Open vSwitch) databases.

Using external providers, including the OVN provider, is a technology preview feature.

SAN Wipe After Delete

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

Enter Yes to set the default value for the wipe_after_delete flag to true, which wipes the blocks of a virtual disk when it is deleted.

Using the wipe after delete functionality is a technology preview feature.

Web Server Configuration

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

Provide the organization name to use for the automatically generated self-signed SSL certificate used by the Manager 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]:

Enter Yes to make the Oracle Linux Virtualization Manager landing page the default page presented by the web server.

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

Enter Automatic to generate a self-signed SSL certificate for the web server. Only use self-signed certificates for testing purposes.

Enter Manual to provide the location of the SSL certificate and private key to use the web server.

Data Warehouse Sampling Scale

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

Set the Data Warehouse sampling scale, either Basic or Full. This step is skipped the Data Warehouse is not configured to run on the Manager host.

Enter 1 for Basic, which reduces the values of DWH_TABLES_KEEP_HOURLY to 720 and DWH_TABLES_KEEP_DAILY to 0. Enter 2 for Full.

If the Manager and the Data Warehouse run on the same host, Basic is the recommended sample scale because this reduces the load on the Manager host. Full is recommended only if the Data Warehouse runs on a remote host.

The Full sampling scale is a technology preview feature.

Logging in to the Administration Portal

After you run the engine-setup command to configure Oracle Linux Virtualization Manager, you should log into the Administration Portal to verify that the configuration was successful.

Preparing to Log in

It is recommended that you use the latest version one of the following browsers to access the Administration Portal

  • Mozilla Firefox

  • Google Chrome

  • Apple Safari

  • Microsoft Internet Explorer 11

  • Microsoft Edge

If Oracle Linux Virtualization Manager was configured to use a self-signed SSL certificate, or an SSL certificate that is signed by a Certificate Authority (CA) that is not trusted by the browser (for example an Intermediate CA), you should install the CA certificate in the browser. Consult your browser's instructions for how to import a CA certificate. You can download the CA certificate from the Manager at:

http://manager-fqdn/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA

Usually you access the Administration Portal using the fully qualified domain name of the Manager host that you provided during installation. However, you can access the Administration Portal using an alternate host name(s). To do this, you need to add a configuration file to the Manager as follows:

  1. Log in to the Manager host as root.

  2. Create the file /etc/ovirt-engine/engine.conf.d/99-custom-sso-setup.conf with the following content:

    SSO_ALTERNATE_ENGINE_FQDNS="alias1.example.com alias2.example.com"

    The list of alternate host names must be separated by spaces.

  3. Restart Oracle Linux Virtualization Manager.

    # systemctl restart ovirt-engine 

Logging in

You log in to the Administration Portal using a web browser and the default admin@internal user.

  1. Go to https://manager-fqdn/ovirt-engine. The Welcome page displays.

  2. (Optional) Change the preferred language from the drop-down list on the Welcome page.

    You can view the Administration Portal in multiple languages. The default language is based on the locale of your web browser.

  3. Click Administration Portal. The Login page displays.

  4. Enter admin for the Username and the password you specified when you configured the Manager.

  5. From the Profile list, select internal and click Log In.

Next Steps

Now that you have configured and logged into the Manager, the next step is to add Oracle Linux KVM hosts, as described in Configuring a KVM Host.

You also need to add storage and configure logical networks. See Adding Storage and Creating a Logical Network.

Logging Out

To log out of the Administration Portal, click the person icon in the header bar and click Sign Out. You are returned to the Login page.