Print-friendly Version

Installation Instructions

Prior to installing the Java 2 SDK, you should insure that you have installed the full set of required patches needed for support of this release. See Solaris Patch Installation before proceeding. See also the note about the location of the Java HotSpot libjvm.so files.

The Java 2 SDK, Standard Edition, v1.3.0, is available in two installation formats.

• A self-extracting binary file which can be used to install the Java 2 SDK in a location chosen by the user. If you are using this file, see Self-Extracting Binary below.

• A .tar.Z file containing Solaris packages to be installed with the pkgadd utility. If you are using this bundle, see Installation of Packages below.

Installation of Self-Extracting Binary

Use these instructions if you want to use the self-extracting binary file to install the Java 2 SDK. If you want to install Solaris packages comprising the SDK, use Installation of Packages below.

1. Check the download file size to ensure that you have downloaded the full, uncorrupted software bundle:

j2sdk1_3_0-solsparc.bin   25056706 bytes

j2sdk1_3_0-solx86.bin     23250922 bytes

2. Make sure that execute permissions are set on the self-extracting binary:

On SPARC:
chmod +x j2sdk1_3_0-solsparc.bin

On x86:
chmod +x j2sdk1_3_0-solx86.bin

3. Change directory to the location where you would like the files to be installed.

4. Run the self-extracting binary.

The files will be installed in a subdirectory called j2sdk1_3_0. After the installation is finished, the subdirectory can be renamed as desired.

Use these instructions if you want to use the pkdadd utility to install the Solaris packages for the Java 2 SDK. If you want to use the self-extracting binary file instead, see Self-extracting Binary above.

1. Check the download file size to ensure that you have downloaded the full, uncorrupted software bundle:

j2sdk1_3_0-solsparc.tar.Z    35968462 bytes

j2sdk1_3_0-solx86.tar.Z      33393677 bytes

2. Extract the contents of the compressed tar file:

On SPARC:
zcat j2sdk1_3_0-solsparc.tar.Z | tar -xf -

On x86:
zcat j2sdk1_3_0-solx86.tar.Z | tar -xf -

This will create four packages (SUNWj3dmo, SUNWj3dev, SUNWj3man, and SUNWj3rt) along with the product license, README, and other release documentation.

Note: The package for the J2SE demos has changed names. In this release it is named SUNWj3dmo; previously it was named SUNWj3dem.

3. Become root:

su

4. Uninstall Previous Installation of J2SE 1.3 Beta or Beta Refresh

Skip this step if you have not previously installed J2SE 1.3 Beta or Beta Refresh.

If you have previously installed the packages for the Beta or Beta Refresh releases of J2SE 1.3, remove them.

pkgrm SUNWj2dem SUNWj2man SUNWj2dev SUNWj2rt

If your /usr/java symbolic link was pointing to /usr/java1.2, you may want to update it to point to another Java platform, either /usr/java1.1 for JDK 1.1.x or /usr/j2se for J2SE 1.3.

5. Run the pkgadd command to install the packages:

pkgadd -d . SUNWj3rt SUNWj3dev SUNWj3man SUNWj3dmo

This will install the SDK into /usr/j2se; see the pkgadd(1) and admin(4) man pages for information on installing the SDK in an alternate location.

6. Delete the tar files and extracted directories.

7. Exit the root shell.

1. Set the NPX_PLUGIN_PATH environment variable to the directory containing the javaplugin.so file.

On SPARC, for example, the directory of javaplugin.so in the default installation location will be /usr/j2se/jre/plugin/sparc

2. For Netscape browsers: Start your Netscape browser, or restart it if it is already up.

3. For Netscape browsers: Restart your browser a second time.

Restarting the browser a second time is necessary because of bug 4358142.

jre/lib/sparc/client/libjvm.so (on SPARC)
jre/lib/i386/client/libjvm.so (on x86)

jre/lib/sparc/server/libjvm.so (on SPARC)
jre/lib/i386/server/libjvm.so (on x86)

Prior to the Solaris 8 release, the /usr/java symbolic link pointed to /usr/java1.1 if both JDK 1.1 and J2SE 1.2.2 were installed. Starting wi th the Solaris 8 release, the /usr/java symbolic link points to /usr/java1.2 by default if both JDK 1.1 and J2SE 1.2.2 are installed.

Since there are symbolic links in /usr/bin (also known as /bin ) that use /usr/java (for example, /usr/bin/java refers to /usr/java/bin/java), this /usr/java link can change the default J ava installation seen by most users. Many Java applications run on any of J2SE 1 .3.0, J2SE 1.2.2, or JDK 1.1, but users and applications might want to be select ive about which Java installation they use.

Java users that want to use JDK 1.1 should add /usr/java1.1/bin to their PATH settings before /usr/bin. Java users that want to use J2SE 1.3.0 should add /usr/j2se/bin to their PATH settings before /usr/bin. Also, depending on the situation, you might need to make changes to other environment variables such as CLASSPATH, LD_LIBRARY_PATH, or JAVA_HOME, although none of these environment variables are required.

It is possible for root users to make J2SE 1.3.0 the default Java platform by modifying the /usr/java symbolic link to point to /usr/j2se. However, changing the symbolic link in this manner may cause problems for some Java applications that are expecting to use earlier versions of the Java platform. See the online compatibility documentation for incompatibilities between J2SE 1.2 and J2SE 1.3.

http://java.sun.com/j2se/1.3/compatibility.html