OVirt

oVirt is a complete open sourced virtualization management platform working with KVM. The project is made of:
 * The Engine core, which is the backend server that does the management.
 * The various VDSM agents installed on each host you 'll use as a hypervisor for VMs
 * A client side UI (GWT based) and/or RESTful API to control the engine core.

Description
This article will try to explain how to install oVirt on Gentoo system, more specifically we'll set up the following:
 * For the engine core
 * The Java runtime environment
 * A JBoss server instance
 * A PostgreSQL server
 * The engine core and UI


 * For the VDSM agents
 * (Work in progress)

Install Java runtime
Ovirt manual is suggesting installing openJDK. My server has sun-jdk already set so I will point you to Gentoo Java guide for setting java environment. Make sure you are setting jdk version 1.6 or 1.7

Install Java application server – JBoss
oVirt runs on JBoss application server, here is a quick guide to set up jboss for our needs. The plan is to have JBoss under /opt, make a jboss user and set the installation dir as the user's home dir (I did this because I wanted to have everything on a single place for portability and because it makes things easier with permissions etc). Then we 'll put ovirt inside this directory and set it up.


 * First go to /opt as root


 * Download latest JBoss version 7


 * Untar the archive


 * Create the jboss user


 * Now set permissions for jboss's home dir


 * Test that JBoss is working by	starting the server as jboss user


 * Now open a browser to your server's hostname (let's assume it's "engine-dev") and check out http://engine-dev:8080 you should see JBoss's welcome screen.

