Djatoka

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)

Provisions

Downloads

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

Installation

Installation Steps:

Download and install Djatoka on your Fedora server by following the installation instructions at: http://sourceforge.net/p/djatoka/code/HEAD/tree/INSTALL.txt.
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:
```
. /opt/adore-djatoka-1.1/bin/env.sh

export JAVA_OPTS

echo $JAVA_OPTS

exec "$PRGDIR"/"$EXECUTABLE" start "$@"
```

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"

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.
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/

Page tree