Skip to end of metadata
Go to start of metadata

Since RHQ 4.12 you can use provisioning to deploy applications to an AS7 or EAP6 server in domain mode and execute CLI scripts. This enhancement is possible thanks to the bundle content handover feature, which allows target resource plugin components to participate in the bundle deployment.

In the rest of the document, we assume that you are already a little bit familiar with Ant Bundles and Bundle content handover.

The use case

I want to deploy a WAR file to an EAP 6 server group, but before it gets deployed, I need a CLI script to be executed to configure a datasource. Besides, I want to be able to define the maximum number of connections the datasource pool can create before the bundle is deployed.

The bundle archive

The bundle zip file must contain:

  • the ANT Bundle Recipe (deploy.xml)
  • a templated EAP6 CLI script to configure a datasource (prepareDatasource.cli)
  • the application WAR file (website.war)

The recipe

The recipe will have the following form.

  1. Before deploying the bundle RHQ will ask you which value you want to set for the jdbc.pool.connections.max and properties
  2. jdbc.pool.connections.max will be used to replace the @@jdbc.pool.connections.max@@ token in prepareDatasource.cli (replace="true")
  3. Then the content of prepareDatasource.cli will be handed over to the the Host Controller resource component, which knows how to execute a CLI script
  4. Eventually, the content of website.war will also be handed over, and the plugin component will deploy it to all servers in the server group named after (handover-param name="serverGroup")
serverGroup handover param must point to an EAP domain server group
Do not confuse the serverGroup handover param with RHQ's bundle destination resource group.

The handover param must point to an EAP domain server group. It is the group of managed servers where the application must be deployed.

The bundle destination resource group encompasses the host controller resources for the bundle deployment.

More information on handover actions in AS7 / EAP6 plugin

The list of handover actions and associated parameters are documented in the AS7 plugin descriptor file. The content of this help section is displayed on your RHQ server:

  1. Browse to Administration / Configuration / Agent Plugins
  2. Click on JBoss Application Server 7.x
  3. Scroll down to Bundle Handover Support
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.