openHAB Build instructions
==========================

Thanks for your interest in the openHAB project!

Building and running the project is fairly easy if you follow the steps
detailed below.


1. PREREQUISITES
================

The openHAB build infrastructure is based on Maven in order to make it
as easy as possible to get up to speed. If you know Maven already then
there won't be any surprises for you. If you have not worked with Maven
yet, just follow the instructions and everything will miraculously work ;-)

What you need before you start:
- Maven2 from http://maven.apache.org/download.html
- Mercurial from http://mercurial.selenic.com/

Make sure that both "mvn" and "hq" commands are available on your path


2. CHECKOUT
===========

Check out the project sources from Google code:

> hg clone https://openhab.googlecode.com/hg/ openhab 

You will now have all required sources in the openhab subdirectory.


3. BUILDING THE RUNTIME
=======================

To build the runtime from the sources, Maven takes care of everything:
- change into the openhab-runtime directory ("cd openhab-runtime")
- run "mvn clean install" to compile and package all sources


4. PROVISIONING AND STARTING THE RUNTIME
========================================

Now that the bundles are available in your local Maven repository
all that is left is to provision the runtime platform and to start it up:
- run "mvn pax:provision"
- check if everything has started correctly: http://localhost:8080/system/console