Hemera:Install for developer

From HemeraBook
Revision as of 10:05, 27 November 2011 by Projettwk (Talk | contribs) (Updated categories + links to new page name + some improvements)

Jump to: navigation, search

Prepare your Operating System

Hemera is mainly compounded of several projects in Java (including the Web Module), and all script pieces are in GNU/Bash.
To work on Java projects, it is strongly recommanded to use an IDE like Eclipse which has been used for development.
Following instructions give information to setup Eclipse to work on Hemera, but you may adapt them to work on another IDE.


Install development and build tools


* about Tomcat, you can:

  • install a dedicated binary version of Tomcat where you want, and then, after having got Hemera source code, create a symbolic link named HEMERA_TP_PATH/webServices/bin/tomcat, to the Tomcat installation
  • wait before installing Tomcat and configuring Sysdeo Eclipse Tomcat Launcher (but you still need to install it now) until you get source code, and then complete your installation


Prepare to install third-party tools

Some third-party tools needs C/C++ compilation, you should prepare your Operating System to compile source code.


Get the source code

Under Eclipse (or other IDE)

In EGit, add the git repository:

Then, you can easily import projects in your working directory (they all have a .project file): Hemera, ThirdParty, WebModule, Tests

Command line

If you don't want to use an IDE, you can get everything with following commands:

cd HEMERA_ROOT_PATH

For read-only access:

git clone git://hemerais.git.sourceforge.net/gitroot/hemerais/hemerais

For read/write access (you MUST be a project's member, and replace <USERNAME> by your user name):

git clone ssh://<USERNAME>@hemerais.git.sourceforge.net/gitroot/hemerais/hemerais


Hemera application launcher

Java properties

If you launch Hemera Java application directly under IDE, 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"