从 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 file name>.jar
操作
- 对于 Windows:%HOMEPATH%/wlpExtract/<jar file name>_nnnnnnnnnnnnnnnnnnn
- 对于所有其他平台:$HOME/wlpExtract/<jar file name>_nnnnnnnnnnnnnnnnnnn
可以使用 WLP_JAR_EXTRACT_ROOT 或 WLP_JAR_EXTRACT_DIR 环境变量来控制输出位置。
停止服务器
要停止 Liberty 服务器,请按 Ctlr-C。当 Liberty 服务器停止时,解压目录将自动删除。如果您以任何其他方式停止活动 shell,那么不会自动清除解压目录,您必须手动将其清除。
以调试方式运行
如果在启动 Liberty 服务器之前设置了环境变量 WLP_JAR_DEBUG,那么可以用调试方式运行 Liberty 服务器。
控制输出
缺省情况下,服务器输出将写到解压目录,当服务器停止时会删除该目录。如果要保存输出,请在启动服务器之前使用 WLP_OUTPUT_DIR 环境变量指定持久输出位置。
两阶段落实事务
缺省情况下,两阶段落实事务已禁用,因为事务日志位于扩展目录中,并将在 Liberty 服务器停止时删除。因此,无法进行事务恢复。
要启用两阶段落实,请将事务日志配置为位于文件系统或 RDBMS 内的持久位置中,并设置 WLP_JAR_ENABLE_2PC 环境变量。
要配置事务日志,请使用 server.xml 配置中事务元素上的 transactionLogDirectory 或 dataSourceRef 属性。
在 CYGWIN 下运行
在 CYGWIN shell 中运行 Liberty 服务器 JAR 文件具有两个需求:
- 指定 WLP_JAR_CYGWIN 环境变量。
当此变量在 CYGWIN 环境中运行时,会导致 Liberty 服务器 JAR 运行器来执行 UNIX 样式的文件和进程处理。
- 在 Bash shell 下运行,而非 mintty。
仅当在 Bash shell 下运行时,才会自动删除解压文件。您可以在 mintty 下运行,但必须手动删除解压文件。Mintty 不会自动转发触发 Java 关闭挂钩所需的必要信号。
环境变量引用
环境变量名称 | 描述 |
---|---|
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。 |