配置 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 资源的方法。
过程
结果
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 概述。