[MTOMCAT-64] Document how to change the Embedded Tomcat Version

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.0
• Fix Version/s: 1.1
• Assignee: Olivier Lamy
• Reporter: Mark Michaelis
• Due: 01/Sep/11
• Created: 30/Sep/10 06:54
• Updated: 30/Sep/10 04:32
• Resolved: 07/Sep/11 21:18

Description

Using the embedded Tomcat we needed a way to exchange the Tomcat with a specific version. You can do so by providing this in your plugin configuration:

<project>
   [...]
  <properties>
   <tomcat.version>6.0.29</tomcat.version>
   [...]
  </properties>
   [...]
  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.codehaus.mojo</groupId>
          <artifactId>tomcat-maven-plugin</artifactId>
          <version></version>
          <dependencies>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>catalina</artifactId>
              <version></version>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>catalina-ha</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>tribes</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>el-api</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>jasper</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>jasper-el</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>jasper-jdt</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>jsp-api</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>servlet-api</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>coyote</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
            <dependency>
              <groupId>org.apache.tomcat</groupId>
              <artifactId>dbcp</artifactId>
              <version></version>
              <scope>runtime</scope>
            </dependency>
          </dependencies>
        </plugin>
        [...]
      </plugins>
    </pluginManagement>
    [...]
  </build>
  [...]
</project>

Attached a proposal for the documentation (site and example-apt-entry).