stopServer 命令

stopServer 命令读取指定的服务器进程的配置文件。此命令将 Java™ 管理扩展 (JMX) 命令发送到指示它关闭的服务器。

服务器进程可以是应用程序服务器、DMZ Secure Proxy Server for IBM® WebSphere® Application Server、管理代理程序服务器或作业管理器服务器。

缺省情况下,stopServer 命令在服务器完成关闭进程之前,不会将控制权返回到命令行。存在用于立即返回的 -nowait 选项,以及控制 stopServer 命令行为的其他选项。要了解有关从何处运行此命令的更多信息,请参阅使用命令行工具主题。

[AIX Solaris HP-UX Linux Windows]如果您正在 Microsoft Windows 操作系统上运行该产品并且将服务器作为 Windows 操作系统服务运行,那么 stopServer 命令会停止负责启动服务器的 Windows 服务。

[IBM i]尽管 stopServer 命令会在服务器完成关闭时返回控制权,但它可以在 IBM i 进程终止之前返回控制权。根据 Java 虚拟机 (JVM) 必须返回到内存池的内存量,该进程可能需要几秒或几分钟才能完全结束。在该进程终止之前,您不应再次尝试启动服务器。使用 WRKACTJOB SBS(subsystem) CL 命令来确定进程是否已完全终止。缺省情况下,子系统为 QWAS85。

[AIX][Linux][Solaris][HP-UX]如果启用了安全性,那么必须将用户名和密码与 stopServer 命令配合使用,这是因为该命令在服务器上调用 MBean 方法。

[Windows]对于 stopServer 命令,user name 和 password 参数不是必需参数。会自动将这些参数传递到 Windows 操作系统服务用来关闭系统的脚本中。

避免故障 避免故障: 如果系统日志文件中显示了消息 ADMC0074E: 由于不可恢复错误,将关闭连接,那么客户机可能已尝试将用户名和密码发送至禁用了安全性的另一服务器。可忽略此消息,因为客户机会自动将其安全设置更改为与客户机正尝试进行通信的服务器的安全设置匹配。连接最终成功完成。但是,现在为管理客户机和接收服务器禁用了安全性。gotcha

语法

命令语法为下列其中一项:

stopServer <server_name> [options]

其中 server_name 是要停止的应用程序服务器或DMZ Secure Proxy Server for IBM WebSphere Application Server的配置目录的名称。

[AIX Solaris HP-UX Linux Windows][z/OS]此参数是必需的。

[IBM i]此参数是可选的。如果正在使用缺省概要文件,那么服务器缺省为 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>
如果在服务器中启用安全性,那么指定认证的密码。
避免故障 避免故障: 如果您在安全的环境中运行但没有提供用户标识和密码,您将接收到以下错误消息:
ADMN0022E: 由于不足或空的凭证,拒绝对服务器 MBean 上的 stop 操作的访问。
要解决该问题,提供用户标识和密码信息。gotcha
-help
显示用法说明。
-?
显示用法说明。

使用方案

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

[AIX Solaris HP-UX Linux Windows][z/OS]
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]
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)

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_stopserver
文件名:rxml_stopserver.html