Skip to content

Hemera:Install_for_developer

Bertrand Benoit edited this page Dec 7, 2019 · 2 revisions

title: Hemera:Install for developer permalink: /Hemera:Install_for_developer/

TOC

Prepare your Operating System

Hemera is mainly compounded of several projects in Java (including the Web Module), and all script pieces are in GNU/Bash. To work on Java projects, it is strongly recommanded to use an IDE like Eclipse which has been used for development. Following instructions give information to setup Eclipse to work on Hemera, but you may adapt them to work on another IDE.

==Install development and build tools==

  • install Git
  • install [Java Development Kit|Third-party:Global#Java]]
  • install [Apache Ant|Third-party:Global#Tools_available_with_package_manager]]
  • install Eclipse from site version or your OS package manager
  • install a dedicated binary version of [Tomcat|Third-party:Web]] *
  • install Eclipse plugins:

* about Tomcat, you can:

  • install a dedicated binary version of Tomcat where you want, and then, after having got Hemera source code, create a symbolic link named [HEMERA_TP_PATH](/Appendix#HEMERA_TP_PATH]]/webServices/bin/tomcat, to the Tomcat installation
  • wait before installing Tomcat and configuring Sysdeo Eclipse Tomcat Launcher (but you still need to install it now) until you get source code, and then complete your installation

Prepare to install third-party tools

Some third-party tools needs C/C++ compilation, you should [prepare your Operating System to compile source code|Third-party:Prepare_to_compile_Source]].

=Get the source code=

Under Eclipse (or other IDE)

In EGit, add the git repository:

Then, you can easily import projects in your working directory (they all have a .project file): Hemera, ThirdParty, WebModule, Tests

Command line

If you don't want to use an IDE, you can get everything with following commands:

cd [HEMERA_ROOT_PATH](/Appendix#HEMERA_ROOT_PATH]]

For read-only access:

git clone https://github.com/bertrand-benoit/hemerais

For read/write access (you MUST be a project's member, and you must setup your SSH key):

git clone git@github.com:bertrand-benoit/hemerais.git

Hemera application launcher

Java properties

If you launch Hemera Java application directly under IDE, you should specify the following properties:

  • java.system.class.loader to define the Hemera specific classloader which loads the properties file automatically
  • hemera.property.file to define the Hemera properties file

For instance (with Eclipse ${workspace_loc} variable):

-Djava.system.class.loader=hemera.HemeraClassLoader -Dhemera.property.file=${workspace_loc}/Hemera/config/hemera.conf

You may use the additional properties: * hemera.log.file to define a log file (messages will be appended to the file if it already exists) For instance:

-Dhemera.log.file="/path/to/logFile"

Category:HemeraBook/en Category:Developer/en

You can’t perform that action at this time.