Interstage Application Server リファレンスマニュアル(コマンド編)

12.10 svmondspstat

名前

　svmondspstat − Webサーバコネクタの故障監視機能における振り分け先状態の表示

形式

　svmondspstat [-i name] [-s Webサーバ名]

機能説明

　本コマンドは、以下に格納されています。

　C:\Interstage\bin\

　/opt/FJSVsvmon/bin

　svmondspstatコマンドは、Webサーバコネクタの故障監視機能で監視しているWebサーバコネクタの振り分け先の状態を一覧表示する機能を提供します。
　振り分け先の状態は、“Status IP Address:Port Number:WorkUnit Name:WebServer Name”の形式で表示します。

　Statusには、以下の状態が表示されます。

• ACTIVE
  IP Address:Port Numberで示された振り分け先は稼動中の状態です。Webサーバコネクタによってリクエストの振り分けが行われます。
• DOWN
  IP Address:Port Numberで示された振り分け先は停止中の状態です。Webサーバコネクタのリクエストの振り分けは抑止されます。
• UNKNOWN
  IP Address:Port Numberで示された振り分け先の状態の取得が完了していない状態です。Webサーバコネクタによってリクエストの振り分けが行われます。
  故障監視の開始直後から、最初の振り分け先状態の監視が完了するまでの間、振り分け先の状態にはUNKNOWNが表示されます。

　以下にsvmondspstatコマンドのオプションおよび引数を説明します。

-i name

　特定のIJServerの状態のみを表示する場合、表示対象のIJServerのワークユニット名を指定します。指定したIJServerが存在しない場合はエラーとなります。
　省略した場合、すべてのIJServerの状態を表示します。

-s Webサーバ名

　振り分け先状態を表示させたいWebサーバコネクタに該当するWebサーバのWebサーバ名を指定します。指定したWebサーバが存在しない場合はエラーとなります。
　省略した場合、すべてのWebサーバが対象になります。

戻り値

　0 = 正常終了
　上記以外 = エラーが発生し処理を中断

注意事項

• 故障監視機能を有効にした後や故障監視機能の設定変更を行った後は、Webサーバを再起動してください。
  故障監視機能を有効にした後や故障監視機能の設定変更を行った後、Webサーバの再起動を行わなかった場合、クライアントからの最初のアクセスが発生した時点で、設定変更された内容で振り分け先の故障監視を開始します。
  このため、設定変更した後、Webサーバを再起動しなかった場合には、最初のアクセスが発生するまでの間は、変更前の状態が表示されます。
  たとえば、監視方法を“ping監視”から“ポート監視”に変更した場合、監視先のServletコンテナが停止していても、クライアントからの最初のアクセスが発生するまでは、“稼動中”と表示されます。

• 本コマンドは、管理者権限を所有するユーザだけが実行可能です。

• Windows Server(R) 2003で、本コマンドを管理者権限以外のユーザで実行する場合、イベントログへの書き込み権限を設定する必要があります。

使用例

　すべての振り分け先IJServerの状態を表示する場合の操作例を以下に示します。

  -----------------------------------------------------------------------
  > svmondspstat
    Status  IP Address  : Port Number : WorkUnit Name ： WebServer Name
    -------------------------------------------------------------------
    ACTIVE  172.16.30.2 : 9000        : MyIJServer1    : FJapache
    ACTIVE  172.16.30.3 : 9000        : MyIJServer1    : WEB001
    DOWN    172.16.30.2 : 9001        : MyIJServer2    : FJapache
    ACTIVE  172.16.30.3 : 9001        : MyIJServer2    : WEB001
  -----------------------------------------------------------------------

　Webサーバ名がFJapacheの振り分け先IJServerの状態のみを表示する場合の操作例を以下に示します。

  -----------------------------------------------------------------------
  > svmondspstat -s FJapache
    Status  IP Address  : Port Number : WorkUnit Name ： WebServer Name
    -------------------------------------------------------------------
    ACTIVE  172.16.30.2 : 9000        : MyIJServer1    : FJapache
    DOWN    172.16.30.2 : 9001        : MyIJServer2    : FJapache
  -----------------------------------------------------------------------

　IJServerのワークユニット名がMyIJServer1の振り分け先IJServerの状態のみを表示する場合の操作例を以下に示します。

  -----------------------------------------------------------------------
  > svmondspstat -i MyIJServer1
    Status  IP Address  : Port Number : WorkUnit Name ： WebServer Name
    -------------------------------------------------------------------
    ACTIVE  172.16.30.2 : 9000        : MyIJServer1    : FJapache
    ACTIVE  172.16.30.3 : 9000        : MyIJServer1    : WEB001
  -----------------------------------------------------------------------