从命令行管理 Liberty
可以使用 服务器 命令和可执行 JAR 文件 ws-server.jar 来创建、启动或停止服务器,检查服务器是否处于运行状态,或者调试服务器。
关于此任务
wlp/bin 目录包含一个称为 服务器 的脚本,以帮助控制服务器进程。此脚本的语法如下所示:
服务器 <action> [server] [options]
有关 options 的可用值,请参阅 服务器命令选项。
避免故障: 使用管理控制台可启动和停止 Liberty 服务器(仅当此服务器处于维护状态时),此服务器为可自动缩放集群的集群成员。如果从命令行启动或停止作为可自动缩放集群的集群成员的 Liberty 服务器,那么会导致不可预测的结果。
此脚本支持下列操作:
- create
- 此命令用来创建新服务器。
- debug
- 此命令在调试器连接至调试端口之后在控制台前台运行指定的服务器。缺省端口为 7777。可以使用 WLP_DEBUG_ADDRESS 变量来指定替代端口。
- dump
- 此命令用来创建服务器的快照并将结果保存到归档文件以便进一步调优和诊断。
- javadump
- 此命令用于创建服务器 Java™ 虚拟机 (JVM) 的快照并将结果保存到文件。每种内存转储类型都将创建一个文件,但是并非所有内存转储类型都受所有虚拟机支持。内存转储文件的缺省目录为 ${server.output.dir}。要设置另一个缺省目录,您必须使用 IBM® JVM 并设置下列环境变量:
- IBM_HEAPDUMPDIR
- IBM_COREDIR
- IBM_JAVACOREDIR
- list
- 此命令用来列示所定义的 Liberty 应用程序服务器。
- package
- 此命令用来将服务器打包。
pause
此命令用来暂停可在服务器暂停的所有组件。要暂停特定组件,请使用 --target 选项。有关 pause 和 resume 的更多信息,请参阅从命令行暂停和恢复 Liberty 服务器。
resume
此命令用来恢复可在服务器暂停的所有组件。要恢复特定组件,请使用 --target 选项。有关 pause 和 resume 的更多信息,请参阅从命令行暂停和恢复 Liberty 服务器。
- run
- 此命令用来在前台启动服务器。
- start
- 此命令用来将服务器作为后台进程启动。
可以使用 WLP_ZOS_PROCEDURE 环境变量来指定 STC 过程的名称,该过程用于将服务器作为 z/OS® 启动任务而非 USS 后台进程启动;请参阅定制 Liberty 环境。
- stop
- 此命令用来停止正在运行的服务器。
- 状态
- 此命令用来检查指定的服务器是否处于运行状态。
- version
- 此命令用来显示当前服务器和 Java 运行时环境的版本信息。
- help
- 用于获取命令行脚本帮助(包括其他选项的详细信息)的命令。
注: 如果未在命令行上指定服务器,那么会对缺省服务器实例 defaultServer(如果存在)执行操作。
您也可以通过使用 ${wlp.install.dir}/bin/tools 目录中的可执行 JAR 文件 ws-server.jar 来执行相似的操作。示例
要在 Windows 系统上运行 服务器 脚本,请输入以下命令:
服务器.bat create server_name
服务器.bat package server_name
服务器.bat run server_name
服务器.bat help server_name
要在其他系统上运行 服务器 脚本,请输入以下命令:服务器 create server_name
服务器 package server_name
服务器 run server_name
服务器 help server_name
要在不使用 服务器 脚本的情况下运行可执行 JAR 文件 ws-server.jar,请输入以下命令:
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar server_name --create
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar server_name
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar --help
--help 选项提供有关可执行
JAR 文件 ws-server.jar 的更多命令行参数(例如
--stop、--version、--clean 和 --include)的信息。