Difference between revisions of "Imeji Developer environment"

From MPDLMediaWiki
Jump to navigation Jump to search
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Imeji}}
'''Please note:''' Content was moved to http://imeji.org/wordpress/development/


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 [mailto:imeji-community@gwdg.de community].


=Install Java=
[[Category:Imeji_Content_moved|Developer environment]]
imeji supports java 6. Compatibility with Java 7 is not guarantee:
* [http://www.java.com/de/download/manual_v6.jsp Download Java 6]
 
=Install Eclipse=
For the development, we encourage to use the Eclipse IDE for JEE developers:
* [http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/junosr1 Download Eclipse]
 
=Install Maven=
imeji use Maven 2.2.1:
* [http://maven.apache.org/download.html Download Maven]
To install Maven, please follow [[Installation_of_maven | this guide]]. You can also use the Maven Eclipse plugin. To install it, please follow [[Maven_integration_in_eclipse | this guide ]]
 
=Install Jboss=
As a web software, imeji needs an application server. Currently imeji supports only JBoss 4.2.x:
* [http://sourceforge.net/projects/jboss/files/JBoss/JBoss-4.2.3.GA/ Download JBoss 4.2.3]
== Import server in Eclipse ==
# Open Eclipse
# On the top menu, select Window -> Show View -> Server (If server is not displayed, select Other and then Server)
# Right click in Server View, select New -> Server
# 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 [https://github.com/imeji-community/imeji Github]. We recommend to use the official Github client:
* [http://windows.github.com/ Download Github client for Windows]
* [http://mac.github.com/ Download Github client for Mac]
* [http://eclipse.github.com/ Download Github client for Eclipse]
==Clone imeji on Windows==
After having installed the Github client for Windows, go on [https://github.com/imeji-community/imeji imeji Github page] and click on "clone in Windows".
 
=Import imeji in Eclipse=
# open Eclipse
# Click on top menu "File"
# Select Import
# Select Maven: Existing Maven Project and click on next
# 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 [mailto:imeji-support@gwdg.de]):
<code>
<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>
</code>
* 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 [https://www.escidoc.org/JSPWiki/en/DownloadInfrastructure eSciDoc core service page]. For problems with the core service please contact the eSciDoc developer [mailto:escidoc-dev-ext@gwdg.de mailing list]
** '''For more information about the properties see the [[imeji properties]] page'''
* If you want to use the [[ESciDoc_Services_FledgedDataService | 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/faces/ http://localhost:8080/imeji/]
[[Category:Imeji|Develop]]

Latest revision as of 10:56, 9 January 2014

Please note: Content was moved to http://imeji.org/wordpress/development/