Difference between revisions of "Hemera:Install"

From HemeraBook
Jump to: navigation, search
(Hemera user)
(Foreword)
Line 1: Line 1:
 
=Foreword=
 
=Foreword=
 
If ever you have problem while installing Hemera or third-party tools, check the [[Troubleshooting]] page.<br />
 
If ever you have problem while installing Hemera or third-party tools, check the [[Troubleshooting]] page.<br />
If you don't find solution, post a request on the [https://sourceforge.net/projects/hemerais/forums/forum/1202771 Help Forum].
+
If you don't find solution, post a request on the [https://sourceforge.net/projects/hemerais/forums/forum/1202771 Help Forum].<br />
 +
<br />
 +
This page gives information to install Hemera from scratch, if you already have an Hemera version, you should consider [[Upgrade_Hemera |upgrading it]].
  
 
<br />
 
<br />
 +
 
=Prepare a Workspace=
 
=Prepare a Workspace=
 
You should begin preparing a workspace with enough space.<br />
 
You should begin preparing a workspace with enough space.<br />

Revision as of 13:49, 16 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.
Hemera is compounded of several projects:

  • Hemera: the main project, let's call it's directory [HEMERA_ROOT_PATH]
  • 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 the directory of your choice

Among other things, it will create the Hemera main project directory; called [HEMERA_ROOT_PATH] on all these pages.


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.