Plugin Documentation

Goals available for this plugin:

Goal Description
tomcat6:deploy Deploy a WAR to Tomcat.
tomcat6:deploy-only Deploy a WAR to Tomcat without forking the package lifecycle.
tomcat6:exploded Deploy an exploded WAR to Tomcat.
tomcat6:help Display help information on tomcat6-maven-plugin.
Call mvn tomcat6:help -Ddetail=true -Dgoal=<goal-name> to display parameter details.
tomcat6:info Lists information about the Tomcat version, OS, and JVM properties.
tomcat6:inplace Deploy a WAR in-place to Tomcat.
tomcat6:list Lists all the currently deployed web applications in Tomcat.
tomcat6:redeploy Redeploy a WAR in Tomcat. (Alias for the deploy goal with its update parameter set to true.)
tomcat6:redeploy-only Redeploy a WAR in Tomcat without forking the package lifecycle. (Alias for the deploy-only goal with its update parameter set to true.)
tomcat6:reload Reload a WAR in Tomcat.
tomcat6:resources Lists JNDI resources in Tomcat.
tomcat6:roles Lists security roles in Tomcat.
tomcat6:run Runs the current project as a dynamic web application using an embedded Tomcat server.
tomcat6:run-war Runs the current project as a packaged web application using an embedded Tomcat server.
tomcat6:run-war-only Same as run-war goal without forking the package cycle.
tomcat6:sessions Lists session information for a WAR in Tomcat.
tomcat6:shutdown

Shuts down all possibly started embedded Tomcat servers. This will be automatically done through a shutdown hook or you may call this Mojo to shut them down explictly.

By default the shutdown goal is not bound to any phase. For integration tests you might want to bind it to post-integration-test.

tomcat6:start Start a WAR in Tomcat.
tomcat6:stop Stop a WAR in Tomcat.
tomcat6:undeploy Undeploy a WAR from Tomcat.

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven 2.2.1
JDK 1.5
Memory No minimum requirement.
Disk Space No minimum requirement.

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.tomcat.maven</groupId>
          <artifactId>tomcat6-maven-plugin</artifactId>
          <version>2.3-SNAPSHOT</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat6-maven-plugin</artifactId>
        <version>2.3-SNAPSHOT</version>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"