名前
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コマンドのオプションおよび引数を説明します。
特定のIJServerの状態のみを表示する場合、表示対象のIJServerのワークユニット名を指定します。指定したIJServerが存在しない場合はエラーとなります。
省略した場合、すべてのIJServerの状態を表示します。
振り分け先状態を表示させたいWebサーバコネクタに該当するWebサーバのWebサーバ名を指定します。指定したWebサーバが存在しない場合はエラーとなります。
省略した場合、すべてのWebサーバが対象になります。
戻り値
0 = 正常終了
上記以外 = エラーが発生し処理を中断
注意事項
故障監視機能を有効にした後や故障監視機能の設定変更を行った後は、Webサーバを再起動してください。
故障監視機能を有効にした後や故障監視機能の設定変更を行った後、Webサーバの再起動を行わなかった場合、クライアントからの最初のアクセスが発生した時点で、設定変更された内容で振り分け先の故障監視を開始します。
このため、設定変更した後、Webサーバを再起動しなかった場合には、最初のアクセスが発生するまでの間は、変更前の状態が表示されます。
たとえば、監視方法を“ping監視”から“ポート監視”に変更した場合、監視先のServletコンテナが停止していても、クライアントからの最初のアクセスが発生するまでは、“稼動中”と表示されます。
本コマンドは、管理者権限を所有するユーザだけが実行可能です。
Windows Server(R) 2003以降で、本コマンドを管理者権限以外のユーザで実行する場合、イベントログへの書き込み権限を設定する必要があります。
Windows Server(R) 2008で、本コマンドをビルトインゲストアカウント(OSインストール時に作成されるGuestユーザ)で実行した場合、SvMon1010メッセージが出力され、コマンドを正常に実行することができません。
使用例
すべての振り分け先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 |