Revision as of 19:14, 18 May 2011

Foreword

If ever you have problem while installing Hemera or third-party tools, check the Troubleshooting page.
If you don't find solution, post a request on the Help Forum.

This page gives information to install Hemera from scratch, if you already have an Hemera version, you should consider upgrading it.

Prepare a Workspace

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

Hemera is compounded of several projects:

• Hemera: the main project
• HemeraThirdParty: (since v0.2) third-party structure project (where you will install third-party tools)
• HemeraTests: containing various tests scripts
• HemeraWebModule: (since v0.2) the Web Service Module project
• HemeraSamples: some samples (not included in binary version)
• various tools project

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

• Prepare environment to work on Hemera

Setup

Update Operating System

To setup Hemera, you must launch the following script with an user having enough privileges, or using sudo (or root user):

HEMERA_ROOT_PATH/Hemera/scripts/setupHemera.sh

or

sudo HEMERA_ROOT_PATH/Hemera/scripts/setupHemera.sh

Setup will:

• create a sysconfig file defining the installation directory
• create a profile file adding Hemera main script directories to PATH environment variable

Configure

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

since v0.2

Create a configuration file, in your home directory, from the provided sample:

mkdir -p $HOME/.hemera
cp HEMERA_ROOT_PATH/Hemera/config/hemera.conf.sample $HOME/.hemera/hemera.conf

Adapt it to your need; for each tool, you can:

• ensure it is available from the PATH environment variable (specifying only the file name of the tool).
• or update the corresponding configuration element (specifying an absolute path, or a path relative to HEMERA_TP_PATH

v0.1

Copy HEMERA_ROOT_PATH/Hemera/config/hemera.conf.sample to HEMERA_ROOT_PATH/Hemera/config/hemera.conf and adapt it to your configuration.
For each tool, you can:

• ensure it is available from the PATH environment variable (specifying only the file name of the tool).
• or update the corresponding configuration element (specifying an absolute path, or a path relative to HEMERA_ROOT_PATH/Hemera (meaning the thirdParty sub-directory must be specified)

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.