Article : JavaTM Advanced Imaging API v1.1.3 Installation

JavaTM Advanced Imaging API v1.1.3 Installation

Contents

  • System Requirements
  • Download Instructions
  • Installation Instructions
    • Solaris 32-bit Operating Environment Installation Instructions
    • Solaris 64-bit Operating Environment Installation Instructions
    • CLASSPATH Installation Instructions for Solaris/Linux
    • Microsoft Windows Operating Environment Installation Instructions
    • Linux 32- and 64-bit Operating Environment Installation Instructions
    • Java Platform-Independent Installation Instructions
    • Automatic Installation Instructions
  • After Java Advanced Imaging is Installed
  • Updating CLASSPATH, PATH, and LD_LIBRARY_PATH
  • Running Without Native Acceleration
  • Uninstall Instructions
  • Permisson-Related Issues

System Requirements:

  • For the SolarisTM operating environment:
    • Solaris operating environment 2.6 or subsequent compatible version.
    • JavaTM 2 platform, Standard Edition, v1.3.0 or later. (v1.3.1 or later for the JavaTM Plug-In.)
    • 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.
    • An additional 10M bytes may be needed temporarily during the installation process
  • For the LinuxTM operating system:
    • 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.
    • JavaTM 2 platform, Standard Edition, v1.3.0 or later.
    • At least 6M bytes of free disk space.
    • An additional 10M bytes may be needed temporarily during the installation process
  • For Microsoft Windows:
    • Windows 95, 98, ME, NT 4.0, 2000 or XP.
    • JavaTM 2 platform, Standard Edition, v1.3.0 or later. (v1.3.1 or later for the JavaTM Plug-In.) 
    • At least 7M bytes of free disk space
    • An additional 10M bytes may be needed temporarily during the installation process
  • For the Java Platform Indepedent version (no native acceleration):
    • A JavaTM virtual machine equivalent to Sun Microsystems' JavaTM 2 platform, Standard Edition, v1.3.0 or later.
    • At least 7M bytes of free disk space
    • Note that this installation is not officially supported on platforms other than those for which natively accelerated versions are provided.

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. 

