Difference between revisions of "Hemera:Install"

From HemeraBook
Jump to: navigation, search
(Configure)
(Configure)
Line 49: Line 49:
  
 
==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 [[Appendix#Configuration_file |configuration file]] system has been created.<br />
<br />
+
For paths, you should read [[Appendix#Binary_and_Library_paths_configuration | Binary and Library paths configuration]] first.<br />
 +
 
 
===since v0.2===
 
===since v0.2===
 
Create a configuration file, in your home directory, from the provided sample:
 
Create a configuration file, in your home directory, from the provided sample:
 
  mkdir -p $HOME/.hemera
 
  mkdir -p $HOME/.hemera
 
  cp [[Appendix#HEMERA_ROOT_PATH |HEMERA_ROOT_PATH]]/Hemera/config/hemera.conf.sample $HOME/.hemera/hemera.conf
 
  cp [[Appendix#HEMERA_ROOT_PATH |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 [[Appendix#Configuration_file |configuration element]] (specifying an absolute path, or a path relative to [[Appendix#HEMERA_TP_PATH |HEMERA_TP_PATH]]
 
<br />
 
  
 
===v0.1===
 
===v0.1===
 
Copy [[Appendix#HEMERA_ROOT_PATH |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 [[Appendix#HEMERA_ROOT_PATH |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 />
For each tool, you can:
+
'''IMPORTANT''': in this version, relative path are prefixed by [[Appendix#HEMERA_ROOT_PATH |HEMERA_ROOT_PATH]]/Hemera (meaning the ''thirdParty'' sub-directory must be specified)
* ensure it is available from the PATH environment variable (specifying only the file name of the tool).
+
* or update the corresponding [[Appendix#Configuration_file |configuration element]] (specifying an absolute path, or a path relative to [[Appendix#HEMERA_ROOT_PATH |HEMERA_ROOT_PATH]]/Hemera (meaning the ''thirdParty'' sub-directory must be specified)
+
 
<br />
 
<br />
  

Revision as of 10:17, 19 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, 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.
For paths, you should read Binary and Library paths configuration first.

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

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.
IMPORTANT: in this version, relative path are prefixed by 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.