Contents

• Platform 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
• Linux 32- and 64-bit Operating Environment Installation Instructions
• Microsoft Windows Operating Environment Installation Instructions
• Automatic Installation Instructions
• After Java Advanced Imaging Image I/O Tools is Installed
• Files installed in the JDK
• Registry Keys (Windows only)
• Updating CLASSPATH, PATH, and LD_LIBRARY_PATH
• Uninstall Instructions
• Permisson-Related Issues

System Requirements

Platform Requirements

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

Native Libraries

Download Instructions

Using your browser, download the appropriate bundles 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 files available for download are: 

Installation Type	Download Bundle
JDK Installation	jai_imageio-1_1-lib-solaris-sparc-jdk.bin
JRE Installation	jai_imageio-1_1-lib-solaris-sparc-jre.bin
CLASSPATH Installation	jai_imageio-1_1-lib-solaris-sparc.tar.gz

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

For the Intel edition, the available files are: 

Installation Type	Download Bundle
JDK Installation	jai_imageio-1_1-lib-solaris-i586-jdk.bin
JRE Installation	jai_imageio-1_1-lib-solaris-i586-jre.bin
CLASSPATH Installation	jai_imageio-1_1-lib-solaris-i586.tar.gz

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_1-lib-solaris-sparc-jdk.bin
% $downloaddir/jai_imageio-1_1-lib-solaris-sparc-jdk.bin

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

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

You may answer 'yes' to any questions about replacing files. You may delete the jai_imageio-1_1-*.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_1-lib-solaris-sparc-jre.bin
% $downloaddir/jai_imageio-1_1-lib-solaris-sparc-jre.bin

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

% chmod u+x $downloaddir/jai_imageio-1_1-lib-solaris-i586-jre.bin
% $downloaddir/jai_imageio-1_1-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. 

• Solaris 64-bit Operating Environment Installation Instructions

For the SPARC edition, the files available for download are: 

Installation Type	Download Bundle
JDK Installation	jai_imageio-1_1-lib-solaris-sparcv9-jdk.bin
JRE Installation	jai_imageio-1_1-lib-solaris-sparcv9-jre.bin
CLASSPATH Installation	jai_imageio-1_1-lib-solaris-sparcv9.tar.gz

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

For the AMD edition, the available files are: 

Installation Type	Download Bundle
JDK Installation	jai_imageio-1_1-lib-solaris-amd64-jdk.bin
JRE Installation	jai_imageio-1_1-lib-solaris-amd64-jre.bin
CLASSPATH Installation	jai_imageio-1_1-lib-solaris-amd64.tar.gz

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:

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

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

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

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

You may answer 'yes' to any questions about replacing files. You may delete the jai_imageio-1_1-*.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: 

• First install the 32-bit JDK version as described above.

% 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_1-lib-solaris-sparcv9-jre.bin
% $downloaddir/jai_imageio-1_1-lib-solaris-sparcv9-jre.bin

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

% chmod u+x $downloaddir/jai_imageio-1_1-lib-solaris-amd64-jre.bin
% $downloaddir/jai_imageio-1_1-lib-solaris-amd64-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_1 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)

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

Set CLASSPATH as follows: 

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

Unlike for the JRE and JDK installations, the 64-bit version Solaris platform bundles for CLASSPATH installation, jai_imageio-1_1-lib-sparcv9.tar.gz and jai_imageio-1_1-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.
• Linux 32- and 64-bit Operating Environment Installation Instructions

The files available for download are: 

Installation Type	Download Bundle
JDK Installation	jai_imageio-1_1-lib-linux-$ARCH-jdk.bin
JRE Installation	jai_imageio-1_1-lib-linux-$ARCH-jre.bin
CLASSPATH Installation	jai_imageio-1_1-lib-linux-$ARCH.tar.gz

where ARCH is either i586 for the 32-bit platform or amd64 for the 64-bit platform.

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_1-lib-linux-$ARCH-jdk.bin
% $downloaddir/jai_imageio-1_1-lib-linux-$ARCH-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_1-lib-linux-$ARCH-jre.bin
      % $downloaddir/jai_imageio-1_1-lib-linux-$ARCH-jre.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 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. 

• Microsoft Windows Installation Instructions

The objects available for download are executable (.exe) files: 

Installation Type	Download Bundle
JDK Installation	jai_imageio-1_1-lib-windows-i586-jdk.exe
JRE Installation	jai_imageio-1_1-lib-windows-i586-jre.exe
CLASSPATH Installation	jai_imageio-1_1-lib-windows-i586.exe

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 CLASSPATH version, double-click on the jai_imageio-1_1-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.1

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_1-lib-windows-i586-jre.exe icon and follow the directions. 

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

You may delete the jai_imageio-1_1-*.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:

