Goals
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.
Second, it is to provide a RHQ platform for the standalone IronJacamar distribution using the GWT based user interface as the new management UI.
Design
1. RHQ 4 + Plugin + Embedded JCA
http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-6-11452/450-317/plugin1.jpg
2. RHQ 4 + Plugin + Standalone JCA
http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-6-11453/450-317/plugin2.jpg
3. JBoss AS 7 + Admin Console + Plugin + JCA Module
http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-6-11454/450-317/plugin3.jpg
Implementation
The management integration with IronJacamar must be built based on the
org.jboss.jca.core.api.management
package. A
org.jboss.jca.core.api.management.ManagementRepository
instance must be injected into the RHQ plugin in order to etablish the connection between the plugin and the container.
Some important interfaces and classes:
- org.jboss.jca.rhq.core.Discover SPI for discovery (getManagementRepository)
- org.jboss.jca.rhq.core.EmbeddedJcaDiscover Test implementation of Discover using embedded IronJacamar
- org.jboss.jca.rhq.core.BaseResourceComponent Base class to implement basic methods of the ResourceComponent interfaces
- IronJacamarResourceDiscoveryComponent and IronJacamarResourceComponent "Root" RHQ components of inventory tree
Inventory tree:
IronJacamar_AS7
- Resource Adapters
- xa.rar
- ResourceAdpater
- ConfigProperty
- (operations)
- Connection Factories
- jndiName
- ManagedConnectionFactory
- ConfigProperty
- PoolConfiguration
- Pool
- (operations)
- AdminObjects
- jndiName
- ConfigProperty
Code
To build rhq plugin for IronJacamar:
svn co http://anonsvn.jboss.org/repos/jbossas/projects/jboss-jca/trunk/ jboss-jca
cd jboss-jca
ant rhq
Supported metrics and operations
How to run plugin on RHQ 4
cd <RHQ_Server>/bin
./rhq-server.sh start
- browse http://localhost:7080
- Install RHQ database and do post-install (use h2 sql as test database and use standalone agent)
- Download RHQ agent jar from Administrator -> Download and install it into a empty directory
- login in to RHQ console (rhqadmin : rhqadmin)
- Administrator -> Plugin, Install ironjacamar-rhq-plugin.jar
- Start RHQ agent
cd <RHQ_Agent>/bin
./rhq-agent.sh
- Inventory -> Discovery Queue, find IronJacamar_AS7
- click "import" button on the bottom
- Inventory -> Servers, click IronJacamar_AS7
Screenshots
http://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-6-11451/450-266/Screenshot.png
Links
