Skip to content

Installation Archive

Jump to bottom
haarli edited this page Apr 29, 2020 · 3 revisions

imeji 4.5 - Manual Installation

Requirements

Configuration

  • Rename imeji-x.x.x.war to imeji.war and put it into Tomcat's webapp 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

imeji 4.4 - Manual Installation

Requirements

Configuration

  • Rename imeji-x.x.x.war to imeji.war and put it into Tomcat's webapp 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
  • 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
    
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

imeji 4.0 - imeji 4.3 - Manual Installation

Requirements

Configuration

  • Rename imeji-x.x.x.war to imeji.war and put it into Tomcat's webapp 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.cluster.name must be set to the same value as your cluster.name property in elasticsearch.yml configuration
    • elastic.cluster.home Set to a writeable directory where imeji will store its search index
    • elastic.analyser Set to ducet_sort when ICU plugin is installed
    • imeji.tdb.path Set to a writeable directory where imeji can store its database
    • imeji.storage.path Set to a writeable directory where imeji can store the binary files

  • 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
  • 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
    
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Clone this wiki locally