[分享]Solaris Java Runtime Environment(JRE) 1.2.2 配置指南

本文档包含与 Java(tm) 开发工具包 (JDK(tm)) 1.2.2 FCS 相对应的 JRE 的信息。本
版 FCS 适合包含在开发产品中。

说明 - 要了解有关 1.2.2 FCS 的信息，请参考 Solaris(tm) 1.2.2 FCS 版本注释，
位于：

http://www.sun.com/solaris/java

o       "Java Runtime 概述"
o       "Java Runtime"
o       "必需文件与可选文件"
o       "Solaris 可选文件和目录"
o       "如何捆绑和运行 Java Runtime"
o       "捆绑 Java Runtime"
o       "Java Runtime示例"
o       "Runtime 文档"
o       "版本和供应商的识别"

Java Runtime 概述
-----------------

JRE 是运行 Java 程序的最低的标准 Java 平台。它包含 Java 虚拟机 (JVM)、Java 
核心类和支持文件。

使用 'java' 工具从命令行调用 JRE（参见下一节）。使用 -cp 选项指定应用程序的
类路径。JRE 包括所有不可调试的 .so 文件以及来自 1.2.2 的支持纯运行时程序所必
需的类。JRE 不包含任何仅属于一个开发系统的开发工具（如 appletviewer 或 javac) 
和类。

在本文档中，“供应商”这个词是指获得许可的人、开发商和独立的软件供应商(ISV)，
他们用自己的 Java 程序发放 JRE 的使用许可和分发 JRE。供应商必须遵守 JRE 二进
制代码许可协议的条款，其中包括：

1.  不得分发 JRE 的必需文件和目录的子集。您只能忽略下列作为可选项列出的文件。

2.  将 JRE 二进制代码许可协议包含在您的产品许可条款中。

供应商还应意识到与 JRE 相关的支持条件。有关信息：

http://www.java.sun.com/solaris/java/support.html

Java Runtime
------------

jre 命令对 JRE 1.2 来讲已过时，已与 java 命令合并。仍然使用的唯一的环境变量是
CLASSPATH，现在可以使用 java 命令的 -classpath 和 -cp 选项覆盖这个变量。JRE 
中过去用来预先考虑系统类路径的 -cp 选项，现在等同于新的 java 命令中的
 classpath。

这个 java 命令调用 Java Runtime 来执行 Java 应用程序。该命令在 JRE 的 Solaris
SPARC(tm) 和 Solaris Intel 下载软件包中可用。这个 java 命令的语法如下：

java [ threads-flag ] [ options ] class [ argument ... ]

java [ threads-flag ] [ options ] -jar file.jar [ argument ... ]

类名参数是要执行的类文件名称。将传递给类的参数放在命令行的类名之后。使用 -cp 
选项指定应用程序的类路径。

