Apache Tomcat plugin supported by Pivotal

  • Tags: tomcat, server, deployment
  • Latest: 8.0.14.1
  • Last Updated: 14 October 2014
  • Grails version: 2.3 > *
29 votes

100% of Grails users

Dependency:
compile ":tomcat:8.0.14.1"

 Documentation  Source  Issues

Summary

Makes Tomcat 8.x the servlet container for Grails at development time

Description

This plugin makes Tomcat the default development server for Grails. To install in Grails versions before 2.3 add this to BuildConfig.groovy:

build ":tomcat:$grailsVersion"

To install in Grails 2.3 and higher, add an entry with a specific version to BuildConfig.groovy:

build ':tomcat:7.0.54'

Adjust the version to match the latest version (listed at the top of this page) or an older version if you need a particular earlier release.

No other installation of an external Tomcat distribution is required, but you can deploy your application to a standalone Tomcat server or other servlet container or application server by creating a WAR file with the `war` script.

Configuration Options

  • tomcat.deploy.username - The username of the remote tomcat to deploy to
  • tomcat.deploy.password - The password for the remote tomcat to deploy to
  • tomcat.deploy.url - The remote tomcat deploy URL
  • tomcat.scan.enabled - Where Servlet 3.0 annotation classpath scanning is enabled (false by default). Note that enabling this setting will require you to significantly increase your memory settings as the Servlet 3.0 scanning feature consumes a large amount of memory.
  • tomcat.scan.excludes - If class path scanning is enabled, what jars to limit
  • tomcat.nio - Whether to enable the Tomcat New IO connector
  • tomcat.keystorePath - The path to the Tomcat keystore for HTTPS
  • tomcat.keystorePassword - The password for the keystore for HTTPS
  • grails.tomcat.jvmArgs - Any JVM arguments to pass to the isolated Tomcat instance used for run-war
  • tomcat.startupTimeoutSecs - The time to wait for startup for the isolated Tomcat instance

JNDI

You can specify JNDI naming entries to be used by the embedded Tomcat in your grails-app/conf/Config.groovy file:

grails.naming.entries = ['jdbc/mydb': [
   type: "javax.sql.DataSource", //required
   auth: "Container", // optional
   description: "Data source for ...", //optional
   //properties for particular type of resource
   url: "jdbc:oracle:thin:@dbserver:1521:DBNAME",
   username: "dbuser",
   password: "secret",
   driverClassName: "oracle.jdbc.driver.OracleDriver",
   maxActive: "8", //and so on
   maxIdle: "4"
   ]
]

These can then be looked up by configuring an appropriate Spring bean in @grails-app/conf/resources.groovy@:

beans = {
  xmlns jee:"http://www.springframework.org/schema/jee"
  jee.'jndi-lookup'(id:"myDbDataSource", 'jndi-name':"java:comp/env/jdbc/mydb")
}

Note if you deploy to a standalone Tomcat instance then these will need to be configured in your Tomcat context.xml file as per the Tomcat documentation

Remote Deployment

The plugin features remote deployment Gant scripts. To deploy the current Grails application simply run:

grails tomcat deploy

and to undeploy run:

grails tomcat undeploy

Note you will need to configure permissions in your tomcat-users.xml directory such as:

<role rolename="manager"/>
<user username="manager" password="secret" roles="standard,manager"/>

You can then need to specify the username/password (and potentially url) in your Config.groovy file:

tomcat.deploy.username="manager"
tomcat.deploy.password="secret"
tomcat.deploy.url="http://myserver.com/manager"

Tomcat 7

If you are using Tomcat 7, ensure the user has the manager-script role

<user username="manager" password="secret" roles="manager-script" />

And the configuration in Config.groovy looks like

tomcat.deploy.username="manager"
tomcat.deploy.password="secret"
tomcat.deploy.url="http://myserver.com/manager/text"

Using jvmArgs property

In <app>/conf/BuildConfig.groovy one has to place the property as shown below:

The properties are given only for reference as an example and please do optimize as per your requirement

grails.tomcat.jvmArgs = [
   "-server", "-XX:MaxPermSize=512m", "-XX:MaxNewSize=256m", "-XX:NewSize=256m",
   "-Xms768m", "-Xmx1024m", "-XX:SurvivorRatio=128", "-XX:MaxTenuringThreshold=0",
   "-XX:+UseTLAB", "-XX:+UseConcMarkSweepGC", "-XX:+CMSClassUnloadingEnabled",
   "-XX:+CMSIncrementalMode", "-XX:-UseGCOverheadLimit", "-XX:+ExplicitGCInvokesConcurrent"]

(or)

grails {
    tomcat {
        jvmArgs = [
           "-server", "-XX:MaxPermSize=512m", "-XX:MaxNewSize=256m", "-XX:NewSize=256m",
           "-Xms768m", "-Xmx1024m", "-XX:SurvivorRatio=128", "-XX:MaxTenuringThreshold=0",
           "-XX:+UseTLAB", "-XX:+UseConcMarkSweepGC", "-XX:+CMSClassUnloadingEnabled",
           "-XX:+CMSIncrementalMode", "-XX:-UseGCOverheadLimit", "-XX:+ExplicitGCInvokesConcurrent"]
    }
}