Difference between revisions of "Hemera:Install"

From HemeraBook
Jump to: navigation, search
Line 9: Line 9:
 
=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 />
Let's call it '''''[HEMERA_ROOT_PATH]'''''.<br />
+
Let's call it [ [[Appendix#HEMERA_ROOT_PATH |HEMERA_ROOT_PATH]] ].<br />
  
 
Hemera is compounded of several projects:<br />
 
Hemera is compounded of several projects:<br />
Line 26: Line 26:
 
* enter the directory of the version you want
 
* enter the directory of the version you want
 
* download the Hemera-vX.Y.tgz tarball (X.Y corresponding to the version)
 
* download the Hemera-vX.Y.tgz tarball (X.Y corresponding to the version)
* uncompress it in '''''[HEMERA_ROOT_PATH]'''''
+
* uncompress it in [ [[Appendix#HEMERA_ROOT_PATH |HEMERA_ROOT_PATH]] ]
  
 
<br />
 
<br />
Line 37: Line 37:
 
==Update Operating System==
 
==Update Operating System==
 
To setup Hemera (e.g. improving accessibility of Hemera binaries/scripts), launch as root superuser:<br />
 
To setup Hemera (e.g. improving accessibility of Hemera binaries/scripts), launch as root superuser:<br />
'''[HEMERA_ROOT_PATH]/Hemera/scripts/setupHemera.sh'''
+
'''[ [[Appendix#HEMERA_ROOT_PATH |HEMERA_ROOT_PATH]] ]/Hemera/scripts/setupHemera.sh'''
  
 
<br />
 
<br />
Line 43: Line 43:
 
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 />
 
<br />
 
<br />
===v0.2 and newer===
+
Copy [HEMERA_ROOT_PATH]/Hemera/config/hemera.conf.sample to '''[ [[Appendix#HEMERA_ROOT_PATH |HEMERA_ROOT_PATH]] ]/Hemera/config/hemera.conf''' and adapt it to your configuration.<br />
Copy [HEMERA_ROOT_PATH]/Hemera/config/hemera.conf.sample to '''[HEMERA_ROOT_PATH]/Hemera/config/hemera.conf''' and adapt it to your configuration.<br />
+
 
For each tool, you can:
 
For each tool, you can:
 
* ensure it is available from the PATH environment variable (specifying only the file name of the tool).
 
* 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]/HemeraThirdParty)
+
* or update the corresponding configuration element (specifying an absolute path, or a path relative to [ [[Appendix#HEMERA_TP_PATH |HEMERA_TP_PATH]] ])
<br />
+
 
+
===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.<br />
+
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)
+
 
<br />
 
<br />
  

Revision as of 16:48, 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.
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


Setup

Update Operating System

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


Configure

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

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_TP_PATH ])


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.