README Java(TM) 2 Platform Standard Edition Runtime Environment Version 5.0 The J2SE(TM) Runtime Environment (JRE) is intended for software developers and vendors to redistribute with their applications. The J2SE Runtime Environment contains the Java virtual machine, runtime class libraries, and Java application launcher that are necessary to run programs written in the Java programming language. It is not a development environment and does not contain development tools such as compilers or debuggers. For development tools, see the J2SE Development Kit. ======================================================================= Deploying Applications with the J2SE Runtime Environment ======================================================================= 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. See also the Notes for Developers page on the Java Software website: http://java.sun.com/j2se/1.5.0/runtime.html ----------------------------------------------------------------------- Runtime Environment ----------------------------------------------------------------------- To run your application, a user needs the J2SE Runtime Environment, which is freely available from Sun. Or, You can redistribute the J2SE Runtime Environment for free with your application, according to the terms of the Runtime Environment's license. 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. You should ensure that your installation procedure does not overwrite existing JRE installations, as they may be required by other applications. ======================================================================= Redistribution of the J2SE Runtime Environment ======================================================================= -------------------------------------------------------- NOTE - The license for this software does not allow the redistribution of beta and other pre-release versions. -------------------------------------------------------- The term "vendors" used here refers to licensees, developers, and independent software vendors (ISVs) who license and distribute the J2SE Runtime Environment with their programs. Vendors must follow the terms of the J2SE Runtime Environment Binary Code License agreement. ----------------------------------------------------------------------- Required vs. Optional Files ----------------------------------------------------------------------- The files that make up the J2SE Runtime Environment are divided into two categories: required and optional. Optional files may be excluded from redistributions of the J2SE Runtime Environment at the licensee's discretion. The following section contains a list of the files and directories that may optionally be omitted from redistributions with the J2SE Runtime Environment. All files not in these lists of optional files must be included in redistributions of the runtime environment. ----------------------------------------------------------------------- Optional Files and Directories ----------------------------------------------------------------------- The following files may be optionally excluded from redistributions. These files are located in the jre1.5.0_ directory, where is the update version number. Solaris and Linux filenames and separators are shown. Windows executables have the ".exe" suffix. Corresponding files with _g in name can also be excluded. lib/charsets.jar Character conversion classes lib/ext/ sunjce_provider.jar - the SunJCE provider for Java Cryptography APIs localedata.jar - contains many of the resources needed for non US English locales ldapsec.jar - contains security features supported by the LDAP service provider dnsns.jar - for the InetAddress wrapper of JNDI DNS provider 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/kinit Used to obtain and cache Kerberos ticket-granting tickets bin/klist Kerberos display entries in credentials cache and keytab bin/ktab Kerberos key table manager bin/policytool Policy File Creation and Management Tool bin/orbd Object Request Broker Daemon bin/servertool Java IDL Server Tool bin/javaws, lib/javaws/ and lib/javaws.jar Java Web Start When redistributing the JRE on Microsoft Windows as a private application runtime (not accessible by other applications) with a custom launcher, the following files are also optional. These are the Netscape and IE plugin modules and are not useful in a private JRE redistribution. java.exe javaw.exe ActPanel.dll jpicpl32.exe jpicpl32.cpl jpiexp32.dll jpins32.dll jpishare.dll NPJava11.dll NPJava12.dll NPJava13.dll NPJava32.dll NPJPI141.dll NPOJI610.dll ----------------------------------------------------------------------- Redistributable JDK(TM) Files ----------------------------------------------------------------------- The limited set of files from the JDK listed below may be included in vendor redistributions of the J2SE Runtime Environment. All paths are relative to the top-level directory of the JDK. - jre/lib/cmm/PYCC.pf Color profile. This file is required only if one wishes to convert between the PYCC color space and another color space. - All .ttf font files in the jre/lib/fonts directory. Note that the LucidaSansRegular.ttf font is already contained in the J2SE Runtime Environment, so there is no need to bring that file over from the JDK. - jre/lib/audio/soundbank.gm This MIDI soundbank is present in the JDK, but it has been removed from the J2SE Runtime Environment in order to reduce the size of the Runtime Environment's download bundle. However, a soundbank file is necessary for MIDI playback, and therefore the JDK's soundbank.gm file may be included in redistributions of the Runtime Environment at the vendor's discretion. Several versions of enhanced MIDI soundbanks are available from the Java Sound web site: http://java.sun.com/products/java-media/sound/ These alternative soundbanks may be included in redistributions of the J2SE Runtime Environment. - The javac bytecode compiler, consisting of the following files: bin/javac [Solaris(TM) Operating Environment and Linux] bin/sparcv9/javac [Solaris Operating Environment (SPARC(R) Platform Edition)] bin/javac.exe [Microsoft Windows] lib/tools.jar [All platforms] - The Annotation Processing Tool, consisting of the following files: bin/apt [Solaris(TM) Operating Environment and Linux] bin/sparcv9/apt [Solaris Operating Environment (SPARC(R) Platform Edition)] bin/apt.exe [Microsoft Windows] - jre\bin\server\ On Microsoft Windows platforms, the JDK includes both the Java HotSpot Server VM and Java HotSpot Client VM. However, the J2SE Runtime Environment for Microsoft Windows platforms includes only the Java HotSpot Client VM. Those wishing to use the Java HotSpot Server VM with the J2SE Runtime Environment may copy the JDK's jre\bin\server folder to a bin\server directory in the J2SE Runtime Environment. Software vendors may redistribute the Java HotSpot Server VM with their redistributions of the J2SE Runtime Environment. ----------------------------------------------------------------------- Unlimited Strength Java Cryptography Extension ----------------------------------------------------------------------- Due to import control restrictions for some countries, the Java Cryptography Extension (JCE) policy files shipped with the J2SE Development Kit and the J2SE Runtime Environment allow strong but limited cryptography to be used. These files are located at /lib/security/local_policy.jar /lib/security/US_export_policy.jar where is the jre directory of the JDK or the top-level directory of the J2SE Runtime Environment. An unlimited strength version of these files indicating no restrictions on cryptographic strengths is available on the JDK web site for those living in eligible countries. Those living in eligible countries may download the unlimited strength version and replace the strong cryptography jar files with the unlimited strength files. ----------------------------------------------------------------------- Endorsed Standards Override Mechanism ----------------------------------------------------------------------- An endorsed standard is a Java API defined through a standards process other than the Java Community Process(SM) (JCP(SM)). Because endorsed standards are defined outside the JCP, it is anticipated that such standards will be revised between releases of the Java 2 Platform. In order to take advantage of new revisions to endorsed standards, developers and software vendors may use the Endorsed Standards Override Mechanism to provide newer versions of an endorsed standard than those included in the Java 2 Platform as released by Sun Microsystems. For more information on the Endorsed Standards Override Mechanism, including the list of platform packages that it may be used to override, see http://java.sun.com/j2se/1.5.0/docs/guide/standards/ Classes in the packages listed on that web page may be replaced only by classes implementing a more recent version of the API as defined by the appropriate standards body. In addition to the packages listed in the document at the above URL, which are part of the Java 2 Platform Standard Edition (J2SE(TM)) specification, redistributors of Sun's J2SE Reference Implementation are allowed to override classes whose sole purpose is to implement the functionality provided by public APIs defined in these Endorsed Standards packages. Redistributors may also override classes in the org.w3c.dom.* packages, or other classes whose sole purpose is to implement these APIs. ----------------------------------------------------------------------- Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.