[[PageOutline]]

= Build DeepaMehta From Source =

== Requirements ==

* **Java 6 or newer** (both, Oracle Java and OpenJDK work).

Installing the JDK for Java 7 in Ubuntu (OpenJDK):

{{{
sudo apt-get install openjdk-7-jdk

}}}

* **Git 1.7** (other Git versions work as well).

* **Maven 3** (Maven 2 does ''not'' work).

Installing maven in Ubuntu

{{{
sudo apt-get install mvn

}}}

== Build ==

{{{
git clone git://github.com/jri/deepamehta.git
cd deepamehta
mvn install -P all
}}}

== Run ==

{{{
mvn pax:run
}}}
This starts the DeepaMehta server and then opens the DeepaMehta web client in a browser window.\\
If no browser window appears open it manually:

http://localhost:8080/de.deepamehta.webclient/

Your terminal is now occupied by the interactive ''Apache Felix Gogo Shell'' (press return and you'll see its `g!` prompt).

== Stop ==

In the Gogo shell type:
{{{
stop 0
}}}
This shuts down the web server and puts the database in a consistent state.

== Run again ==

{{{
cd deepamehta
mvn pax:run
}}}

== Update ==

{{{
cd deepamehta
git pull
mvn clean install -P all
}}}
This can be performed on a running DeepaMehta instance (from another terminal). The new code is hot-deployed. Of course you can stop the instance before updating as well.