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

Fri Aug 8 00:27:50 EDT 2008

    [ https://jira.jboss.org/jira/browse/JBAS-5734?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12424164#action_12424164 ] 

samson kittoli commented on JBAS-5734:
--------------------------------------

Obsolete content removed. new content to be added.cc'ing Dimitris for the web.xml fix.

> Installation And Getting Started Guide: Tomcat Documentation
> ------------------------------------------------------------
>
>                 Key: JBAS-5734
>                 URL: https://jira.jboss.org/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
>            Assignee: 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: https://jira.jboss.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira