Red Hat Training

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

7.2. RPM からのエージェントのインストール

JBoss ON エージェントは jboss-on-agent-3.3 パッケージからインストールされます。このパッケージはすべてのエージェントファイルをインストールし、特定の JBoss ON エージェントシステムユーザーを作成し、JBoss ON エージェントをシステムサービスとして設定します。
重要
この手順では、JBoss ON によって管理されるプラットフォームでエージェントをインストールおよび管理します。
このシステムが JBoss ON サーバーをホストする場合は、の説明に従って、サーバーのインストールプロセスの一部としてエージェントをインストールし 3章JBoss ON Server のインストール ます。JBoss ON サーバーと同じマシン上のエージェントは、エージェント RPM からインストールまたは管理できます。rhqctl スクリプトを使用してインストールおよび管理する必要があります。

7.2.1. yum を使用したインストール

インストールの前に、前述のセクションで説明されているように、関連する Red Hat JBoss Enterprise Application Platform リポジトリーを追加していることを確認してください 「JBoss ON エージェントを提供するリポジトリーの有効化」
注記
RPM をインストールするには、3.3 リリースの RHN ユーザーアカウントの特定のエンタイトルメントが必要です。適切なリポジトリーにアクセスできるように、この RHN ユーザーアカウントを使用してシステムを登録する必要があります。
  1. を使用 yum してパッケージをインストールします。
    [root@server ~]# yum install jboss-on-agent-3.3
    これにより、にエージェントがインストールされ /usr/share/jboss-on-3.3.2.GA/agentます。
  2. service jon-agent config コマンドを実行してエージェントを設定します。これは、高度なインストーラーで実行され、エージェントを設定します。
    [jsmith@server ~]$ sudo service jon-agent config
    RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
    ** Advanced Setup **
    ... 8< ...
    Agent Name [agent.example.com] : agent1
    Agent Hostname or IP Address [!*] :
    Agent Port [16163] :
    Agent Transport Protocol [socket] :
    Agent Transport Parameters [numAcceptThreads=1&maxPoolSize=303&clientMaxPoolSize=304&socketTimeout=60000&enableTcpNoDelay=true&backlog=200] :
    RHQ Server Hostname or IP Address [255.255.255.255] :
    RHQ Server Port [7080] :
    RHQ Server Transport Protocol [servlet] :
    RHQ Server Transport Parameters [/jboss-remoting-servlet-invoker/ServerInvokerServlet] :
    RHQ Server Alias [rhqserver] :
    The setup has been completed for the preferences at node [/rhq-agent/default].
    この config コマンドは、すべての高度な設定オプションで実行し、エージェントの 3 つのエリアを設定します。
    • エージェントをサーバーに登録するために使用されるエージェント接続情報
      • エージェント名
      • エージェントポート
      • エージェントホスト(ホスト名または IP アドレスによる)
    • エージェントとの通信の頻度に関する SSL またはセキュアな接続およびルールの設定を含む agent-server 通信設定
      • ソケット(通常)または sslsocket(secure)のいずれかのエージェントプロトコル。
        sslsocket の場合は、JBoss ON サーバー 『およびエージェントの設定の SSL 接続を許可するよう JBoss ON サーバーを設定する必要が』 あります。
      • サーバーへの接続に使用するクライアントトランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。トランスポートパラメーターには、プールサイズ、タイムアウト期間、バッファー設定が含まれます。完全なリストは、JBoss Remoting クライアントパラメーターのドキュメントを参照してください
      • エージェントがサーバーへのメッセージを送信するために使用するサーバープロトコル(通常の)または sslservlet(セキュア)
        エージェントで設定したサーバー接続設定は、サーバー自体の設定と一致している 必要 があります。
      • エージェントからメッセージを受信するために使用するサーバートランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。サーバーのトランスポートパラメーターは、エージェントメッセージの受信に使用されるサーブレットに関連します。
    • 登録する JBoss ON サーバー
      • サーバーホスト(ホスト名または IP アドレスによる)
      • サーバーポート
      • サーバーインスタンスを識別するための短いニックネームサーバーエイリアス。
  3. エージェントを起動します。
    [jsmith@server ~]$ sudo service jon-agent start

7.2.2. RPM のダウンロードによるインストール

  1. でカスタマーポータルにログインし https://access.redhat.com ます。
  2. Downloads タブをクリックします。
  3. Packages ボックスをクリックして、エージェント RPM パッケージを検索します。
  4. パッケージ名 jboss-on-agent として入力し、In the following architectures ラジオボタンを選択して、システムに適したアーキテクチャーを設定します。
  5. パッケージ名をクリックし、最新のエージェント RPM 更新の名前をクリックします。
  6. ページの下部までスクロールし、Download Package リンクをクリックして、パッケージをシステムの任意の場所に保存します。
  7. rpm コマンドを使用してインストールします。例:
    [root@server ~]# rpm -ivh /tmp/downloads/jboss-on-agent-3.3.2.GA.el6.noarch.rpm
    これにより、にエージェントがインストールされ /usr/share/jboss-on-3.3.2.GA/agentます。
  8. service jon-agent config コマンドを実行してエージェントを設定します。これは、高度なインストーラーで実行され、エージェントを設定します。
    [jsmith@server ~]$ sudo service jon-agent config
    RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
    ** Advanced Setup **
    ... 8< ...
    Agent Name [agent.example.com] : agent1
    Agent Hostname or IP Address [!*] :
    Agent Port [16163] :
    Agent Transport Protocol [socket] :
    Agent Transport Parameters [numAcceptThreads=1&maxPoolSize=303&clientMaxPoolSize=304&socketTimeout=60000&enableTcpNoDelay=true&backlog=200] :
    RHQ Server Hostname or IP Address [255.255.255.255] :
    RHQ Server Port [7080] :
    RHQ Server Transport Protocol [servlet] :
    RHQ Server Transport Parameters [/jboss-remoting-servlet-invoker/ServerInvokerServlet] :
    RHQ Server Alias [rhqserver] :
    The setup has been completed for the preferences at node [/rhq-agent/default].
    この config コマンドは、すべての高度な設定オプションで実行し、エージェントの 3 つのエリアを設定します。
    • エージェントをサーバーに登録するために使用されるエージェント接続情報
      • エージェント名
      • エージェントポート
      • エージェントホスト(ホスト名または IP アドレスによる)
    • エージェントとの通信の頻度に関する SSL またはセキュアな接続およびルールの設定を含む agent-server 通信設定
      • ソケット(通常)または sslsocket(secure)のいずれかのエージェントプロトコル。
        sslsocket の場合は、JBoss ON サーバー 『およびエージェントの設定の SSL 接続を許可するよう JBoss ON サーバーを設定する必要が』 あります。
      • サーバーへの接続に使用するクライアントトランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。トランスポートパラメーターには、プールサイズ、タイムアウト期間、バッファー設定が含まれます。完全なリストは、JBoss Remoting クライアントパラメーターのドキュメントを参照してください
      • エージェントがサーバーへのメッセージを送信するために使用するサーバープロトコル(通常の)または sslservlet(セキュア)
        エージェントで設定したサーバー接続設定は、サーバー自体の設定と一致している 必要 があります。
      • エージェントからメッセージを受信するために使用するサーバートランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。サーバーのトランスポートパラメーターは、エージェントメッセージの受信に使用されるサーブレットに関連します。
    • 登録する JBoss ON サーバー
      • サーバーホスト(ホスト名または IP アドレスによる)
      • サーバーポート
      • サーバーインスタンスを識別するための短いニックネームサーバーエイリアス。
  9. エージェントを起動します。
    [jsmith@server ~]$ sudo service jon-agent start