stopNode 命令

stopNode 命令读取 Node Agent 进程的配置文件,并发送 Java™ 管理扩展 (JMX) 命令,指示 Node Agent 关闭。

缺省情况下,stopNode 命令在将控制返回到命令行之前等待节点代理程序完成关闭。 有一个可以立即返回的 -nowait 选项,以及控制 stopNode 命令行为的其他选项。 要了解有关从何处运行此命令的更多信息,请参阅“使用命令行工具”。

[z/OS]如果在使用 stopServer -servers 命令停止 Node Agent 之前停止服务器,那么当您发出 startServer 命令时,服务器将不会重新启动。

对于转换用户: 在版本 6.1 和更低版本中,此命令从 profile_root/properties/soap.client.props 文件获取用户标识和密码信息。 在此版本的产品中,将从 profile_root/properties/ipc.client.props 文件中获取同一信息。 为了避免使用此命令时出现用户标识和密码提示,请将用户标识和密码信息添加到 ipc.client.props 文件。

语法

命令语法如下所示:
stopNode [options]

参数

以下选项可用于 stopNode 命令:

-nowait
指示 stopNode 命令不要等待节点代理程序进程成功关闭。
-quiet
阻止 stopNode 命令以正常方式打印的进度信息。
-logfile <fileName>
指定写入跟踪信息的日志文件的位置。 缺省情况下,日志文件名为 stopServer.log,并在所停止节点的概要文件的 logs 目录中创建。
-replacelog
替换日志文件,而不是附加到当前日志。
-trace
将跟踪信息生成文件以用于调试。 跟踪输出将写至 was_jobname-jobuser-jobnum.log 文件,此文件位于 profile_root/logs 目录中。
-timeout <seconds>
指定超时和返回错误之前等待代理程序关闭的时间。
受支持的配置: timeout 参数用于一次停止一个服务器。 如果将 timeout 参数与 stopservers 参数一起使用,那么将忽略 timeout 参数值。
-statusport <portNumber>
一个可选参数,允许管理员设置 Node Agent 状态回调的端口号。 该工具打开此端口并等待节点代理程序在完全停止前返回的状态回调。 如果未设置此参数,那么将自动分配一个未使用的端口。
-stopservers [-saveNodeState]
在停止节点代理程序之前,停止所有节点上的应用程序服务器。

使用 -saveNodeState 选项来保存服务器重新启动状态,以便您可以使用 startNode 命令根据以前的状态来启动应用程序服务器。

-conntype <type>
指定用于与 Deployment Manager 进行连接的 Java 管理扩展 (JMX) 连接器类型。 有效类型有 SOAP 或远程方法调用 (RMI)。
-port <portNumber>
指定要明确使用的节点代理程序JMX 端口,这样您可以避免读配置文件以获取信息。
-username <name>
如果在节点代理程序中启用安全性,那么指定认证的用户名。 等同于 -user 选项。
-user <name>
如果在节点代理程序中启用安全性,那么指定认证的用户名。 等同于 -username 选项。
-password <password>
如果在节点代理程序中启用安全性,那么指定认证的密码。
注: 如果您正在安全环境中运行,但未提供用户标识和密码,那么您将收到以下错误消息:
ADMN0022E: 由于服务器 MBean 上的停止操作,访问被拒绝 
凭证不足或为空。
要解决该问题,提供用户标识和密码信息。
-help
显示用法说明。
注: 请求有关 stopNode 命令的用法语句的帮助时,将显示对 stopServer 命令的引用。 此用法说明显示的所有选项适用于 stopNode 命令。
-?
显示用法说明。
注: 请求有关 stopNode 命令的用法语句的帮助时,将显示对 stopServer 命令的引用。 此用法说明显示的所有选项适用于 stopNode 命令。

使用方案

以下示例说明正确的语法:

[z/OS]
stopNode

stopNode -nowait 

stopNode -trace (produces the stopnode.log file)