stopServer 命令
stopServer 命令读取指定的服务器进程的配置文件。此命令将 Java™ 管理扩展 (JMX) 命令发送到指示它关闭的服务器。
服务器进程可以是应用程序服务器、DMZ Secure Proxy Server for IBM® WebSphere® Application Server、管理代理程序服务器或作业管理器服务器。
缺省情况下,stopServer 命令在服务器完成关闭进程之前,不会将控制权返回到命令行。存在用于立即返回的 -nowait 选项,以及控制 stopServer 命令行为的其他选项。要了解有关从何处运行此命令的更多信息,请参阅使用命令行工具主题。
如果您正在 Microsoft Windows
操作系统上运行该产品并且将服务器作为 Windows 操作系统服务运行,那么
stopServer 命令会停止负责启动服务器的 Windows 服务。
尽管 stopServer 命令会在服务器完成关闭时返回控制权,但它可以在 IBM i 进程终止之前返回控制权。根据 Java
虚拟机 (JVM) 必须返回到内存池的内存量,该进程可能需要几秒或几分钟才能完全结束。在该进程终止之前,您不应再次尝试启动服务器。使用 WRKACTJOB SBS(subsystem) CL 命令来确定进程是否已完全终止。缺省情况下,子系统为 QWAS85。
如果启用了安全性,那么必须将用户名和密码与
stopServer 命令配合使用,这是因为该命令在服务器上调用 MBean 方法。
对于 stopServer 命令,user name 和 password 参数不是必需参数。会自动将这些参数传递到
Windows 操作系统服务用来关闭系统的脚本中。

语法
命令语法为下列其中一项:
stopServer <server_name> [options]
其中 server_name 是要停止的应用程序服务器或DMZ Secure Proxy Server for IBM WebSphere Application Server的配置目录的名称。
此参数是必需的。
此参数是可选的。如果正在使用缺省概要文件,那么服务器缺省为
server1。如果概要文件名不是缺省值,那么服务器缺省为概要文件名。
stopServer <adminagent_name>
其中 adminagent_name 是要停止的管理代理程序的名称。
stopServer <job_manager>
其中 job_manager 是要停止的作业管理器的名称。
参数
下列选项可用于 stopServer 命令:
- -nowait
- 指示 stopServer 命令不要等待服务器进程成功关闭。
- -quiet
- 阻止显示 stopServer 命令在正常方式下显示的进度信息。
- -logfile <fileName>
- 指定写入跟踪信息的日志文件的位置。缺省情况下,日志文件名为 stopServer.log,并且是在 logs 目录中创建的。
- -profileName
- 在多概要文件安装中定义服务器进程的概要文件。在单概要文件环境中运行不需要 -profileName 选项。此选项的缺省值为缺省概要文件。
- -replacelog
- 替换日志文件,而不是附加到当前日志。
- -trace
- 将跟踪信息生成文件以用于调试。跟踪输出将写至位于 profile_root/logs/server 目录的 stopServer.log 文件。
- -timeout <seconds>
- 指定超时和返回错误之前等待服务器关闭的时间。
- -statusport <portNumber>
- 一个可选参数,允许管理员设置服务器状态回调的端口号。该工具打开此端口并等待服务器在停止前返回的状态回调。如果未设置此参数,那么将自动分配一个未使用的端口。
- -conntype <type>
- 指定用于连接到 Deployment Manager 的 JMX 连接器类型。 有效类型有 SOAP 或远程方法调用 (RMI)。
- -port <portNumber>
- 指定要显式使用的服务器 JMX 端口,以便可在不读取配置文件的情况下获取信息。
- -username <name>
- 如果在服务器中启用安全性,那么指定认证的用户名。等同于 -user 选项。
- -user <name>
- 如果在服务器中启用安全性,那么指定认证的用户名。等同于 -username 选项。
- -password <password>
- 如果在服务器中启用安全性,那么指定认证的密码。
避免故障: 如果您在安全的环境中运行但没有提供用户标识和密码,您将接收到以下错误消息:
要解决该问题,提供用户标识和密码信息。gotchaADMN0022E: 由于不足或空的凭证,拒绝对服务器 MBean 上的 stop 操作的访问。
- -help
- 显示用法说明。
- -?
- 显示用法说明。
使用方案
以下示例说明了正确的语法:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopServer server1
stopServer server1 -nowait
stopServer server1 -trace (produces the stopserver.log file)
stopServer adminagent
stopServer jobmgr
stopServer proxy1 (for the secure proxy profile)
![[IBM i]](../images/iseries.gif)
stopServer server1 (stops the server1 server for the default profile)
stopServer server1 -nowait
stopServer server1 -trace (produces the stopserver.log file)
stopServer -profileName mytest (stops server mytest
configured for profile mytest)
stopServer AdminAgent01
stopServer JobMgr01
stopServer proxy1 (default server name for the SecureProxySrv01 profile)