Menu Close

Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

7.3. RPM インストール後のエージェント設定の変更

エージェント設定には、2 つの部分があります。
  • エージェントインスタンスとサーバーとの通信方法を定義するエージェント接続プロパティー。
  • エージェントのパフォーマンスとオプションを管理するエージェント JVM プロパティー

7.3.1. エージェント接続設定の変更

エージェントの接続プロパティーは、エージェントのインストール時に定義されます。これには、接続先のサーバー、ポート番号、および SSL 接続を使用するサーバーなどの情報が含まれます。
そのエージェント接続設定は、最初に起動時にセットアッププロンプトで入力 agent-configuration.xml した値が、最初に読み取られて上書きされます。エージェントの初期設定後、エージェントはその設定を Java 設定(/var/lib/jboss-on/agent/prefs/.java/.userPrefs/rhq-agent/default/)で永続化し、agent-configuration.xml 再度参照しません。
その情報を変更するには、エージェント接続情報を削除してリセットする必要があります。
エージェントの接続(登録)設定を変更するには、config service コマンドを使用して再度設定オプションを介して実行します。これにより、設定ストアが消去され、agent-configuration.xml ファイルの再読み取りが行われ、設定が再度実行されます。
重要
RPM から JBoss ON エージェントをインストールすると、自動的にシステムサービスとして設定されます。データの一貫性とエージェントのパフォーマンスは、設定ファイルや JVM 起動プロパティーを直接編集しようとするのではなく、サービスツールを使用してエージェント接続設定を常に管理します。
例:
[jsmith@server ~]$ sudo service jon-agent config
RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
** Advanced Setup **
Agent Name [agent.example.com] : agent1
Agent Hostname or IP Address [!*] :
Agent Port [16163] :
Agent Transport Protocol [socket] :
... 8< ...
config service コマンドはエージェント起動スクリプトを開き、エージェント接続設定を編集する一連のオプションを自動的に渡します。
  • --cleanconfig, 以前の設定を消去するには
  • --setup また --advanced、エージェントの設定を再度実行するように強制します。
  • --daemon さらに --nostart、エージェントプロセスを開始せずにエージェントのコマンドプロンプトを実行し、終了します(これにより、エージェントをサービスとして起動可能)。
したがって、service jon-agent config コマンドは、これらのすべてのオプションでエージェントを起動するのと同じです。
rhq-agent.sh --cleanconfig --setup --advanced --daemon --nostart

7.3.2. エージェント JVM および他の Init 設定の変更

エージェントの設定後、オプションの JVM 設定(永続設定)は init スクリプト、/etc/init.d/jon-agent ファイル、または環境スクリプトで設定され rhq-agent-env.shます。どちらのファイルがエージェントを起動するたびに読み込まれます。init スクリプトを編集することが推奨されます。これにより、追加の JAVA_OPTS 値を設定することが推奨されます。
例:
RHQ_AGENT_ADDITIONAL_JAVA_OPTS="-Drhq.agent.data-directory=$RHQ_AGENT_DATA_DIR -Djava.util.prefs.userRoot=$RHQ_AGENT_PREFS_DIR -Xms64m -Xmx128m -Djava.net.preferIPv4Stack=true"
export RHQ_AGENT_ADDITIONAL_JAVA_OPTS
のような agent prompt コマンドを使用して、Java 設定を編集することもでき setconfigます。これは、「 JBoss ON のサーバーおよびエージェントの設定 」を参照してください。