Print-friendly Version

System Requirements

You should insure that you have installed the full set of required patches needed for support of this release.

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 also the note about the location of the Java HotSpot libjvm.so files.

The J2SDK 1.3.1, 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.

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

  Note: The tar files containing Solaris packages are available for download from the Sun Download Center on www.sun.com.

       <version number>

      chmod +x j2sdk-1_3_1_<version number>-solsparc.bin

      chmod +x j2sdk-1_3_1_01-solsparc.bin

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, see Installation of Packages.

1. Check the download file size

Before you download a file, notice that its byte size is provided on the download page. Once the download has completed, check that you have downloaded the full, uncorrupted software file.

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

On SPARC:
chmod +x j2sdk-1_3_1_<version number>-solsparc.sh

On x86:
chmod +x j2sdk-1_3_1_<version number>-solx86.sh

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

4. Run the self-extracting binary.

Launch the self-extracting binary file. The binary code license will be displayed, and you will be prompted to agree to its terms. The Java 2 SDK files will be installed in a subdirectory called j2sdk1_3_1_<version number>. After the installation is finished, the subdirectory can be renamed as desired.

Installation of Packages

Note: The tar files containing Solaris packages are available for download from the Sun Download Center on www.sun.com.

Use these instructions if you want to use the pkgadd 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.

1. Check the download file size

Before you download a file, notice that its byte size is provided on the download page. Once the download has completed, check that you have downloaded the full, uncorrupted software file.

2. Extract the contents of the compressed tar file:

On SPARC:
zcat j2sdk-1_3_1_<version number>-solsparc.tar.Z | tar -xf -

On x86:
zcat j2sdk-1_3_1_<version number>-solx86.tar.Z | tar -xf -

This will create seven packages (SUNWj3dmo, SUNWj3dev, SUNWj3man, SUNWj3rt, plus three packages containing Japanese man pages: SUNWjej3m, SUNWjpj3m, and SUNWjuj3m) along with the product license, README, and other release documentation.

3. Become root by running su and entering the super-user password.

4. Uninstall Previous Installation of J2SDK 1.3.0

Note: The default installation location for J2SDK 1.3.1 versions is /usr/j2se. That is the same location in which J2SDK 1.3.0 is installed. In this step you will uninstall J2SDK 1.3.0 to clear the way for the installation of a J2SDK 1.3.1 version. Skip this step if you have not previously installed J2SDK 1.3.0 or if you intend to install J2SDK 1.3.1 in a non-default location.

If you have previously installed the packages for J2SDK 1.3.0, remove them.

pkgrm SUNWj3dmo SUNWj3man SUNWj3dev SUNWj3rt

If your /usr/java symbolic link was pointing to the J2SDK 1.2.2 installation at /usr/java1.2, you may want to update it to point to /usr/j2se where the J2SDK 1.3.1 version will be installed.

5. Run the pkgadd command to install the packages:

pkgadd -d . SUNWj3rt SUNWj3dev SUNWj3man SUNWj3dmo

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

6. For Japanese users, run the pkgadd command to install the Japanese man page packages:

pkgadd -d . SUNWjej3m SUNWjpj3m SUNWjuj3m

7. Delete the tar files and extracted directories.

8. Exit the root shell.

Java Plug-in Product Installation Instructions

For documentation on the Java Plug-in product, see

http://java.sun.com/products/plugin/1.3.1/index.html

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

On SPARC platforms, the default location of javaplugin.so for the package installation is in this directory: /usr/j2se/jre/plugin/sparc/ns4/

On Intel platforms, the default location is this directory: /usr/j2se/jre/plugin/i386/ns4/

 

1. The location of the Plug-in (javaplugin.so) should be give with an absolute path—not relative to the installation location of the JRE. 2. Setting NPX_PLUGIN_PATH will override the default search path used by the browser. Therefore any plugin directories that the browser currently searches for plugins should also be added to the path.

2. For Netscape 6 browsers: Create a symbolic link in the Netscape plugins directory

If (and only if) you are using Netscape 6, you will need to create a symbolic link in the Netscape plugins directory to the path of the libjavaplugin_oji.so file. In the package installation of J2SDK 1.3.1, this file is located at /usr/j2se/jre/plugin/<arch>/ns600/libjavaplugin_oji.so, where <arch> is either sparc or i386, depending on your platform. For example:

cd ${NETSCAPE6}/bin/plugins
ln -s ${JRE}/plugin/sparc/ns600/libjavaplugin_oji.so.

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

4. For Netscape 4.x 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 J2SDK 1.2.2 were installed, making JDK 1.1 the default Java platform. Starting with the Solaris 8 release, the /usr/java symbolic link points to /usr/java1.2 by default if both JDK 1.1 and J2SDK 1.2.2 are installed, making J2SDK 1.2.2 the default Java platform.

Because 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 Java installation seen by most users. Many Java applications run on any of J2SDK 1.3.1, J2SDK 1.2.2, or JDK 1.1, but users and applications might want to be selective about which Java installation they use.

If you want to use JDK 1.1, /usr/java1.1/bin should be on your PATH before /usr/bin. If you want to use J2SDK 1.3.1, /usr/j2se/bin should be on your PATH before /usr/bin.

It is possible for root users to make J2SDK 1.3.1 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