Installation Notes JavaTM 2 SDK, Standard Edition Version 1.3.1 SolarisTM 2.6, 7, 8 Operating Environment

System Requirements

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 Solaris Font Package Requirements for information about which font packages should be on your system.

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 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 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.
  Note: The tar files containing Solaris packages are available for download from the Sun Download Center on www.sun.com.

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:

j2sdk-1_3_1-solsparc.sh   26638917 bytes

j2sdk-1_3_1-solx86.sh     24698506 bytes

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

On SPARC:
chmod +x j2sdk-1_3_1-solsparc.sh

On x86:
chmod +x j2sdk-1_3_1-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. After the installation is finished, the subdirectory can be renamed as desired.

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 above.

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

j2sdk-1_3_1-solsparc.tar.Z    37770767 bytes

j2sdk-1_3_1-solx86.tar.Z      35202328 bytes

2. Extract the contents of the compressed tar file:

On SPARC:
zcat j2sdk-1_3_1-solsparc.tar.Z | tar -xf -

On x86:
zcat j2sdk-1_3_1-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 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 J2SDK 1.3.1. 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 /usr/j2se J2SDK 1.3.1 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 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.

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/

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 all 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 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 versions of the Java platform. See the online compatibility documentation for information about incompatibilities between J2SDK 1.2 and J2SDK 1.3.

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

Copyright © 2001 Sun Microsystems, Inc. All Rights Reserved.