Deploy as a WAR in Tomcat - Documentation topics on: dotcms war,ejb,j2ee,tomcat,war,.

Deploy as a WAR in Tomcat

The following steps should be performed to install dotCMS as a WAR file in Tomcat.


  • Before following these steps which are specific to this application server, please read and follow all the steps in the WAR Installation documentation.
  • Please see the dotCMS Installation Requirements document to ensure your version of Tomcat is supported by dotCMS.

Installation Steps

  1. Copy mail.jar and JDBC driver jar files into the apache-tomcat-8.0.18/lib directory.
  2. Delete all file and directories in the apache-tomcat-8.0.18/webapps/ROOT directory.
  3. Unzip the dotcms.war file.
  4. Copy the extracted directory into the apache-tomcat-8.0.18/webapps/ROOT directory.
  5. Configure and copy the context.xml file into the apache-tomcat-8.0.18/webapps/ROOT/META-INF directory.
  6. Create the /dotserver/apache-tomcat-8.0.18/bin/ file and include the following lines:
    • Linux:
      #[[#debug options
      CATALINA_OPTS="$CATALINA_OPTS -Djava.awt.headless=true -Xverify:none -Dfile.encoding=UTF8 -server -Xmx4G -XX:MaxPermSize=512m -XX:+DisableExplicitGC -XX:+UseConcMarkSweepGC"
      # jamm jar options
      #CATALINA_OPTS="$CATALINA_OPTS -javaagent:/xxxxxxx/apache-tomcat-8.0.18/webapps/ROOT/WEB-INF/lib/dot.jamm-0.2.5_1.jar"
      export CATALINA_OPTS]]#
    • Windows:
      rem debug options
      set "CATALINA_OPTS=%CATALINA_OPTS% -Djava.awt.headless=true -Xverify:none -Dfile.encoding=UTF8 -server    -Xmx4G -XX:MaxPermSize=512m -XX:+DisableExplicitGC -XX:+UseConcMarkSweepGC"
      rem jamm jar options
      rem set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:/xxxxxxx/apache-tomcat-8.0.18/webapps/ROOT/WEB-INF/lib/dot.jamm-0.2.5_1.jar"

For more information on installing dotCMS as a WAR file, please see the WAR Installation documentation.