Installation Instructions

  • Solaris 32-bit Operating Environment Installation Instructions

    For the SPARC edition, the download files are: 

    • jai-1_1_3-lib-solaris-sparc-jdk.bin
    • jai-1_1_3-lib-solaris-sparc-jre.bin
    • jai-1_1_3-lib-solaris-sparc.tar.gz
    For the Intel edition, they are: 
    • jai-1_1_3-lib-solaris-i586-jdk.bin
    • jai-1_1_3-lib-solaris-i586-jre.bin
    • jai-1_1_3-lib-solaris-i586.tar.gz
    Assuming:
  • $JDK  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:
    • If you are on a SPARC-based system, run the commands:

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

    • If you are on an Intel-based system, run the commands:
  • % cd $JDK
    % chmod u+x $downloaddir/jai-1_1_3-lib-solaris-i586-jdk.bin
    % $downloaddir/jai-1_1_3-lib-solaris-i586-jdk.bin

    You may answer 'yes' to any questions about replacing files. You may delete the jai-1_1_3-*.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 $JRE  ($JRE is the path into jre1.3 or later version.)

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

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

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

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

    To view an html page containing an (JAI or other optional package) applet, the Java Plug-in must also be registered with the browser as described at http://java.sun.com/j2se/1.4.2/install-solaris.html#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. 

  • Solaris 64-bit Operating Environment Installation Instructions

    For the SPARC edition, the download files are: 

    • jai-1_1_3-lib-solaris-sparcv9-jdk.bin
    • jai-1_1_3-lib-solaris-sparcv9-jre.bin
    • jai-1_1_3-lib-solaris-sparcv9.tar.gz
    For the AMD64 edition, they are: 
    • jai-1_1_3-lib-solaris-amd64-jdk.bin
    • jai-1_1_3-lib-solaris-amd64-jre.bin
    • jai-1_1_3-lib-solaris-amd64.tar.gz
    Assuming: To install the JDK version for Solaris:
    • First install the 32-bit version for JDK as described above.


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

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

      % cd $JDK
      % chmod u+x $downloaddir/jai-1_1_3-lib-solaris-sparcv9-jdk.bin
      % $downloaddir/jai-1_1_3-lib-solaris-sparcv9-jdk.bin

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

      % cd $JDK
      % chmod u+x $downloaddir/jai-1_1_3-lib-solaris-amd64-jdk.bin
      % $downloaddir/jai-1_1_3-lib-solaris-amd64-jdk.bin

    You may answer 'yes' to any questions about replacing files. You may delete the jai-1_1_3-*.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 $JRE  ($JRE is the path into jre1.3 or later version.)

      First install the 32-bit version for JRE as described above.
      If you are on a SPARC-based system, run the commands:

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

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

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

    To view an html page containing an (JAI or other optional package) applet, the Java Plug-in must also be registered with the browser as described at http://java.sun.com/j2se/1.4.2/install-solaris.html#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_3 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/linux-amd64)

      $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_3-lib-($PLATFORM).tar.gz | tar xf -

    Set CLASSPATH as follows:

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

    Unlike for the JRE and JDK installations, the 64-bit version Solaris platform bundles for CLASSPATH installation, jai-1_1_3-lib-sparcv9.tar.gz and jai-1_1_3-lib-amd64.tar.gz, are self-contained and will function in 64-bit mode only. If they are unpacked in the same location as the equivalent 32-bit bundle they will overwrite the files extracted from the 32-bit bundle.
    Microsoft Windows Operating Environment Installation Instructions

    The downloaded objects are executable files. In Microsoft Windows, they are .exe files:

      jai-1_1_3-lib-windows-i586.exe
      jai-1_1_3-lib-windows-i586-jre.exe
      jai-1_1_3-lib-windows-i586-jdk.exe

    To install the library files, double-click on the jai-1_1_3-lib-windows-i586.exe icon and follow the directions. This will install the library files into a default location

    C:\Program Files\Sun Microsystems\Java Advanced Imaging 1.1.3

  • without any check for the JDK or the JRE 

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

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

    You may delete the jai-1_1_3-*.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 32- and 64-bit Operating Environment Installation Instructions

    The downloaded files are: 

    • jai-1_1_3-lib-linux-$ARCH-jdk.bin
    • jai-1_1_3-lib-linux-$ARCH-jre.bin
    • jai-1_1_3-lib-linux-$ARCH.tar.gz
    where ARCH is either i586 for the 32-bit platform or amd64 for the 64-bit platform.

    To install the JDK version for Linux, assuming:

  •   $JDK  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 $JDK
      % chmod u+x $downloaddir/jai-1_1_3-lib-linux-$ARCH-jdk.bin
      % $downloaddir/jai-1_1_3-lib-linux-$ARCH-jdk.bin

    Note that unlike in the case of Solaris, the Linux 32- and 64-bit installations are not layered but rather mutually exclusive.

    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 $JRE  ($JRE is the path into jre1.3 or later version.)
      % chmod u+x $downloaddir/jai-1_1_3-lib-linux-$ARCH-jre.bin
      % $downloaddir/jai-1_1_3-lib-linux-$ARCH-jre.bin 

    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. 
  • Java Platform-Independent Installation Instructions

    The downloaded file is: 

    • jai-1_1_3-lib.zip

    Unpacking the archive will create a directory (folder) named jai-1_1_3 which contains the LICENSE-jai.txt and other legal files at the top level and a lib subdirectory containing jai_core.jar and jai_codec.jar. To install the Java version simply unpack the archive and set the CLASSPATH environment variable to include jai_core.jar and jai_codec.jar. If only the codec packages com.sun.media.jai.codec are desired then jai_core.jar may be omitted from the CLASSPATH. For additional information refer also to the section Running Without Native Acceleration.

  • Automatic Installation of JAI

    JavaTM Plug-in Technology establishes a connection between popular browsers and the JavaTM platform. The JavaTM Plug-in 1.4.2. Developer Guide discusses how to use the JavaTM Plug-in Component to enable applets in browsers. One of the capabilities provided by JavaTM Plug-in (JPI) is JavaTM extension deployment. The JPI installs or replaces the Java extensions (such as JAI) in your browser with an updated version. If a user's browser runs a Java program requiring an Optional Package, the JPI can be made to automatically download and run the Optional Package's installer. For more information please refer to the detailed instructions on how to deploy an applet which may deploy an Optional Package such as JAI.

    A JPI auto-installation download bundle for JAI is provided for each of the supported platforms:

    Platform Download Bundle Contents
    solaris-sparc jai-1_1_3-solaris-sparc-jar.zip jai_solaris-sparc.jar
    solaris-sparcv9 jai-1_1_3-solaris-sparcv9-jar.zip jai_solaris-sparcv9.jar
    solaris-amd64 jai-1_1_3-solaris-amd64-jar.zip jai_solaris-amd64.jar
    solaris-i586 jai-1_1_3-solaris-i586-jar.zip jai_solaris-i586.jar
    linux-amd64 jai-1_1_3-linux-amd64-jar.zip jai_linux-amd64.jar
    linux-i586 jai-1_1_3-linux-i586-jar.zip jai_linux-i586.jar
    windows-i586 jai-1_1_3-windows-i586-jar.zip jai_windows-i586.jar

    Each bundle is a Zip archive containing a signed JAI extension jar file which in turn contains a JAI JRE installer. The Implementation-URL attribute of the manifest of the applet jar file must refer to this signed jar file. Thus developers of applets which use auto-installation of JAI must unpack the Zip archive and place the jar file contained therein at the location specified by the Implementation-URL attribute of their applet jar file's Manifest. For example, the applet jar file's manifest might look like this

    Extension-List: jai_core
    jai_core-Extension-Name: javax.media.jai
    jai_core-Specification-Version: 1.1-mr
    jai_core-Implementation-Version: 1.1.3
    jai_core-Implementation-Vendor-Id: com.sun
    jai_core-Implementation-URL: http://mydomain.com/jai_solaris-sparc.jar
    
    if the solaris-sparc auto-installation jar file was being used and was located at the top level of the http://mydomain.com server.

    As with the standard Solaris 64-bit JRE installation, the 64-bit automatic installation on solaris-sparcv9 and solaris-amd64 is layered over the respective 32-bit automatic installation. For automatic installation this means that the applet's manifest jar file must include both installers for example as

    Extension-List: jai_core jai_core64
    jai_core-Extension-Name: javax.media.jai
    jai_core-Specification-Version: 1.1-mr
    jai_core-Implementation-Version: 1.1.3
    jai_core-Implementation-Vendor-Id: com.sun
    jai_core-Implementation-URL: http://mydomain.com/jai_solaris-sparc.jar
    jai_core64-Extension-Name: javax.media.jai64
    jai_core64-Specification-Version: 1.1-mr
    jai_core64-Implementation-Version: 1.1.3
    jai_core64-Implementation-Vendor-Id: com.sun
    jai_core64-Implementation-URL: http://mydomain.com/jai_solaris-sparcv9.jar
    

    Note that the version of the JPI specified by an applet must match the version of JPI installed in the browser. Note also that installation will not succeed if the user does not have write permission for the JPI installation location. See also (Updating CLASSPATH, PATH, and LD_LIBRARY_PATH) for information related to the usage of the correct version of JPI. 

    After Java Advanced Imaging is installed

    Java Advanced Imaging will be installed under the $JDK directory with the following files:
    COPYRIGHT-jai.txt Copyright notice.
    UNINSTALL-jai UnInstall executable (Solaris and Linux only)
    LICENSE-jai.txt License agreement.
    DISTRIBUTIONREADME-jai.txt License agreement for redistribution.
    THIRDPARTYLICENSEREADME-jai.txt License information for embedded third party software.
    jre/lib/ext/jai_core.jar JAR file containing core JAI class files.
    jre/lib/ext/jai_codec.jar JAR file containing JAI class files for image I/O.
    jre/lib/ext/mlibwrapper_jai.jar mediaLib JNI interfaces.
    jre/lib/sparc/libmlib_jai.so mediaLib JNI shared libraries, C version.
    (Solaris operating environment, SPARC edition.)
    jre/lib/sparc/libmlib_jai_vis.so mediaLib JNI shared libraries, VIS version.
    (Solaris operating environment, SPARC edition only.)
    jre/lib/sparc/libmlib_jai_vis2.so mediaLib JNI shared libraries, VIS2 version.
    (Solaris operating environment, SPARC edition only.)
    jre/lib/sparcv9/libmlib_jai.so mediaLib JNI shared libraries, C version.
    (Solaris operating environment, 64-bit SPARC edition only.)
    jre/lib/sparcv9/libmlib_jai_vis.so mediaLib JNI shared libraries, VIS version.
    (Solaris operating environment, 64-bit SPARC edition only.)
    jre/lib/sparcv9/libmlib_jai_vis2.so mediaLib JNI shared libraries, VIS2 version.
    (Solaris operating environment, 64-bit SPARC edition only.)
    jre/lib/i386/libmlib_jai.so mediaLib JNI shared libraries, C version.
    (Solaris operating environment, Intel edition.)
    jre/lib/amd64/libmlib_jai.so mediaLib JNI shared libraries, C version.
    (Solaris operating environment, 64-bit AMD edition.)
    jre/lib/i386/libmlib_jai.so mediaLib JNI shared libraries, C version.
    (Linux operating environment, Intel edition)
    jre/lib/amd64/libmlib_jai.so mediaLib JNI shared libraries, C version.
    (Linux operating environment, 64-bit AMD edition)
    jre/bin/mlib_jai.dll mediaLib JNI DLL libraries, C version.
    (Microsoft Windows operating environment)
    jre/bin/mlib_jai_mmx.dll mediaLib JNI DLL libraries, MMX version.
    (Microsoft Windows operating environment)
    jre/bin/mlib_jai_util.dll A utility to detect whether MMX is available.
    (Microsoft Windows operating environment)

    Read the top-level JAI README file for information on what is in this release of Java Advanced Imaging.