Troubleshooting JBoss
If you're being attacked by exceptions, follow this list: jboss.te
 * Verify jboss folder owner and permissions.
 * For external connections, make sure your firewall allows incoming traffic on 8080 port.
 * If your machine has and selinux policy installed, make sure it will not block JBoss. Here is a very dirty and insecure jboss.te just to temporarily pass these denials (you'll also need selinux-java)

127.0.0.1 localhost engine-dev
 * Used TCP ports: 8080/8443/8083/1090/4457
 * These ports may be used by other applications. Either close other application or change JBoss configuration (/opt/jboss-as-7.1.1.Final/standalone/configuration/standalone.xml)
 * Since JBoss binds to the hostname, your hostname should be resolvable, or you may add it to /etc/hosts for local resolution.


 * Verify you gave JBoss's enough RAM to work with

Installing PostgreSQL
oVirt Engine works with postgresql 9.1.x

If you didn't already, specify default locale for your server (as root):
 * Check /etc/locale.gen, e.g.:


 * Create /etc/env.d/02locale


 * Update environment for current shell (and every new shell you open) or simply reboot

Now lets install PostgreSQL...


 * Emerge Postgresql server. Make sure uuid useflag is enabled!


 * Make sure the jdbc installed is 9.1_XXX (you may need to unmask it).
 * Once emerged, verify the config files in /etc/postgresql-9.1 	and /etc/conf.d directory. Use Gentoo Postgresql Guide as a reference for configuration.
 * Make sure pg_hba.conf file has access rules set to trust
 * Add jboss user to postgres group


 * Run the relevant emerge --config … command.
 * Start the database server

Installing oVirt Engine Core
Now that our needed components are in place it's time to download and build the engine core. Sticking to the plan lets get ovirt engine's source code and place it inside ~jboss/ We 'll do the whole process as user jboss

Install maven

 * Install dev-java/maven-bin. It is no longer a must to build version 2 of maven. Version 3 is supported. As of time of writing, stable version in portage is 2.2.1 so it is safe to just emerge it. Alternatively you may add it to your keywords file:


 * Next:


 * If unsure, emerge strict version:


 * or


 * Set up the needed repositories for Maven. To create default repository directory, run maven as non-privileged user. DO NOT use root user.


 * This command will create .m2 directory in jboss user's HOME directory.
 * Copy paste the content of the file below into user's ~/.m2/settings.xml file. See the [Maven personal settings] on the oVirt wiki.


 * Modify jbossHome and JAVA_1_6_HOME tags as needed. If these parameters are incorrect, compiling and installing using maven will fail!

Prepare build environment
export MAVEN_OPTS="-Xmx2048M -XX:MaxPermSize=2048M" by adding the lines:
 * Increase some maximum values by default. Add the following to ~jboss/.mavenrc:
 * Values for mx and MaxPermSize may be different!
 * Build GWT to work with a specific browser (this is needed in case you don't have that much RAM to compile support for all 6). Modify
 * ~jboss/ovirt-engine/frontend/webadmin/modules/webadmin/src/main/resources/org/ovirt/engine/ui/webadmin/WebAdmin.gwt.xml
 * ~jboss/ovirt-engine/frontend/webadmin/modules/userportal/src/main/java/org/ovirt/engine/ui/userportal/UserPortal.gwt.xml



Building ovirt-engine and REST api

 * As unprivileged user

Compile web-admin and user-portal

 * As unprivileged user

Application deployment
Time to put oVirt Engine Core and its components to JBoss
 * The first deployment of the application to JBoss AS container should use the setup profile:


 * There is a issue with the dep and setup_postgres profiles getting in the way of each other. The setup_postgres profile will prevent the deployment of the quartz jar to the JBoss server. So after this step completes, run:


 * From this point on, since postgres is already set up, every time you deploy you can simply run:

New ROOT container deployment
We need to replace the JBoss's root container (what you see under http://engine-dev:8080/) with oVirt's ROOT.war since it'll hold the Engine Core's certificate and public ssh key, used by oVirt nodes.
 * Copy ROOT.war to the deployments directory


 * Tweak standalone.xml to enable the new server's root


 * And tell JBoss to deploy it next time it runs

Creating the database schema
Finally it's time to create the database schema for Engine Core

Create the oVirt Engine Core's Certificate Authority and keys
Now we need to create the Engine Core's CA certificate that 'll be used to sign the certificate of each Hypervisor and its public ssh key, needed for engine <-> Hypervisor communication. The plan is to put everything under ~/pki (on Fedora /etc/pki is used) and put the needed values on the database.


 * First lets make the needed dirs


 * Now compile pubkey2ssh program needed to create the public ssh key from your CA certificate


 * Create and set up the CA


 * Create and set up the SSH keys


 * Put CA certificate and public SSH key under /

Time to add our new CA to the database, this script will do the trick...
 * Set CA directories on the database

Testing

 * Start JBoss application server


 * Test JBoss by accessing from browser: http://engine-dev:8080/
 * Use username admin@internal and password letmein!	for testing access.
 * Accessing the web-admin: http://engine-dev:8080/webadmin
 * Accessing the user-portal: http://engine-dev:8080/UserPortal
 * Accessing the RESTful API:


 * From the browser: http://engine-dev:8080/api

Install vdsm

 * Install dev-python/pyflakes as it is needed by vdsm


 * Obtain VDSM source RPM


 * Convert rpm package to tgz


 * Unpack the archive


 * Enter the directory and do the configure-make-make install magic (Recommended to use –prefix when compiling from source so you can have all files under one directory per package)

How to contribute

 * oVirt project is working with Gerrit code review for code contribution.
 * In order to register and login to oVirt's Gerrit, you'll need an OpenID account.
 * You can use a Google OpenID, or register to some other provider and use it,
 * All other details can be found here: http://www.ovirt.org/wiki/Working_with_oVirt_Gerrit

Errors & Solutions
Error: When compiling projects, getting errors about unmappable characters. Solution: My install is UTF8, but default locale was not set. So default locale by Maven/JBoss (not sure which one) was US_ASCII. Set default locale and errors are history. Error: Compile process dies with PermGenSpace error. Solution: This error means that no more memory is available to java compiler. This is fixed by setting MAVEN_OPTS with higher values for mx and MaxPermSize parameters. Another trick that helped was choosing only one browser to compile GWT for by modifying above mentioned files. Error: Compile process dies with error code 137. Solution: This one I'm not quite sure about. The only info I could google out was a suggestion to try change the java compiler (oVirt wiki uses openJDK, me sun-jdk). The solution for me was to add -e -DskipTests=true options to maven. Again, I'm not sure how this is relevant as I don't know what error 137 means or how it is caused. Error: Message: JBAS014724: Missing required attribute(s): cache-ref Solution:
 * Theese are the errors and solutions as I was going through the process of installing oVirt. Feel free to add your own :)
 * Errors while deploying the root container

165c158 <                 --- >                 Error: Message: JBAS014788: Unexpected attribute 'show-model' encountered Solution:

222c215 <         --- >        

oVirt Node integration

 * By default development setup works with hosts based on base distro's installations.
 * In order to be able to work with oVirt Node (which is a sub-set of the base OS), you'll need to setup a Public Key environment.
 * More details on Engine and oVirt Node integration can be found here: http://www.ovirt.org/wiki/Engine_Node_Integration.
 * Note that by default Gentoo does not have /etc/pki folder, and you'll need to create it (or write an eBuild which will do that).

External resources

 * Additional information (including presentations)
 * Users list: users@ovirt.org