---
 About Apache Tomcat Maven Plugin
 ---
 Oliver Lamy
 ---
 2011-01-10
 ---

 ~~ Licensed to the Apache Software Foundation (ASF) under one
 ~~ or more contributor license agreements.  See the NOTICE file
 ~~ distributed with this work for additional information
 ~~ regarding copyright ownership.  The ASF licenses this file
 ~~ to you 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.

 ~~ NOTE: For help with the syntax of this file, see:
 ~~ http://maven.apache.org/doxia/references/apt-format.html

Apache Tomcat Maven Plugin

  This is the new home for the Tomcat Maven Plugin (previously hosted at Codehaus).

  Version ${project.version} has the following new features:

  * Apache Tomcat7 support

  * {{{./executable-war-jar.html}Build an Executable War/Jar}}

  []

  More details in {{{./jira-report.html}Generated changelog from issue tracker}}.

  The Tomcat Maven Plugin provides goals to manipulate WAR projects within the {{{http://tomcat.apache.org/}Apache Tomcat}} servlet container.

  Or to run your war project with an embedded Apache Tomcat. The run goals give you the opportunity to quickly develop your application without needing
  to install a standalone Tomcat instance. More details and features: {{{./run-mojo-features.html}see documentation}}.

* groupId and Mojo name change

  Since version 2.0-beta-1 tomcat mojos has been renamed to tomcat6 and tomcat7 with the same goals.

  You must configure your pom to use this new groupId:

+----------
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.tomcat.maven</groupId>
          <artifactId>tomcat6-maven-plugin</artifactId>
          <version>${project.version}</version>
        </plugin>
        <plugin>
          <groupId>org.apache.tomcat.maven</groupId>
          <artifactId>tomcat7-maven-plugin</artifactId>
          <version>${project.version}</version>
        </plugin>
      </plugins>
    </pluginManagement>
+----------

  Or add the groupId in your settings.xml

+----------
  <pluginGroups>
    ....
    <pluginGroup>org.apache.tomcat.maven</pluginGroup>
    ....
  </pluginGroups>
+----------


* Goals Overview


  * {{{./context-goals.html}Goals to manipulate deployed projects within Tomcat}}

  * {{{./container-goals.html}Goals to obtain information from Tomcat}}

  * {{{./executable-war-jar.html}Build an Executable War/Jar}}

  []

* Known limitations

  Some goals are not yet available with the tomcat7 mojo. Those {{{./container-goals.html}container goals}} are available with
  the tomcat6 mojo, you only need to update the manager url in your pom.

  Use <<<http://localhost:8080/manager/text>>> rather than the default tomcat6 url.