Java ^TM Advanced Imaging Image I/O Tools Installation

Platform Requirements

Java ^TM Advanced Imaging and JAI Image I/O Tools

^TMnotis

Native Libraries

^TM

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 Operating Environment Installation Instructions
• For the SPARC edition, the files available for download are: 

Only the bundle(s) required for the installation type(s) of interest need to be downloaded.

For the Intel edition, the available files are: 

Only the bundle(s) required for the installation type(s) of interest need to be downloaded.

Assuming:

$JDK       is the path into the JDK (1.4
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_imageio-1_0_01-lib-solaris-sparc-jdk.bin
  % $downloaddir/jai_imageio-1_0_01-lib-solaris-sparc-jdk.bin

  % cd $JDK
  % chmod u+x $downloaddir/jai_imageio-1_0_01-lib-solaris-i586-jdk.bin
  % $downloaddir/jai_imageio-1_0_01-lib-solaris-i586-jdk.bin

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

IMPORTANT: If you do not "cd" to the JDK (1.4 or higher version) directory before performing the extraction, then JAI Image I/O Tools will not install. 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 JRE 1.4 or later version.)

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

• % chmod u+x $downloaddir/jai_imageio-1_0_01-lib-solaris-sparc-jre.bin
  % $downloaddir/jai_imageio-1_0_01-lib-solaris-sparc-jre.bin

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

• % chmod u+x $downloaddir/jai_imageio-1_0_01-lib-solaris-i586-jre.bin
  % $downloaddir/jai_imageio-1_0_01-lib-solaris-i586-jre.bin

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

% setenv NPX_PLUGIN_PATH $JRE/plugin/sparc/ns4

if you have not already done so, when you installed your Solaris JRE/plugin. For Mozilla instead of NPX_PLUGIN_PATH set MOZ_PLUGIN_PATH to the same value. 

IMPORTANT: If you do not "cd" to the JRE (or higher version) directory before performing the extraction, then JAI Image I/O Tools will not install. 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_imageio-1_0_01 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)

$JIODIR is the directory into which the JAI Image I/O Tools files are to be installed

To install, change directories to $JIODIR, gunzip, untar, and set CLASSPATH as follows:

% cd $JIODIR
% gunzip -c $downloaddir/jai_imageio-1_0_01-lib-($PLATFORM).tar.gz | tar xf -

Set CLASSPATH as follows: 

% setenv JIOHOME $JIODIR/jai_imageio-1_0_01/lib
% setenv CLASSPATH $JIOHOME/jai_imageio.jar:$JIOHOME/clibwrapper_jiio.jar:$CLASSPATH
% setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:$JIOHOME

Linux Installation Instructions

The files available for download are: 

Only the bundle(s) required for the installation type(s) of interest need to be downloaded.

To install the JDK version for Linux, assuming: 

$JDK       is the path into the JDK (1.4
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_imageio-1_0_01-lib-linux-i586-jdk.bin
% $downloaddir/jai_imageio-1_0_01-lib-linux-i586-jdk.bin

IMPORTANT: If you do not "cd" to the JDK (1.4 or higher version) directory before performing the extraction, then JAI Image I/O Tools will not install. 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 JRE 1.4 or later version.)
      % chmod u+x $downloaddir/jai_imageio-1_0_01-lib-linux-i586-jre.bin
      % $downloaddir/jai_imageio-1_0_01-lib-linux-i586-jre.bin

IMPORTANT: If you do not "cd" to the JRE (1.4 or higher version) directory before performing the extraction, then JAI Image I/O Tools will not install. You may also need appropriate write permissions into the JRE directory in order to install. 

Only the bundle(s) required for the installation type(s) of interest need to be downloaded.

Two setup types are offered for selection during installation. The "Typical" setup type will install the entirety of JAI-Image I/O Tools including both the Java and native plug-ins. The "Custom" setup type allows for the selection of which files to include. By default the files installed for the "Custom" setup type are the Java Image I/O plug-ins only, i.e., the native plug-ins are omitted. Note that if jai_imageio.jar is not among the files installed by the "Custom" setup type then the installation will be non-functional.

To install the library files, double-click on the jai_imageio-1_0_01-lib-windows-i586.exe icon and follow the directions.

This will install the library files into a default location

C:\Program Files\Sun Microsystems\JAI Image IO Tools 1.0_01

without any check for the JDK or the JRE. The CLASSPATH and PATH variables will then need to be set in order to use JAI Image I/O Tools. 

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

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

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

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

Automatic Installation of JAI Image I/O Tools

Java ^TM Plug-in Technology establishes a connection between popular browsers and the Java ^TM platform. The Java ^TM Plug-in 1.4.2. Developer Guide discusses how to use the Java ^TM Plug-in Component to enable applets in browsers. One of the capabilities provided by Java ^TM Plug-in (JPI) is Java ^TM extension deployment. The JPI installs or replaces the Java extensions (such as JAI Image I/O Tools) 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 Image I/O Tools.

