从 JAR 文件运行 Liberty 服务器

可以从 Java 归档 (JAR) 文件启动 Liberty 服务器。此方法提供一种简洁而又可移动的方式来启动 Liberty 服务器。可使用 Liberty 服务器命令创建 JAR 文件,然后使用 Java -jar 命令将其作为可执行 JAR 文件运行。

创建可运行的 JAR 文件

可以指定 minify 以获得尽可能小的归档。必须指定 JAR 类型归档才能获得可运行的 JAR 文件。在 z/OS 上,唯一受支持的归档类型是 pax;在除此之外的所有平台上,缺省归档类型为 .zip。例如:

server package <server name> --include=[minify,]runnable --archive=<jar file name>.jar

运行 JAR 文件

通过将标准 Java 命令与 –jar 选项配合使用来运行 JAR 文件,例如:
java –jar <jar file name>.jar

操作

运行 JAR 文件时,它将解压到临时位置,然后,由 Liberty 服务器 run 命令启动的服务器将在前台运行。所有输出将写到 stdoutstderr。缺省情况下,文件将解压到临时位置:
  • 对于 Windows:%HOMEPATH%/wlpExtract/<jar file name>_nnnnnnnnnnnnnnnnnnn
  • 对于所有其他平台:$HOME/wlpExtract/<jar file name>_nnnnnnnnnnnnnnnnnnn

可以使用 WLP_JAR_EXTRACT_ROOTWLP_JAR_EXTRACT_DIR 环境变量来控制输出位置。

停止服务器

要停止 Liberty 服务器,请按 Ctlr-C。当 Liberty 服务器停止时,解压目录将自动删除。如果您以任何其他方式停止活动 shell,那么不会自动清除解压目录,您必须手动将其清除。

以调试方式运行

如果在启动 Liberty 服务器之前设置了环境变量 WLP_JAR_DEBUG,那么可以用调试方式运行 Liberty 服务器。

控制输出

缺省情况下,服务器输出将写到解压目录,当服务器停止时会删除该目录。如果要保存输出,请在启动服务器之前使用 WLP_OUTPUT_DIR 环境变量指定持久输出位置。

两阶段落实事务

缺省情况下,两阶段落实事务已禁用,因为事务日志位于扩展目录中,并将在 Liberty 服务器停止时删除。因此,无法进行事务恢复。

要启用两阶段落实,请将事务日志配置为位于文件系统或 RDBMS 内的持久位置中,并设置 WLP_JAR_ENABLE_2PC 环境变量。

要配置事务日志,请使用 server.xml 配置中事务元素上的 transactionLogDirectorydataSourceRef 属性。

在 CYGWIN 下运行

在 CYGWIN shell 中运行 Liberty 服务器 JAR 文件具有两个需求:

  1. 指定 WLP_JAR_CYGWIN 环境变量。

    当此变量在 CYGWIN 环境中运行时,会导致 Liberty 服务器 JAR 运行器来执行 UNIX 样式的文件和进程处理。

  2. 在 Bash shell 下运行,而非 mintty。

    仅当在 Bash shell 下运行时,才会自动删除解压文件。您可以在 mintty 下运行,但必须手动删除解压文件。Mintty 不会自动转发触发 Java 关闭挂钩所需的必要信号。

环境变量引用

表 1. 环境变量名称及其定义
环境变量名称 描述
WLP_JAR_EXTRACT_ROOT 将 JAR 文件解压到目录 ${WLP_JAR_EXTRACT_ROOT}/<jar file name>_nnnnnnnnnnnnnnnnnnn
WLP_JAR_EXTRACT_DIR 将 JAR 文件解压到目录 ${WLP_JAR_EXTRACT_DIR}
WLP_OUTPUT_DIR 将 Liberty 服务器输出文件写到目录 ${WLP_OUTPUT_DIR}
WLP_JAR_DEBUG 通过使用 server debug <server name> 而非 server run <server name> 来运行 Liberty 服务器。
WLP_JAR_ENABLE_2PC 如果设置为值 true,那么可在可运行 JAR 文件运行时启用 2PC。
WLP_JAR_CYGWIN 如果在 CYGWIN 下运行 JAR 文件,请设置为值 true

用于指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: Monday, 5 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=rwlp_setup_jarserver
文件名:rwlp_setup_jarserver.html