Difference between revisions of "Hemera:Install"

From HemeraBook
Jump to: navigation, search
(Hemera user)
Line 12: Line 12:
  
 
<br />
 
<br />
 
 
==Hemera developer/contributor==
 
==Hemera developer/contributor==
 
* [[Install Hemera - Developer | Prepare environment to work on Hemera]]
 
* [[Install Hemera - Developer | Prepare environment to work on Hemera]]
 
<br />
 
=Get the source code=
 
==Command line==
 
cd '''''[HEMERA_ROOT_PATH]'''''<br/>
 
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.<br />
 
Checkout following projects, from trunk or wanted branch: ''Hemera''
 
  
 
<br />
 
<br />
Line 32: Line 21:
 
'''[HEMERA_ROOT_PATH]/scripts/setupHemera.sh'''
 
'''[HEMERA_ROOT_PATH]/scripts/setupHemera.sh'''
  
 +
<br />
 
==Configure==
 
==Configure==
 
To help configuring the whole of Hemera, a global configuration file system has been created.<br />
 
To help configuring the whole of Hemera, a global configuration file system has been created.<br />
Line 37: Line 27:
 
Copy [HEMERA_ROOT_PATH]/config/hemera.conf.sample to '''[HEMERA_ROOT_PATH]/config/hemera.conf''' and adapt it to your configuration.<br />
 
Copy [HEMERA_ROOT_PATH]/config/hemera.conf.sample to '''[HEMERA_ROOT_PATH]/config/hemera.conf''' and adapt it to your configuration.<br />
 
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).
 
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:
 
* [http://www.oracle.com/technetwork/java/index.html Java Development Kit] (jdk6 or newer)
 
* [http://ant.apache.org 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
 
<br />
 
For instance (with Eclipse ${workspace_loc} variable):
 
-Djava.system.class.loader=hemera.HemeraClassLoader -Dhemera.property.file=${workspace_loc}/hemera/config/hemera.conf
 
<br />
 
You may use the additional properties:<br />
 
* '''hemera.log.file''' to define a log file (messages will be appended to the file if it already exists)
 
<br />
 
For instance:
 
-Dhemera.log.file="/path/to/logFile"
 
  
 
<br />
 
<br />

Revision as of 16:32, 30 April 2011

Prepare a Workspace

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


Get Hemera

Hemera user

You can download Hemera binaries from the SourceForge project site:

  • enter the directory of the version you want
  • download the Hemera-vX.Y.tgz tarball (X.Y corresponding to the version)
  • uncompress it in [HEMERA_ROOT_PATH]


Hemera developer/contributor


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).


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.