ドメインモードエージェントのインストール

ドメインモードの場合、設定を構成する場所はご使用の環境の性質により異なります。ドメインは以下のもので構成されています。
  • ドメインコントローラ(管理および構成サーバー)。domain.xml 構成ファイルは、管理対象ホストのグローバル構成です。
  • ホストコントローラ(1 つまたは複数のアプリケーション サーバ ノードを持つ特定のホストを管理します)。ホストコントローラとノードの数に制限はありません。hosts.xml ファイルには、そのホストマシン上にあるノードの設定が含まれます。ホストマシン

したがって、構成を配置する場所は次のように異なります。

  • domain.xml:管理対象ドメイン内のすべてのホストで同一である可能性のある(つまり、ログマネージャとエージェントのファイルがすべてのマシン上の同じ場所にある)設定は、ドメインコントローラの domain.xml ファイルに移動できます。
  • host.xml:ホストごとに特殊化する必要がある設定(たとえば、ホスト上の関連ファイルへのパスが異なる場合)は、host.xml ファイルに移動する必要があります。

構成設定は、グローバルであるのか、ホスト固有であるのかに応じて、domain.xmlhost.xml の両方に追加できます。次のセクションでは、一般的な設定をドメイン構成に追加し、ノード名の設定をホスト構成に追加する例を示します。

Domain.xmlの構成
  1. ドメイン用に domain.xml を探し編集する。
    このファイルは通常$JBOSS_HOME/domain/configuration/にあります。
  2. system-properties エレメントを見つけ、既存のシステムプロパティに com.singularity の値を持つ jboss.modules.system.pkgs という名のプロパティを追加する。
    例:
    <system-properties>
            <!-- IPv4 is not required, but setting this helps avoid unintended use of IPv6 -->
            <property name="java.net.preferIPv4Stack" value="true"/>
            <property name="jboss.modules.system.pkgs" value="com.singularity"/>
    </system-properties>
    このプロパティは、JBossクラスローダーにAppDynamicsパッケージをロードするよう指示します。これは Java エージェントを実行するのに必須です。

    プロパティ jjboss.modules.system.pkgs が環境で使用可能であることを確認します。プロパティが存在する場合は、 com.singularity を追加します。

    例:
    -Djboss.modules.system.pkgs=org.jboss.byteman,com.singularity
    このプロパティが存在しない場合は、新しいプロパティを設定します。
    -Djboss.modules.system.pkgs=com.singularity
  3. エージェントを有効にするサーバーグループ名の下に、エージェントの位置、JBossアプリケーション名、ティア名に適切な値を使いJVMオプションを追加する。
    <server-group name="main-server-group" profile="full">
        <jvm name="default">
             <heap size="1303m" max-size="1303m"/>
             <permgen max-size="256m"/>
             <jvm-options>
                <option value="-javaagent:<agent_install_dir>/javaagent.jar"/> 
                <option value="-Dappdynamics.agent.applicationName=JBOSS-EAP-APP"/>
                <option value="-Dappdynamics.agent.tierName=JBOSS-EAP-TIER"/>
             </jvm-options>
        </jvm>
        <socket-binding-group ref="full-sockets"/>
     </server-group>
    domain.xml ファイルの変更を有効にするには、管理ホストを再起動する必要があります。変更をサーバーホストに反映させるには、それらも再起動する必要があります。
Host.xmlの構成

ホストごとに、(通常は$JBOSS_HOME/domain/configuration/に配置されている)host.xmlファイルでAppDynamicsノード名を指定します。Splunk AppDynamicshost.xml

このインスタンスのノード名を指定するには、-Dappdynamics.agent.nodeName JVM オプションを追加します。

<servers>
    <server name="server-one" group="main-server-group"> 
            <jvm name="default">
              <jvm-options>
                <option value="-agentlib:jdwp=transport=dt_socket,address=8787,server=y,suspend=n"/>
                <option value="-Dappdynamics.agent.nodeName=JBOSS-EAP-NODE-1"/>
              </jvm-options>
            </jvm>
     </server>
     <server name="server-two" group="main-server-group" auto-start="true">
            <socket-bindings port-offset="150"/>
            <jvm name="default">
              <jvm-options>
                <option value="-Dappdynamics.agent.nodeName=JBOSS-EAP-NODE-2"/>
              </jvm-options>
            </jvm>
      </server>
      <server name="server-three" group="other-server-group" auto-start="false">
            <socket-bindings port-offset="250"/>
      </server>
</servers>

簡潔にするために、サンプルからコメントが削除されています。