You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by bu...@apache.org on 2015/10/02 22:52:42 UTC

[Bug 58474] New: Clarity in documentation for CATALINA_HOME and CATALINA_BASE

https://bz.apache.org/bugzilla/show_bug.cgi?id=58474

            Bug ID: 58474
           Summary: Clarity in documentation for CATALINA_HOME and
                    CATALINA_BASE
           Product: Tomcat 8
           Version: trunk
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Catalina
          Assignee: dev@tomcat.apache.org
          Reporter: dsheil@vartmp.com

Created attachment 33156
  --> https://bz.apache.org/bugzilla/attachment.cgi?id=33156&action=edit
More clarity in sample documentation

If we look at this file -

http://svn.apache.org/repos/asf/tomcat/trunk/webapps/docs/appdev/sample/index.html

It says:

"The easiest way to run this application is simply to move the war file to your
<b>CATALINA_HOME/webapps</b> directory."

However, when tomcat is running multiple instances, this directory is actually
CATALINA_BASE/webapps .  On Debian recent stable jessie release, by default
tomcat8's CATALINA_HOME has no webapps directory, whereas CATALINA_BASE does,
and moving the sample war file to CATALINA_BASE will deploy it.

I have attached a patch where I change the documentation to read:

"The easiest way to run this application is simply to move the war file to your
<b>CATALINA_HOME/webapps</b> directory (or if you are running multiple
instances, move the war file to your <b>CATALINA_BASE/webapps</b> directory)."

One reason for extra explanation here is this is one of the first things
someone new to Tomcat will see, and that note will probably save them from some
confusion.

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


[Bug 58474] Clarity in documentation for CATALINA_HOME and CATALINA_BASE

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=58474

Mark Thomas <ma...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         Resolution|---                         |FIXED
             Status|NEW                         |RESOLVED

--- Comment #1 from Mark Thomas <ma...@apache.org> ---
Thanks for the report.

Fixed in trunk and 8.0.x for 8.0.28 onwards.

I used a slightly different form of words to provide a pointer to more
information since I wanted to keep this page as simple as possible.

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org