Hemera:Install
Contents
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.