mps-stop

在 Windows、Linux 和 macOS 系统上从命令行停止服务器实例

语法

mps-stop [-C [path/]server_name] [-f] [-p | --purge] [-k | --kill] [-v] [--timeout hh:mm:ss]

描述

mps-stop [-C [path/]server_name] [-f] [-p | --purge] [-k | --kill] [-v] [--timeout hh:mm:ss] 立即关闭 HTTP 服务器套接字和所有打开的客户端连接。当您发出 mps-stop 时，服务器正在执行的所有功能请求都可以在服务器关闭之前完成。

如果要删除服务器实例目录，可以在实例停止后再删除它。您可以发出 mps-status 命令来验证服务器实例是否已停止。

输入参数

`-C path/`	指定服务器实例的路径。如果要停止当前工作文件夹中的服务器实例，则不需要指定完整路径；只需指定服务器名称。如果省略此选项，系统将搜索当前工作文件夹及其父文件夹来查找服务器实例。
`server_name`	要停止的服务器的名称。
`-f`	即使服务器实例当前已停止，也强制成功。停止已停止的实例被视为错误。
`-p \| --purge`	删除实例目录中的工作文件。这些文件通常在正常关机时被删除。
`-k \| --kill`	立即强制终止此实例的所有正在运行的进程。如果正常关闭失败，请使用此选项。如果同时指定 `-k\|--kill` 和 `--timeout` `hh`:`mm`:`ss` 选项，则所有正在运行的服务器实例进程将在 `hh`:`mm`:`ss` 处强制终止（如果它们尚未停止）。要在 `server-termination-grace-period` 属性指定的持续时间内强制终止服务器实例进程，请不要指定 `-k` 选项。您不能强行终止作为 Windows^® 服务运行的服务器实例。
`-v`	显示系统消息。
`--timeout hh:mm:ss`	设置 `mps-stop` 在返回成功或失败之前运行的时间限制。如果指定 `--timeout` 选项，服务器将尝试正常关闭并释放所有已签出的许可证。例如，如果您指定 `--timeout 00:02:00`，那么当服务器关闭时间超过两分钟时，`mps-stop` 就会退出并显示一条消息。即使 `mps-stop` 超时，服务器实例仍会继续尝试终止。如果不指定此选项，则默认行为是等待实例停止所需的时间（无限长）。如果同时指定 `-k\|--kill` 和 `--timeout` `hh`:`mm`:`ss` 选项，则所有正在运行的服务器实例进程将在 `hh`:`mm`:`ss` 处强制终止（如果它们尚未停止）。

示例

停止位于 tmp 文件夹中的服务器实例 server_1。

使用 -f 选项强制成功完成 mps-stop。如果 mps-stop 需要三分钟以上才能完成，请使用 --timeout 选项返回一条消息。指定详尽的 -v 选项来生成输出状态消息。
在系统命令行中输入以下内容：
```
mps-stop -f -v -C /tmp/server_1 --timeout 00:03:00
```
```
waiting for stop... (timeout = 00:03:00)
```
使用 -k 选项强制立即终止所有正在运行的服务器实例进程。
在系统命令行中输入以下内容：
```
mps-stop -k /tmp/server_1
```
要等待必要的时间来停止服务器实例进程，请不要指定 --timeout 选项或在 main_config 服务器配置文件中设置 server-termination-grace-period 属性。
在系统命令行中输入以下内容：
```
mps-stop /tmp/server_1
```

版本历史记录

在 R2012b 中推出

另请参阅

mps-start | mps-service | mps-restart | mps-new | mps-status