[jboss-dev-forums] [IronJacamar Development] - IronJacamar RHQ platform

Jesper Pedersen do-not-reply at jboss.com
Wed Jan 18 10:29:07 EST 2012 

Jesper Pedersen [https://community.jboss.org/people/jesper.pedersen] modified the document:

"IronJacamar RHQ platform"

To view the document, visit: https://community.jboss.org/docs/DOC-16378

--------------------------------------------------------------
h1. Status

Inactive - RHQ functionality will only be provided through the JBoss Enterprise Application Platform.

h1. 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.

h1. Design
1. RHQ 4 + Plugin + Embedded JCA
 https://community.jboss.org/servlet/JiveServlet/showImage/102-16378-11-11452/plugin1.jpg  https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-11-11452/450-317/plugin1.jpg 

2. RHQ 4 + Plugin + Standalone JCA
 https://community.jboss.org/servlet/JiveServlet/showImage/102-16378-11-11453/plugin2.jpg  https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-11-11453/450-317/plugin2.jpg 

3. JBoss AS 7 + Connector subsystem +  Model type + Console

Picture is deprecated, will replace
 https://community.jboss.org/servlet/JiveServlet/showImage/102-16378-11-11454/plugin3.jpg  https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-11-11454/450-317/plugin3.jpg 


h1. 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
  - Datasources
   - jndiName
   - PoolConfiguration
   - Pool


h2. 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 -Dmodule=rhq module-test


Then the plugin could been found:
./build/rhq/ironjacamar-rhq-test-all.jar
h1. Supported metrics and operations

*ResourceAdpaters*
*
*
Metrics (Configurations)

|| Name
 || Display name
 || *Type* || *Required* || *Readonly* || *Default* || *Unit* || *Description* ||
| name | Display name | String | Y | Y | 
 | 
 | 
 |
| jndi-name | JNDI name | String | Y | 
 | 
 | 
 | 
 |
| class-name | Resource Adapater class name | String | N | Y | 
 | 
 | Class name of ResourceAdapter |
| use-ra-association | Use ResourceAdapterAssociation | Boolean | N | Y | 
 | 
 | 
 |
| source-path | Source path | String | Y | Y | 
 | 
 | RAR file path |
| 
 | 
 | 
 | 
 | 
 | 
 | 
 | 
 |
| 
 | 
 | 
 | 
 | 
 | 
 | 
 | 
 |


Operation

|| 
 || *Name* || *Display name* || *Type* || *Required* || *Discription* ||
| Operation | start | 
 | 
 | 
 | Start this RAR |
| 
 | stop | 
 | 
 | 
 | Stop this RAR |
| 
 | restart | 
 | 
 | 
 | Stop and restart this RAR  |
| 
 | suspend | 
 | 
 | 
 | Suspend this RAR |


*Managed Connection Factories*

Metrics (Configurations)

|| Name
 || Display name
 || *Type* || *Required* || *Readonly* || *Default* || *Unit* || *Description* ||
| jndi-name | JNDI name | String | Y | 
 | 
 | 
 | 
 |
| mcf-class-name | ManagedConnectionFactory class name | String | Y | Y | 
 | 
 | 
 |
| cf-interface-name | ConnectionFactory interface class name | String | Y | Y | 
 | 
 | 
 |
| cf-impl-name | ConnectionFactory implement class name | String | Y | Y | 
 | 
 | 
 |
| connection-interface-name | Connection interface class name | String | Y | Y | 
 | 
 | 
 |
| connection-impl-name | Connection implement class name | String | Y | Y | 
 | 
 | 
 |






|| 
 || *Name* || *Display name* || *Type* || *Required* || *Discription* ||
| Operation | 
 | 
 | 
 | 
 | 
 |
| Parameters | 
 | 
 | 
 | 
 | 
 |
| Results | 
 | 
 | 
 | 
 | 
 |




h1. How to run plugin on RHQ 4

* Download RHQ 4.0.0.Beta1 from  http://rhq-project.org/display/RHQ/Download http://rhq-project.org/display/RHQ/Download
* unzip to empty directory
* Make sure Java JDK/JRE installed
* Start RHQ server

cd <RHQ_Server>/bin
./rhq-server.sh start


* browse  http://localhost:7080 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
* click "import" button on the bottom
* Inventory -> Servers, click IronJacamar
* right click IronJacamar, Create Child, choose to upload xa.rar
* refresh on the inventory tab, the inventory tree should show
h1. Screenshots

 https://community.jboss.org/servlet/JiveServlet/showImage/102-16378-11-11451/Screenshot.png  https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16378-11-11451/450-266/Screenshot.png 

h1. Links
*  http://www.rhq-project.org/display/RHQ/Home RHQ
*  https://community.jboss.org/docs/DOC-16363 Management console design for AS 7
*  https://community.jboss.org/docs/DOC-16376 Management console roadmap for AS 7
--------------------------------------------------------------

Comment by going to Community
[https://community.jboss.org/docs/DOC-16378]

Create a new document in IronJacamar Development at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2099]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-dev-forums/attachments/20120118/94528e49/attachment.html

More information about the jboss-dev-forums mailing list