Print-friendly Version

README

Java 2 Runtime Environment, Standard Edition
v 1.2.2

The Java 2 Runtime Environment contains the Java virtual machine, runtime class libraries, and Java application launcher that are necessary to run programs written in the Java progamming language. It is not a development environment and does not contain development tools such as compilers or debuggers. For development tools, use the Java 2 SDK, Standard Edition. The Java 2 SDK version 1.2.2 is available for free download from the Java Software web site

The Win32 version of the Java 2 Runtime Environment includes the Java Plug-in product which enables support for the Java 2 platform on recent releases of Netscape Navigator and Microsoft Internet Explorer. When you install the Java 2 Runtime Environment, you can install the Plug-in as well. For more information, including information about the Java Plug-in for the Solaris Operating Environment, see the Plug-in web page.

The Win32 version of the Java 2 Runtime Environment includes a Symantec JIT compiler, Copyright (c) 1996-1999 by Symantec Corporation. All rights reserved.

This release of the Java 2 Runtime Environment, Standard Edition, v 1.2.2 for Linux does not include Java Plug-in. Future plans call for a Linux port of Java Plug-in and inclusion of it as part of the Linux JRE.

Deploying Applications with the Java 2 Runtime Environment

A Java-technology application, unlike an applet, cannot rely on a web browser for installation and runtime services. When you deploy an application written in the Java programming language, your software bundle will probably consist of the following parts:

• Your own class, resource, and data files.
• A runtime environment.
• An installation procedure or program.

You already have the first part, of course. The remainder of this document covers the other two parts.

Runtime Environment

To run your application, a user needs a Java virtual machine, the Java platform core classes, and various support programs and files. This collection of software is known as a runtime environment.

The Java 2 SDK software can serve as a runtime environment. However, you probably cannot assume your users have the Java 2 SDK software installed, and your Java 2 SDK software license doesn't allow you to redistribute SDK software files.

