Hemera:Install

From HemeraBook
Revision as of 09:36, 27 November 2011 by Projettwk (Talk | contribs) (moved Install Hemera to Hemera:Install)

Jump to: navigation, search

Foreword

If ever you have problem while installing Hemera, 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.


Information

Multi user

Hemera is usually installed by a System administrator (or advanced user with root access) to be available for any users.
In installation process, a global/common configuration file is created; any user has a specific configuration file (his configuration override global configuration).

However, there is no need special permissions, so any user can install his own Hemera version (e.g. in his home directory), and any needed third-party tools which are not already installed on the Operating System.
If there is no global configuration file, an user can fully configure Hemera in his own configuration file.

UTF-8

For greater interoperability and internationalization, it is recommended that you configure your OS to use UTF-8.
It can be done defining the $LANG environment variable in the good global file which depends on your operating system.
Under RedHat-like GNU/Linux distribution:

/etc/sysconfig/i18n

Under Debian-like GNU/Linux distribution:

/etc/default/locale


Create the file if needed, and add the following line (you can change en_US with the language of your choice, but it is mandatory to use UTF-8):

LANG="en_US.UTF-8"


Get Hemera

System administrators and standard users may prefer release version, available on 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 (called HEMERA_ROOT_PATH in this wiki)

For a global installation, /usr/share/hemera is an usual installation path.
For standard user, ~/hemera is a good installation path.

For developers, contributors and advanced users, you will prefer source code version.

Setup

System administrator must perform a global setup (with -g option); it will automatically:

  • create the global configuration file
  • create the hemera group
  • create the third-party tools directory structure and update group owner and permissions
 HEMERA_ROOT_PATH/Hemera/scripts/setupHemera.sh -g
05/11/11 22:11.29 [setup]         'hemera' group created/updated.
05/11/11 22:11.29 [setup]         Global configuration file '/etc/hemera.conf' created/updated.
05/11/11 22:11.31 [setup]         Third-party tools '/usr/share/hemera/ThirdParty' structure created/updated.
05/11/11 22:11.31 [setup]         Hemera completed successfully.

You can use -T option to specify another third-party tools directory (use -h option to see all options).

After setup, System administrator can add user to hemera group, to give them permissions to update global configuration file or install/update third-party tools installation (for instance for projettwk user):

usermod -aG hemera projettwk


Standard user must perform a setup; it will automatically:

  • create a 'system' file in his home directory to define some global Hemera variables (e.g. installation directory)
  • update/create his $HOME/.bashrc file to add Hemera main script directories to $PATH environment variable


Configure

Global configuration file is automatically created by global setup.
Standard user can create a specific configuration file, in his home directory, to override global configuration:

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


For paths, you should read Binary and Library paths configuration first.

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.

Check Hemera configuration

At anytime to check global configuration, you can launch:

 HEMERA_ROOT_PATH/Hemera/scripts/checkConfig.sh
05/11/11 22:37.28 [check]         Checking 'hemera.path.bin' ... OK
05/11/11 22:37.28 [check]         Checking 'hemera.path.lib' ... OK
05/11/11 22:37.28 [check]         Checking 'hemera.language' ... OK
05/11/11 22:37.28 [check]         Checking internationalization files (BEGIN)
05/11/11 22:37.28 [check]         Checking internationalization files (END)
05/11/11 22:37.28 [check]         Found: java version "1.6.0_20" [OpenJDK Runtime Environment (IcedTea6 1.9.10) (fedora-55.1.9.10.fc14-x86_64)]
05/11/11 22:37.28 [check]         Checking 'environment.ant.home' ... OK
05/11/11 22:37.28 [check]         Found: Apache Ant version 1.7.1 compiled on April 16 2010
05/11/11 22:37.28 [check]         Checking 'hemera.run.activation.tomcat' ... OK
05/11/11 22:37.28 [check]         Found: Apache Tomcat Version 7.0.12
05/11/11 22:37.29 [hemera]        Checking 'hemera.run.mode' ... OK
05/11/11 22:37.29 [hemera]        Checking 'hemera.run.activation.inputMonitor' ... OK
05/11/11 22:37.29 [hemera]        Checking 'hemera.run.activation.ioProcessor' ... OK
05/11/11 22:37.29 [hemera]        Checking 'hemera.run.activation.soundRecorder' ... OK
05/11/11 22:37.29 [hemera]        Checking 'hemera.run.activation.tomcat' ... OK
05/11/11 22:37.29 [inputMonitor]  Checking 'hemera.core.iomanager.inputMonitor.path' ... OK
05/11/11 22:37.29 [inputMonitor]  Checking 'hemera.core.iomanager.inputMonitor.options' ... OK
05/11/11 22:37.29 [IOProcessor]   Checking 'hemera.core.iomanager.ioProcessorMonitor.path' ... OK
05/11/11 22:37.29 [IOProcessor]   Checking 'hemera.core.iomanager.ioProcessorMonitor.options' ... OK
05/11/11 22:37.29 [soundRecorder] Checking 'hemera.core.speechRecognition.soundRecorder.path' ... OK
05/11/11 22:37.29 [soundRecorder] Checking 'hemera.core.speechRecognition.soundRecorder.options' ... OK
05/11/11 22:37.29 [featureFile]   Checking 'hemera.core.speechRecognition.soundFeatureCreator.path' ... OK
05/11/11 22:37.29 [featureFile]   Checking 'hemera.core.speechRecognition.soundFeatureCreator.options' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.mode' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.soundConverter.path' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.soundConverter.options' ... OK
05/11/11 22:37.29 [speechReco]    Checking configuration specific to mode 'sphinx3' ...
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.tool.path' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.tool.options' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.lexicalModel.words' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.lexicalModel.fillers' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.languageModel' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.acousticModel.definition' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.acousticModel.means' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.acousticModel.variances' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.acousticModel.mixtureWeights' ... OK
05/11/11 22:37.29 [speechReco]    Checking 'hemera.core.speechRecognition.sphinx3.acousticModel.transitionMatrices' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.mode' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.espeak.language' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.soundPlayer.path' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.soundPlayer.options' ... OK
05/11/11 22:37.29 [speech]        Checking configuration specific to mode 'espeak+mbrola' ...
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.tool.path' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.tool.options' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.mbrola.path' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.mbrola.options' ... OK
05/11/11 22:37.29 [speech]        Checking 'hemera.core.speech.mbrola.language' ... OK
05/11/11 22:37.30 [manageSound]   Checking 'hemera.core.speech.soundPlayer.path' ... OK
05/11/11 22:37.30 [manageSound]   Checking 'hemera.core.speech.soundPlayer.options' ... OK
05/11/11 22:37.30 [plugin:search] Checking 'hemera.core.command.general.htmlConverter.path' ... OK
05/11/11 22:37.30 [plugin:search] Checking 'hemera.core.command.general.fileSplitter.path' ... OK
05/11/11 22:37.30 [plugin:search] Checking 'hemera.core.command.search.url' ... OK