Skip to content

Installation

Jump to bottom
haarli edited this page Apr 19, 2024 · 37 revisions

imeji 4.10 - Manual Installation

Requirements

Configuration

  • Rename imeji-x.x.x.war to imeji.war and put it into Tomcat's webapps directory

  • Put imeji.properties into Tomcat's conf directory

  • Edit imeji.properties:

    • imeji.instance.url Set to the URL on which imeji will run
    • elastic.url Set to the URL on which your elasticsearch REST interface runs (e.g. http://localhost:9200 for default installations)
    • imeji.tdb.path Set to a writeable directory where imeji can store its database (Apache Jena)
    • imeji.storage.path Set to a writeable directory where imeji can store the binary files
    • imeji.imagemagick.installpath If ImageMagick 6 is installed (recommended), set to the directory where the ImageMagick binaries (convert etc.) are installed
    • imeji.imagemagick.enable If ImageMagick 6 is installed (recommended), set to true

  • Add a file vocabulary.properties to the Tomcat's conf directory. It can be empty or contain links to interfaces of external vocabulary APIs, e.g. MPDL's CoNE service:

google_geo_api=https://maps.googleapis.com/maps/api/geocode/json?sensor=false&address=
cone_CreativeCommons_licenses=http://api.creativecommons.org/rest/1.5/simple/chooser?locale=
cone_authors=http://pubman.mpdl.mpg.de/cone/persons/query?format=json&n=10&m=full&q=
cone_journals=http://pubman.mpdl.mpg.de/cone/journals/query?format=json&n=10&m=full&q=
cone_Languages_(iso639-3)=http://pubman.mpdl.mpg.de/cone/iso639-3/query?format=json&n=10&m=full&q=
cone_IANA_Mimetypes=http://pubman.mpdl.mpg.de/cone/mimetypes/query?format=json&n=10&m=full&q=
cone_DDC_Subjects=http://pubman.mpdl.mpg.de/cone/mpipks/query?format=json&n=10&m=full&q=

Running imeji

  • Startup Elasticsearch and wait until it is completely available (e.g. by checking http://localhost:9200)
  • Startup Tomcat
  • During the first startup, an admin user will be automatically created. The credentials can be found in the imeji.log file in Tomcat's log directory
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
    
    CREATING NEW SYSADMIN
    Use this user to recover your system
    
    EMAIL: ***********@imeji.org
    PASSWORD: *****
    
    Created admin user successfully!
    
    PLEASE CHANGE USER AND PASSWORD IMMEDIATELY
    
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Migrating from imeji 4.4

  • Install/update new Elasticsearch version
  • Replace imeji.war file with new one
  • Reindex required: After successful startup, login as admin, go to Admin -> Tools -> Reindex

Migrating from imeji 4.0 - 4.3

  • Install/update new Java, Elasticsearch and Apache Tomcat versions
  • Replace imeji.war file with new one
  • Add new property 'elastic.url' to imeji.properties
  • Reindex required: After successful startup, login as admin, go to Admin -> Tools -> Reindex

Manual Installation for older releases

Can be found in the Installation Archive

Installation for Debian Server (DEPRECATED!)

Deprecated ! - Installation via Package Manager is not supported any more

Supported Debian version: 8 (Jessie)

Install Elasticsearch

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
echo "deb http://packages.elastic.co/elasticsearch/2.x/debian stable main" >> /etc/apt/sources.list.d/elastic-2.x.list

apt-get update
apt-get install elasticsearch=2.3.2

Add MPDL repository

wget -qO - http://repository.mpdl.mpg.de/MPDL.gpg.key | apt-key add -
echo "deb http://repository.mpdl.mpg.de/ Jessie main" >> /etc/apt/sources.list.d/mpdl-repo.list

Install imeji

apt-get update
apt-get install imeji

Note: imeji will check if Java 1.8 from Oracle is installed on the server. If not, you will get "No valid Java version found: Please install Oracle JRE 1.8". Just follow the instructions and rerun apt-get install imeji

Clone this wiki locally