JavaTM Advanced Imaging API

                            JavaTM Advanced Imaging API
                                                 v1.1.2
                                           Installation

  Contents

     * System Requirements
     * Download Instructions
     * Installation Instructions
          o Solaris Operating Environment Installation Instructions
          o CLASSPATH Installation Instructions for Solaris/Linux
          o Microsoft Windows Operating Environment Installation Instructions
          o Linux Operating Environment Installation Instructions
          o Sample Demos Installation Instructions
          o Automatic Installation Instructions
     * After Java Advanced Imaging is Installed
     * Updating CLASSPATH, PATH, and LD_LIBRARY_PATH
     * Uninstall Instructions
     * Permisson-Related Issues

  System Requirements:

     * For the SolarisTM operating environment:
          o Solaris operating environment 2.6 or subsequent compatible version.
          o JavaTM 2 platform, Standard Edition, v1.3.0 or later. (v1.3.1 or later for the JavaTM Plug-In.)
          o At least 14M bytes of free disk space for the SPARC edition, or at least 6M bytes of free disk space
            for the X86 platform.
          o Optionally, an additional 6M bytes of free disk space for the sample code and images
          o An additional 10M bytes may be needed temporarily during the installation process
     * For the LinuxTM operating system:
          o Red Hat 6.2 or subsequent compatible version. See
            JavaTM 2 SDK 1.3.1 for Linux Installation Notes
            for more information on JVM system requirements for Linux.
          o JavaTM 2 platform, Standard Edition, v1.3.0 or later.
          o At least 6M bytes of free disk space.
          o Optionally, an additional 6M bytes of free disk space for the sample code and images
          o An additional 10M bytes may be needed temporarily during the installation process
     * For Microsoft Windows:
          o Windows 95, 98, ME, NT 4.0, 2000 or XP.
          o JavaTM 2 platform, Standard Edition, v1.3.0 or later. (v1.3.1 or later for the JavaTM Plug-In.)
          o At least 7M bytes of free disk space
          o Optionally, an additional 6M bytes of free disk space for the sample code and images
          o An additional 10M bytes may be needed temporarily during the installation process

  Download Instructions

  Using your browser, download the appropriate executable(s) or tar.gz files from the download page to the location
  where you want to temporarily store them.

  The download has been broken into two archives for convenience. The first archive contains the JAI library itself
  and is required in order to run JAI. The second archive contains sample code and images that may optionally be
  downloaded in order to demonstrate some of the functionality of JAI.

  Installation Instructions

     * Solaris Operating Environment Installation Instructions

       For the SPARC edition, the download files are:
          o jai-1_1_2-lib-solaris-sparc-jdk.bin
          o jai-1_1_2-lib-solaris-sparc-jre.bin
          o jai-1_1_2-lib-solaris-sparc.tar.gz
       For the Intel edition, they are:
          o jai-1_1_2-lib-solaris-i586-jdk.bin
          o jai-1_1_2-lib-solaris-i586-jre.bin
          o jai-1_1_2-lib-solaris-i586.tar.gz
       Assuming:

            $JDK1_3       is the path into the jdk1.3 (or a higher version),
            $downloaddir  is the directory into which you downloaded the .bin files.

       To install the JDK version for Solaris:
          o If you are on a SPARC-based system, run the commands:

            % cd $JDK1_3
            % chmod u+x $downloaddir/jai-1_1_2-lib-solaris-sparc-jdk.bin
            % $downloaddir/jai-1_1_2-lib-solaris-sparc-jdk.bin

          o If you are on an Intel-based system, run the commands:

            % cd $JDK1_3
            % chmod u+x $downloaddir/jai-1_1_2-lib-solaris-i586-jdk.bin
            % $downloaddir/jai-1_1_2-lib-solaris-i586-jdk.bin

       You may answer 'yes' to any questions about replacing files. You may delete the jai-1_1_2-*.bin files after
       you are done with the extraction.

       IMPORTANT: If you do not "cd" to the JDK1.3 (or higher version) directory before performing the extraction,
       then JAI will not work correctly. You may also need appropriate write permissions into the JDK directory in
       order to install.

       To install the JRE version for Solaris:

             % cd $JRE1_3         ($JRE1_3 is the path into jre1.3 or later version.)

          o If you are on a SPARC-based system, run the commands:

            % chmod u+x $downloaddir/jai-1_1_2-lib-solaris-sparc-jre.bin
            % $downloaddir/jai-1_1_2-lib-solaris-sparc-jre.bin

          o If you are on an Intel-based system, run the commands:

            % chmod u+x $downloaddir/jai-1_1_2-lib-solaris-i586-jre.bin
            % $downloaddir/jai-1_1_2-lib-solaris-i586-jre.bin

       To view an html page containing an (JAI or other optional package) applet with Netscape 4.x, you need to set
       NPX_PLUGIN_PATH with

            % setenv NPX_PLUGIN_PATH $JRE1_3/plugin/sparc/ns4

       if you have not already done so, when you installed your Solaris JRE/plugin.

       IMPORTANT: If you do not "cd" to the JRE1.3 (or higher version) directory before performing the extraction,
       then JAI will not work correctly. You may also need appropriate write permissions into the JRE directory in
       order to install.

     * CLASSPATH Installation Instructions for Solaris/Linux Platforms

       The tar.gz downloads are installations which do not check for the JDK or the JRE and install into a
       directory called jai-1_1_2 by default. CLASSPATH needs to be set to point to the jar files in this
       directory.

       Assuming:

            $PLATFORM   is the specific platform (solaris-sparc/solaris-i586/linux-i586)

            $JAIDIR is the directory into which the JAI files are to be installed
       To install, change directories to $JAIDIR, unzip, untar, and set CLASSPATH as follows:

            % cd $JAIDIR
            % gunzip -c $downloaddir/jai-1_1_2-lib-($PLATFORM).tar.gz | tar xf -

       Set CLASSPATH as follows:

            % setenv JAIHOME $JAIDIR/jai-1_1_2/lib
            % setenv CLASSPATH $JAIHOME/jai_core.jar:$JAIHOME/jai_codec.jar:$JAIHOME/mlibwrapper_jai.jar:$CLASSPATH
            % setenv LD_LIBRARY_PATH .:$JAIHOME:$CLASSPATH

     * Microsoft Windows Installation Instructions

       The downloaded objects are executable files. In Microsoft Windows, they are .exe files:
          o jai-1_1_2-lib-windows-i586.exe
          o jai-1_1_2-lib-windows-i586-jre.exe
          o jai-1_1_2-lib-windows-i586-jdk.exe
       To install the library files, double-click on the jai-1_1_2-lib-windows-i586.exe icon and follow the
       directions. This will install the library files into a default location C:\jai-1_1_2 without any check for
       the JDK or the JRE

       To install the JRE version, double-click on the jai-1_1_2-lib-windows-i586-jre.exe icon and follow the
       directions.

       To install the JDK version, double-click on the jai-1_1_2-lib-windows-i586-jdk.exe icon and follow the
       directions.

       You may delete the jai-1_1_2-*.exe files after you are done with the extraction.

       IMPORTANT: The executable will try to install JAI within the latest JDK (or JRE) version that it finds. If
       you need to install and use JAI within another JDK (or JRE) version on disk, please make sure you enter a
       valid JDK directory when prompted.

     * Linux Installation Instructions

       The downloaded files are:
          o jai-1_1_2-lib-linux-i586-jdk.bin
          o jai-1_1_2-lib-linux-i586-jre.bin
          o jai-1_1_2-lib-linux-i586.tar.gz
       To install the JDK version for Linux, assuming:

            $JDK1_3       is the path into the jdk1.3 (or a higher version),
            $downloaddir  is the directory into which you downloaded the .bin files.

       Run the following commands:

            % cd $JDK1_3
            % chmod u+x $downloaddir/jai-1_1_2-lib-linux-i586-jdk.bin
            % $downloaddir/jai-1_1_2-lib-linux-i586-jdk.bin

       IMPORTANT: If you do not "cd" to the JDK1.3 (or higher version) directory before performing the extraction,
       then JAI will not work correctly. You may also need appropriate write permissions into the JDK directory in
       order to install.

       To install the JRE version for Linux, try

             % cd $JRE1_3         ($JRE1_3 is the path into jre1.3 or later version.)
             % chmod u+x $downloaddir/jai-1_1_2-lib-linux-i586-jre.bin