Difference between revisions of "Imeji install"

From MPDLMediaWiki
Jump to navigation Jump to search
m (fixed broken link)
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Imeji_Tech}}
'''Please note:''' Content was moved to http://imeji.org/install/ and http://imeji.org/install/server-setup/
This page describes how to install the imeji software.  


= Operating system =
As a Java software, imeji works on all operating system where Java is installed. Nevertheless, we recommend using http://www.opensuse.org (or SUSE Linux Enterprise Server) which is used for the development and testing of imeji


= Install Java=
[[Category:Imeji_Content_moved|Install]]
imeji supports Java 6. Compatibility with Java 7 is not guaranteed:
* [http://www.java.com/de/download/manual_v6.jsp Download Java 6]
 
= Install application server =
== Version 1.1.0.0 and after ==
Since version 1.1.0.0 imeji supports both JBoss 7.x and Tomcat 7.x:
*[http://tomcat.apache.org/download-70.cgi Download Tomcat] (Recommended)
OR
*[http://www.jboss.org/jbossas/downloads Download JBoss]
 
== Versions before 1.1.0.0 ==
Versions of imeji  before 1.1.0.0 only support JBoss 4.2.x:
* [http://sourceforge.net/projects/jboss/files/JBoss/JBoss-4.2.3.GA/ Download JBoss 4.2.3]
 
= Download imeji =
The latest stable version of imeji is always available at this location:
# [http://rd.mpdl.mpg.de/nexus/content/groups/public/org/imeji/imeji/ Download imeji] : choose the latest version, and click on the war file (imeji-x.x.x.x.war)
# rename the file imeji.war
 
= Install imeji=
# Copy the imeji war file (from [http://colab.mpdl.mpg.de/mediawiki/Imeji_install#Download_imeji here]) in your server:
#* JBoss: JBoss_Home_Path/standalone/deployments
#* Tomcat: Tomcat_home/webapps
# Create, and edit the properties files (as defined here: [[Imeji_properties]])
 
= (Optional) Install Apache Server =
Download and install [http://httpd.apache.org/]
* Recommended configuration:
<pre>
# Add the following lines at the end of your proxypass rules. Change the port if needed.
ProxyPass /imeji http://localhost:8080/imeji
ProxyPassReverse /imeji http://localhost:8080/imeji
ProxyPass / http://localhost:8080/imeji
ProxyPassReverse / http://localhost:8080/imeji
</pre>
* Important: the follwing modules must be loaded:
** proxy_module
** proxy_http_module
 
= (Optional) Install ImageMagick =
imeji uses http://www.imagemagick.org/ (from imeji version 1.3.0.0) to support not only more image formats, but also videos and audio formats. Therefore we strongly recommend to install it:
* Follow the installation instruction according to your operating system
* Set the ImageMagick properties in [[Imeji_properties]]
 
= (Optional) Fledged Data Service =
If you want to use the Fledged Data Service (for the OAI interface) you can download it here:
 
* Put fledgeddata.war file in webapps folder
* Put [[File:Fds.properties | fds.properties]] in conf folder (please adapt).
* Put [[File:Imeji2oai_dc.xslt | imeji2oai.xslt]] in conf folder
 
= (Optional) Digilib =
If you want to use Digilib (from imeji version 1.3.0.0), follow installation here: [[Imeji_digilib]]
 
=Start imeji=
#run
#* JBoss: JBoss_Home_Path/bin/run.xx
#* Tomcat: Tomcat_home/bin/startup.xx
# imeji runs under your_server:port/imeji
# Change admin password: the administrator account is created on first start. The credentials are admin@imeji.org with password admin. '''PLEASE CHANGE THIS IMMEDIATELY!!!'''
Eventually an Apache Server can be installed.
 
=Stop imeji=
#run
#* JBoss: ?
#* Tomcat: Tomcat_home/bin/shutdown.xx
* Note: Check with ps aux| grep java whether Tomcat has been really stopped. If not, kill it...
 
= Install eSciDoc (Optional)=
Download and install [https://www.escidoc.org/JSPWiki/en/DownloadForRelease1.4 escidoc]
=== Note ===
eSciDoc is only optional. It is needed when the eSciDoc is used as the storage (see [[Imeji_storage]]). This is defined in the imeji properties (see [[Imeji_properties]]). The default is the internal storage setting for which you do not need eSciDoc.
 
=License=
The imeji software is developed by the open source imeji community. The code is distributed under the [http://opensource.org/licenses/CDDL-1.0 Common Development and Distribution License (CDDL)].
 
[[Category:Imeji|Install]]
[[Category:Imeji_Technical_Specification|Install]]

Latest revision as of 12:51, 6 February 2014

Please note: Content was moved to http://imeji.org/install/ and http://imeji.org/install/server-setup/

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