WebLogic Deployer Plugin

Plugin Information

This plugin deploy artifacts built on a CI server Hudson to a weblogic target (managed server, cluster ...) as an application or a library component.

Thanks for the contribution of IHD team (a ByTel department).

General

The plugin supports the artifact deployment to the 9.X weblogic environments. All kinds of component such as library or application (ear, war, ejb-jar) are eligible to the deployment.

Pre-requisites

This plugin is only applicable for maven Job and works with 9.X weblogic version. The deployment to others weblogic versions has not been tested.

Getting Started

Before use it, The plugin has to be configured. It consists of loading the weblogic environments configuration and adding the weblogic library path (i.e /pathtojar/weblogic.jar) which will be used while deploying artifacts.

Configuration

System Configuration

• Fichier de configuration : xml file path containing deployments targets. It has to be http://host:port/plugin/weblogic-deployer-plugin/defaultConfig/plugin-configuration.xsd schema compliant. For instance no validation is performed. The file can be added through a local path (/usr/users/.../plugin-configuration.xml) or a remote URL (http://xxxxxxxxx/plugin-configuration.xml)

<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="http://com.bouygtel.dy.hudson.plugin/WeblogicDeploymentPlugin"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://com.bouygtel.dy.hudson.plugin/WeblogicDeploymentPlugin plugin-configuration.xsd">
	<weblogic-targets>
		<weblogic-target>
			<name>_name_</name>
			<host>_weblogic.admin.server.host_</host>
			<port>_weblogic.admin.server.port_</port>
			<login>_weblogic.admin.server.login_</login>
			<password>_weblogic.admin.server.password_</password>
			<ftpHost>_weblogic.remote.host_</ftpHost>
			<ftpUser>_weblogic.remote.user_</ftpUser>
			<ftpPassowrd>_weblogic.remote.passowrd_</ftpPassowrd>
			<remoteDir>/remate/file/to/path/used/to/deploy/libraries</remoteDir>
		</weblogic-target>
	</weblogic-targets>
</config>

NB : the ftpHost/ftpUser/ftpPassowrd/remoteDir are used to deploy libraries. Basically, weblogic.remote.host should be the same as weblogic.admin.server.host

• Classpath : weblogic.jar file path loaded for deployment. If no value is set but the WL_HOME environment variable is found, the plugin will try to load %WL_HOME%/server/lib/weblogic.jar.

• Java Options : the java options used by the java process when invoking the weblogic library. By default it will be -Xms256M -Xmx256M.

• Liste d'exclusion : the built artifacts name pattern excluded from post build deployment action.

• Desactiver : If checked, the plugin execution is disabled.

Job Configuration

If no configuration has been set, the plugin will display an error message

Here is an example of a hudson job configuration

• environment : the targeted weblogic environment
• nom : the name used by weblogic to display component
• targets : the weblogic target ( can be a managed server instance, a cluster or AdminServer). By default the plugin will use the AdminServer. Many targets can be defined and will be separated by un comma symbol.
• librairie weblogic : If checked, the generated artifact will be deployed as a library component
• 'Build en echec si erreur au deploiement' : If checked, The current build will be stated as a failed one if the deployment task failed.
• 'Strategie de deploiement' : Configure which cause(s) will trigger the deployment action. If 'Non specifie' is selected, the deployment occurs each time the job builds. If another ones are selected, the deployement action only occurs when the build was triggered by a chosen cause.
• 'Deploiement uniquement sur modifications des sources' : If checked, the deployment action only occurs when the build trigger by a parametrized cause AND the SCM step detects any changes.
• 'Projets déployés requis' : (experimental) specifies a dependence with others job.

User Guide

View deployment Logs

TODO

Release Notes

Version 1.0 (Jan 3, 2012)

Initial release.

RoadMap

Add timeout.
Add configuration file xsd validation.
Hide admin password