Java Advanced Imaging Installation Instructions

• System Requirements
• Downloading the archive files
• Installation Instructions
• Solaris operating environment installation instructions
• Microsoft Windows operating environment installation instructions
• Manual installation instructions
• After Java Advanced Imaging is installed
• Updating CLASSPATH, PATH, and LD_LIBRARY_PATH
• Uninstall Instructions

• For the Solaris operating environment:
• Solaris operating environment 2.5.1 or subsequent compatible version
• Java 2 platform (JDK 1.2 ) FCS or subsequent compatible version
• At least 8M bytes of free disk space for the SPARC edition, or at least 5M bytes of free disk space for the Intel edition
• Optionally, an additional 5M 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/NT 4.0
• Java 2 platform (JDK 1.2) FCS or subsequent compatible version
• At least 5M bytes of free disk space
• Optionally, an additional 5M bytes of free disk space for the sample code and images
• An additional 10M bytes may be needed temporarily during the installation process

Downloading the Archive Files

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


The downloaded bin files are executable files. In the Solaris operating environment, they are self-extracting shell scripts.

• For the SPARC edition, they are:
• jai1_0_2-lib-solsparc.bin
• jai1_0_2-sample-solsparc.bin
• For the Intel edition, they are:
• jai1_0_2-lib-solx86.bin
• jai1_0_2-sample-solx86.bin
The archive files are also available for download in separate pieces of 1.4 Mbytes each. These pieces have names ending in -a.bin, -b.bin, etc. These pieces must be reassembled into complete archive files before proceeding with the installation. 

The archive pieces may be reassembled into complete archive files using the commands: 

% cat jai1_0_2-lib-solsparc-?.bin > \
 jai1_0_2-lib-solsparc.bin
% cat jai1_0_2-sample-solsparc-?.bin > \
 jai1_0_2-sample-solsparc.bin

To extract the files from the archives: 

% cd $JDK1_2

where $JDK1_2 is the path into the jdk1.2 (or a higher version) directory, and $downloaddir is the directory into which you downloaded the .bin files.
• If you are on a SPARC-based system, run the commands:

% chmod u+x $downloaddir/jai1_0_2-lib-solsparc.bin
% $downloaddir/jai1_0_2-lib-solsparc.bin

If you wish to install the sample files, run the commands:

% chmod u+x $downloaddir/jai1_0_2-sample-solsparc.bin
% $downloaddir/jai1_0_2-sample-solsparc.bin

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

% chmod u+x $downloaddir/jai1_0_2-lib-solx86.bin
% $downloaddir/jai1_0_2-lib-solx86.bin

If you wish to install the sample files, run the commands:

% chmod u+x $downloaddir/jai1_0_2-sample-solx86.bin
% $downloaddir/jai1_0_2-sample-solx86.bin

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

IMPORTANT: If you do not "cd" to the JDK1.2 (or higher version) directory before performing the extraction, then JAI will not work correctly. 

• Microsoft Windows installation instructions


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

• jai1_0_2-lib-win.exe
• jai1_0_2-sample-win.exe
The archive files are also available for download in separate pieces of 1.4Mbytes each. These pieces have names ending in -a.exe, -b.exe, etc. These pieces must be reassembled into complete archive files before proceeding with the installation. The MS-DOS copy command may be used to reassemble the pieces into a single file. 

To reassemble the library archive pieces, run the following command from an MS-DOS (command prompt) window:

C:\> copy /b jai1_0_2-lib-win-a.exe +              jai1_0_2-lib-win-b.exe + jai1_0_2-lib-win-c.exe              jai1_0_2-lib-win.exe C:\> copy /b jai1_0_2-sample-win-a.exe +              jai1_0_2-sample-win-b.exe +              jai1_0_2-sample-win-c.exe + jai1_0_2-sample-win-d.exe              jai1_0_2-sample-win.exe


The commands are shown here on multiple lines for formatting reasons; they should each be entered on a single line. 
• To install the library files, double-click on the jai1_0_2-lib-win.exe icon and follow the directions.
• If you wish to install the sample files, double-click on the jai1_0_2-sample-win.exe icon and follow the directions.
You may delete the jai1_0_2-*.exe files after you are done with the extraction. 

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

• Manual installation instructions


In addition to the self-installing .bin files, the Solaris version of JAI is also available in the form of standard gzip compressed tar archives for manual installation. These may be used, for example, to experiment with JAI on unsupported platforms. Manual installation is to be done at your own risk; the directory structure and installation rules for Java extensions may differ from platform to platform. 

The tar.gz files are: 

• jai1_0_2-lib-solx86.tar.gz
• jai1_0_2-sample-solx86.tar.gz
To install, change directories to the root directory of the JDK and issue commands such as: 

% gunzip -c $downloaddir/jai1_0_2-lib-solsparc.tar.gz | tar xf -
% gunzip -c $downloaddir/jai1_0_2-sample-solsparc.tar.gz | tar xf -

to load the Solaris/SPARC files, or 

% gunzip -c $downloaddir/jai1_0_2-lib-solx86.tar.gz | tar xf -
% gunzip -c $downloaddir/jai1_0_2-sample-solx86.tar.gz | tar xf -

to install the Solaris/Intel files.

Java Advanced Imaging will be installed under the $JDK1_2 directory with the following files:

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

Since JAI is now installed as part of the Java 2 SDK's Java Runtime Environment, no CLASSPATH or LD_LIBRARY_PATH settings are required. 

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

c:\jdk1.2

C:\Program Files\JavaSoft\Jre\1.2

Developers need to be aware of this when working with the Java 2 SDK. Unless the path to the 1.2 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.

Uninstall Instructions

• Solaris operating environment

% cd $JDK1_2

where $JDK1_2 is the path into the jdk1.2 (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.0.2 and click on Add/Remove. This should uninstall the library for you.