Red Hat JBoss AS 7.0 plugin
This Red Hat product plugin enables integration with and provisioning of JBoss AS 7.0 services.
Prerequisites
The JBoss AS 7.0 binary file is required if you intend to install the product on a target severs using RapidDeploy.
Red Hat JBoss AS products can be downloaded from this web site: Red Hat.
An installed JBoss AS 7.0 server is required if you intend to deploy application and configuration using RapidDeploy
Usage
This plugin manages the installation, deployment of applications, configuration and uninstallation of JBoss AS 7.0 product on target servers regardless of the target operating system.
The configuration used to control the tasks is stored in the Environment product settings. Select the JBoss AS 7 Environment product and populate the mandatory values. These settings are used to connect, control and snapshot the JBoss installation. There are very little settings needed in most of the JBoss AS 7 task parameters as most of the information is sourced from these environment product settings. When you save the environment configuration, select the check box labelled "Write Environment Data to all Associated Projects:" this will create a file named server.environment.domainxml with all the data set in the environment product in all the projects that references that particular environment.
| Task Name | Task Description |
|---|---|
| InstallJBossAS7Task | This task uncompresses the package relative ZIP file into the specified installation directory. If the task is executed on a non-Windows server, chmod is used on the installation directory to make the necessary files executable. |
| UnInstallJBossAS7Task | This task stops the JBoss server, then deletes every file and directory under the JBoss home directory. |
| InstallJBossAS7WebServerTask | This task uncompresses the package relative ZIP file into the specified JBoss home.If the task is executed on a non-Windows server, chmod is used on the installation directory to make the necessary files executable. |
| DeployAS7ModulesTask | This task copies the package relative modules directory into the JBoss servers modules directory. If a relative modules directory cannot be found in the package this task then looks for a zip file to unpack and copy the modules directory from that file. |
| AddAS7ManagementUserTask | This task creates a mgmt user entry in the server configuration 'mgmt-users.properties' file. |
| AddAS7ApplicationUserTask | This task creates an app user entry in the server configuration 'application-users.properties' and 'application-roles.properties files. |
| DeployJBossAS7ApplicationTask | This task deploys an application (WAR / EAR / RAR) into the JBoss server. |
| UnDeployJBossAS7ApplicationTask | This task undeploys an application (WAR / EAR / RAR)from the JBoss server. |
| StartAS7ServerTask | This task starts up the JBoss server, it tries to connect to the server using the remoting connection settings and if it cannot establish a connection, it assumes JBoss is not running and it starts JBoss. |
| StopAS7ServerTask | This task stops the JBoss server, it tries to connect to the server using the remoting connection settings and if it can establish a connection, it issues the shutdown command to stop the server. |
| ExecuteAS7CommandsTask | This task executed commands specified in a file, on the JBoss server. Values in the commmands can be substituted with data dictionary items. |
| WriteJBossAS7AttributeTask | This task writes an attribute in the JBoss server. It throws an exception if the attribute is not written. The property and name combinations are used to navigate to node address of the property attribute to write. |
| CheckJBossAS7ResourceExistTask | This test if a resource exists in the JBoss Server configuration. If the resource does exist then this task will throw an exception. The intention is this task can be used in an orchestration to stop the orchestration or highlight that the resource is already configured on the server. This task reads a resource (non-recursive) at the address defined by the property name and value. If this address returns a node, then the we get the result type node from the returned node and test if a property of the given name is on that node. If it does exist this task will throw an exception. |
| CreateJBossAS7JdbcDriverTask | This task creates a JDBC Driver resource in the JBoss server. It throws an exception if the driver has not been created or does not exist. |
| CreateJBossAS7DataSourceTask | This task creates a Data Source resource in the JBoss server. It throws an exception if the data source has not been created or does not exist. |
| TestJBossAS7DataSourceTask | This task tests a Data Source resource in the JBoss server. It throws an exception if the data source test fails. |
Attributes and parameters
List and description of all tasks and parameters.
Restrictions
This is separately licensed plugin that is not shipped with the framework. Please contact MidVision sales to obtain a copy of this plugin. This plugin interacts with Red Hat software, which may require a separate license.