Tomcat 3.1 (Or Later) With Apache

• These instructions assume you have successfully integrated Tomcat with Apache according to the Tomcat documentation.
• Copy "struts-documentation.war" and "struts-example.war" to your $TOMCAT_HOME/webapps directory
• Restart Tomcat if it is already running
• Tomcat will generate a file "$TOMCAT_HOME/conf/tomcat-apache.conf" that will be used by Apache. This file is regenerated every time you start Tomcat, so copy this file to a safe place (such as your Apache configuration directory; on Unix systems this is usually /usr/local/apache/conf.
• If you are running Tomcat 3.1, Tomcat will not have generated the entries for your new applications. Add the following lines to the tomcat-apache.conf file that you have saved, replacing $TOMCAT_HOME with the path to your Tomcat home directory:

Alias /struts-documentation "$TOMCAT_HOME/webapps/struts-documentation
  <Directory "$TOMCAT_HOME/webapps/struts-documentation>
    Options Indexes FollowSymLinks
  </Directory>
    ApJServMount /struts-documentation/servlet /struts-documentation
  <Location "/struts-documentation/WEB-INF/">
    AllowOverride None
    deny from all
  </Location>
Alias /struts-example "$TOMCAT_HOME/webapps/struts-example"
  <Directory "$TOMCAT_HOME/webapps/struts-example>
    Options Indexes FollowSymLinks
  </Directory>
    ApJServMount /struts-example/servlet /struts-example
  <Location "/struts-example/WEB-INF/">
    AllowOverride None
    deny from all
  </Location>

• On all versions of Tomcat, the generated file above does not know anything about extension mappings defined in a web.xml file, so the "*.do" URIs that go to the controller servlet will not be recognized. To fix this, add the following line to the saved version of "tomcat-apache.conf", after the corresponding line for the .jsp extension:
  AddHandler jserv-servlet .do
• Ensure that the saved version of "tomcat-apache.conf" is referenced in your Apache "httpd.conf" configuration file. A typical use would have the following line at the bottom of "httpd.conf":
  Include /usr/local/apache/conf/tomcat-apache.conf
• In order to recognize "index.jsp" as a default page for web applications, search in your "httpd.conf" for a "DirectoryIndex" directive. If you have one, add "index.jsp" to the end of the list, so that it might look like this:
  DirectoryIndex index.html index.jsp
  If you do not have such an entry, add one like this:
  DirectoryIndex index.jsp
• Restart Apache to make it aware of the new applications. You should now be able to access the applications from a browser like this:
  http://localhost/struts-documentation
http://localhost/struts-example

• Author: Craig R. McClanahan

Back to Installation