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: dsh...@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-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org

Reply via email to