Red Hat Training
A Red Hat training course is available for Red Hat JBoss Operations Network
7.3. エージェントのコマンドプロンプトの使用
エージェントがターミナルで起動すると(エージェントプロセスを開始して)、スクリプトはエージェントコマンドプロンプトを起動します。エージェントプロンプトを使用してエージェントを管理するには、設定の確認、一部のタスクの実行、またはエージェントの設定の編集を行います。
7.3.1. エージェントのコマンドプロンプトを開く
エージェントの起動スクリプトを実行すると、エージェントコマンドプロンプトが開きます。
$ rhq-agent.sh
7.3.2. エージェント起動オプション
エージェント管理によっては、rhq-agent.sh 開始スクリプトでオプションを渡すことで実行できます。これらは主に、入力ファイルまたは渡されたパラメーターを使用して外部設定を読み込んでサーバーに永続的な設定オプションを渡すことを目的としています。これらのオプションはに記載されてい 表7.1「rhq-agent.sh スクリプトのオプション」 ます。
表7.1 rhq-agent.sh スクリプトのオプション
短い引数 | 長い引数 | description |
---|---|---|
-a | --advanced | 基本的な開始モードではなく、設定モードでエージェントスクリプトを実行します。 |
-c | --config=filename | ファイルシステムまたはクラスパスのエージェント設定ファイルを指定します。 |
-d | --daemon | エージェントをデーモンモードで実行します。つまり、stdin から追加のコマンドが読み取られません。 |
-Dname[=value] | エージェント設定の設定を上書きし、システムプロパティーを設定します。 | |
-e | --console=type | コンソール入力の読み取り時に使用する実装を指定します。使用できる 3 つの値は jline、sigar、および java です。 |
-g | --purgeplugins | すべてのプラグインを削除し、すべてのプラグインを再ダウンロードするよう強制します。 |
-h | --help | ヘルプメッセージを開きます。 |
-i | --input=filename | 入力に使用するスクリプトファイルを指定します。 |
-l | --cleanconfig | 既存の設定およびデータファイルをすべて消去します。これにより、エージェントは保持されるエージェントセキュリティートークンを 除き、空白の設定で起動します。 |
-L | --fullcleanconfig | 既存の設定ファイルおよびデータファイルを消去します。これにより、エージェントはセキュリティートークンのパージなど、完全にクリーンなスレートで起動します。 |
-n | --nostart | エージェントプロセスを開始せずに、エージェントスクリプトを実行します。 |
-o | --output=filename | スクリプトからすべての出力を書き込むファイルを指定します。ただし、ログメッセージはエージェントログに常に書き込まれます。 |
-p | --pref=preferences_name | エージェント設定に使用する Java プリファレンスノードを指定します。 |
-s | --setup | エージェントがセットアップに関する質問を強制します。 |
-t | --nonative | エージェントがネイティブシステムを無効にするように強制します。 |
-u | --purgedata | 永続インベントリーおよびその他のデータファイルをパージします。 |
-- | エージェントがオプションの処理を停止します。 |
7.3.3. エージェントプロンプトコマンド
エージェントは、エージェントプロンプトを介して対話的に渡される、または起動スクリプトの起動時に渡すことのできる入力ファイルから渡されるプロンプトコマンドを処理します。エージェントプロンプトコマンド(にリストされている 表7.2「エージェントプロンプトコマンド」)は、リソースの管理(可用性、検出の実行、監視情報の確認)、エージェント自体の管理(サーバーへの登録、プラグインの読み込み、構成設定の表示または再読み込みなど)に使用できます。
表7.2 エージェントプロンプトコマンド
prompt コマンド | description |
---|---|
avail
|
従来のリソースの可用性を提供します。
|
config
|
エージェントの設定を管理します。
|
debug
|
エージェントのデバッグに役立つ機能を提供します。
|
検出
|
サーバースキャン検出の実行をプラグインに要求します。
|
ダウンロード
|
JBoss ON サーバーからファイルをダウンロードします。
|
dumpspool
|
コマンドの spool ファイルにあるエントリーを表示します。
|
exit
|
エージェントの通信サービスをシャットダウンし、エージェントを強制終了します。
|
フェイルオーバー
|
高可用性サーバーのフェイルオーバーリストを表示または更新します。
|
gc
|
ガベージコレクターを呼び出してメモリーを解放するのに役立ちます。
|
getconfig
|
1 つ、複数のエージェント設定設定、またはすべてのエージェント設定設定設定を表示します。
|
help
|
指定コマンドのヘルプを表示します。
|
識別
|
リモートサーバーの特定を要求します。
|
インベントリー
|
現在のリソースのインベントリーに関する情報を提供します。
|
log
|
ログメッセージの設定を行います。
|
metrics
|
は、エージェントメトリクスを表示します。
|
ネイティブ
|
ネイティブシステム情報にアクセスします。
|
pc
|
プラグインコンテナーおよびデプロイされたすべてのプラグインを開始して停止します。
|
PING
|
JBoss ON サーバーを ping します。
|
piql
|
PIQL クエリーを実行して、実行中のプロセスを検索します。
|
plugins
|
エージェントプラグインを、サーバーからの最新バージョンで更新します。
|
quit
|
エージェントプロンプトを終了します(エージェントを停止せずに)。
|
登録
|
このエージェントを JBoss ON サーバーに登録します。
|
スケジュール
|
指定されたリソースの測定スケジュール情報を取得します。
|
sender
|
コマンド送信を開始または停止するためにコマンドセンダーを制御します。
|
setconfig
|
エージェント設定の優先度を設定します。
|
設定
|
一連の質問を行い、エージェントの設定を設定します。
|
shutdown
|
エージェントを強制終了せずに、すべての通信サービスをシャットダウンします。
|
sleep
|
エージェントプロンプトを一定期間スリープ状態にします。
|
start
|
リモート要求を許可できるように、エージェントがサービスを起動します。
|
timer
|
別のプロンプトコマンドを実行するのにかかる時間。
|
update
|
エージェントの更新機能を提供します。
|
version
|
エージェントのバージョン情報を表示します。
|