To solve this problem, Sun provides the Java 2 Runtime Environment as a free, redistributable runtime environment, available for Win32 and Solaris systems. (The Java 2 runtime environment should not be confused with the Java 2 SDK's own internal, non-redistributable version of the runtime environment housed in the jdk1.2.2/jre directory.)

The Win32 version of the Java 2 Runtime Environment comes with a built-in installation program suitable for end-users. Solaris versions require the developer to provide installation support.

The Java 2 Runtime Environment for Win32 is available both with and without international support. The non-international version is much smaller, but is suitable only for English-speaking users.

The final step in the deployment process occurs when the software is installed on individual user system. Installation consists of copying software onto the user's system, then configuring the user's system to support that software.

This step includes installing and configuring the runtime environment. If you use the Java 2 Runtime Environment, you must make sure that your installation procedure never overwrites an existing installation, unless the existing runtime environment is an older version.

The Win32 version of the Java 2 Runtime Environment is distributed as a self-installing executable. A simple way to redistribute the Java 2 Runtime Environment is to include this executable in your software bundle. You can then have your installation program run the executable, or simply instruct the user to install the Java 2 Runtime Environment before installing the rest of your bundle.

The Win32 installation program records program information in the Microsoft Windows Registry. This registry information includes the software version, which you should compare with the Java 2 Runtime Environment version in your software bundle.

A more sophisticated approach is to install the Java 2 Runtime Environment on your own system, then copy the files you need into your own installation set for redistribution. If you choose this approach, you must include all files except those described as "optional" in the "Redistrubition of the Java 2 runtime environment" section of this README. The Java 2 Runtime Environment software can only be redistributed if all "required" files are included. See the LICENSE file for specifics.

If you use this approach, your installation program should copy the Java 2Runtime Environment files into the same directory where your application is installed. In effect, then, your application will have its own "private" copy of the Java 2 Runtime Environment.

The Win32 Java 2 Runtime Environment now includes Java Plug-in software, which enables Netscape Navigator and Microsoft Internet Explorer to support the Java 2 platform. To develop applets that use Java Plug-in software, see the Java Plug-in product page on the Java Software website.

Winsock Deployment

The following URL contains information about how to determine if the Winsock 2.0 components are installed on a Microsoft Windows 95 platform:

http://support.microsoft.com/support/kb/articles/Q177/7/19.asp

Redistribution of the Java 2 Runtime Environment

The term "vendors" used here refers to licensees, developers, and independent software vendors (ISVs) who license and distribute the Java 2 Runtime Environment with their programs.

Vendors may not redistribute this Java 2 Runtime Environment except in the limited circumstances described in the accompanying Binary Code License agreement, contained in the LICENSE file in the download bundle.

Vendors must follow the terms of the Binary Code License agreement which include, among others:

• Arbitrary subsetting of the Java 2 Runtime Environment is not allowed. See the section below entitled "Required vs. Optional Files" for those files that may be optionally omitted from redistributions of the runtime environment.
• Vendors must include in your product's license the provisions called out in the Binary Code license.

Vendors may also optionally include some specific files from the Win32 version of the Java 2 SDK in their redistributions of the Win32 version of the Java 2 Runtime Environment. The SDK files that may be redistributed with the Runtime Environment are listed below in the subsection "Redistribution of Java 2 SDK Files".

Required vs. Optional Files

Licensees must follow the terms of the accompanying LICENSE.

The files that make up the Java 2 Runtime Environment are divided into two categories: required and optional. Files that are marked "optional" here do not need to be included in redistributions of the Java 2 Runtime Environment.

The following sections contain lists of the files, for both Microsoft Windows and Solaris platforms, that optionally may be omitted from redistributions with the Java 2 Runtime Environment. All files not in these lists of optional files must be included in redistributions of the runtime environment.

The Java 2 Runtime Environment includes the bin and lib directories which both must reside beneath the same top-level directory. All paths given in the file lists below are relative to this top-level directory.

Note that in the case of the Win32 Java 2 Runtime Environment, the native code C runtime library, msvcrt.dll, is located in the Microsoft Windows system directory. The location of this directory varies on different operating systems, but is usually

• winnt\system32 on Microsoft Windows NT
• windows98\system on Microsoft Windows 98
• windows\system on Microsoft Windows 95

This file should be included in redistributions of the Win32 version of the Java 2 Runtime Environment.

Win32 Optional Files and Directories

All font properties files in the lib directory other than the default lib\font.properties file are optional, and vendors may choose not to include them in redistributions of the Java 2 Runtime Environment. In addition, the following may be optionally excluded from redistributions:

bin\beans.ocx		      
   Plugin ActiveX control
lib\jaws.jar		      
   Plugin classes
lib\i18n.jar                  
   Character conversion classes and all other locale support
lib\ext\                      
   Directory containing extension jar files
bin\symcjit.dll               
   JIT compiler
bin\rmid.exe
   Java RMI Activation System Daemon
bin\rmiregistry.exe
   Java Remote Object Registry
bin\tnameserv.exe
   Java IDL Name Server
bin\keytool.exe
   Key and Certificate Management Tool
bin\policytool.exe
   Policy File Creation and Management Tool

Solaris Optional Files and Directories

The directory referred to as in the list below varies depending on the hardware architecture implementation. It will be either sparc or i386.

All font properties files in the lib directory other than the default lib/font.properties file for Solaris 2.6 and the default lib/font.properties.5.5.1 file for Solaris 2.5.1 are optional, and vendors may choose not to include them in redistributions of the Java 2 Runtime Environment. In addition, the following may be optionally excluded from redistributions:

lib/i18n.jar                  
   Character conversion classes and all other locale support
lib//libsunwjit.so       
   JIT compiler
lib/ext/                      
   Directory containing extension jar files
bin/rmid
   Java RMI Activation System Daemon
bin/rmiregistry
   Java Remote Object Registry
bin/tnameserv
   Java IDL Name Server
bin/keytool
   Key and Certificate Management Tool
bin/policytool
   Policy File Creation and Management Tool

Linux Optional Files and Directories

lib/i18n.jar                  
   Character conversion classes and all other locale support
lib/ext/                      
   Directory containing extension jar files
bin/rmid
   Java RMI Activation System Daemon
bin/rmiregistry
   Java Remote Object Registry
bin/tnameserv
   Java IDL Name Server
bin/keytool
   Key and Certificate Management Tool
bin/policytool
   Policy File Creation and Management Tool

Redistribution of Java 2 SDK Files

The Java 2 SDK, Standard Edition, may not be redistributed. However, the limited set of files from the Win32 version of the SDK listed below may be included in vendor redistributions of the Win32 version of the Java 2 Runtime Environment. All paths are relative to the top-level directory of the SDK.

• jre/lib/cmm/PYCC.pf Color-management profile. This file is required only if the Java 2D API is used to perform color map conversions.

• All .ttf font files in the jre/lib/fonts directory. Note that the LucidaSansRegular.ttf font is already contained in the Java 2 Runtime Environment, so there is no need to bring that file over from the SDK.

Credits

The JavaTM 2 Platform, Standard Edition port to Linux was made possible by the efforts of several volunteers of the Blackdown porting team. Sun is grateful to the Blackdown porting team members and their support of the Java on Linux community. Special gratitude goes to the following Blackdown porting team members:

• Juergen Kreileder
• Kevin B. Hendricks
• Steve Byrne
• Johan Vos
• Eddie Dost
• Scott Hutinger
• Karl Asha
• Kars de Jong
• Nigel Gamble
• Michael Sinz
• Brad Crochet