How do I set up JBoss 7 AS in Domain Mode with Introscope Agent and see JMX metrics?

Products

• CA Application Performance Management Agent (APM / Wily / Introscope)
• INTROSCOPE

Issue/Introduction

What is needed to see JMX metrics using Introscope Agent with JBoss AS 7 running in Domain Mode?

Environment

• Application Performance Management 9.7 or higher.

Resolution

Configure JBoss 7 AS in Domain mode

The JBoss 7 AS console differs from the JBoss 6 EAP console. Here are the steps to configure the agent in JBoss 7 AS Domain mode at a server or server group level:

1. Stop JBoss
2. Open the [JBoss 7 AS Home]\domain\configuration\host.xml file with a text editor.
3. Modify the section so that it looks similar to the one shown below. Note that for the first two property names, boot-time must be set to true. 
   
   

   <servers>
    <server name="server-one"
            group="main-server-group"
            auto-start="true">
     <system-properties>
      <property name="com.wily.introscope.agentProfile"
                value="C:/jboss-as-7.1.0.Final/wily/core/config/IntroscopeAgent.profile"
                boot-time="true"/>
      <property name="jboss.modules.system.pkgs"
                value="com.wily,com.wily.*"
                boot-time="true"/>
     </system-properties>
     <jvm name="default">
      <jvm-options>
       <option value="-javaagent:C:/jboss-as-7.1.0.Final/wily/Agent.jar"/>
       <option value="-Dcom.wily.introscope.agentProfile=C:/jboss-as-7.1.0.Final/wily/core/config/IntroscopeAgent.profile"/>
       <option value="-Djboss.modules.system.pkgs=org.jboss.byteman,com.wily,com.wily.*"/>
       <option value="-Dcom.wily.introscope.agent.agentName=Server1"/>
      </jvm-options>
     </jvm>
    </server>
    <server name="server-two"
            group="main-server-group"
            auto-start="true">
     <jvm name="default">
      <jvm-options>
       <option value="-javaagent:C:/jboss-as-7.1.0.Final/wily/Agent.jar"/>
       <option value="-Dcom.wily.introscope.agentProfile=C:/jboss-as-7.1.0.Final/wily/core/config/IntroscopeAgent.profile"/>
       <option value="-Djboss.modules.system.pkgs=org.jboss.byteman,com.wily,com.wily.*"/>
       <option value="-Dcom.wily.introscope.agent.agentName=Server2"/>
      </jvm-options>
     </jvm>
     <socket-bindings port-offset="150"/>
    </server>
    <server name="<server_hostname>"
            group="other-server-group"
            auto-start="false">
     <socket-bindings port-offset="250"/>
    </server>
   </servers>

4. Save and exit.
5. Restart JBoss

Additional Information

 Note that these instructions differ from what is needed for JBoss 6 EAP. A separate article discusses the steps to take for JBoss 6 EAP.  See below

How do I set up JBoss 6 EAP with the Introscope Agent and seeJMX metrics