oVirt 3.3 All in One Howto

up-and-running-ovirt33.adoc

Up and Running with oVirt 3.3

The oVirt Project is now putting the finishing touches on version 3.3 of oVirt, the KVM-based virtualization management platform. The release will be feature-packed, including expanded support for Gluster storage, new integration points for OpenStack’s Neutron networking and Glance image services, and a raft of new extensibility and usability upgrades.

oVirt 3.3 also sports an overhauled All-in-One (AIO) setup plugin, which makes it easy to get up and running with oVirt on a single machine to see what oVirt can do for you.

Prerequisites

• Hardware: You’ll need a machine with at least 4GB RAM and processors with hardware virtualization extensions. A physical machine is best, but you can test oVirt effectively using nested KVM as well.

• Software: oVirt 3.3 runs on the 64-bit editions of Fedora 19 or Red Hat Enterprise Linux 6.4 (or on the equivalent version of one of the RHEL-based Linux distributions such as CentOS or Scientific Linux).

• Network: Your test machine’s domain name must resolve properly, either through your network’s DNS, or through the /etc/hosts files of your test machine itself and through those of whatever other nodes or clients you intend to use in your installation.

  On Fedora 19 machines with a static IP address (dhcp configurations appear not to be affected), you must disable NetworkManager for the AIO installer to run properly:

  sudo systemctl stop NetworkManager.service; sudo systemctl mask NetworkManager.service; sudo service network start; sudo chkconfig network on

  Also, check the configuration file for your interface (for instance, /etc/sysconfig/network-scripts/ifcfg-eth0) and remove the trailing zero from "GATEWAY0" as this syntax appears only to work while NetworkManager is enabled. [BZ]

• All parts of oVirt should operate with SELinux in enforcing mode, but SELinux bugs do surface. At the time that I’m writing this, the Glusterization portion of this howto requires that SELinux be put in permissive mode. Also, the All in One install on CentOS needs SELinux to be in permissive mode to complete.

  You can put selinux in permissive mode with the command:

  sudo setenforce 0

  To make the shift to permissive mode persist between reboots, edit "/etc/sysconfig/selinux" and change SELINUX=enforcing to SELINUX=permissive.

Install & Configure oVirt All in One

1. Run one of the following commands to install the oVirt repository on your test machine.

   1. For Fedora 19:

      sudo yum localinstall http://ovirt.org/releases/ovirt-release-fedora.noarch.rpm -y

   2. For RHEL/CentOS 6.4 (also requires EPEL):

      sudo yum localinstall http://resources.ovirt.org/releases/ovirt-release-el6-8-1.noarch.rpm -y
      sudo yum localinstall http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm -y

   3. At the time that I’m writing this, oVirt 3.3 is still pre-release, so you’ll have to edit "/etc/yum.repos.d/ovirt.repo" (or el6-ovirt.repo for RHEL/CentOS) and change "enabled=0" to "enabled=1" in the "[ovirt-beta]" section before running the next command.

2. Next, install the oVirt All-in-One setup plugin:

   sudo yum install ovirt-engine-setup-plugin-allinone -y

3. Run the engine-setup installer. When asked whether to configure VDSM on the host, answer yes. You should be fine accepting the other default values.

   sudo engine-setup

   Once the engine-setup script completes, you’ll have a working management server that doubles as a virtualization host. The script sets up a local storage domain for hosting VM images, and an iso domain for storing iso images for installing operating systems on the VMs you create.

4. Before we leave the command line and fire up the oVirt Administrator Portal, we’re going to create one more storage domain: an export domain, which oVirt uses for ferrying VM images and templates between data centers.

   We can do this by creating the export domain mount point, setting the permissions properly, copying and tweaking the configuration files that engine-setup created for the iso domain, and reloading nfs-server:

   sudo mkdir /var/lib/exports/export
   
   sudo chown 36:36 /var/lib/exports/export

   1. For Fedora:

      sudo cp /etc/exports.d/ovirt-engine-iso-domain.exports /etc/exports.d/ovirt-engine-export-domain.exports

      In ovirt-engine-export-domain.exports Change "iso" to "export"

      sudo vi /etc/exports.d/ovirt-engine-export-domain.exports

      sudo service nfs-server reload

   2. For RHEL/CentOS:

      sudo vi /etc/exports

      In /etc/exports append the line:

      /var/lib/exports/export    0.0.0.0/0.0.0.0(rw)

      sudo service nfs reload

5. Now, fire up your Web browser, visit the address your oVirt engine machine, and click the "Administrator Portal" link. Log in with the user name "admin" and the password you entered during engine-setup.

   Once logged into the Administrator Portal, click the "Storage" tab, select your ISO_DOMAIN, and visit the the "Data Center" tab in the bottom half of the screen. Next, click the "Attach" link, check the check box next to "local_datacenter," and hit "OK." This will attach the storage domain that houses your ISO images to your local datacenter.

   Next, we’ll create and activate our export domain. From the "Storage" tab, click "New Domain," give the export domain a name (I’m using EXPORT_DOMAIN), choose "local_datacenter" in Data Center drop down menu, choose "Export / NFS" from "Domain Function / Storage Type" drop down menu, enter your oVirt machine IP / FQDN :/var/lib/exports/export in the Export Path, and click OK.

6. Before we create a VM, let’s head back to the command line and upload an iso image that we can use to install an OS on the VM we create.

   Download an iso image:

   curl -O http://mirrors.kernel.org/fedora/releases/19/Fedora/x86_64/iso/Fedora-19-x86_64-netinst.iso

   Upload the image into your iso domain:

   engine-iso-uploader upload -i ISO_DOMAIN Fedora-19-x86_64-netinst.iso

7. Now we’re ready to create and run a VM. Head back to the oVirt Administrator Portal, visit the "Virtual Machines" tab, and click "New VM." In the resulting dialog box, give your new instance a name and click "OK."

   In the "New Virtual Machine - Guide Me" dialog that pops up next, click "Configure Virtual Disks," enter a disk size, and click "OK." Hit "Configure Later" to dismiss the Guide Me dialog.

   Next, select your newly-created VM, and click "Run Once." In the dialog box that appears, expand "Boot Options," check the "Attach CD" check box, choose your install iso from the drop down, and hit "OK" to proceed.

   After a few moments, the status of your new vm will switch from red to green, and you can click on the green monitor icon next to "Migrate" to open a console window.

   oVirt defaults to the SPICE protocol for new VMs, which means you’ll need the virt-viewer package installed on your client machine. If a SPICE client isn’t available to you, you can opt for VNC by stopping your VM, clicking "Edit," "Console," "Show Advanced Options," and choosing VNC from the "Protocol" drop down menu.