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` を指定した場合、サーバーのシャットダウンに 2 分以上かかると、`mps-stop` はメッセージを表示して終了します。サーバーインスタンスは、`mps-stop` がタイムアウトした場合でも終了することを試み続けます。このオプションを指定しなかった場合、既定の動作は、インスタンスが停止するまで必要なだけ (無限に) 待機することです。 `-k\|--kill` と `--timeout` `hh`:`mm`:`ss` の両方のオプションを指定すると、実行中のすべてのサーバーインスタンスプロセスは、既に停止していない場合、`hh`:`mm`:`ss` に強制的に終了されます。

例

tmp フォルダーにあるサーバーインスタンス server_1 を停止します。

-f オプションを使用して mps-stop を強制的に正常に完了させます。--timeout オプションを使用して、mps-stop が完了するまでに 3 分を超えてかかった場合はメッセージが表示されるようにします。詳細な -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