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 で導入

参考

| | | |