Installing the Solaris SPARC JDK and JRE 1.2.1_03 Introduction: This release of the Solaris SPARC JDK and JRE 1.2 includes new Java class libraries and Java virtual machine featuring an improved Just-In-Time (JIT) compiler, fast synchronization and a generational memory system that accelerates garbage collection. Improved collection performance is achieved in part by requiring that native methods be implemented using the Java Native Interface introduced in JDK 1.1. This system does not support the original native method interface (NMI) in JDK 1.0. SUN MICROSYSTEMS INC. IS WILLING TO LICENSE THE LICENSED SOFTWARE TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THE LICENSE AGREEMENT. For more information, see "http://www.sun.com/solaris/java" Requirements: Solaris 2.6 or Solaris 7 plus the required patches from the table below. The patches in the table can be obtained from your service provider or downloaded from the Web. To download the patches, start at http://www.sun.com/solaris/java and follow the links to download the JDK; the patches are available on the same page as the JDK. The number in parenthesis in the Solaris Version column is the output from the command 'uname -r' on that version of Solaris. The two digit number following the dash in each Patch Id is the revision of that patch. The table lists the minimum patch revisions required by this release of the JDK and JRE; later revisions are acceptable. Solaris Version Patch Id Description ------------- --------- ----------- ------------------------------------ 2.6 (5.6) 105490-05 required Linker Patch 2.6 (5.6) 105568-13 required Libthread Patch 2.6 (5.6) 105210-17 required LibC Patch 2.6 (5.6) 106040-10 required X Input & Output Method Patch(2) 2.6 (5.6) 105633-21 required OpenWindows 3.6: Xsun Patch (1) 2.6 (5.6) 106409-01 required Fixes the Chinese TrueType fonts(3) 2.6 (5.6) 105181-11 recommended Kernel Update (socket close/hang) 2.6 (5.6) 105669-04 recommended CDE 1.2: libDTSvc Patch (dtmail) 7 (5.7) 106980-04 required Libthread Patch 7 (5.7) 107078-08 recommended OpenWindows 3.6.1 Xsun Patch (1) Notes: (1) - these patches are required in asian locales. (2) - this patch is required in japanese locales. (3) - this patch is required to display Traditional Chinese characters in Swing applications. It is recommended that Libthread patch be applied last. In addition to the patches listed here, you may also want to install the latest patch cluster for your version of Solaris, which includes additional recommended and security patches. Solaris patch clusters are available for download on the Web; follow the appropriate links starting at http://sunsolve.sun.com. Patch Installation: Use the command 'showrev -p' to list the patches installed on your system. If the required/recommended patches are not already installed, follow the steps below to install the necessary patches. Patch installation is simplest if the patch tar file is downloaded into an empty current working directory with at least 110MB of free space. (1) Extract the patch tar file that matches your version of Solaris (only one will apply to a given system): Solaris 2.6: $ tar xvf 1.2.1_03_patches_sparc_5.6.tar Solaris 7: $ tar xvf 1.2.1_03_patches_sparc_5.7.tar This will create a number of patch archives with names like .tar.Z. (2) Uncompress and extract each of the patch archives that you wish to install: $ uncompress .tar.Z $ tar xvf .tar A directory with a name like will be created for each patch. General instructions for patch installation are included in the Install.info file in the top-level directory of each patch. In addition, special installation instructions or post-installation requirements (such as a system reboot) appear in the README file included with each patch, along with a list of bug ids fixed and files changed by that patch. (3) Login to the system console as root. (4) Place the system in single-user mode (this step is not required, but is recommended for patch installation): # shutdown (5) Install the patches. Most patches can be installed using the commands below; however the Install.info and README files for each patch should be consulted. In the commands below, replace with the path to the directory where the patches were extracted. Solaris 2.6 and Solaris 7: # patchadd -M ... (6) Shutdown and reboot: # shutdown -i6 JDK/JRE Installation: The JDK is available either as a set of Solaris packages or as a self-extracting binary; the JRE is available as a self-extracting binary. Follow the instructions that match the form of the JDK/JRE you wish to install. JDK Installation - Solaris packages: Installation is simplest if the JDK tar file is downloaded into an empty current working directory. (1) Extract the contents of the compressed tar file: $ zcat 1.2.1_03_jdk_sparc.tar.Z | tar -xf - This will create a set of six files and four packages: README.sparc LICENSE.ps COPYRIGHT 1.2.1_03_Developer-Guide.ps 1.2.1_03_Release-Notes.ps 1.2.1_03_Release-Notes.html SUNWj2rt SUNWj2dev SUNWj2man SUNWj2dem README.sparc is this file; the LICENSE file is a copy of the license agreement. (2) Become root: $ su (3) Run the pkgadd command to install the packages: # pkgadd -d . SUNWj2rt SUNWj2dev SUNWj2man SUNWj2dem This will install the JDK into /usr/java1.2; see the pkgadd(1) and admin(4) man pages for information on installing the JDK in an alternate location. (4) Delete the tar files and extracted directories. (5) Exit the root shell. JDK/JRE Installation - Self-extracting binary: These instructions apply both to the JDK distributed as a self-extracting binary and the JRE. The example commands below use the JDK file names; for the JRE simply replace "JDK" with "JRE" in the directory and file names. (1) Make sure that execute permissions are set on the self-extracting binary: $ chmod +x Solaris_JDK_1.2.1_03_sparc.bin (2) Change directory to the location where you would like the files to be installed. (3) Run the self-extracting binary. The files will be installed in a subdirectory called Solaris_JDK_1.2.1_03. After the installation completes, the subdirectory can be renamed as needed. Example: $ chmod +x /tmp/Solaris_JDK_1.2.1_03_sparc.bin $ cd /export $ /tmp/Solaris_JDK_1.2.1_03_sparc.bin Unpacking... Checksumming... Extracting... Archive: ./install.sfx.1665 creating: Solaris_JDK_1.2.1_03/ ... Using the Java Development Kit 1.2: Before using the JDK or JRE, please verify that the patches required for your version of Solaris are installed. The required patches are listed above in the Requirements section. The easiest way to run JDK 1.2 is to update the PATH environment variable in your shell by placing the path to the java executables at the front, before /usr/bin. For example, if the JDK is installed in /usr/java1.2, (csh) setenv PATH "/usr/java1.2/bin:$PATH" (sh or ksh) PATH="/usr/java1.2/bin:$PATH" Alternatively, the executables may be run by specifying the full path name, e.g., /usr/java1.2/bin/javac, /usr/java1.2/bin/java, etc. See the section in the Release Notes titled "Running with Both JDK 1.2 and JDK 1.1" for information regarding making JDK 1.2 the default on your system. If JDK 1.2 is made the default, then the above changes to the PATH environment variable are no longer necessary. However, compatibility reasons may necessitate keeping JDK 1.1 as the default JDK. No other environment variables (such as JDK_HOME, JAVA_HOME or CLASSPATH) are required to run the JDK. However, existing settings of these variables may result in improper operation and should be checked for possible conflicts. Sending Feedback to Sun Microsystems: Please send any comments, observations or problem reports to the feedback mail address solaris_jdk12_feedback@Sun.COM. A response is not guaranteed, but all submissions will be read. Bugs should be reported to Sun Enterprise Services or your authorized service provider in order to receive the appropriate attention. We cannot guarantee an investigation of bugs reported using the solaris_jdk12_feedback@Sun.COM alias; however, if you would like to report a bug using this alias, please include: - the JDK/JRE version (java -version) - the Solaris version and hardware type (uname -a) - all the information necessary to reproduce the problem Copyright 1999 Sun Microsystems, Inc. All rights reserved. Copyright 1999 Sun Microsystems, Inc. Tous droits réservés.