Bundled Installation Instructions

This document describes how to set up the bundled oVirt appliance. If you want to manage physical hosts with oVirt, these are the instructions you should use. If you just want to develop on the web front-end, or just see what oVirt can do, it is recommended that you follow the developer instructions here. The developer instructions are slightly simpler and require less hardware, and will get you up and running faster.

Throughout this document, we give commands to type at a shell prompt. By convention, if a command is meant to be run by a non-privileged user, we will precede it with a $ prompt. If a command is meant to be run by the root user, we will precede it with a #.

Prerequisites

There are a number of prerequisites for the bundled install:

A machine that supports hardware virtualization and has at least two network interfaces. This machine will be referred to as the "management host" throughout the rest of this document. It will run the management console as a KVM guest, and will take over the second network card (eth1) for a private oVirt network.
One or more additional machines that support hardware virtualization. These machines will be the physical machines where VMs are run, and will be referred to as the "managed nodes" throughout the rest of the document. These machines should be physically cabled to the same network as the second network interface on the management host.
Fedora 9 installed on the host machine with latest updates, kvm, libvirt, virt-manager and virt-viewer.
The Fedora 9 installation tree or boot ISO

Installation

Using the pre-built appliance image
Please follow the instructions at Download page
Using GIT source repository
This procedure, recommended for developers modifying oVirt, uses pungi to create a local repository of required Fedora RPMs (<1GB) making subsequent rebuilds faster.
In your oVirt source repository clone
```
# ./build-all.sh -ac -b 
```
and proceed to step 3 below.
Using Fedora installation tree or boot ISO
1. Download create-wui-appliance.sh script onto the host machine.
2. Run this script as root; you can use pre-built appliance image or build the appliance from scratch if you point it at the location of your Fedora installation tree or boot ISO
  - Using Fedora installation tree (without boot ISO) NOTE replace download.fedora.redhat.com URL with your local mirror
```
# bash wui-appliance-create-wui-appliance.sh \
-t http://download.fedora.redhat.com/pub/fedora/linux/releases/9/Fedora/i386/os/ \
-k http://ovirt.org/download/wui-rel-i386.ks -b
```
    or
```
# bash wui-appliance-create-wui-appliance.sh \
-t http://download.fedora.redhat.com/pub/fedora/linux/releases/9/Fedora/x86_64/os/ \
-k http://ovirt.org/download/wui-rel-x86_64.ks -b
```
  - Using Fedora boot ISO
```
# bash wui-appliance-create-wui-appliance.sh -i /tmp/boot.iso -b
```
    virt-viewer screen pops up and when you see the boot screen, make sure to hit <Tab>, and then append ks=http://ovirt.org/download/wui-rel-x86_64.ks ksdevice=eth0 (for x86_64) or ks=http://ovirt.org/download/wui-rel-i386.ks ksdevice=eth0 (for i386) to the boot line.
3. After installation has finished, the guest should be rebooted to perform first-run setup. At the end of the boot process, you will see a message saying "Starting ovirt-dev-wui-first-run:". This command will take a while to finish, and is completely normal.
4. At this point, your appliance should be ready. Now, you can bring up the main oVirt screen by running firefox on the guest (here you'll need the root password, which is ovirt):
```
# ssh -fY root@192.168.50.2 firefox -no-remote
```
  To connect to the console of a virtual machine running on a managed node use:
```
# ssh -fY root@192.168.50.2 virt-viewer -c qemu+tcp://node3.priv.ovirt.org/system VM_NAME
```