Platform	Download Bundle	Contents
solaris-sparc	jai_imageio-1_1-lib-solaris-sparc-jar.zip	jai_imageio_solaris-sparc.jar
solaris-sparcv9	jai_imageio-1_1-lib-solaris-sparcv9-jar.zip	jai_imageio_solaris-sparcv9.jar
solaris-amd64	jai_imageio-1_1-lib-solaris-amd64-jar.zip	jai_imageio_solaris-amd64.jar
solaris-i586	jai_imageio-1_1-lib-solaris-i586-jar.zip	jai_imageio_solaris-i586.jar
linux-amd64	jai_imageio-1_1-lib-linux-amd64-jar.zip	jai_imageio_linux-amd64.jar
linux-i586	jai_imageio-1_1-lib-linux-i586-jar.zip	jai_imageio_linux-i586.jar
windows-i586	jai_imageio-1_1-lib-windows-i586-jar.zip	jai_imageio_windows-i586.jar

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.1
jai_imageio-Implementation-Version: 1.1
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.

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_imageio jai_imageio64
jai_imageio-Extension-Name: com.sun.media.imageio
jai_imageio-Specification-Version: 1.1
jai_imageio-Implementation-Version: 1.1
jai_imageio-Implementation-Vendor-Id: com.sun
jai_imageio-Implementation-URL: http://mydomain.com/jai_imageio_solaris-sparc.jar
jai_imageio64-Extension-Name: com.sun.media.imageio64
jai_imageio64-Specification-Version: 1.1
jai_imageio64-Implementation-Version: 1.1
jai_imageio64-Implementation-Vendor-Id: com.sun
jai_imageio64-Implementation-URL: http://mydomain.com/jai_imageio_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 Image I/O Tools is installed

Files installed in the JDK

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.

COPYRIGHT-jai_imageio.txt	Copyright notice.
UNINSTALL-jai_imageio	Uninstall script (Solaris and Linux operating environments only).
LICENSE-jai_imageio.txt	License agreement.
THIRDPARTYLICENSEREADME-jai_imageio.txt	License information for embedded third party software.
jre/lib/ext/jai_imageio.jar	JAR file containing core JAI Image I/O class files.
jre/lib/ext/clibwrapper_jiio.jar	codecLib JNI interfaces.
jre/lib/sparc/libclib_jiio.so	codecLib JNI shared libraries, C version. (Solaris operating environment, SPARC edition.)
jre/lib/sparc/libclib_jiio_vis.so	codecLib JNI shared libraries, VIS version. (Solaris operating environment, SPARC edition only.)
jre/lib/sparc/libclib_jiio_vis2.so	codecLib JNI shared libraries, VIS2 version. (Solaris operating environment, SPARC edition only.)
jre/lib/sparcv9/libclib_jiio.so	codecLib JNI shared libraries, C version. (Solaris operating environment, 64-bit SPARC edition.)
jre/lib/sparcv9/libclib_jiio_vis.so	codecLib JNI shared libraries, VIS version. (Solaris operating environment, 64-bit SPARC edition only.)
jre/lib/sparcv9/libclib_jiio_vis2.so	codecLib JNI shared libraries, VIS2 version. (Solaris operating environment, 64-bit SPARC edition only.)
jre/lib/amd64/libclib_jiio.so	codecLib JNI shared libraries. (Solaris operating environment, 64-bit AMD edition.)
jre/lib/i386/libclib_jiio.so	codecLib JNI shared libraries. (Solaris operating environment, Intel edition.)
jre/lib/amd64/libclib_jiio.so	codecLib JNI shared libraries. (Linux operating environment, 64-bit AMD edition.)
jre/lib/i386/libclib_jiio.so	codecLib JNI shared libraries. (Linux operating environment, Intel edition.)
jre/bin/clib_jiio.dll	codecLib JNI DLL libraries. (Microsoft Windows operating environment)
jre/bin/clib_jiio_sse2.dll	codecLib JNI DLL libraries, SSE2 version. (Microsoft Windows operating environment)
jre/bin/clib_jiio_util.dll	codecLib JNI DLL library utilities. (Microsoft Windows operating environment)

Registry Keys (Windows only)

The installer will insert the product key

HKEY_LOCAL_MACHINE\SOFTWARE\SUNW\JAI ImageIO Tools

into the registry. It will contain a value entry with name CurrentVersion and value 1.1. A sub-key

HKEY_LOCAL_MACHINE\SOFTWARE\SUNW\JAI ImageIO Tools\1.1

will be added with a value entry named JaiImageIOHome with its value set to the installation location of the JAI-Image I/O Tools binaries. In the case of the JDK and JRE installations this will be the root of the JDK or JRE, respectively, in which the binaries were installed; for the CLASSPATH installation it will be the top-level folder selected during installation.

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.1 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 2006 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 2006 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.