配置 Liberty JVM 服务器

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

关于此任务

您可以通过两种方法来配置 Liberty JVM 服务器:
自动配置
CICS® 根据 CICS 安装目录中提供的模板自动创建和更新 Liberty 的配置文件 server.xml。 Autoconfigure 可帮助您快速开始使用 Liberty 中的一组最小配置值。 要启用自动配置,请将 JVM 系统属性 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure 属性设置为 true。 如果要在 CICS 束中定义 JVM 服务器,请设置此选项。
手动配置
这是缺省设置。 提供配置文件和所有值。 手动配置适用于您希望完全控制 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 概要文件的所有选项和值。 遵循 JVM 概要文件编码规则中的编码规则 (包括概要文件名称的编码规则)。
    1. 对样本概要文件进行以下更改:
      • JAVA_HOME 设置为已安装的 IBM® Java™ SDK 的位置。
      • WORK_DIR 设置为您为来自 JVM 服务器的消息,跟踪和输出选择的目标目录。
      • WLP_INSTALL_DIR 设置为 &USSHOME;/wlp
      • 设置 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 Liberty 缺省 Web 应用程序,以使用以下 URL 来验证 Liberty JVM 服务器是否正在运行: http://server:port/com.ibm.cics.wlp.defaultapp/。 有关更多信息,请参阅 配置 CICS 缺省 Web 应用程序
  • 指定包含本机 C 动态链接库 (DLL) 文件的任何目录,例如 IBM MQ。 IBM 或供应商提供的中间件和工具可能需要将 DLL 文件添加到库路径。
  • 添加对安全性的支持。 请参阅 配置 Liberty JVM 服务器的安全性
  • 安装 Java EE 应用程序 (EAR 文件, WAR 文件和 EBA 文件) ,如 将 CICS 束中的 Java EE 应用程序部署到 Liberty JVM 服务器中所述。
  • 可以将 Liberty 引导属性放在 JVM 概要文件中,以实现与使用 Liberty bootstrap.properties 文件相同的效果。
  • 缺省情况下,在启动 JVM 服务器时不会清除 Liberty 和 OSGi 高速缓存。 如果迂到高速缓存问题,或者接收 IBM 服务团队的指导以清除服务器,那么可以使用以下两种方法之一来实现此目的:
    • -Dcom.ibm.cics.jvmserver.wlp.args=--clean 添加到 JVM 概要文件。
    • -Dorg.osgi.framework.storage.clean=onFirstInit 添加到 JVM 概要文件。

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

  • 请注意,缺省情况下,配置 Liberty 时,将应用两个缺省设置,但这些设置在 server.xml中不可见。 请参阅 CICS Liberty 缺省设置 以获取更多信息。
  • 有关常规 Liberty 设置的更多信息,请参阅 Liberty 上的此概述 Liberty 概述