A JPI auto-installation download bundle for JAI-Image I/O Tools is provided for each of the supported platforms:

Each bundle is a Zip archive containing a signed JAI Image I/O Tools extension jar file which in turn contains a JAI Image I/O Tools 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 Image I/O Tools 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_imageio
jai_imageio-Extension-Name: com.sun.media.imageio
jai_imageio-Specification-Version: 1.0-mr
jai_imageio-Implementation-Version: 1.0_01
jai_imageio-Implementation-Vendor-Id: com.sun
jai_imageio-Implementation-URL: http://mydomain.com/jai_imageio-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.

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 Image I/O Tools is installed

Java Advanced Imaging Image I/O Tools will be installed under the $JDK directory with the files in the locations given in the following table. The same files will appear in analogous locations in the JRE installation. In the CLASSPATH installation they will be located in the installation directory and its lib subdirectory.

Updating CLASSPATH, PATH, and LD_LIBRARY_PATH

If JAI Image I/O Tools is installed as part of the Java 2 SDK's Java Runtime Environment, no CLASSPATH or LD_LIBRARY_PATH settings are required. When you encounter problems running JAI Image I/O Tools applications, it is most likely that you are not running the correct version of java (jdk). Check with the command "java -version" on Solaris or at Dos prompt. If needed, set the PATH correctly to use the correct version of JDK or JRE as follows. 

For Solaris: 

% setenv PATH $JDK/bin:$PATH;    or
% setenv PATH $JRE/bin:$PATH;    and/or  
% setenv NPX_PLUGIN_PATH $JRE/plugin/sparc/ns4;  (for applet/plugin to work on Netscape 4.x);   and/or  
% setenv MOZ_PLUGIN_PATH $JRE/plugin/sparc/ns4;  (for applet/plugin to work on Mozilla).

For Windows: 

A point to be noted on the Windows platform is that the Java2 SDK 1.4, by default, installs Java into both the JDK location: 

c:\jdk1.4

and into the JRE location: 

C:\Program Files\JavaSoft\jre\1.4

Additionally, a shortcut to java.exe is installed in the WINNT/System32 (for NT systems) or Windows/System (for Windows 95 and 98) directory. 

Developers need to be aware of this when working with the Java 2 SDK. Unless the path to the SDK jre\bin and bin directories is placed in the PATH environment variable in the same order, ahead of the system directory, the SDK's java.exe will not be executed. Any extensions (such as JAI Image I/O Tools) that are installed into the SDK but not into the JRE will not be found during program execution. The same applies to higher versions of the JDK. 

To set PATH environment variable, you may need to edit autoexec.bat on Windows 98/95. For other Windows systems, try click Start-Settings-ControlPanel, then double click on System. Choose Environment. Under System Variables, click on PATH, and update its value to put

c:\Program Files\JavaSoft\jre\1.4\bin;     or
  c:\jdk1.4\jre\bin;     or 
  c:\jdk1.4\bin;

ahead of other folders in the PATH. Note that ";" is used to separate folders within the PATH. To double check, open a DOS command prompt and use "set" or "set path" to view the PATH environment variable.

If you have used the CLASSPATH install into arbitrary location for Windows, then you will also need to set your CLASSPATH variable to point to each of the JAI Image I/O jar files in your installed directory. 

Uninstall Instructions

• Solaris/Linux Operating Environment

• % cd $JDK

  where $JDK is the path into the JDK (1.4 or a higher version) directory, where JAI Image I/O Tools was installed.

  % chmod u+x UNINSTALL-jai
  % ./UNINSTALL-jai

  If uninstalling from a JRE, first cd to the JRE path $JRE.

• Microsoft Windows Operating Environment
• You would need to go to the Control Panel and double-click on Add/Remove Programs. Find the listing for Java Advanced Imaging Image I/O Tools 1.0_01 and click on Change/Remove. This should uninstall the library for you.

Permission-Related Issues

• Run Applets with codecLib Enabled
• On the Solaris platform, the following permission has to be added in the file java.policy located at $JRE/lib/security:

  permission java.io.FilePermission "/usr/bin/uname", "execute";

  For the other platforms, the codecLib version is enabled by default .

• File Permission for Decoding in Applets
• When files are to be accessed, either explicitly or implicitly, the permissions for the default temporary-file directory (defined by the system property "java.io.tmpdir") are necessary.  That is, add the following line into the proper policy file:

  permission java.io.FilePermission ${java.io.tmpdir}/*, "read,write,delete";

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Portions may be derived from Berkeley BSD systems, licensed from U. of CA. Sun, Sun Microsystems, the Sun logo, Java, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions.

Copyright 2004 Sun Microsystems, Inc. Tous droits réservés. Distribué par des licences qui en restreignent l'utilisation. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun. Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l'Université de Californie. Sun, Sun Microsystems, le logo Sun, Java, et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.