<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="http://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
IronJacamar RHQ platform
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="http://community.jboss.org/people/jeff.zhang">Jeff Zhang</a> in <i>IronJacamar Development</i> - <a href="http://community.jboss.org/docs/DOC-16378">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><h1>Goals</h1><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>The goals of the IronJacamar RHQ plugin is to provide a RHQ 4 plugin for the IronJacamar container which exposes the metrics and operations of the deployed resource adapters.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Second, it is to provide a RHQ platform for the standalone IronJacamar distribution using the GWT based user interface as the new management UI.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h1>Design</h1><p>1. RHQ 4 + Plugin + Embedded JCA</p><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-16378-3-11452/plugin1.jpg"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-3-11452/450-317/plugin1.jpg </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>2. RHQ 4 + Plugin + Standalone JCA</p><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-16378-3-11453/plugin2.jpg"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-3-11453/450-317/plugin2.jpg </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>3. JBoss AS 7 + Admin Console + Plugin + JCA Module</p><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-16378-3-11454/plugin3.jpg"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-3-11454/450-317/plugin3.jpg </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h1>Implementation</h1><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>The management integration with IronJacamar must be built based on the</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive-pre"><code class="jive-code">org.jboss.jca.core.api.management
</code></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>package. A</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre ___default_attr="plain" class="jive_text_macro jive_macro_code"><p>org.jboss.jca.core.api.management.ManagementRepository</p></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>instance must be injected into the RHQ plugin in order to etablish the connection between the plugin and the container.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h2>Code</h2><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>To build rhq plugin for IronJacamar:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive-pre"><code class="jive-code">svn co http://anonsvn.jboss.org/repos/jbossas/projects/jboss-jca/trunk/ jboss-jca
cd jboss-jca
ant rhq
</code></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h1>Supported metrics and operations</h1><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h1>How to run plugin on RHQ 4</h1><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Download RHQ4 DR3 from <a class="jive-link-external-small" href="http://rhq-project.org/display/RHQ/Download">http://rhq-project.org/display/RHQ/Download</a></li><li>unzip to empty directory</li><li>Make sure Java JDK/JRE installed</li><li>Start RHQ server</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive-pre"><code class="jive-code">cd <RHQ_Server>/bin
./rhq-server.sh start
</code></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li><span>browse </span><a class="jive-link-external-small" href="http://localhost:7080" target="_blank">http://localhost:7080</a></li><li>Install RHQ database and do post-install (use h2 sql as test database and use standalone agent)</li><li>Download RHQ agent jar from Administrator -> Download and install it into a empty directory</li><li>login in to RHQ console (rhqadmin : rhqadmin)</li><li>Administrator -> Plugin, Install ironjacamar-rhq-plugin.jar</li><li>Start RHQ agent</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive-pre"><code class="jive-code">cd <RHQ_Agent>/bin
./rhq-agent.sh
</code></pre><ul><li>Inventory -> Discovery Queue, find IronJacamar_AS7</li><li>click "import" button on the bottom</li><li>Inventory -> Servers, click IronJacamar_AS7</li></ul><h1>Screenshots</h1><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-16378-3-11451/Screenshot.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-3-11451/450-266/Screenshot.png </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h1>Links</h1><ul><li><a class="jive-link-external-small" href="http://www.rhq-project.org/display/RHQ/Home">RHQ</a></li><li><a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-16363">Management console design for AS 7</a></li><li><a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-16376">Management console roadmap for AS 7</a></li></ul></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="http://community.jboss.org/docs/DOC-16378">going to Community</a></p>
<p style="margin: 0;">Create a new document in IronJacamar Development at <a href="http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2099">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>