Menu Close

Red Hat Training

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

6.2. JAR ファイルからのエージェントのインストール

  1. ブラウザーで、サーバー上のダウンロード URL を示します。例:
    http://server.example.com:7080/agentupdate/download
    エージェントをインストールするディレクトリー .jar に、エージェントバイナリーの更新を保存します。保存するファイルには .jar 拡張子があるはずです。
  2. JBoss ON サーバーからダウンロード .jar したエージェント更新バイナリーをディレクトリーにコピーします。
  3. JAR をインストールします。
    java -jar downloaded_agent_jar_file.jar --install
    これにより、エージェント更新バイナリーに、JBoss ON エージェントディストリビューションを展開し、rhq-agent サブディレクトリーに新しいコピーをインストールするように指示されます。
    重要
    名前にスペースがあるディレクトリーにエージェントをインストールしないでください C:\Program Files
    pathname に空白のディレクトリーにエージェントをインストールすると、エージェントが特定のタイプのリソース(一部の JBoss サービスを含む)への接続を確立する際に問題が生じる可能性があります。
  4. エージェントの環境変数として JRE へのパスを設定します。エージェントでは、Java ホームディレクトリーが設定で明示的に設定されている必要があります。
    agentRoot/rhq-agent/bin/rhq-agent-env.sh ファイルを開き、アンコメントを解除するか、RHQ_JAVA_HOME 変数の行を追加します。
    export RHQ_JAVA_HOME=/usr
  5. エージェントを起動して、設定プロセスを開始します。
    agentRoot/rhq-agent/bin/rhq-agent.sh
    注記
    設定をすべて一度に送信して、設定ウィザードをスキップすること 「エージェントのサイレントインストール」 ができます。には、設定をエージェントインストーラーに直接渡すことのできるファイルの設定の詳細が記載されています。
  6. プロンプトが表示されたら、エージェントとサーバー接続の情報を入力します。
    [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「詳細設定で使用可能なすべてのオプション」 ます。
  7. の説明に従って、エージェントをバックグラウンドサービスとして設定し 「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