2005-01-20 22:31:45 +00:00

69 lines
2.4 KiB
XML

<?xml version="1.0"?>
<!--
/*
* Copyright 2001-2005 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-->
<document>
<properties>
<title>Maven JBoss plugin</title>
<author email="vmassol@apache.org">Vincent Massol</author>
<author email="jim@crossleys.org">Jim Crossley</author>
</properties>
<body>
<section name="Maven JBoss plugin">
<p>
This is a plugin for creating a packaged JBoss server
configuration zip. It supports static and dynamic
deployment of J2EE modules. The dynamic deployment is
implemented using JMX.
</p>
</section>
<section name="Usage">
<p>
This plugin contains goals to help in quickly building and deploying a webapp into a running JBoss server
if you do not have IDE support for it.
</p>
<p>
To build your webapp into the correct directory structure, set the following property for your project:
</p>
<source>maven.war.webapp.dir=${maven.build.dir}/exploded/${pom.artifactId}.war/</source>
<p>
To deploy your webapp after making changes to your java source code, run:
</p>
<source>maven jboss:deploy-exploded-warfile</source>
<p>
If only webapp content has changed (ie the webapp does not need to be reloaded), you can run:
</p>
<source>maven war:webapp</source>
<p>
To undeploy the webapp:
</p>
<source>maven jboss:undeploy-exploded-warfile</source>
<p>
The JBoss plugin takes advantage of the jmx-console webapp provided in the default configuration of JBoss.
It assumes you have JBoss running on localhost with its embedded web server (either Tomcat or Jetty)
listening on port 8080. To override these, please refer to the
<a href="properties.html">JBoss Plugin Properties</a> reference.
</p>
</section>
</body>
</document>