--------------------------------------------------------------- --------------------------------------------------------------- Products listed on this page have completed the Sun End of Life process. These products are no longer supported by Sun. For developer requirements, products that have completed the EOL transition period have moved to the Archive area. Users should upgrade to current product versions. Links below may have been disabled, please see the Archive for documentation available for download. --------------------------------------------------------------- --------------------------------------------------------------- -------------------------------------------------------------------------- Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, California 94303, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in this product. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and other countries. This product is distributed under licenses restricting its use, copying distribution, and decompilation. No part of this product may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Sun, Sun Microsystems, the Sun logo, Java and the Java Coffee Cup logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon architecture developed by Sun Microsystems, Inc. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions. -------------------------------------------------------------------------- Installing the Java 2 SDK and Runtime Environment Version 1.3.0_05 Introduction: ------------- Version 1.3.0_05 is an update release of the Java 2 SDK, Standard Edition (J2SE) v1.3.0 and the associated Java 2 Runtime Environment and contains fixes for a select list of bugs. The first update release 1.3.0_01 contained new enhancements to the Java Plug-in as well as bug fixes. 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 about this release, see the release notes ( http://java.sun.com/j2se/1.3.0/ReleaseNotes.html ) and J2SE documentation ( http://java.sun.com/j2se/1.3.0/docs/ ). Requirements: ------------- Solaris 2.6, Solaris 7, or Solaris 8 plus the required patches from the table below. Information regarding patches is revised occasionally as new patches are added to the list of recommended and required patches. For the latest information about recommended and required patches and any requirements in the order in which patches must be installed for the Java 2 SDK, see the appropriate section at: http://java.sun.com/j2se/1.3.0/install-solaris-patches.html Download tar bundles containing the patches are provided on the J2SE download site. The patches also can be obtained from your service provider or downloaded individually from the SunSolve web site http://sunsolve.sun.com. Use the SunSolve web site search facility to search for the patch number. 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 patch revisions which this release of J2SE was tested with; later patch revisions are expected to work also. Solaris Version Patch Id Note Description ------------- --------- ----------- ----- ----------------------------- 2.6 (5.6) 107734-09 required Linker Patch 2.6 (5.6) 105569-23 required Libthread Patch 2.6 (5.6) 105211-39 required LibC Patch 2.6 (5.6) 106041-15 required X Input & Output Method Patch 2.6 (5.6) 106248-44 required (1,4,5) OpenWindows 3.6: Xsun Patch 2.6 (5.6) 106410-01 required (2) Fixes the Chinese TrueType fonts 2.6 (5.6) 108642-03 required (3) SunOS 5.6_x86: fatal error in ISO8859-01 locales 2.6 (5.6) 106844-05 required (4) Euro currency support 2.6 (5.6) 105200-12 required (4) Keytables Patch 2.6 (5.6) 105182-27 required Kernel Update (socket close/hang) 2.6 (5.6) 105670-09 recommended CDE 1.2: libDTSvc Patch (dtmail) 2.6 (5.6) 105285-41 recommended Motif 1.2.7_x86: Runtime library patch 2.6 (5.6) 104678-08 required C++ shared library patch 2.6 (5.6) 106126-11 required Patch for patchadd and patchrm 7 (5.7) 106981-17 required Libthread Patch 7 (5.7) 108377-25 required (1,5) OpenWindows 3.6.1 Xsun Patch 7 (5.7) 107637-08 required X Input & Output Method Patch 7 (5.7) 107152-01 required (1) Replaces bad font in zh.GBK locale 7 (5.7) 107657-06 required OpenWindows 3.6.1_x86: ERC X11R6.4 Extension Patch 7 (5.7) 106542-17 required Kernel update 7 (5.7) 107545-03 required Used with kernel update patch 7 (5.7) 106951-13 required Linker Patch 7 (5.7) 106328-09 required Shared library patch for C++. 7 (5.7) 107082-33 required Motif 1.2 and 2.1 patch 7 (5.7) 107227-18 required CDE 1.3_x86: dtwm patch 7 (5.7) 108375-05 required CDE 1.3_x86: libDtWidget Patch 7 (5.7) 107703-08 required CDE 1.3_x86: dtsession patch 8 (5.8) 108941-25 required Motif 2.1 patch -- available soon from SunSolve. 8 (5.8) 108653-30 required X11 6.4.1_x86: Xsun patch 8 (5.8) 108922-12 required CDE 1.4_x86: dtwm patch Notes: (1) - this patch is required in asian locales. (2) - this patch is required to display Traditional Chinese characters in Swing applications. (3) - this patch is required for any locale which uses the ISO8859-1 or ISO8859-15 character encoding (4) - this patch is required for support of Euro currency (5) - required for running Java Compatibility Kit tests 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 130MB 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 j2sdk-1_3_0_05-solx86-5_6_patch.tar Solaris 7: $ tar xvf j2sdk-1_3_0_05-solx86-5_7_patch.tar Solaris 8: $ tar xvf j2sdk-1_3_0_05-solx86-5_8_patch.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. # patchadd -M ... (6) Shutdown and reboot: # shutdown -i6 FONT Packages requirement: -------------------------- Different locales may require different character encodings. You should check the table below to see what Solaris Font Packages you may need on your system. The utility "pkginfo" can be used to list the packages you have installed on your system. Required Solaris Font Packages For Java 2 on Solaris ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Java Encoding Font Locales supported by encoding Locale Packages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ***ALL*** iso-8859-1 SUNWi1of, ***Required for all locales*** SUNWxwfnt (and sufficient for most Western European locales.) *_EURO iso-8859-15 SUNWi15rf(3) Euro currency locale variants cs,hu,pl iso-8859-2 SUNWi2of, Czech Republic, Hungary, Poland, SUNWi2rf(1) Slovakia, Albania, Bosnia, Croatia, Romania, Slovenia lt,lv iso-8859-4 SUNWi4of, Latvia, Lithuania (Solaris 2.6 and 7) SUNWi4rf lt,lv iso-8859-13 SUNWi13rf Latvia, Lithuania (Solaris 8) ru iso-8859-5 SUNWi5of Russia, Bulgaria, Macedonia, Serbia el iso-8859-7 SUNWi7of, Greece SUNWi7rf tr iso-8859-9 SUNWi9of, Turkey SUNWi9rf ja jisx0201, SUNWjxcft, Japan jisx0208, SUNWjxmft(2) jisx0212 ko ksc5601 SUNWkcoft Korea zh_CN gb2312 SUNWcttf China (PRC) zh_TW cns11643 SUNWhttf China (Taiwan) zh_TW_Big5 big5 SUNW5ttf(4) China (Taiwan) BIG5 zh_GBK gbk SUNWgttf China (PRC) GBK *_UTF-8 utf-8 SUNW5ttf,SUNWcttf, All UTF-8 locales (Solaris 8) SUNWi15rf,SUNWi2of, SUNWi4of,SUNWi4rf, SUNWi5of,SUNWi7of, SUNWi7rf,SUNWi9of, SUNWi9rf,SUNWjxcft, SUNWjxmft(2),SUNWkttf Notes: (1) SUNWi2rf is needed for Solaris 2.6 and 7. (2) SUNWjxmft is needed for Solaris 8. (3) Euro locale fonts for Solaris 2.6 are supplied with the Euro currency support patches instead. (4) SUNW5ttf is available for Solaris 7 and 8. SDK/JRE Installation: --------------------- The Java 2 SDK 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 SDK/JRE you wish to install. For the most up-to-date information related to installation, see the online installation notes at http://java.sun.com/j2se/1.3.0/install-solaris.html SDK Installation - Solaris packages: ------------------------------------ Installation is simplest if the SDK tar file is downloaded into an empty current working directory. (1) Extract the contents of the compressed tar file: $ zcat j2sdk-1_3_0_05-solx86.tar.Z | tar -xf - This will create a set of five files and four packages: README.i386 LICENSE COPYRIGHT DeveloperGuide.ps ReleaseNotes.html SUNWj3rt SUNWj3dev SUNWj3man SUNWj3dmo README.i386 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 . 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. (4) Delete the tar files and extracted directories. (5) Exit the root shell. SDK/JRE Installation - Self-extracting binary: ---------------------------------------------- These instructions apply both to the SDK distributed as a self-extracting binary and the JRE. The example commands below use the SDK file names; for the JRE simply replace "j2sdk" with "j2re" in the directory and file names. (1) Make sure that execute permissions are set on the self-extracting binary: $ chmod +x j2sdk-1_3_0_05-solx86.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 j2sdk1_3_0_05. After the installation completes, the subdirectory can be renamed as needed. Example: $ chmod +x /tmp/j2sdk-1_3_0_05-solx86.bin $ cd /export $ /tmp/j2sdk-1_3_0_05-solx86.bin Unpacking... Checksumming... Extracting... Archive: ./install.sfx.1665 creating: j2sdk1_3_0_05/ ... Using the Java 2 SDK 1.3: ------------------------- Before using the Java 2 SDK or Java 2 Runtime Environment, 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 the Java 2 SDK 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 SDK is installed in /usr/j2se, (csh) setenv PATH "/usr/j2se/bin:$PATH" (sh or ksh) PATH="/usr/j2se/bin:$PATH" Alternatively, the executables may be run by specifying the full path name, e.g., /usr/j2se/bin/javac, /usr/j2se/bin/java, etc. No other environment variables (such as JDK_HOME, JAVA_HOME or CLASSPATH) are required to run the SDK. 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-java-feedback@Eng.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-java-feedback@Eng.Sun.COM alias; however, if you would like to report a bug using this alias, please include: - the SDK/JRE version (java -version) - the Solaris version and hardware type (uname -a) - the patches installed on the system (showrev -a) - all the information necessary to reproduce the problem -------------------------------------------------------------------------- Copyright 2001 Sun Microsystems, Inc. All rights reserved. --------------------------------------------------------------------------