Readme The Java™ 2 Runtime Environment, Standard Edition (JRE), v 1.2.2-12 for Compaq® Tru64™ UNIX®

Contents

• Introduction
• Installation
• Using the Java 2 Runtime Environment
• Redistribution of the JRE
• Bundling the Java 2 Runtime Environment

Introduction

Thank you for downloading the Java^™ 2 Runtime Environment, Standard Edition (also known as the Java 2 Runtime or JRE) v 1.2.2-12 for Compaq^® Tru64^™ UNIX^®. The JRE is the minimum standard Java Platform for running Java programs. It contains the Virtual Machine for Java 2™, Java core classes, and supporting files. The JRE does not contain any of the development tools (such as appletviewer or javac) or classes that pertain only to a development environment.

This Readme provides installation instructions for the JRE and information that may be useful for developers who want to redistribute the JRE with their software.

IMPORTANT: Please make sure you understand the Copyright (copyright.txt, installed file) and License (license.txt, installed file) information before using this release.

Installation

Presently, this JRE v 1.2.2-12 release does not require any operating system patches. However, the need for patches may be discovered after this release becomes available. Therefore, we recommend that you check our patch installation page for Compaq® Tru64™ UNIX® for the latest information.

The following steps must be done as superuser. Untar the binary kit in a scratch directory, then use the setld command to load from that directory. This example uses /tmp/java as the scratch directory, and assumes the tar file is in /tmp:

   cd /tmp/java 
   tar xf /tmp/javajre122-12.tar 
   setld -l /tmp/java

There are two subsets in this kit:

• JAVAJRE122 -- The mandatory subset, which provides support for running Java programs
   
• JAVAJREOPT122 -- The optional components, mostly font files for internationalization support

  Installation of the JAVAJRE122 subset creates /usr/opt/jre122 and installs the Java^™ 2 Runtime Environment in /usr/opt/jre122/bin and /usr/opt/jre122/lib. You can see the files installed by the mandatory subset by means of the following command:

     % setld -i JAVAJRE122
  

  The optional JAVAJREOPT122 subset installs the following files in /usr/opt/jre122/lib:

  
   

  JAVAJREOPT122 Installed Files

  File	Contents
  il8n.jar	I18N character conversion classes from sun.io
  font.properties.cs	AWT font properties for Czech locale
  font.properties.el	AWT font properties for Greek locale
  font.properties.hu	AWT font properties for Hungarian locale
  font.properties.ja	AWT font properties for Japanese locale
  font.properties.ko	AWT font properties for Korean locale
  font.properties.lt	AWT font properties for Lithuanian locale
  font.properties.lv	AWT font properties for Latvian locale
  font.properties.pl	AWT font properties for Polish locale
  font.properties.ru	AWT font properties for Russian locale
  font.properties.tr	AWT font properties for Turkish locale
  font.properties.zh_EUC_CN	AWT font properties for Chinese locale
  font.properties.zh_HK_Big5	AWT font properties for Chinese locale
  font.properties.zh_HK_EUC_TW	AWT font properties for Chinese locale
  font.properties.zh_TW_Big5	AWT font properties for Chinese locale
  font.properties.zh_TW_EUC_TW	AWT font properties for Chinese locale
  psfont.properties.ja	Japanese Postscript® printer property file

  The JAVAJREOPT122 subset installs the following files in /usr/opt/jre122/bin and /usr/opt/jre122/bin/alpha/native_threads:

  keytool
  policytool
  rmid
  rmiregistry
  tnameserv

  The JAVAJREOPT122 subset also installs the file iiimp.jar in the /usr/opt/jre122/lib/ext directory.

Using the Java 2 Runtime Environment

In this release, a single Java application launcher, the java command-line tool, is used both for development (the Java^™ 2 SDK) and deployment (the Java 2 Runtime Environment).

The old deployment launcher, jre is no longer provided.

Redistribution of the JRE

If you redistribute the JRE, you must follow the terms of the JRE Binary Code License agreement, which includes these terms:

• Do not arbitrarily subset the JRE. You may omit only the files in the JAVAJREOPT122 optional subset.
   
• Include in your product's license the provisions called out in the JRE Binary Code License.

Bundling the Java 2 Runtime Environment

This release of the JRE for Tru64 UNIX is packaged as two setld subsets, which makes it suitable for downloading by end users. Java application developers have the option of not bundling the JRE with their software. Instead, they can direct end users to download and install the JRE themselves.

When bundling the JRE with application software on Tru64 UNIX, the following points should be considered:

1. It is suggested that you include the Java^™ 2 Runtime Environment files under a common directory (<runtime-dir>). Include all the required files from /usr/opt/jre122/bin and /usr/opt/jre122/lib in the bin and lib subdirectories of <runtime-dir>, following the same directory hierarchy and relative placement of files. The internationalization files installed by the optional subset can be included for language localization support.
    
2. It is suggested that all application-specific classes be placed in a directory other than <runtime-dir>. Application-specific classes can be individual .class files, .jar files, or .zip files.
    
3. If native code support is required, then the native library must be located in LD_LIBRARY_PATH. The best way to do this is to install the native libraries in <app-dir>/lib/<sys>. LD_LIBRARY_PATH should then be set to include these directories.
    
4. The application can be invoked by using the java command-line tool with the -cp option to specify the application's class path. In the standard installation, for example, the command might look like this:

      /usr/opt/jre122/bin/java -cp <app-dir>/lib/app.jar <classname>