stopNode 命令
stopNode 命令读取节点代理程序进程的配置文件,并发送指示关闭节点代理程序的 Java™ 管理扩展 (JMX) 命令。
缺省情况下,stopNode 命令在将控制返回到命令行之前等待节点代理程序完成关闭。有一个可以立即返回的 -nowait 选项,以及控制 stopNode 命令行为的其他选项。要了解有关从何处运行此命令的更多信息,请参阅“使用命令行工具”。
如果您使用的是 Windows 操作系统并且节点代理程序作为 Windows 服务运行,那么 stopNode 命令将使用关联的 Windows 服务来停止节点代理程序。
如果在使用 stopServer -servers 命令停止节点代理程序之前停止服务器,那么当您发出 startServer 命令时,服务器将不会重新启动。
尽管 stopServer 命令会在服务器完成关闭时返回控制权,但它可以在
IBM® i 进程终止之前返回。根据 Java 虚拟机必须返回到内存池的内存量,该进程可能需要几秒或几分钟才能完全结束。在该进程终止之前,您不应再次尝试启动服务器。使用 WRKACTJOB SBS(subsystem) CL 命令来确定进程是否已完全终止。缺省情况下,子系统为 QWAS85。

语法
命令语法如下所示:
stopNode [options]
参数
以下选项可用于 stopNode 命令:
- -nowait
- 指示 stopNode 命令不要等待节点代理程序进程成功关闭。
- -quiet
- 阻止 stopNode 命令以正常方式打印的进度信息。
- -logfile <fileName>
- 指定写入跟踪信息的日志文件的位置。缺省情况下,日志文件名为 stopServer.log,并在所停止节点的概要文件的 logs 目录中创建。
-profileName
在多概要文件安装中定义应用程序服务器进程的概要文件。在单概要文件环境中运行不需要 -profileName 选项。此选项的缺省值为缺省概要文件。
- -replacelog
- 替换日志文件,而不是附加到当前日志。
- -trace
- 将跟踪信息生成文件以用于调试。跟踪输出将写至 was_jobname-jobuser-jobnum.log 文件,此文件位于 profile_root/logs 目录中。
- -timeout <seconds>
- 指定超时和返回错误之前等待代理程序关闭的时间。
支持的配置: 使用 timeout 参数一次停止一台服务器。如果将 timeout 参数与 stopservers 参数一起使用,那么将忽略 timeout 参数值。sptcfg
- -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 上的 stop 操作的访问。
- -help
- 显示用法说明。注: 当对 stopNode 命令的用法说明请求帮助时,将显示 stopServer 命令的参考。此用法说明显示的所有选项适用于 stopNode 命令。
- -?
- 显示用法说明。注: 当对 stopNode 命令的用法说明请求帮助时,将显示 stopServer 命令的参考。此用法说明显示的所有选项适用于 stopNode 命令。
使用方案
以下示例说明了正确的语法:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopNode
stopNode -nowait
stopNode -trace (produces the stopnode.log file)
![[IBM i]](../images/iseries.gif)
stopNode
stopNode -profileName mynode
stopNode -nowait
stopNode -trace (produces trace files under
the profile_root/logs directory.)