配置 Liberty JVM 服务器

如果要部署 Enterprise Java 应用程序 (例如 EJB ， JSP ， JSF 和 Servlet) ，请配置 Liberty JVM 服务器。

如果要配置 CMCI JVM 服务器，请参阅 设置 CMCI 以获取指示信息。 CMCI JVM 服务器 是一种特殊类型的 Liberty JVM 服务器，支持 CMCI API。 它不用于托管应用程序。

如果要使用默认 CICS® Liberty 之外的其他 Liberty 版本，请参阅配置其他 Liberty 安装位置中的详细信息。

注: 请查看 为 CICS Liberty 配置安全性 主题，以获取更多与安全性相关的 Liberty 配置信息。

关于此任务

您可以通过两种方法来配置 Liberty JVM 服务器:
自动配置
CICS 根据 CICS 安装目录中提供的模板自动创建和更新 Liberty 的配置文件 server.xml。 Autoconfigure 可帮助您快速开始使用 Liberty 中的一组最小配置值。 要启用自动配置，请将 JVM 系统属性 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure 属性设置为 true。 如果要在 CICS 束中定义 JVM 服务器，请设置此选项。

将 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure 设置为 true 将指示 CICS 创建和配置 Liberty。 CICS 将:
  • 如果 Liberty 服务器不存在，请创建该服务器
  • 将必需的 CICS Liberty 功能部件添加到 server.xml
    • cicsts:core-1.0
  • 如果安全性处于活动状态 (SEC = YES) ，请将 CICS 安全性功能部件添加到 server.xml 和 <safRegistry> 元素
    • cicsts:security-1.0
    • <safRegistry enableFailover=“false”id=“saf”/>
  • 如果指定HTTPS ，请添加transportSecurity
    • transportSecurity-1.0
  • 设置 <httpEndpoint> 元素中的服务器主机 httpPort 和 httpsPort 值 (如果在 JVM 概要文件中提供)
    • <httpEndpoint host=“*” httpPort=“nnnnn” httpsPort=“mmmmm” id=“defaultHttpEndpoint”/>
当 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure 属性设置为 false 时， CICS 将期望在 WLP_USER_DIR/servers/defaultServer中提供已配置的 server.xml 。
-Dcom.ibm.cics.jvmserver.wlp.autoconfigure的缺省值 (如果省略) 为 false。
手动配置
此配置是缺省设置。 提供配置文件和所有值。 手动配置适用于您希望完全控制 Liberty 服务器配置的情况。

要定义 JVM 服务器，请参阅 如何定义 CICS 资源。

过程

  1. 创建 JVMSERVER 资源。 如果要在 CICS 束中创建 JVMSERVER 资源，请参阅 可在束中部署的工件。
    1. 指定 JVM 服务器的 JVM 概要文件的名称。 在 JVMSERVER 的 JVMPROFILE 属性上，指定 1-8 字符名称。 此名称用于 JVM 概要文件的文件名，该文件包含 JVM 服务器的配置选项。 您无需在此处指定文件类型 .jvmprofile。
    2. 指定 JVM 服务器的线程限制。 在 JVMSERVER 的 THREADLIMIT 属性上，指定要分配的最大线程数。 实际使用的线程数取决于您在 JVM 服务器中运行的工作负载。 首先，您可以接受缺省值，然后调整环境。 您可以在 JVM 服务器中设置多达 256 个线程。
    3. 设置 JVM 概要文件的位置。 JVM 概要文件必须位于您在系统初始化参数 JVMPROFILEDIR上指定的目录中。 有关更多信息，请参阅 设置 JVM 概要文件的位置。
  2. 创建 JVM 概要文件以定义 JVM 服务器的配置选项。 您可以使用样本概要文件 DFHWLP.jvmprofile作为基础。 此概要文件包含适合于启动 JVM 服务器的选项子集。 JVM 概要文件验证和属性中描述了 JVM 概要文件的所有选项和值。 遵循 用于对概要文件进行编码的规则中的编码规则 (包括用于概要文件名称的那些规则)。
    1. 对样本概要文件进行以下更改:
      • 将 JAVA_HOME 设置为已安装 IBM Java™ SDK 的位置。
      • 将 WORK_DIR 设置为您为来自 JVM 服务器的消息，跟踪和输出选择的目标目录。
      • 将 WLP_INSTALL_DIR 设置为 &USSHOME;/wlp。 您还可以通过设置其他路径来使用备用 Liberty 位置，请参阅 配置备用 Liberty 安装位置。
      • 设置 TZ 以指定来自 JVM 服务器的消息上的时间戳记的时区。 英国的一个示例是 TZ=GMT0BST,M3.5.0,M10.4.0
      • 将 -Dfile.encoding 设置为 ISO-8859-1，例如 -Dfile.encoding=ISO-8859-1。
      • (可选) 设置 CICS_WLP_MODE 以选择 CICS 与 Liberty 之间的集成级别。

      有关 JVM 服务器选项的更多信息，请参阅 JVM 概要文件中使用的符号。

    2. 保存对 JVM 概要文件的更改。 JVM 概要文件必须以 EBCDIC 文件编码保存在 UNIX 系统服务上，并且文件类型必须为 .jvmprofile。
  3. 创建 Liberty 服务器配置。
    当需要仔细控制配置文件时，手动创建 JVM 服务器是适当的。 有关更多信息，请参阅 手动创建 Liberty 服务器 和 手动定制 server.xml。
    要点: 如果要在 CICS 束中定义 JVM 服务器，那么应使用自动配置，因为 server.xml 配置文件不能包含在 CICS 束中的 JVM 概要文件中。
  4. 安装并启用 JVMSERVER 资源。

