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。

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

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

避免麻烦: 如果消息ADMC0074E: Connection will be closed due to unrecoverable error显示在系统日志文件中，客户机可能已尝试将用户名和密码发送到另一个禁用了安全性的服务器。可忽略此消息，因为客户机会自动将其安全设置更改为与客户机正尝试进行通信的服务器的安全设置匹配。连接最终成功完成。但是，现在为管理客户机和接收服务器禁用了安全性。

语法

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

stopServer <server_name> [options]

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

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

[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 上的停止操作，访问被拒绝 
凭证不足或为空。

要解决该问题，提供用户标识和密码信息。

-help

显示用法说明。

-?

显示用法说明。

使用方案

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

stopServer server1

stopServer server1 -nowait 

stopServer server1 -trace (produces the stopserver.log file)

stopServer adminagent

stopServer jobmgr

stopServer proxy1 (for the secure proxy profile)

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)