Versions Compared

Old Version 1

changes.mady.by.user Melissa Anez

Saved on

compared with

New Version Current

changes.mady.by.user Melissa Anez

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The Djatoka JPEG 2000 Image Server is a plug-in image server that images can be sent to for processing. It can function with an installation of Apache Tomcat as a web app. Islandora uses Djatoka to prepare TIFF images for viewing, particularly with the Internet Archive Bookreader

Dependencies

  • A working web app server to install it to (Tomcat - bundled with Fedora - in a default installation)
  • Oracle Java JDK 8 (Djatoka requires Sun/Oracle Java, not OpenJDK 8)

Provisions

Downloads

Djatoka can be downloaded from the project's Sourceforge page at http://sourceforge.net/projects/djatoka/files/djatoka/.

Installation

Installation Steps:

  1. Download and install Djatoka on your Fedora server by following the installation instructions at: http://sourceforge.net/p/djatoka/code/HEAD/tree/INSTALL.txt.

  2. For this example, we have installed Djatoka in /opt/adore-djatoka-1.1. Once Djatoka has been verified and installed, you will need to change the environment variables in the $CATALINA_HOME/bin/startup.sh script. At the very end of the file, insert the following:

    Code Block
    . /opt/adore-djatoka-1.1/bin/env.sh

export JAVA_OPTS

echo $JAVA_OPTS

exec "$PRGDIR"/"$EXECUTABLE" start "$@"
  3. Then, modify the env.sh file found in /opt/adore-djatoka-1.1/bin/

      a) At the top of the file:

    Change this:

    To this:

    #!/bin/sh
    # setup environment variables for shell script

    # Define DJATOKA_HOME dynamically
    LAUNCHDIR=$PWD
    cd ..

    DJATOKA_HOME=`pwd`
    LIBPATH=$DJATOKA_HOME/lib

    #!/bin/sh
    # setup environment variables for shell script
    CURRENTDIR=$PWD
    # Define DJATOKA_HOME dynamically
    LAUNCHDIR=/opt/adore-djatoka-1.1/bin
    #cd ..

    DJATOKA_HOME=/opt/adore-djatoka-1.1
    LIBPATH=$DJATOKA_HOME/lib

      b) Then, at the bottom of the file:

    Change this:

    To this:

    KAKADU_HOME=$DJATOKA_HOME/bin/$PLATFORM
    export KAKADU_HOME
    cd $LAUNCHDIR

    for line in `ls -1 $LIBPATH | grep '.jar'`
      do
      classpath="$classpath:$LIBPATH/$line"
    done



    #DEBUG="-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n"
    CLASSPATH=.:../build/:$classpath
    JAVA_OPTS="$DEBUG -Djava.awt.headless=true  -Xmx512M -Xms64M -Dkakadu.home=$KAKADU_HOME -Djava.library.path=$LIBPATH/$PLATFORM $KAKADU_LIBRARY_PATH"

    KAKADU_HOME=$DJATOKA_HOME/bin/$PLATFORM
    #cd $LAUNCHDIR


    #for line in `ls -1 $LIBPATH | grep '.jar'`
     # do
     # classpath="$classpath:$LIBPATH/$line"
    #done
    #go back to tomcat dir
    #cd $CURRENTDIR

    #DEBUG="-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n"
    #CLASSPATH=.:../build/:$classpath
    JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true -Dkakadu.home=$KAKADU_HOME -Djava.library.path=$LIBPATH/$PLATFORM $KAKADU_LIBRARY_PATH"

  4. Restart Fedora and test the Djatoka application by going to: http://\[fedora-server\]:8080/adore-djatoka 

    To test your installation, click the 'Update Image' button. If you do not see part of an image from the Library of Congress there is a problem with your Djatoka installation. Go back and review the installation instructions to make sure that they were followed correctly.

    Info

    Though not required, it is a good idea to set the path for Djatoka log files. You can do this by adding a line to the log4j.properties file. For example:

    log.dir=/usr/local/fedora/server/logs/

Accommodating Viewing Restrictions for Djatoka

The Djatoka image viewer must send authentication credentials to Fedora in order to get titles back. For most set-ups, this communication between Djatoka and Fedora will be direct. However, if you wish to put Djatoka behind an authentication wall to restrict the view of objects to certain users in Fedora, you will need to make some additional configurations.

...