Menu Close

Red Hat Training

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

6.6. エージェントの自動更新

エージェントの自動アップグレードであっても、アップグレードプロセスがスムーズに実行され、エージェントが正常に再起動するように JBoss ON エージェントに特定の準備を行う必要があります。

6.6.1. エージェントの自動アップグレード時のプロセス

デフォルトでは、JBoss ON サーバーおよびエージェントはエージェントを自動的にアップグレードするように設定されます。JBoss ON サーバーがアップグレードされるとすぐにエージェントがアップグレードされます。
注記
の説明に従って、エージェントをバックグラウンドで正しくアップグレードする必要があり 「JBoss ON Agent をサービスとして実行」 ます。
自動アップグレードプロセスは、サーバーの更新を確認する通常のエージェントタスクの一部です。
  1. 更新されたサーバーは、更新されたエージェントパッケージをエージェントがアクセスできるディレクトリーに配置します。
  2. サーバーは、サーバーがエージェントが古いバージョンを実行していることを検出し次第、エージェントが更新する必要があることを通知します。
  3. エージェントが更新の準備ができると、他のプロセスをシャットダウンします。各スレッドを正常にシャットダウンするため、数分の時間がかかる場合があります。
  4. エージェントはサーバーから新しいバイナリーをダウンロードします。
  5. エージェントは新しい Java プロセスを開始します。
  6. Java プロセスは古いエージェント設定のバックアップを作成し、更新を適用します。
  7. その後、Java プロセスはエージェントを再起動し、それ自体を強制終了します。
エージェントが更新を開始するように指示したり、エージェントのコマンドラインで更新が利用可能かどうか update を確認するように指示することができます。
agentRoot/rhq-agent/bin/rhq-agent.sh

> update

6.6.2. エージェント設定

Java ホームディレクトリーなどの設定のエージェント設定は、通常使用するために環境変数に設定できます。ただし、アップグレードプロセスが停止してエージェントを再起動すると、シェルに設定した環境変数が失われます。これは、アップグレード後にエージェントを自動的に再起動しないことを意味します。エージェントのカスタム設定(例:) RHQ_AGENT_HOME または RHQ_AGENT_ADDITIONAL_JAVA_OPTS, を rhq-agent-env.sh ファイルに追加する必要があります。このファイルはアップグレード中に保持されるため、すべての設定が続きます。
警告
JBoss ON エージェントの起動に使用するスクリプトは編集しないでください。変更するべきではない 4 つのファイルがあります。
  • rhq-agent.sh
  • rhq-agent-wrapper.sh
  • rhq-agent.bat
  • rhq-agent-wrapper.bat
ランチャースクリプトへの変更は、自動更新時に上書きされます。環境ファイル(など rhq-agent-env.sh )への変更は、更新時に保持されます。

6.6.3. カスタムスクリプト

JBoss ON 3.3 では、カスタムスクリプトをエージェントに配置でき /binます。エージェントがアップグレードされると、エージェントのディレクトリーにある .sh または .bat 拡張のあるファイルは、新しいエージェントの /bin ディレクトリーにコピーされ /bin ます。

6.6.4. カスタム log4j 設定のアップグレード

rhq-agent-env.sh ファイルの Java 設定に対する編集は、アップグレード間で保持されます。また、log4j.xml ファイルに変更を加えた場合、ファイル全体がコピーされます。

6.6.5. カスタム agent-configuration.xml 設定のアップグレード

アップグレードプロセス中に、現在のファイルが新たにインストールされたもの agent-configuration.xml と全く異なる場合は agent-configuration.xml、両方のファイルが保持されます。現在の agent-configuration.xml ファイルは、同じ名前で保持されます。新規インストール後の名前 agent-configuration.xml が変更され agent-configuration.xml.newます。これにより、--cleanconfig オプションを使用してエージェントを再起動すると、カスタム設定を保持することができます。新しい設定が必ず追加されるように、両方のファイルを確認する必要があり agent-configuration.xmlます。
注記
現在のバージョン agent-configuration.xml と新規インストールが同じ場合 agent-configuration.xml は、agent-configuration.xml.new ファイルは作成されません。

6.6.6. キーストアおよびトラストストアの設定

元の JBoss ON エージェントがカスタムキーストアおよびトラストストアを使用して SSL で実行されるよう設定されている場合、アップグレードされたエージェントが引き続きアクセスできるようにこれらのストアが設定されていることを確認してください。
  1. キーストアファイルには、ファイル名に keystore という単語が含まれている必要があります。例: my-agent-keystore.dat
  2. トラストストアファイルには、ファイル名に トラストストア という単語が必要です。例: my-agent-truststore.dat
  3. キーストアとトラストストアファイルは、共にエージェントの agentRoot/rhq-agent/conf/ ディレクトリーに置く必要があります。エージェントの conf/ ディレクトリー内の信頼ファイルは、アップグレード中など、エージェントの設定が消去またはパージされた際に保持されます。
SSL ファイルが適切に設定されている限り、これらのファイルは新しいエージェント設定にコピーされ、新しいエージェントは自動的に SSL で実行されます。

6.6.7. エージェントホームディレクトリーでの書き込み権限の設定

アップグレードプロセスにより、新しいファイルがエージェントの現在のインストールディレクトリーに書き込まれるため、エージェントのシステムユーザーに ディレクトリーへの書き込み権限が必要になります。たとえば、エージェントがインストールされている場合は /opt/rhq/rhq-agent、エージェントユーザーにその /opt/rhq ディレクトリーへの書き込み権限が必要です。
必要に応じて、エージェントのホームディレクトリーの権限をリセットします。例:
[root@server ~]# chown agent_user /opt/rhq

6.6.8. エージェントをバックグラウンドサービスとして起動

「JBoss ON Agent をサービスとして実行」 では、エージェントをバックグラウンドサービスとして実行するように設定する方法を説明します。Windows では、これはサービスとして実行されます。Linux および Unix システムでは、エージェントは init.d から起動時に起動します。
自動アップグレードプロセスでは、エージェントがバックグラウンドで実行されていることを前提としています。エージェントがバックグラウンドデーモンとして実行されていない場合は、エージェントの自動更新時にコンソールで実行している古いエージェントプロセスはシャットダウンし、可能な場合は新しいエージェントがバックグラウンドサービスとして再起動します。