Java(TM) Advanced Imaging API Installation

Java Advanced Imaging

Contents

• System Requirements
• Download Instructions
• Installation Instructions
• Solaris Operating Environment Installation Instructions
• CLASSPATH Installation Instructions for Solaris/Linux
• Microsoft Windows Operating Environment Installation Instructions
• Linux Operating Environment Installation Instructions
• Sample Demos Installation Instructions
• 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 Solaris^TM operating environment:
• Solaris operating environment 2.6 or subsequent compatible version.
• Java^TM 2 platform, Standard Edition, v1.3.0 or later. (v1.3.1 or later for the Java^TM 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.
• Optionally, an additional 6M bytes of free disk space for the sample code and images
• An additional 10M bytes may be needed temporarily during the installation process
• For the Linux^TM operating system:
• Red Hat 6.2 or subsequent compatible version. See

Java^TM 2 SDK 1.3.1 for Linux Installation Notes
for more information on JVM system requirements for Linux.
• Java^TM 2 platform, Standard Edition, v1.3.0 or later.
• At least 6M bytes of free disk space.
• Optionally, an additional 6M bytes of free disk space for the sample code and images
• 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.
• Java^TM 2 platform, Standard Edition, v1.3.0 or later. (v1.3.1 or later for the Java^TM Plug-In.) 
• At least 7M bytes of free disk space
• Optionally, an additional 6M bytes of free disk space for the sample code and images
• 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: 

• jai-1_1_2-lib-solaris-sparc-jdk.bin
• jai-1_1_2-lib-solaris-sparc-jre.bin
• jai-1_1_2-lib-solaris-sparc.tar.gz
For the Intel edition, they are: 
• jai-1_1_2-lib-solaris-i586-jdk.bin
• jai-1_1_2-lib-solaris-i586-jre.bin
• 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:
• 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

• 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.)

• 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

• 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: 

• jai-1_1_2-lib-windows-i586.exe
• jai-1_1_2-lib-windows-i586-jre.exe
• 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: 

• jai-1_1_2-lib-linux-i586-jdk.bin
• jai-1_1_2-lib-linux-i586-jre.bin
• 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
      % $downloaddir/jai-1_1_2-lib-linux-i586-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. 
• Sample Demos Installation Instructions 

The downloaded files are: 

• jai-1_1_2-Unix-sample.tar.gz
• jai-1_1_2-windows-i586-sample.exe

 


If you wish to install the sample files on Solaris/Linux, run the command:

% gunzip -c $downloaddir/jai-1_1_2-Unix-sample.tar.gz | tar xf -

On Windows: double-click on the jai-1_1_2-windows-i586-sample.exe icon and follow the directions. 
• Automatic Installation of JAI

Sun has introduced a new feature into the Java Plug-In (JPI) starting with version 1.3. The JPI installs/replaces the Java extensions in your browser with an updated version. The JPI is installed automatically when Java from Sun is installed on Windows, and starting with Java 1.3, on Solaris too. If a user's browser runs a Java program requiring an Optional Package, the Plug-In can be made to automatically download and run the Optional Package's installer. For more information refer to:http://java.sun.com/products/plugin/1.3/docs/extensions.html

Thus, it is possible that your browser may attempt to install the latest JAI version into the java standard optional package directory $JRE1_3/lib/ext, when you view an HTML page with an auto-installation enabled JAI applet. In case of problems, check whether a desired version of jre/plugin is used. For example, it requires JRE 1.3.0 or later on Windows and JRE 1.3.1 or later on Solaris. See also (Updating CLASSPATH, PATH, and LD_LIBRARY_PATH) for usage of the correct version of JRE/plugin. 

The feature-enabled plugin downloads a signed jar which contains the special Manifest file and the appropriate installer according to platform. The jar file for Windows is now available for developers to download, test and use.

However, there are a couple of known issues with the older versions of the Plug-in. 

On Windows: A bug in the 1.3.0 version of the JPI keeps signatures from being verified. The user still sees a dialog where they "Grant" permission, but the certificate is never actually verified. Your installer will be downloaded and run without its authenticity being checked. JPI 1.3.1 fixes the problem. When you use JPI 1.3.1, you will notice that you get more information about the signing certificate. 

On Solaris: The Solaris Auto Installation jar requires the JPI v1.3.1 or later. 

After Java Advanced Imaging is installed

If the sample archive has been installed, the following files will also be installed:

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

Updating CLASSPATH, PATH, and LD_LIBRARY_PATH

For Solaris: 

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

For Windows: 

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

c:\jdk1.3

C:\Program Files\JavaSoft\jre\1.3

Developers need to be aware of this when working with the Java 2 SDK. Unless the path to the 1.3 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) 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.3\bin;     or
  c:\jdk1.3\jre\bin;     or 
  c:\jdk1.3\bin;

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 jar files in your installed directory 

Uninstall Instructions

• Solaris/Linux Operating Environment

% cd $JDK1_3

where $JDK1_3 is the path into the jdk1.3 (or a higher version) directory, where JAI was installed.

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

• 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 1.1.2 and click on Add/Remove. This should uninstall the library for you.

Permission-Related Issues

• Run Applets with MediaLib-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 mediaLib version is enabled by default .

• File Permission for Decoding in Applets
 
When FileCacheSeekableStream is used, 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";