Configuring a KVM Host

To manage an Oracle Linux KVM host using Oracle Linux Virtualization Manager, you must prepare the KVM host by performing a fresh installation of Oracle Linux 7 and enabling the required repositories, and then you add the host to a data center using the Administration Portal.

Preparing a KVM Host

Before you can add a KVM host, you must prepare it by performing a fresh installation of Oracle Linux 7 and enabling the required repositories. You can download the installation ISO for the latest Oracle Linux 7 Update 7 update from the Oracle Software Delivery Cloud at https://edelivery.oracle.com.

  1. Install Oracle Linux 7 Update 7 on the host.

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

    Select Minimal Install as the base environment for the installation.

    Do not install any additional packages until after you have added the host to the Manager, 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 configured KVM hosts only: Install the Oracle Linux Virtualization Manager Release 4.3.6 package and enable the required repositories.

      Note

      Installing the Oracle Linux Virtualization Manager Release 4.3.6 package configures an Oracle Linux KVM host; it does not install the Manager.

      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 Oracle® Linux 7: Managing Software

      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. (Optional) Open the Cockpit port.

    # firewall-cmd --zone=public --add-port=9090/tcp

    The Cockpit web interface can be used to monitor the host’s resources and to perform administrative tasks. You can access the host's Cockpit web interface from the Administration Portal or by connecting directly to the host.

    For more information about configuring firewalld, see Configuring Packet-filtering Firewalls in the Oracle® Linux 7: Security Guide.

  6. (Optional) Complete the previous steps to prepare additional KVM hosts.

The KVM host is now ready to be added to the Manager using the Administration Portal.

Adding a KVM Host

Once you have configured an Oracle Linux KVM host, you use the Administration Portal to add the host to a data center so that it can be used to run virtual machines.

Note

When you install Oracle Linux Virtualization Manager, a data center and cluster named Default is created. You can rename and configure this data center and cluster, or you can add new data centers and clusters, to meet your needs. See the Data Centers and Clusters tasks in the Oracle Linux Virtualization Manager: Administration Guide for details of how to do this.

To add a KVM host:

  1. Log in to the Administration Portal.

    See Logging in to the Administration Portal for details.

  2. Go to Compute and then click Hosts.

  3. On the Hosts pane, click New.

    The New Host dialog box opens with the General tab selected on the sidebar.

  4. From the Host Cluster drop-down list, select the data center and host cluster for the host.

    By default, the Default data center is selected.

  5. In the Name field, enter a name for the host.

  6. In the Hostname field, enter the fully-qualified DNS name for the host.

  7. In the SSH Port field, change the standard SSH port 22 if the SSH server on the host uses a different port.

  8. Under Authentication, select the authentication method to use.

    Oracle recommends that you select SSH PublicKey authentication. If you select this option, copy the key displayed in the SSH PublicKey field to the /root/.ssh/authorized_keys file on the host.

    Otherwise, enter the root user's password to use password authentication.

  9. (Optional) Configure other settings for the host from the other tabs on the New Host sidebar.

    Note

    If you do not want to set any other configuration options now, you can always make changes later by selecting a host from the Hosts pane and clicking Edit.

  10. Click OK to add the host to the data center.

    The host is added to the list of hosts in the Manager. While the Manager is installing the host agent (VDSM) and other required packages on the host, the status of the host is shown as Installing. You can view the progress of the installation in the details pane. When the host is added to the Manager, the host status changes to Up.

  11. (Optional) Complete the previous steps to add more KVM hosts to the Manager.

Now that you have your engine and host(s) configured, you can complete other configuration and administrative tasks. See Quick Start for information on configuring your environment with storage, networks, virtual machines and learn how to create templates and back up your environment. See the Oracle Linux Virtualization Manager: Administration Guide for more detailed configuration and administrative tasks.