这个 java 命令的选项如下（来自 java.1 man 页）：

     -classpath classpath
     -cp classpath
                    指定用于搜索类文件的目录、JAR 归档文件和 ZIP 归档文件的
                    列表。 类路径中的项用冒号 ( 隔开。指定 -classpath 或 
                    -cp 覆盖 CLASSPATH 环境变量的任何设置。

                    用于 java 时，-classpath 或 -cp 只是为用户类指定类。用于
                    oldjava 时，-classpath 或 -cp 为用户类和引导类指定类。

                    如果未使用 -classpath 和 -cp，也没有设置 CLASSPATH， 则用
                    户类路径由当前目录 (.) 构成。

                    有关类路径的详细信息，请参见“设置类路径”。

     -debug         该选项已由 -Xdebug 代替。

     -Dproperty=value
                    设置一个系统属性值。

     -jar           执行一个 JAR 归档文件中封装的程序。第一个参数是一个 JAR 
                    文件的名称，而不是一个启动类的名称。为了使该选项有效，JAR 
                    文件清单中必须包含一行 Main-Class:classname 这样的格式。
                    这里 classname 标识拥有 public static void main(String[]  
                    args) 方法的类，该类作为您的应用程序的启点提供服务。有关
                    使用 Jar 文件和 Jar 文件清单的信息，请参见 Jar 工具参考页
                    以及“Java 教程”的 Jar 线索。使用该选项时，JAR 文件是所有
                    用户类的源，其它用户类路径设置将被忽略。

                    oldjava 工具不支持 -jar 选项。

     -noclassgc     该选项已由 -Xnoclassgc 代替。

     -ossn          该选项已由 -Xossn 代替。

     -msh           该选项已由 -Xmsn 代替。

     -mxn           该选项已由 -Xmxn 代替。

     -ssn           该选项已由 -Xssn 代替。

     -t             该选项已由 -Xt 代替。

     -tm            该选项已由 -Xtm 代替。

     -verbose
     -verbose:class
                    显示有关每个所加载的类的信息。

     -verbosegc     该选项已由 -verbose:gc 代替。

     -verbose:gc    报告每个垃圾收集事件。

     -verbose:jni   报告有关本机方法和其它 Java 本机接口活动的使用情况。

     -version       显示版本信息并退出。

     -?
     -help
                    显示用法信息并退出。

     -X             显示有关非标准选项的信息并退出。

     -Xbootclasspath:bootclasspath
                    指定一个用来搜索引导类文件的目录、JAR 归档文件和 ZIP 归
                    档文件的列表，用冒号分隔。这些用于取代 JDK 1.2 软件中所
                    包含的引导类文件。

     -Xdebug         在启用调试程序的前提下启动。Java 解释器打印输出一个用于
                     jdb(1) 的口令。详细信息和一个示例，请参考对 jdb(1) 的描述。

     -Xcheck:jni     对 Java 本机接口函数执行额外的检查。

     -Xmaxjitcodesize
                     为 JIT 代码区指定最大大小（以字节为单位）。

     -Xnoclassgc     禁用类垃圾收集

     -Xmsn           指定内存分配池的初始大小。该值必须大于 1000。若要用 1000 
                     乘以该值，请加上字母 k。若要用 1 百万乘以该值，请加上字母
                     m。默认值为 1m。

     -Xmxn           指定内存分配池的最大大小。该值必须大于 1000。若要用 1000 
                     乘以该值，请加上字母 k。若要用 1 百万乘以该值，请加上字母
                     m。默认值为 16m。

     -Xossn          每个 Java 线程都有两个堆栈：一个用于 Java 代码，一个用于
                     C 代码。-Xoss 选项将一个线程中 Java 代码可以使用的最大堆
                     栈大小设为 n。在传递给 java 的程序的执行过程中产生的每个
                     线程，将 n 作为其 Java 堆栈大小。n 的默认单位是字节，且 
                     n 必须大于 1000 字节。若要修改 n 的含义，请加上字母 k 表
                     示千字节，或字母 m 表示兆字节。默认的堆栈大小是 400 千字
                     节 (-Xoss400k)。

     -Xrunhprof[:help][:suboption=value,...]
                     启用 cpu、heap 或 monitor 配置文件。该选项后面一般都带一
                     个用逗号分隔的 suboption=value 数对的列表。执行命令 java
                     -Xrunhprof:help 来获得子选项及其默认值的列表。

     -Xprof[:file]   启用配置文件。如果没有指定文件，则将结果写入当前目录中的
                     java.prof。

     -Xssn           每个 Java 线程都有两个堆栈：一个用于 Java 代码，一个用于
                     C 代码。-Xss 选项将一个线程中C 代码可以使用的最大堆栈大
                     小设为 n。在传递给 java 的程序的执行过程中产生的每个线程
                     ，将 n 作为其 Java 堆栈大小。n 的默认单位是字节，且 n 必
                     须大于 1000 字节。若要修改 n 的含义，请加上字母 k 表示千
                     字节，或字母 m 表示兆字节。默认的堆栈大小是128 千字节 
                     (-Xss128k)。
                    
     -Xrs            减少操作系统信号的使用。

     -Xsqnopause     在 siqquit 上不暂停等待用户的交互操作。

     -Xt             开启指令跟踪。

     -Xtm            开启方法跟踪。

必需的文件与可选的文件
------------------------------

获得许可协议的人必须遵守随附的“许可协议”的条款。组成 JRE 的文件分为两类：
必需文件和可选文件。出于解释该许可协议的目的，标记为“可选”的文件不需要包含
在获得许可协议的人的程序中。大部分可选文件都提供语言本地化支持。

“必需”这个词是指获准分发运行时的人必须将这些文件包含在他们的程序中，无论这
些文件是否被他们的程序所使用。这些文件是 Java 平台所必需的。所有没有明确标记
为可选的文件均为必需的文件。

Solaris Production JRE 只提供本机线程支持；不包括未经处理的线程支持。供应商
必须包含提供本机线程支持的文件，这些文件位于目录 lib/<sys>/native_threads 中。

JRE 包含 bin 和 lib 目录，两者必须位于同一个目录中，即 <runtime-dir>。

在下面的列表中，所有的路径都相对于 <runtime-dir> 目录
（原先是Solaris_JRE_1.2.2）。

Solaris 可选文件和目录
----------------------

目录 <sys> 随硬件体系结构实施的不同而异。对于 Solaris，它不是 sparc，就是 
i386。

除了默认的 lib/font.properties 文件外，其它所有位于 lib 目录中的用于
Solaris 2.6 和 7 的字体属性文件均为可选，供应商在重新分发 JRE 时，可以选择不
包含这些文件。另外，也可以将下列各项排除在重新分发之外：        

    lib/i18n.jar                  
       字符转换类及所有其它语言环境支持
    lib/ext/                      
       包含扩展 jar 文件的目录
    bin/rmid
       Java RMI 激活系统守护程序
    bin/rmiregistry
       Java 远程对象注册表
    bin/tnameserv
       Java IDL 名称服务器
    bin/keytool
       密匙和证书管理工具
    bin/policytool
       策略文件创建和管理工具

下列文件是可选的：

 lib/i18n.jar                         来自 sun.io 的 I18N 字符转换类 
 lib/font.properties.cs               用于捷克语环境的 AWT 字体属性
 lib/font.properties.pl               用于波兰语环境的 AWT 字体属性
 lib/font.properties.hu               用于匈牙利语环境的 AWT 字体属性
 lib/font.properties.lt               用于立陶宛语环境的 AWT 字体属性
 lib/font.properties.lv               用于拉脱维亚语环境的 AWT 字体属性
 lib/font.properties.el               用于希腊语环境的 AWT 字体属性
 lib/font.properties.tr               用于土耳其语环境的 AWT 字体属性
 lib/font.properties.ja               用于日语环境的 AWT 字体属性
 lib/psfont.properties.ja             用于日语环境的 AWT psfont 字体属性
 lib/font.properties.ru               用于俄语环境的 AWT 字体属性
 lib/font.properties.ko               用于韩文语言环境的 AWT 字体属性
 lib/font.properties.zh_G             用于简体中文语言环境的 B2312 AWT 字体属性 
 lib/font.properties.zh_T             用于繁体中文语言环境的 W_Big5 AWT 字体属性
 lib/font.properties.zh_TW_CNS11643   用于繁体中文语言环境的可选 AWT 字体属性

如何捆绑和运行 Java Runtime
===========================

捆绑 Java Runtime
-----------------

在 Solaris 上将 JRE 捆绑到应用软件上时需考虑以下几点：

1. 将 JRE 安装在它自己的子目录下，即下面的 <runtime-dir>。包括所有列在
<runtime-dir> 的 bin 和 lib 子目录中的必需文件，并且采用安装 JRE 时创建的目
录结构和相对的文件位置。可以根据需要，包含标记为可选的国际化文件以提供语言本
地化支持。

2. 示例显示的是 <app-dir>/lib/app.jar 中的所有应用程序特定类。为了便于维护，
建议将所有应用程序特定类放在 <runtime-dir> 以外的一个目录中。应用程序特定类
可以是个别的 .class 文件、.jar 文件或 .zip 文件。

一个示例目录结构可以象下面这个样子：

              <app-dir>
  _________________|_________
  |          |               |
 bin        lib          <runtime-dir>
  |          |       ________|________       
          app.jar    |               |
                    bin             lib
                     |               |


3. 如果需要本机代码支持，则本机库必须位于 LD_LIBRARY_PATH 中。其中一个方法是
将本机库安装在 <app-dir>/lib/<sys> 中，然后将路径 LD_LIBRARY_PATH 设置为包含
这些目录。

4. 可以使用 JRE 命令行工具调用应用程序，使用 -cp 选项指定应用程序的类路径。
例如在上面的目录树示例中，其命令可以象下面这个样子：

<app-dir>/<runtime-dir>/bin/java -cp <app-dir>/lib/app.jar <classname>

有关安装和运行 JRE 的详细信息，请参考 JDK 安装指导：

http://www.java.sun.com/products/jdk/1.2/runtime_solaris.html


Java Runtime 示例
-----------------

下面的 Web 页面处有一个可下载的“Hello World”示例，它演示了如何创建一个简单
的 Java 应用程序，使其可以在 JRE 上运行且与之捆绑。

http://www.java.sun.com/products/jdk/1.2/runtime.html

此示例显示如何进行一个简单无缝的转换，使得用 JDK 开发应用程序的过程变为用更
轻量级的 JRE 部署该应用程序。

Runtime 文档
------------

Runtime 文档是最终用户在安装完一个运行在 JRE 上的 Java 应用程序之后所需的任何
文档。我们提供下列 Runtime 文档：

1. 每个属性文件都包含此文件的用途以及如何进行修改的说明。

2. awt.properties 文件 - KeyEvent 使用它打印关键事件的属性，通常是为调试之用。
这可以被 GUI 调试程序用来打印事件。

3. fontprop.html 文件中有一个介绍如何在 Runtime 中添加字体的 Web 页面：

http://www.java.sun.com/products/jdk/1.2/docs/guide/internat/fontprop.html

版本和供应商的识别
------------------

为了使客户能够识别出 JRE 的版本和供应商以便排除故障，一旦 JVM 正在运行，就请
参考下列方法：

java.lang.System.getProperties() (所有属性)
        或
java.lang.System.getProperty("java.version" (单个属性）

相关属性是：

属性                            说明

java.version                    Java 版本号
java.vendor                     Java 供应商特定字符串
java.vendor.url                 Java 供应商的 URL
java.class.version              Java 类格式版本号
java.compiler                   Java 编译器
os.name                         操作系统名称
os.arch                         操作系统结构
os.version                      操作系统版本

可选的：
 
属性                            说明

java.home                       Java 安装目录
java.class.path                 Java 类路径

-------------------------------------------------------------------------------
Copyright 2001 Sun Microsystems, Inc. All rights reserved.
Copyright 2001 Sun Microsystems, Inc. Tous droits r閟erv閟.

sun4unix 回复于：2002-12-06 00:23:06

this is good, but can you tell me how to install JRE, I just can download bin file from sun java site.

LuLuT 回复于：2002-12-06 09:28:57

帮忙啊  我安装Oracle8.1.7在solaris8上始终出现问题 在第一步就提示 找不到jre   安装无法继续 急

YT 回复于：2002-12-07 03:50:56

那你的solaris是怎么安装的啊？

原文转自：http://www.ltesting.net