Struts Framework
|
Installing Struts with your servlet container |
- 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
|
|