Package com.xebialabs.deployit.plugin.jbossas

The Deployit plugin for JBoss Application Server.

See:
Description

Package com.xebialabs.deployit.plugin.jbossas Description

The Deployit plugin for JBoss Application Server.

This is the standard Deployit plugin for functionality related to JBoss Application Server (further referenced in this documentation as JBoss). It provides support for JBoss-specific components and allows users to deploy applications containing JBoss resources to a JBoss Application Server environment.

Supported middleware

This plugin supports JBoss Application Server versions 4.2.x.

Requirements

The plugin executes its deployment and configuration tasks by connecting to the target host systems and executing twiddle commands there. This implies that the following must be possible:

• creating a connection to the host on which the "deployment manager" is running, using the Host's specified connection methods
• starting jboss-installation-dir/bin/twiddle.sh (twiddle.bat on Windows) on the target host server under the user Deployit uses to connect to the host (or the SUDO user, if specified)

Further, the following configuration settings must be applied to the JBoss AS instances being managed:

• the DeleteWorkDirOnContextDestroy attribute in server-profile/deploy/jboss-web.deployer/META-INF/jboss-service.xml must be set to true
• the ScanEnabled attribute in server-profile/conf/jboss-service.xml must be set to false

Components

JBoss middleware environments are modeled on the basis of the following Configuration Items (CIs):

• JBoss Application Server

Further, the plugin provides CIs for the following JBoss-related resources:

• JDBC DataSource
• JMS Queue
• JMS Topic

Supported scenarios

The plugin supports:

• the initial deployment, re- and undeployment of deployment packages to/from JBoss environments via the JBoss Deployment RunBook

For details of the exact components supported, sequence in which steps are carried out, limitations etc. please consult the documentation of the appropriate run book.

Mapping

The plugin contains the following DeployableArtifact mappings:

• Mapping maps an Ear to a JBoss Application Server
• Mapping maps an War to a JBoss Application Server

All JBoss-related resources can be mapped wit the JbossasResourceMapping to:

• A specified JBoss Application Server running on a Host

Known limitations

The plugin does not currently support

• Installation, maintenance or removal of JBoss installations and profiles.
• Management of JBoss Clusters.

If you have questions, comments or feedback please contact the JBoss development team at XebiaLabs.

Version:

1.2