结果

JVMSERVER 读取 JVM 概要文件并根据提供的设置初始化自身。 如果已启用自动配置并且 Liberty 服务器配置不存在，那么将创建该配置。 如果未启用自动配置，并且您没有配置，或者配置不正确，那么 JVMSERVER 将变为 DISABLED 并报告相应的故障。 在后续启动时， JVMSERVER 使用现有配置并启动 Liberty 服务器实例。 当 JVMSERVER 成功完成启动时， JVMSERVER 资源将以 ENABLED 状态安装。

如果发生错误，例如， CICS 无法找到或读取 JVM 概要文件，那么 JVM 服务器无法初始化。 JVM 服务器以 DISABLED 状态安装， CICS 向系统日志发出错误消息。 请参阅 对 Liberty JVM 服务器和 Java Web 应用程序进行故障诊断 以获取帮助。 要确认 Liberty 在 JVM 服务器中成功启动，请参阅 zFS上 WLP_USER_DIR 输出目录中的 messages.log 文件。

警告:
请勿使用 Liberty bin/server 脚本来启动或停止在 JVM 服务器中运行的 Liberty 服务器。
注: 在 CICS 集成方式 Liberty 中， JVM 服务器指示的当前线程数返回正值，并且即使没有工作负载在运行时也会波动。 发生此情况的原因是为了提高效率，在 Liberty 中汇集了线程。

下一步操作

  • 运行 CICS 默认Web应用程序，通过URL 验证Liberty JVM服务器是否正在运行： http://server:port/com.ibm.cics.wlp.defaultapp/ 。 更多信息，请参阅配置 CICS 默认Web应用程序。
  • 指定包含本地 C® 动态链接库 (DLL) 文件的任何目录，如 IBM® MQ. IBM 或供应商提供的中间件和工具可能需要将 DLL 文件添加到库路径。
  • 添加对安全性的支持。 请参阅 为 CICS Liberty 配置安全性。
  • 安装 Enterprise Java 应用程序 (EAR 文件， WAR 文件和 EBA 文件) ，如 将 CICS 束中的 Enterprise Java 应用程序部署到 Liberty JVM 服务器中所述。
  • 可以将 Liberty 引导属性放在 JVM 概要文件中，以实现与使用 Liberty bootstrap.properties 文件相同的效果。
  • 缺省情况下，在启动 JVM 服务器时不会清除 Liberty 和 OSGi 高速缓存。 如果自 JVM 服务器上次重新启动以来应用了 CICS 维护，那么 --clean 选项将在内部用作一次性操作，以确保清除高速缓存。 稍后，如果迂到高速缓存问题，或者接收 IBM 服务团队的指导以清除服务器，那么可以使用以下两种方法之一来实现此情况:
    • 将 -Dcom.ibm.cics.jvmserver.wlp.args=--clean 添加到 JVM 概要文件。
    • 将 -Dorg.osgi.framework.storage.clean=onFirstInit 添加到 JVM 概要文件。

    在这两种情况下，请在服务器启动时除去该选项，以确保后续重新启动不受性能影响。

  • 缺省情况下，配置 Liberty 时，将应用两个缺省设置，但这些设置在 server.xml中不可见。 有关更多信息，请参阅 CICS Liberty 缺省设置。
  • 有关 Liberty 一般设置的更多信息，请参阅 Liberty 概述。

配置备用 Liberty 安装位置

您可能不希望使用 CICS Liberty 的缺省安装，因为您的 Liberty 实例已在使用中。 这种配置有时被称为 "自带自由 "或 BYOL。

您可以通过配置WLP_INSTALL_DIR使用现有安装的定义目录路径来满足这一需求。 有关更多信息，请参阅 JVM 服务器选项 WLP_INSTALL_DIR。