| <?xml version="1.0"?> |
| <!-- |
| $Id$ |
| |
| 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. |
| --> |
| <document url="installation-tc.html"> |
| |
| <properties> |
| <title>The Struts Framework Project - Installation - Tomcat with |
| Apache</title> |
| </properties> |
| |
| <body> |
| <section name="6.2 Installation" href="installation"> |
| <subsection name="Installing Struts with your servlet container" |
| href="Containers"> |
| <h4 id="tc321">Tomcat 3.2.1 With Apache</h4> |
| <p>Note that the instructions for Tomcat 4 will be different |
| than those for Tomcat 3, |
| but the Tomcat 4.0 web connector is still under |
| development. Versions of Tomcat prior |
| to 3.2.1 are not recommend for use with Struts.</p> |
| <ul> |
| <li>These instructions assume you have successfully |
| integrated Tomcat with Apache |
| according to the Tomcat documentation.</li> |
| <li>Copy "struts-documentation.war" and |
| "struts-example.war" to your $TOMCAT_HOME/webapps |
| directory</li> |
| <li>Restart Tomcat if it is already running</li> |
| <li>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 |
| <code>/usr/local/apache/conf</code> |
| . |
| </li> |
| <li>If you are running Tomcat 3.1, Tomcat will not have |
| generated the entries |
| for your new applications. Add the following lines to |
| the |
| <code>tomcat-apache.conf</code> |
| file that you have saved, replacing $TOMCAT_HOME with |
| the path to your Tomcat |
| home directory: |
| </li> |
| </ul> |
| <pre> |
| 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> |
| </pre> |
| <ul> |
| <li>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: |
| <br/> |
| <code>AddHandler jserv-servlet .do</code> |
| </li> |
| <li>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": |
| <br/> |
| <code>Include |
| /usr/local/apache/conf/tomcat-apache.conf</code> |
| </li> |
| <li>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: |
| <br/> |
| <code>DirectoryIndex index.html index.jsp</code> |
| <br/> |
| If you do not have such an entry, add one like this: |
| <br/> |
| <code>DirectoryIndex index.jsp</code> |
| </li> |
| <li>Restart Apache to make it aware of the new |
| applications. You should now |
| be able to access the applications from a browser like |
| this: |
| <br/> |
| <code>http://localhost/struts-documentation |
| <br/> |
| http://localhost/struts-example |
| </code> |
| </li> |
| </ul> |
| <hr/> |
| <p>Back to |
| <a href="installation.html#Containers">Installation</a> |
| </p> |
| </subsection> |
| </section> |
| </body> |
| </document> |
