Imeji Developer environment

This page describes how to develop the imeji software

Introduction

The imeji software is developed and supported by the imeji community. If you want to participate to the project, please contact the community.

Install Java

imeji supports java 6. Compatibility with Java 7 is not guarantee:

• Download Java 6

Install Eclipse

For the development, we encourage to use the Eclipse IDE for JEE developers:

• Download Eclipse

Install Maven

imeji use Maven 2.2.1:

• Download Maven

To install Maven, please follow this guide. You can also use the Maven Eclipse plugin. To install it, please follow this guide

Install Jboss

As a web software, imeji needs an application server. Currently imeji supports only JBoss 4.2.x:

• Download JBoss 4.2.3

Import server in Eclipse

1. Open Eclipse
2. On the top menu, select Window -> Show View -> Server (If server is not displayed, select Other and then Server)
3. Right click in Server View, select New -> Server
4. Select JBoss -> JBoss v4.2 and click finish (or next if you want to change the default ports)

Download source

The imeji code source is hosted at Github. We recommend to use the official Github client:

• Download Github client for Windows
• Download Github client for Mac
• Download Github client for Eclipse

Clone imeji on Windows

After having installed the Github client for Windows, go on imeji Github page and click on "clone in Windows".

Import imeji in Eclipse

1. open Eclipse
2. Click on top menu "File"
3. Select Import
4. Select Maven: Existing Maven Project and click on next
5. Browse filesystem en select imeji directory and click on Finish

Compile imeji

• Set credentials in your settings.xml of maven (for actual values, please contact [1]):

<properties>
  <jboss.install.dir>YOUR_JBOOS_PATH</jboss.install.dir>
  <escidoc.framework_access.framework.url>YOUR_CORESERVICE_URL</escidoc.framework_access.framework.url>	
  <imeji.tdb.path>YOUR_JENA_DIRECTORY</imeji.tdb.path> 
  <imeji.sysadmin.email>admin_email</imeji.sysadmin.email>
  <imeji.sysadmin.password>a_password</imeji.sysadmin.password>
  <imeji.escidoc.user>an_escidoc_user</imeji.escidoc.user>
  <imeji.escidoc.password>a_password</imeji.escidoc.password> 
  <framework.admin.username>coreservice_admin_login</framework.admin.username>
  <framework.admin.password>password</framework.admin.password>
  <imeji.email.server.smtp>YOUR_MAILSERVER</imeji.email.server.smtp>
  <imeji.email.user>mailserver_user</imeji.email.user>
  <imeji.email.password>mailserver_pwd</imeji.email.password>
  <imeji.email.auth>true/false</imeji.email.auth>
  <imeji.email.sender>sender_adress</imeji.email.sender>
</properties>

• Check properties in "meta" pom.xml
  • Attention: Some properties are related to the core service. If you install your own core service, you will have to adapt it. Please check the eSciDoc core service page. For problems with the core service please contact the eSciDoc developer mailing list
  • For more information about the properties see the imeji properties page
• If you want to use the Fledged Data Service you need to adapt the fds.properties
• Compile presentation: clean install
• Compile ear: clean install jboss:harddeploy
• Start your server
• imeji is available at http://localhost:8080/imeji/

Integrated Development Environment

Open source Java EE-based application server

Open source Java EE-based application server

Web-Based Hosting Service for Software Development with Git Revision Control System

Uniform Resource Locator

Enhanced Scientific Documentation

Enterprise Archive File Formate