Red Hat Training
A Red Hat training course is available for Red Hat JBoss Operations Network
6.2. JAR ファイルからのエージェントのインストール
- ブラウザーで、サーバー上のダウンロード URL を示します。例:
http://server.example.com:7080/agentupdate/download
エージェントをインストールするディレクトリー.jar
に、エージェントバイナリーの更新を保存します。保存するファイルには.jar
拡張子があるはずです。 - JBoss ON サーバーからダウンロード
.jar
したエージェント更新バイナリーをディレクトリーにコピーします。 - JAR をインストールします。
java -jar downloaded_agent_jar_file.jar --install
これにより、エージェント更新バイナリーに、JBoss ON エージェントディストリビューションを展開し、rhq-agent
サブディレクトリーに新しいコピーをインストールするように指示されます。重要名前にスペースがあるディレクトリーにエージェントをインストールしないでくださいC:\Program Files
。pathname に空白のディレクトリーにエージェントをインストールすると、エージェントが特定のタイプのリソース(一部の JBoss サービスを含む)への接続を確立する際に問題が生じる可能性があります。 - エージェントの環境変数として JRE へのパスを設定します。エージェントでは、Java ホームディレクトリーが設定で明示的に設定されている必要があります。
agentRoot/rhq-agent/bin/rhq-agent-env.sh
ファイルを開き、アンコメントを解除するか、RHQ_JAVA_HOME 変数の行を追加します。export RHQ_JAVA_HOME=/usr
- エージェントを起動して、設定プロセスを開始します。
agentRoot/rhq-agent/bin/rhq-agent.sh
注記設定をすべて一度に送信して、設定ウィザードをスキップすること 「エージェントのサイレントインストール」 ができます。には、設定をエージェントインストーラーに直接渡すことのできるファイルの設定の詳細が記載されています。 - プロンプトが表示されたら、エージェントとサーバー接続の情報を入力します。
[Agent Name] agentdomain.example.com [Agent Hostname or IP Address] agentdomain.example.com [Agent Port] 16163 [JON Server Hostname or IP Address] server.example.com [JON Server Port] 7080 native enable
- エージェント名は、JBoss ON デプロイメントのすべてのエージェント間で一意でなければなりません。デフォルトでは、名前はホストマシンの完全修飾ドメイン名です。
- ポートは、エージェントがサーバーから受信メッセージをリッスンするのに使用するものです。これは、デフォルト値が使用されていない場合
rhq.agent.server.bind-port
に設定ファイル内にあります。 - サーバーのホスト名とポートは、JBoss ON システムに登録するためにエージェントによって使用されます。これは、登録後にエージェントが使用する必ずしもプライマリーサーバーとは限りません。設定ファイルでは、はとに
rhq.agent.server.bind-address
なります。rhq.agent.server.bind-port
高度な設定オプションなど、パラメーターの完全な一覧をに記載されてい 表6.2「詳細設定で使用可能なすべてのオプション」 ます。 - の説明に従って、エージェントをバックグラウンドサービスとして設定し 「JBoss ON Agent をサービスとして実行」 ます。
エージェントが設定されると、Java Preferences バッキングストアでその設定が永続化されます。これが発生すると、
agent-configuration.xml
不要となったり、使用されるようになりました。エージェントを再起動しても、編集してもエージェント agent-configuration.xml
は影響を受けなくなります。agent-configuration.xml
ファイルへの変更を取得するには、コマンドラインオプションでエージェントを再起動するか、config --import agent prompt --cleanconfig コマンドで設定を再読み込みする必要があります。
重要
エージェントがサーバーへの登録に失敗し、メッセージを出力した後にハングしていると思われます 。エージェントにプラグインがない場合、ダウンロード後またはプロパティーが設定されていないのを待機 します。そうでない場合は、エージェントログファイルでエラーメッセージ(agentInstallDir)
/logs/agent.log
を確認してください。
通常、エージェントが解決できない、または JBoss ON サーバーからアクセスできない IP アドレスまたはホスト名にバインドしたときに問題が発生します。
同様に、JBoss ON サーバーのパブリックエンドポイントアドレスがすべて JBoss ON エージェントによって解決可能であることを確認してください。エージェントが登録するために入力された JBoss ON サーバーは、エージェントがプライマリーサーバーとして使用するものとは異なる場合があります。高可用性の設定により異なります。エージェントがそのサーバーに接続できない場合は、正しく起動できません。
表6.2 詳細設定で使用可能なすべてのオプション
設定オプション | description | 通常の設定または高度な設定 |
---|---|---|
エージェントのホスト名または IP アドレス | サーバーからメッセージをリッスンするバインドするアドレス。これは通常、JBoss ON サーバーがエージェントへの接続に使用するアドレスと同じです。ネットワーク環境によりアドレスが異なる場合、トランスポートパラメーターを設定してアドレスを解決する必要があります。 | normal |
エージェントポート | エージェントがリッスンするポート番号。IP アドレスと同様に、これは、エージェントへの接続に使用するサーバーに設定したポートと同じですが、ネットワーク環境によりこれらのポートが異なる場合は、トランスポートパラメーターを設定してポートを解決する必要があります。 | normal |
エージェント転送プロトコル | エージェントがサーバーから受信メッセージの受信に使用することが予想されるプロトコルを設定します。これは通常、ソケットまたは sslsocket です。 | Advanced |
エージェント転送のパラメーター | agent-server 接続のリモーティングフレームワークによって使用されるロケーター(URL 形式のアドレス)の最後に追加するトランスポートパラメーターを設定します。 | Advanced |
RHQ サーバーのホスト名または IP アドレス | エージェントが通信するプライマリーサーバーの IP アドレスまたはホスト名を指定します。この情報は、JBoss ON サーバー設定で設定されたホスト名または IP アドレスと同じである 必要 があります。 | normal |
RHQ サーバーポート | エージェントが通信するプライマリーサーバーのポート番号を指定します。この情報は、JBoss ON サーバー設定で設定されたポート番号と同じである 必要 があります。 | normal |
RHQ サーバートランスポートプロトコル | エージェントが JBoss ON サーバーへの送信メッセージに使用するトランスポートプロトコルを設定します。この情報は、サーバーが設定設定で想定されるように設定されたトランスポートメソッドと同じである 必要 があります。 | Advanced |
RHQ サーバートランスポートパラメーター | エージェントがプライマリー JBoss ON サーバーに接続するときに使用する追加のトランスポートパラメーターを指定します。これはサーバーへの接続に使用されるため、これらのパラメーターは JBoss ON サーバー設定で設定されたトランスポートパラメーターと同じである 必要 があります。これらの設定は、JBoss ON サーバーが実際にバインドするものとは異なるホストまたはポートに接続する必要がある場合に特に重要になります。 | Advanced |