![]() |
Readme
|
Thank you for downloading the Compaq Run Time Environment v 1.3.1-3 for the Tru64™ UNIX® Operating System for the Java™ Platform (hereafter called the Compaq RTE or, simply, the RTE). The RTE comprises the Java virtual machine, the Java platform core classes, and supporting files. It is the runtime part of the Compaq Software Development Kit (SDK) v 1.3.1 for the Tru64 UNIX Operating System for the Java Platform (hereafter called the Compaq SDK or the SDK), but without the development tools such as compilers and debuggers. The RTE is packaged with the Compaq Plug-in for the Tru64 UNIX Operating System for the Java Platform software that enables widely deployed web browsers to use the RTE to run applets. This Readme provides installation instructions for the RTE and information that may be useful for developers who want to redistribute the RTE with their software. Also, note that the Compaq Fast Virtual Machine (Fast VM) is now the default VM. For more information about this release, refer to the SDK v 1.3.1-3 Release Notes.
Note: The RTE and RTE Optional kits are no longer available as setld
kits; they are now simply tar
kits that when untarred deliver
the contents into the current directory.
IMPORTANT: Please make sure you understand the Copyright
(COPYRIGHT
, installed file) and License (LICENSE
,
installed file) information before using this release.
Presently, this RTE v 1.3.1-3 release does not require any operating system patches. However, the need for patches may be discovered after this release becomes available. Therefore, Compaq recommends that you check the patch installation page for Tru64 UNIX for the latest information.
This release contains mandatory and optional sets:
javajre131-3.tar.gz
-- The mandatory set,
which provides support for running Java programs. Note that this kit is in
a compressed format.javajreopt131-3.tar
-- The optional
components, mostly font files for internationalization support and precompiled
rt.jar
files for Enhanced Fast VM execution. These compiled files
make up the majority of the kit size. Because these files have been previously
compiled, any attempt to compress them further yields little benefit. Thus,
the kit has been kept in an uncompressed state for convenience.To install the RTE:
Download the compressed RTE kit into the directory where you wish to install
the RTE (e.g., /tmp/java/
, where the italicized text represents
your chosen directory. Note: This default is used throughout the release
notes.) In this directory, decompress and untar the kit:
cd /tmp/java
gunzip javajre131-3.tar.gz
tar xvf javajre131-3.tar
This creates top-level directory jre131/
, which you can rename.
Note: If you wish to include the RTE Optional kit, wait until untarring
that kit to rename the top-level directory. Directory jre131/
now
contains the files plus the following documentation:
COPYRIGHT
LICENSE
README.html
In addition, the following Compaq Fast VM files are installed and part of this
kit (where /tmp/java/
represents the directory of your choosing):
/tmp/java/jre131/lib/alpha/fast32/Xusage.txt
/tmp/java/jre131/lib/alpha/fast32/libjvm.so
/tmp/java/jre131/lib/alpha/fast64/Xusage.txt
/tmp/java/jre131/lib/alpha/fast64/libjvm.so
To improve performance of your application when using the Fast VM, precompiled
standard class files are provided as part of the RTE Optional kit (javajreopt131-3.tar
).
For more information, refer to Precompiled
Standard Class Files in the SDK v 1.3.1-3 Release Notes. See Installed
Files for a list of files that this kit installs.
After installing the RTE, you can run your application by invoking the java
command as follows:
/tmp/java/jre131/bin/java ...
where /tmp/java/
represents the location where you installed
the RTE kit.
In the same directory where you previously installed the RTE kit, download and untar the RTE Optional kit:
cd /tmp/java/
tar xvf javajreopt131-3.tar
The optional javajreopt131-3.tar
set installs
the following files in /tmp/java/jre131/lib
:
File | Contents |
---|---|
il8n.jar | I18N character conversion classes from sun.io |
font.properties.ar | AWT font properties for Arabic locale |
font.properties.iw | AWT font properties for Hebrew locale |
font.properties.ja | AWT font properties for Japanese locale |
font.properties.ko | AWT font properties for Korean locale |
font.properties.th | AWT font properties for 8859-2 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 |
psfontj2d.properties | Postscript® printer property file for Java 2D printing |
alpha/fast32/PrecompiledRT32 | Precompiled rt.jar file, supports 32-bit pointers |
alpha/fast32/PrecompiledRT32U | Precompiled rt.jar file, supports 32-bit unsigned pointers |
alpha/fast64/PrecompiledRT64 | Precompiled rt.jar file, supports 64-bit pointers |
The javajreopt131-3.tar
kit installs the following files in /tmp/java/jre131/bin
and /tmp/java/jre131/bin/alpha/native_threads
:
keytool | |
policytool | |
rmid | |
rmiregistry | |
tnameserv |
Compaq Plug-in v 1.3.1-3 enables users to run Java applets and JavaBeans™ components on web pages using the RTE as an alternative to using the default virtual machine for Java 2 that comes with the Web browser. It is based on the Java Plug-in 1.3.1 provided by Sun Microsystems and contains similar functionality.
For additional information on topics such as Java Plug-in security, using Signed Applets, JNI and the Java Plug-in, using Java Plug-in in Intranet Environments, and how Proxy Configuration works in the Java Plug-in, please see the Sun Microsystems Java Plug-in 1.3 Documentation web page; the documentation is the same for the Java Plug-in 1.3.1.
Note: You must be running Netscape Communicator 4.51 or higher, or Mozilla 0.7 or higher.
Note: The following sections assume the RTE kit is installed in the
directory /tmp/java/
. You can substitute your directory
path for /tmp/java/
.
For Netscape 4.x browsers:
Set the NPX_PLUGIN_PATH
environment variable to
the location of the Plug-in (the directory in which the javaplugin.so
file is located):
NPX_PLUGIN_PATH=/tmp/java/jre131/plugin/alpha/ns4
Note: When setting the NPX_PLUGIN_PATH environment variable,
do not include a trailing slash ('/'). If you include the trailing slash, the
Plug-in will fail to load.
For Mozilla and Netscape 6.x browsers:
Create a symbolic link in the browser's plugins
directory to the path of the libjavaplugin_oji.so
file. This file is located at /tmp/java/jre131/plugin/alpha/ns600/libjavaplugin_oji.so
.
For example:
cd ${MOZILLA}/plugins
ln -s /tmp/java/jre131/plugin/alpha/ns600/libjavaplugin_oji.so
Start your browser, or restart it if it is already running.
Restart your browser a second time. (This is a workaround to a browser bug.)
A Plug-in Control Panel lets you change Plug-in options such as proxies and enabling of the Java console window. It also allows you to switch the RTE version you want to run with your Plug-in. To run the Control Panel, enter the following command:
/tmp/java/jre131/bin/ControlPanel
Or you can use the Netscape Navigator® browser to visit
the Control Panel applet page that was installed as /tmp/java/java131/jre/bin/ControlPanel
.
For example:
netscape /tmp/java/jre131/ControlPanel.html
Please refer to Sun's Java Plug-in Control Panel web page for information about additional features and uses of the Java Plug-in Control Panel.
By default, the Fast VM is used
when running the Plug-in. You can have
the Plug-in use the classic VM by defining the environment
variable JAVA_PLUGIN_CLASSIC_VM
before running your web browser.
To use the Fast VM (with 64-bit pointers), you can define
the environment variable JAVA_PLUGIN_FAST64_VM
.
If you do not define this environment variable, by default
the Fast VM is invoked in 32-bit mode.
Setting both environment variables, JAVA_PLUGIN_CLASSIC_VM
and JAVA_PLUGIN_FAST64_VM
, invokes the Fast
VM in 64-bit mode.
If you don't set an environment variable, the Fast VM with 32-bit pointers is invoked by default.
If you redistribute the RTE, you must follow the terms of the RTE Binary Code License agreement, which includes these terms:
javajreopt131-3.tar
optional kit.
The following SDK files may be redistributed with the RTE:
/usr/opt/java131/bin/alpha/native_threads/javac
/usr/opt/java131/bin/javac
/usr/opt/java131/lib/tools.jar
These files include Java 2 SDK tools classes, including the classes for the
javac
compiler.
This release of the RTE for Tru64 UNIX is packaged as two tar
kits, which makes it suitable for downloading by end users. For your end
users to run your software, they'll need a Java runtime environment installed
on their systems. The SDK contains a runtime environment, of course, so your
customers could use that if they happen to have it installed. However, a better
bet for most of your end users will be the RTE, for several reasons:
For more information on bundling an application in a Java Archive (JAR) file, refer to Packaging Your Application in a JAR File on Sun's site.
When bundling the RTE with application software on Tru64 UNIX, consider the following points:
<runtime-dir>
). Include all the required files from /tmp/java/jre131/bin
and /tmp/java/jre131/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.<runtime-dir>
. Application-specific classes
can be individual .class
files, .jar
files, or .zip
files.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.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:
/tmp/java/jre131/bin/java -cp <app-dir>/lib/app.jar <classname>
© 2002 Compaq Information Technologies Group, L.P. |
Compaq Registered in U.S. Patent and Trademark Office. |
Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. |
All other product names mentioned herein may be trademarks or registered trademarks of their respective companies. |
Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice. |