Revision as of 13:18, 24 April 2011

Prepare a Workspace

You should begin preparing a workspace with enough space.
Let's call it [HEMERA_ROOT_PATH].

Get the source code

Command line

cd [HEMERA_ROOT_PATH]

svn co https://hemerais.svn.sourceforge.net/svnroot/hemerais/trunk/Hemera Hemera

Under Eclipse (or other IDE)

Add https://hemerais.svn.sourceforge.net/svnroot/hemerais as a new repository URL.
Checkout following projects, from trunk or wanted branch: hemera

Setup

Update Operating System

To setup Hemera (e.g. improving accessibility of Hemera binaries/scripts), launch as root superuser:
[HEMERA_ROOT_PATH]/scripts/setupHemera.sh

Configure

To help configuring the whole of Hemera, a global configuration file system has been created.

Copy [HEMERA_ROOT_PATH]/config/hemera.conf.sample to [HEMERA_ROOT_PATH]/config/hemera.conf and adapt it to your configuration.
For each tool, you can either update the corresponding configuration element (specifying an absolute path, or a path relative to [HEMERA_ROOT_PATH]) or ensure it is available from the PATH environment variable (specifying only the file name of the tool).

Environment

Hemera java pieces require:

• Java Development Kit (jdk6 or newer)
• Apache Ant

-> after installation, you should either update your environment variables JAVA_HOME and ANT_HOME,
   or update environment.java.home and environment.ant.home in your Hemera configuration file.

Java properties

If you want launching Hemera java piece (like the Java sound player) in an IDE (e.g. Eclipse), you should specify the following properties:

• java.system.class.loader to define the Hemera specific classloader which loads the properties file automatically
• hemera.property.file to define the Hemera properties file

For instance (with Eclipse ${workspace_loc} variable):

-Djava.system.class.loader=hemera.HemeraClassLoader -Dhemera.property.file=${workspace_loc}/hemera/config/hemera.conf

You may use the additional properties:

• hemera.log.file to define a log file (messages will be appended to the file if it already exists)

For instance:

-Dhemera.log.file="/path/to/logFile"

Third-Party tools availability

See Install third-party tools.
Each third-party tool binary path, and data file path are checked when using corresponding core module.
A specific error message will be given in case of failure.