[jboss-jira] [JBoss JIRA] Created: (JBAS-5734) Installation And Getting Started Guide: Tomcat Documentation

Mon Jul 7 16:00:29 EDT 2008

Installation And Getting Started Guide: Tomcat Documentation
------------------------------------------------------------

                 Key: JBAS-5734
                 URL: http://jira.jboss.com/jira/browse/JBAS-5734
             Project: JBoss Application Server
          Issue Type: Task
      Security Level: Public (Everyone can see)
          Components: Documentation
    Affects Versions: JBossAS-5.0.0.CR1
         Environment: all
            Reporter: Erik Lindquist
         Assigned To: Samson Kittoli

The documentation available for Tomcat is incomplete and incorrect. Section 8.5 "The Web Container - Tomcat" states:

"The embedded Tomcat service is the expanded deploy/jboss-web.deployer. All the necessary jar files needed by Tomcat can be found in there, as well as a web.xml (under the ROOT.war/WEB-INF) file which provides a default configuration set for web applications. "

wrong. It is mixed up between two directories: default/deployers/jbossweb.deployer and default/deploy/jbossweb.sar.  As far as I can tell, the former specifies what to deploy and the latter specifies how to do it..  web.xml can be found under the jbossweb.deployer directory and server.xml is found under jbossweb.sar  This makes it really hard to define CATALINA_HOME.

Also, the web.xml file still contains this comment:

   <!-- IMPORTANT: To use the SSI servlet, you also need to rename the       -->
   <!--            $CATALINA_HOME/server/lib/servlets-ssi.renametojar file   -->
   <!--            to $CATALINA_HOME/server/lib/servlets-ssi.jar             -->

You should just delete that. (goes for CGI too.)

Best solution (IMHO) is to include a link to the appropriate Tomcat doc with along with any special JBoss specific usage notes.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira