Print-friendly Version

Contents

System Requirements
Java 2 SDK Installation Instructions
   Installation of Self-Extracting Binary
   Installation of RPM File
Java Plug-in Browser Registration Instructions
Java Web Start Installation Notes
Troubleshooting
Known Problems on Non-Supported Platforms

System Requirements

You should have about 75 megabytes of free disk space before attempting to install the Java 2 SDK software.

A minimum of 32 megabytes of RAM is required. Recommended 48 megabytes of RAM.

For issues, see the Troubleshooting section below and the Linux Notes section of the Release Notes. Also available is Known Problems on Non-Supported Platforms.

Installation Instructions

• Java Plug-in Browser Registration Instructions
• Java Web Start Installation Notes

• Self-extracting Binary File - This file can be used to install the Java 2 SDK in a location chosen by the user. This one can be installed by anyone (not only root users), and it can easily be installed in any location. As long as you are not root user, it cannot displace the system version of the Java platform suppled by Linux. To use this file, see Installation of Self-Extracting Binary below.
• RPM Packages - A rpm.bin file containing RPM packages, installed with the rpm utility. Requires root access to install, and installs by default in a location that replaces the system version of the Java platform supplied by Linux. To use this bundle, see Installation of RPM File below.

Note: For any text on this page containing the following notation, you must substitute the appropriate Java 2 SDK update version number for the notation.

<version>
    

For example, if you are downloading update 1.4.2_01, the following command:

./j2sdk-1_4_2_<version>-linux-i586.bin
    

would become:

./j2sdk-1_4_2_01-linux-i586.bin
    

1. Download and check the download file size to ensure that you have downloaded the full, uncorrupted software bundle.

You can download to any directory you choose; it does not have to be the directory where you want to install the Java 2 SDK.

Before you download the file, notice its byte size provided on the download page on the web site. Once the download has completed, compare that file size to the size of the downloaded file to make sure they are equal.

Run this command:
chmod +x j2sdk-1_4_2_<version>-linux-i586.bin

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

The next step installs the Java 2 SDK into the current directory.

4. Run the self-extracting binary.

Execute the downloaded file, prepended by the path to it. For example, if the file is in the current directory, prepend it with "./" (necessary if "." is not in the PATH environment variable):

./j2sdk-1_4_2_<version>-linux-i586.bin

The binary code license is displayed, and you are prompted to agree to its terms.

The Java 2 SDK files are installed in a directory called j2sdk1.4.2_<version> in the current directory. Follow this link to see its directory structure. The Java 2 SDK documentation is a separate download.

Note about Root Access: Unbundling the software automatically creates a directory called j2sdk1.4.2_<version>. Note that if you choose to install the Java 2 SDK into system-wide location such as /usr/local, you must first become root to gain the necessary permissions. If you do not have root access, simply install the Java 2 SDK into your home directory, or a subdirectory that you have permission to write to.

Note about Overwriting Files: If you unpack the software in a directory that contains a subdirectory named j2sdk1.4.2_<version>, the new software overwrites files of the same name in that j2sdk1.4.2_<version> directory. Please be careful to rename the old directory if it contains files you would like to keep.

Note about System Preferences: By default, the installation script configures the system such that the backing store for system preferences is created inside the Java 2 SDK's installation directory. If the SDK is installed on a network-mounted drive, it and the system preferences can be exported for sharing with Java runtime environments on other machines. As an alternative, root users can use the -localinstall option when running the installation script, as in this example:

j2sdk-1_4_2_<version>-linux-i586.bin -localinstall

This option causes the system preferences to be stored in the /etc directory from which they can be shared only by VMs running on the local machine. You must be root user for the -localinstall option to work.

See the Preferences API documentation for more information about preferences in the Java platform.

Installation of RPM File

1. Download and check the file size.

You can download to any directory you choose.

Before you download the file, notice its byte size provided on the download page on the web site. Once the download has completed, compare that file size to the size of the downloaded file to make sure they are equal.

2. Extract the contents of the downloaded file.

Change directory to where the downloaded file is located and run these commands to first set the executable permissions and then run the binary to extract the RPM file:

chmod a+x j2sdk-1_4_2_<version>-linux-i586-rpm.bin

./j2sdk-1_4_2_<version>-linux-i586-rpm.bin
  

Note that the initial "./" is required if you do not have "." in your PATH environment variable.

The script displays a binary license agreement, which you are asked to agree to before installation can proceed. Once you have agreed to the license, the install script creates the file j2sdk-1_4_2_<version>-linux-i586.rpm in the current directory.

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

4. Run the rpm command to install the packages that comprise the Java 2 SDK:

rpm -iv j2sdk-1_4_2_<version>-linux-i586.rpm
  

6. Exit the root shell.

Java Plug-in Browser Registration Instructions

http://java.sun.com/j2se/1.4.2/docs/guide/plugin/index.html

There are two ways to register the Java Plug-in product with the Netscape browser. Click on the following buttons to see the instructions for either manual or automatic (via the ControlPanel) registration. For Netscape 7, Mozilla, or the SuSE 8.1 or higher version of Mozilla, use only the manual registration instructions. Note that Mozilla (non-SuSE version) must be 1.1 or higher.

Java Web Start Installation Notes

This SDK release includes Java Web Start; it is installed automatically with the SDK. But note the following:

• Compatibility: The release of Java Web Start that comes with this SDK/JRE can be run on SDK/JRE 1.2.2 or later. It will not work with SDK/JRE 1.1.x or earlier.
• Upgrading from Previous Versions: If you have a previous release of Java Web Start, do not uninstall it. Uninstalling it will cause the download cache to be cleared, and all previously installed Java Web Start applications will have to be downloaded again. This new release will overwrite previous installations and automatically update browsers to use this new release. The configuration files and program files folder used by Java Web Start have not changed, so all your settings will remain intact after the upgrade.
• Using Java Web Start with Netscape 6.x/7.x: For Netscape 6.x/7.x users, setup the Java Web Start MIME type (JNLP) in the Edit->Preferences->Navigator->Helper Applications section. The file extension is jnlp; MIME Type is application/x-java-jnlp-file. It should be handled by the javaws executable file in your Java Web Start directory. Also note that, due to a problem with the JavaScript in Netscape 6.x/7.x, you must use the non-JavaScript version of the demos page

• To print on Linux, the /usr/sbin/lpc utility must be installed. This is a standard Linux utility. On Red Hat 7.1, for example, this utility is in the "LPRng-3.7.4-22 RPM" package.

The following are known problems on the non-supported versions of Linux.

• Red Hat 6.2 - On any version of Linux whose kernel was compiled with the CONFIG_IP_TRANSPARENT_PROXY option, behavior in comformance with the API specification is not guaranteed while running as superuser. The default kernel shipped with the Red Hat 6.2 distribution is compiled with this option. To avoid incompatibilities associated with this problem, either do not use the Java platform while superuser or else upgrade to a Linux operating system whose kernel was not compiled with the CONFIG_IP_TRANSPARENT_PROXY option. Red Hat 7.1 and later versions ship with the version 2.4 kernel which does not have this problem.
• Red Hat 7.0 - When System.exit(int) is invoked, the program never exits with a non-zero value. This problem is apparently due to a bug in the exit function in libc.so library. To avoid this problem, use Red Hat 6.2 or Red Hat 7.1 rather than 7.0.
• Red Hat Linux 7 Server - You must manually install compat-libstdc++-6.21-2.9.0.0.i386.rpm to prevent "error while loading shared libraries" when using the Java HotSpot VMs. This file is located in the /RedHat/RPMS directory on the Red Hat Linux 7 CD-ROM. You may also obtain a copy of this file from http://rpmfind.net. To install the file, use this command:

  rpm --install compat-libstdc++-6.21-2.9.0.0.i386.rpm
  

  It is not necessary to manually install compat-libstdc++-6.21-2.9.0.0.i386.rpm if you are using Red Hat Linux 7 Workstation.

• Checking glibc - You can check your version of glibc using the following command:

  ls /lib/libc-*
  

• glibc 2.2-7 - An apparent bug in glibc 2.2-7 causes invalid hostnames of the form a.b.c.d.e to be resolved as a valid address. This bug means that, on platforms that use glibc 2.2-7, methods such as java.net.InetAddresss.getByName(String host) do not always throw UnknownHostException, as they should, when the hostname is invalid.