CA APM TG コマンド ライン ユーティリティ(WTGUtil)
内容
apmdevops96jp
内容
CA APM TG コマンド ライン ユーティリティ(WTGUtil)では 7 つの基本的なコマンドを使用できます。
WTGUtil は通常、サーバの定期メンテナンス期間中にサーバに要求を行うように設定されたスクリプトまたはスクリプトのグループを無効にする場合、およびその期間が完了してサーバが完全に操作可能になったときにスクリプトまたはグループを有効にする場合に使用されます。
このユーティリティは、手動で起動するか、Windows バッチ ファイルまたは Linux シェル スクリプトを使用して起動します。 Windows のタスク スケジューラまたは Linux の cron ジョブを介して、バッチ ファイルまたはスクリプトを特定の時間に実行するようにスケジュールできます。
基本コマンドの説明
すべてのコマンドは、CA APM TG エージェントに対するリクエスト メッセージという形で行われます。 エージェントは、コマンドが受理されたかどうか、適切な形式であるか、およびコマンド実行後に動作可能かどうかを示す応答メッセージを送信します。
- list agent- CA APM TG エージェントによって記録された最後のステータス メッセージを要求します。
- load agent- 変更されたスクリプトまたはすべてのスクリプトをロードするように CA APM TG に要求します。
- disable group- グループを無効にします。
- enable group- グループを有効にします。
- enable object- スクリプトを有効にします。
- disable object- スクリプトを無効にします。
- Startramp- 事前設定された特定のスクリプトのロード ランピングを開始します。
WTGUtil コマンドの構文
wtgutil
verb type ID
=[-hHOST
] [-pPORT
]- verb =disable | enable | list | load | startramp
- disable/enable は、type = group/object の場合に適用
- startramp は type = object の場合のみに適用
- list/load は、type = agent の場合に適用
- Type =group | object | agent
- ID =Verb 固有の引数は以下のとおりです。
- type = group/object の場合、ID =グループ名/スクリプト名
- load と type = agent を指定する場合、ID = modscripts または allscripts (大文字小文字の区別)
- list agent と指定する場合は不要
注:type の ID では、大文字と小文字が区別されます。 スペースを含むパラメータは引用符で囲む必要があります。 - HOST =CA APM TG エージェントのホスト名または IP アドレス(デフォルト= localhost)。この引数はオプションです。 指定しない場合は、デフォルトのホスト(localhost)が使用されます。
- PORT =CA APM TG エージェントのポート(デフォルト= 7700)この引数はオプションです。 指定しない場合は、デフォルトのポート 7700 が使用されます。
注:
引数を省略するか、または誤った引数を使用してユーティリティを実行すると、使用構文が表示されます。例
最初のコマンド例では、localhost のポート 7700 上にある CA APM TG エージェントからの最後のステータス メッセージを要求します。
wtgutil list agentwtgutil list agent -husmb78.ca.com -p7890wtgutil load agent id=allscriptswtgutil disable group id=TestGroupwtgutil enable group id=TestGroupwtgutil disable object id=test1wtgutil enable object id=test1wtgutil startramp object id=sample
トレース メッセージ
WTGUtil は、タイム スタンプが設定されたすべてのトレース メッセージを STDOUT およびログ ファイルに書き込みます。 ログ ファイルの名前は wtgutil.log であり、 \log にあります。
以下の例に示すように、ローカルの CA APM TG エージェントに対する Successful コマンドが、通常のトレース メッセージとなります。
C::\>wtgutil list agent10/17/2014 17:21:45.265 - [INFO ] List Agent10/17/2014 17:21:45.343 - [INFO ] Connected - Host: pc-2, IP: 127.0.0.1, Port: 770010/17/2014 17:21:45.343 - [INFO ] Batch process complete - Added:110/17/2014 17:21:45.343 - [INFO ] Disconnecting...10/17/2014 17:21:45.375 - [INFO ] Successful