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

7.3 otsmonitor

名前

　otsmonitor　−　OTSシステムおよびリソース管理プログラムの状態監視コマンド

形式

1. OTSシステムが起動するまでを監視する。起動するまでの起動タイムアウト時間を30秒に設定し、監視サイクル時間を5秒にする。
   　otsmonitor -t sys -m "startup,timeout=30,cycletime=5"
2. OTS用のリソース管理プログラムが起動するまでを監視する。起動タイムアウト時間をデフォルトに設定し、監視サイクル時間もデフォルトにする。
   　otsmonitor -t rmp -n リソース定義名 -m "startup"
3. JTS用のリソース管理プログラムが起動するまでを監視する。起動タイムアウト時間をデフォルトに設定し、監視サイクル時間もデフォルトにする。
   　otsmonitor -t rmp -j -m "startup"
4. OTSシステムが停止するのを監視する。
   　otsmonitor -t sys -m "terminate"
5. OTS用のリソース管理プログラムが停止するのを監視する。
   　otsmonitor -t rmp -n リソース定義名 -m "terminate"
6. JTS用のリソース管理プログラムが停止するのを監視する。
   　otsmonitor -t rmp -j -m "terminate"
7. OTSシステムが起動してから停止するまでを監視する。
   　otsmonitor -t sys -m "startup,terminate"
8. リソース管理プログラムが起動してから停止するまでを監視する。
   　otsmonitor -t rmp -n リソース定義名 -m "startup,terminate"

機能説明

　本コマンドは、OTSシステムやリソース管理プログラムの状態を監視することができます。クラスタシステムから、OTSシステムやリソース管理プログラムを監視するのに利用することができます。

　以下に、otsmonitorコマンドのオプションを説明します。

-t sys|rmp

　監視対象を指定します。sysを指定するとOTSシステムを監視対象にします。rmpを指定すると、リソース管理プログラムを監視対象とします。

-n リソース定義名

　リソース定義名を指定します。-t rmpの場合に指定する必要があります。

-j

　JTS用のリソース管理プログラムを監視します。-t rmpの場合に指定する必要があります。

-m "startup,terminate,timeout=nn,cycletime=mm"

　startup,terminate,timeout,cycletimeの文字を半角ダブルクォート（"）で囲んだ中に半角カンマ（,）で指定することにより監視動作を指定することができます。
　startup: 監視対象が起動するまでを監視します。
　terminate: 監視対象が停止するまでを監視します。
　timeout:本コマンドのタイムアウト時間を設定します。タイムアウト時間が経過しても監視対象の処理が完了しない場合にはコマンドがエラー復帰します。timeoutはterminateには影響を与えません。1からlongの最大値（2147483647)まで指定することが可能です。省略した場合または、範囲外の値が指定された場合には、デフォルト値(60秒)が設定されます。
　cycletime: 何秒おきに状態を監視するかを指定します。1からlongの最大値（2147483647)まで指定することが可能です。省略した場合または、範囲外の値が指定された場合には、デフォルト値(5秒)が設定されます。

　また、これらを組み合わせて、“startup,terminate"とすることで、起動から停止までを監視することが可能になります。

　本コマンドの復帰値には以下の意味があります。
復帰値が０： -mに指定した監視動作通りに動作した場合に返却されます
復帰値が１： 処理中に何らかの異常を検出した場合に返却されます
復帰値が２： -mのtimeout時間以内に起動処理が完了しなかった場合に返却されます

注意事項

• 本コマンドは、管理者権限だけが実行可能です。
• 本コマンドからotsstartやotsstartrscが呼ばれるわけではありません。監視のみを行います。
• -mのtimeoutに指定した値が、cycletimeより小さい場合には、cycletimeの時間までtimeout処理が発生しません。
  timeout > cycletime の関係になるように設定してください。

• コマンド実行時には、データベース連携サービス(サービス名:ObjectTransactionService)およびCORBAサービス(サービス名:OD_start,Naming Service)が起動されている必要があります。停止している場合には、手動でサービスを起動してからコマンドを投入するようにしてください。

• CORBAサービスおよびネーミングサービスが起動されている必要があります。

使用例

　OTSシステムの起動を監視する場合。

　rem OTSシステム起動
　otsstart
　otsmonitor -t sys -m "startup"
　if %ERRORLEVEL% EQU 0 goto :NORMAL_END
　if %ERRORLEVEL% EQU 1 goto :ERROR_OCCURRED
　if %ERRORLEVEL% EQU 2 goto :TIMEOUT

　OTS用のリソース管理プログラムの起動を監視する場合。起動時のタイムアウトを30秒に設定。

　rem OTS用のリソース管理プログラムの監視をする場合
　otsstartrsc -pg c:\temp\ots\rdb_resource.exe -n resource1
　otsmonitor -t rmp -n resource1 -m "startup,timeout=30"
　if %ERRORLEVEL% EQU 0 goto :NORMAL_END
　if %ERRORLEVEL% EQU 1 goto :ERROR_OCCURRED
　if %ERRORLEVEL% EQU 2 goto :TIMEOUT

　JTS用のリソース管理プログラムの起動を監視する場合。監視サイクル時間を2秒に設定。

　rem JTS用のリソース管理プログラムの監視をする場合
　otsstartrsc -j
　otsmonitor -t rmp -j -m "startup,cycletime=2"
　if %ERRORLEVEL% EQU 0 goto :NORMAL_END
　if %ERRORLEVEL% EQU 1 goto :ERROR_OCCURRED
　if %ERRORLEVEL% EQU 2 goto :TIMEOUT

　OTSシステムの起動を監視する場合。

　#!/bin/sh
　# OTSシステム起動
　otsstart
　otsmonitor -t sys -m "startup"
　ret = "$?"
　if [ $ret -eq 0 ]
　then
　　# normal end
　fi
　if [ $ret -eq 1 ]
　then
　　# error occurred
　fi
　if [ $ret -eq 2 ]
　then
　　# timeout occurred
　fi

　リソース管理プログラムの起動を監視する場合。起動時のタイムアウトを30秒に設定。

　# OTS用のリソース管理プログラムの監視をする場合
　otsstartrsc -pg /home/ots/rdb_resource -n resource1
　otsmonitor -t rmp -n resource1 -m "startup,timeout=30"
　ret = "$?"
　if [ $ret -eq 0 ]
　then
　　# normal end
　fi
　if [ $ret -eq 1 ]
　then
　　# error occurred
　fi
　if [ $ret -eq 2 ]
　then
　　# timeout occurred
　fi

　JTS用のリソース管理プログラムの起動を監視する場合。監視サイクル時間を2秒に設定。

　rem JTS用のリソース管理プログラムの監視をする場合
　otsstartrsc -j
　otsmonitor -t rmp -j -m "startup,cycletime=2"
　ret = "$?"
　if [ $ret -eq 0 ]
　then
　　# normal end
　fi
　if [ $ret -eq 1 ]
　then
　　# error occurred
　fi
　if [ $ret -eq 2 ]
　then
　　# timeout occurred
　fi