Japanese | English
[ImageSearcher for Java] [Manuals] [Installation]

Installing "ImageSearcher for Java" on Linux

  1. System Environment

     

  2. Installing J2SDK/JRE

    First, you will need to install Java2 Software Development Kit (J2SDK), or Java2 Runtime Environment (JRE). J2SDK and JRE are both available at no cost from Blackdown.org or java.sun.com.

    Download J2SDK or JRE appropriate for your Linux.

    Some of the Linux distributions might have J2SDK ready beforehand. In that case, you don't have to re-install J2SDK.

  3. Installing JIMI Software Development Kit/Java Advanced Imaging API

    Install Sun Microsystems's JIMI Software Development Kit, or Java Advanced Imaging API. JIMI Software Development Kit and JIMI Software Development Kit is available at no cost from Sun Microsystems's Java Technology Homepage.

    The downloadable files have been archived in ZIP/Compressed TAR format and restoring them.

  4. Installing "ImageSearcher for Java"

    The most recent version of "ImageSearcher for Java" is available for downloading from SRA's FTP server.

    The downloadable files have been archived in ZIP format and restoring them will result the following files and directories. Please restore them in an appropriate directory (for example, ~/Isr4Java/). Please use '-a' option for unzip.

    README...README file
    changes...Changes file
    Manuals/...Directory which contains the installation manual.
    src...Source directory.
    lib/isr???.jar...Class library in JAR format. The ??? stands for the version no.
    sql/...Directory which contains the SQL files for "ImageSearcher for Web".
    webapps/...Directory which contains the HTML/JSP files for "ImageSearcher for Web".

    The downloaded file contains StPL.

    README-StPL...README file of StPL.
    src/sra/smalltalk...Source directory of StPL.
    src-jni/ST...Source directory of JIN-compliant so file for StPL
    lib/StPL??.jar ... StPL in JAR format. The ?? stands for the version no.
    lib/linux/StPL.so ... JNI-compliant so file needed to access StPL.

    As this library is a port of the original "Jun" and "ImageSearcher" written in Smalltalk ("Jun for Smalltalk" and "ImageSearcher for Smalltalk"), "ImageSearcher for Java" uses SRA's "Smalltalk-Style Programming Library". Please read the README file at the StPL directory for more information.

    Among these, libStPL.so must be copied or moved to the path which is specified in LD_LIBRARY_PATH environment variable (for example, /usr/lib). If an old version of libStPL.so is installed, please remove it to avoid an inappropriate reference.

    To rebuild libStPL.so, execute make in ~/Isr4Java/src-jni/ST/. (Note that you will need to modify the variables JDK_HOME in the Makefile appropriate for your own environment)

  5. Invoking the Launcher

    Add the 2 JAR files that have been installed (i.e., "isr???.jar" and "StPL??.jar") to the Java class path, then specify the class containing the method main, and invoke the Java virtual machine.

    For example, in the case of JIMI Software Development Kit, this can be accomplished by executing the following shell script.

        setenv CLASSPATH ~/Isr4Java/lib/isr023b.jar:~/Isr4Java/lib/StPL41.jar:~/lib/Jimi/JimiProClasses.zip
        java -Xms10m -Xmx100m sra.isr.system.support.IsrLauncher

    In this, it is assumed that the JAR files have been installed in the path "~/Isr4Java" and "~/lib/Jimi". If they have been installed elsewhere, then revise the specification of CLASSPATH appropriately.

    Further, in the case of Java Advanced Imaging API, executing the following shell script is possible.

        setenv CLASSPATH ~/Isr4Java/lib/isr023b.jar:~/Isr4Java/lib/StPL41.jar:~/lib/Jai/jai_core.jar:~/lib/Jai/jai_codec.jar:~/lib/Jai/mlibwrapper_jai.jar
        java -Xms10m -Xmx100m sra.isr.system.support.IsrLauncher

Mitsuhiro Asada <m-asada@sra.co.jp>