Difference between revisions of "Imeji install"

From MPDLMediaWiki
Jump to navigation Jump to search
(changed github link)
Line 2: Line 2:


= Install sources =
= Install sources =
This page is intended for users running their own instance of imeji and developers contributing to imeji.
This Page descibes how to install the imeji sofware.  


== Prerequisites ==  
= Install Java=
Before downloading the sources:
imeji supports java 6. Compatibility with Java 7 is not guarantee:
* Please check your Java version (type in command line "java -version". imeji needs version 1.6 or above)
* [http://www.java.com/de/download/manual_v6.jsp Download Java 6]
* Install Eclipse (Eclipse IDE for Java EE Developers)
* Download  [http://www.jboss.org/jbossas/downloads/ JBoss 4.2]
* Install JBoss in Eclipse
* [[Installation_of_maven | Install Maven]]
* [[Maven_integration_in_eclipse | Integrate Maven in Eclipse ]]


== Git ==
= Install JBoss =
* Check out sources: https://github.com/imeji-community/imeji
As a web software, imeji needs an application server. Currently imeji supports only JBoss 4.2.x:
* Create a directory for the Jena database (see next chapter to define it in properties)
* [http://sourceforge.net/projects/jboss/files/JBoss/JBoss-4.2.3.GA/ Download JBoss 4.2.3]


== Compile imeji ==
= Download imeji=
* Import imeji in Eclipse (Import as Maven project)
Last imeji stable version is always avalible on the MPDL nexus:
* Set credentials in your settings.xml of maven (for actual values, please contact [mailto:imeji-support@gwdg.de]):
* [http://rd.mpdl.mpg.de/nexus/content/groups/public/de/mpg/mpdl/imeji/imeji_ear/ Download imeji]
<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/]


=Deploy imeji=
To Deploy imeji:
# Copy the imeji ear file in JBoss (JBoss_Home_Path/server/default/deploy)
# Set the imeji Properties in (JBoss_Home_Path/server/default/deploy/imeji.properties). For more information about the properties see [[Imeji_properties here]]
# Start the server (JBoss_Home_Path/bin/run.xx)
# imeji runs under your_server:port/imeji
Eventually an Apache Server can be installed.
[[Category:Imeji|Install]]
[[Category:Imeji|Install]]

Revision as of 09:50, 9 October 2012

Template:Imeji

Install sources[edit]

This Page descibes how to install the imeji sofware.

Install Java[edit]

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

Install JBoss[edit]

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

Download imeji[edit]

Last imeji stable version is always avalible on the MPDL nexus:

Deploy imeji[edit]

To Deploy imeji:

  1. Copy the imeji ear file in JBoss (JBoss_Home_Path/server/default/deploy)
  2. Set the imeji Properties in (JBoss_Home_Path/server/default/deploy/imeji.properties). For more information about the properties see Imeji_properties here
  3. Start the server (JBoss_Home_Path/bin/run.xx)
  4. imeji runs under your_server:port/imeji

Eventually an Apache Server can be installed.

Open source Java EE-based application server

Max Planck Digital Library

Enterprise Archive File Formate

Open Source and Most Widely Used Web Server

Retrieved from "https://colab.mpdl.mpg.de/mw010/index.php?title=Imeji_install&oldid=82836"