[IBM i]

enablejvm 命令(不推荐使用)

enablejvm命令使您可以配置应用程序服务器或特定配置文件以使用IBM® Java™ 虚拟机技术,通过选择IBM Developer Kit for Java。

[IBM i]已弃用的功能:enableJvm命令已被弃用WebSphere® Application Server版本8.0 。 请使用 managesdk 命令来代替 enableJvm 命令。 managesdk 命令提供用于代替 enableJvm 命令的功能。
下表指示哪些 JVM 版本在哪些 IBM i 发行版上受支持。
表 1. 支持 JVM 版本IBM i发布 下表描述了 IBM i 发行版中对 JVM 版本的支持。
IBM i 6.1 IBM i 7.1
Java Platform Standard Edition 6 32 位 JVM(5761JV1 的第 11 个选件)的 IBM 版本 Java Platform Standard Edition 6 32 位 JVM(5761JV1 的第 11 个选件)的 IBM 版本
Java Platform Standard Edition 6 64 位 JVM(5761JV1 的第 12 个选件)的 IBM 版本 Java Platform Standard Edition 6 64 位 JVM(5761JV1 的第 12 个选件)的 IBM 版本

缺省情况下,该产品使用 Java SE 6 32 位 JVM 的 IBM 版本。

要了解有关从何处运行此命令的更多信息,请参阅使用命令行工具主题。

应确保满足下列所有条件,才能运行 enablejvm 命令:
  1. 已安装目标 JVM。
  2. 在 IBM i 系统上安装了“可移植应用程序解决方案环境” (PASE) 产品。 IBM Java SE 6 32 位 JVM 和 IBM Java SE 6 64 位 JVM 都需要此产品。 如果尚未安装此产品,请安装 PASE 产品,它是 IBM i 操作系统的第 33 个选件,随 IBM i 6.1 和更高版本的介质一起提供。

WebSphere Application Server Network Deployment注意事项:

对于任何属于WebSphere Application Server Network Deployment单元,节点的部署管理器必须在enablejvm脚本尝试更新配置文件。 当对某个节点启用 JVM 时,从该节点所属的产品安装的 bin 目录中调用 enablejvm 命令。 也可以从概要文件的 bin 目录中调用 enablejvm 命令,而此概要文件是包含您要更新的节点的概要文件。

如果 Deployment Manager 启用了管理安全性,那么必须在您要启用的节点的 soap.client.props 文件中提供管理用户名和密码:
  1. 编辑以下文件:

    profile_root/properties/soap.client.props

  2. 对 com.ibm.SOAP.loginUserid 和 com.ibm.SOAP.loginPassword 属性指定管理用户名和密码。
  3. 保存该文件。
  4. 使用以下方式对文件中的密码进行编码PropFilePasswordEncoder脚本位于app_server_root/bin产品目录:
    PropFilePasswordEncoder
    profile_root/properties/soap.client.props
    com.ibm.SOAP.loginPassword

对 Deployment Manager 启用 JVM 时,将仅启用 Deployment Manager 服务器。 不会启用由 Deployment Manager 管理的任何节点来使用特定 JVM。

语法

命令语法如下所示:

enablejvm [options]

参数

以下选项可用于 enablejvm 命令:

-jvm jvm_version
这是一个必需参数。 enablejvm如果目标jvm_version未安装。 jvm_version 必须是下列其中一个受支持的版本:
std32
输入此值后,会将应用程序服务器配置为使用 IBM Java SE 6 32 位 JVM。
std64
输入此值后,会将应用程序服务器配置为使用 IBM Java SE 6 64 位 JVM。 如果要在 IBM i 6.1 或更高版本上运行该产品,那么此值有效。
-轮廓配置文件名称
这是一个可选参数。 如果未指定 -profile 参数,那么该脚本使此产品可以使用 J2SE 6.0 JVM,并且还会更新任何现有概要文件以使用对 jvm_version 指定的 JVM。
以下条件适用于已运行 enableJVM 命令的情况:
  • 如果概要文件是联合节点或 Deployment Manager 节点,那么当 enableJVM 命令尝试更新此概要文件时,Deployment Manager 必须正在运行。 为节点启用 jvm 时,运行enableJVM命令来自/bin节点所属的产品安装目录或来自/bin包含要更新的节点的配置文件的目录。
  • 根据以下首选顺序使用受支持的连接器协议时,与 Deployment Manager 的连接必须存在:
    1. SOAP
    2. 进程间通信 (IPC)
    3. 远程方法调用 (Remote Method Invocation, RMI)

如果启用了 SOAP 协议,那么 enableJVM 命令将使用 SOAP 协议。 如果未启用 SOAP 协议,但启用了 IPC 协议,那么该命令将使用 IPC 协议。 如果 SOAP 协议和 IPC 协议都未启用,那么该命令将使用 RMI 协议。

对于每个包含已启用安全性的单元中的联合节点或 Deployment Manager 节点的概要文件,您必须为 enableJVM 命令提供管理用户名和密码。 如果未指定 -user 和 -password 参数,那么 enableJVM 命令可能会失败或停止处理。 关于通过脚本编制配置安全性的主题提供了有关如何保存用户名值和密码值的特定于连接器协议的指示信息。

笔记:除非对具有任何联合节点或启用了安全性的部署管理器的单元的部署管理器的 SOAP、IPC 和 RMI 连接禁用自动提示,否则请不要在安装中使用启用所有配置文件。 自动提示将导致 enableJVM 命令失败或停止处理。

对 Deployment Manager 启用 JVM 时,将仅启用 Deployment Manager 服务器。 不会启用 Deployment Manager 的任何受管节点来使用特定 JVM 版本。

使用方案

以下示例说明正确的语法:

enablejvm -jvm std32 [-profile profile_name]
enablejvm -jvm std64 [-profile profile_name]

如果调用 enablejvm 时未指定 -profile 参数,请重新启动正在运行的所有服务器(例如,Node Agent、Deployment Manager 和应用程序管理器)。 如果调用 enablejvm 时确实指定了 -profile 参数,那么在更改生效前必须重新启动属于已更改的概要文件的所有服务器。

Java 参数 -Xms 或 -Xmx 用于更改应用程序服务器的初始 Java 堆大小或最大 Java 堆大小。 如果先前已使用管理控制台将 Java 参数 -Xms 或 -Xmx 添加至应用程序服务器的通用 JVM 参数设置,那么这些设置可能不适用于 IBM Java SE 6 32 位 JVM,甚至对其无效。 因此,在启用概要文件以使用 IBM Java SE 6 32 位 JVM 后,第一次启动该概要文件下的应用程序服务器时,该应用程序服务器可能会失败,因为这些 Java 堆大小设置都超过了 32 位 JVM 3 千兆字节 Java 堆大小的限制。 请在管理控制台中复审所有 Java 堆设置,并且在适当时更改或移除这些设置。