svn commit: r573898 - /tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml

[ma...@apache.org]

Author: markt
Date: Sat Sep  8 12:57:27 2007
New Revision: 573898

URL: http://svn.apache.org/viewvc?rev=573898&view=rev
Log:
Clarify appBase - docBase relationship

Modified:
    tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml

Modified: tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml?rev=573898&r1=573897&r2=573898&view=diff
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml (original)
+++ tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml Sat Sep  8 12:57:27 2007
@@ -48,14 +48,18 @@
     </p>
     <source>
 &lt;Engine name="Catalina" defaultHost="ren"&gt;
-    &lt;Host name="ren"    appBase="webapps/ren"/&gt;
-    &lt;Host name="stimpy" appBase="webapps/stimpy"/&gt;
+    &lt;Host name="ren"    appBase="webapps-ren"/&gt;
+    &lt;Host name="stimpy" appBase="webapps-stimpy"/&gt;
 &lt;/Engine&gt;
     </source>
     <p>
+      Note that the directory structures under the appBase for each host should
+      not overlap each other.
+    </p>
+    <p>
       Consult the configuration documentation for other attributes of the
       <a href="config/engine.html">Engine</a> and <a href="config/host.html">
-      Host</a>elements.
+      Host</a> elements.
     </p>
   </section>
 
@@ -64,23 +68,36 @@
       Create directories for each of the virtual hosts:
     </p>
     <source>
-mkdir $CATALINA_HOME/webapps/ren
-mkdir $CATALINA_HOME/webapps/stimpy
+mkdir $CATALINA_HOME/webapps-ren
+mkdir $CATALINA_HOME/webapps-stimpy
     </source>
   </section>
 
   <section name="Configuring Your Contexts">
-    <subsection name="Approach #1">
+    <subsection name="General">
+      <p>Contexts are normally located underneath the appBase directory. For
+       example, to deploy the <code>foobar</code> context as a war file in
+       the <code>ren</code> host, use
+       <code>$CATALINA_HOME/webapps-ren/foobar.war</code>. Note that the
+       default or ROOT context for <code>ren</code> would be deployed as
+       <code>$CATALINA_HOME/webapps-ren/ROOT.war</code> (WAR) or
+       <code>$CATALINA_HOME/webapps-ren/ROOR</code> (directory).
+      </p>
+      <p><strong>NOTE: The <code>docBase</code> for a context should never be
+        the same as the <code>appBase</code> for a host.</strong>
+      </p>
+    </subsection>
+    <subsection name="context.xml - approach #1">
       <p>
         Within your Context, create a <code>META-INF</code> directory and then
         place your Context definition in it in a file named
         <code>context.xml</code>. i.e.
-        <code>$CATALINA_HOME/webapps/ren/ROOT/META-INF/context.xml</code>
+        <code>$CATALINA_HOME/webapps-ren/ROOT/META-INF/context.xml</code>
         This makes deployment easier, particularly if you're distributing a WAR
         file.
       </p>
     </subsection>
-    <subsection name="Approach #2">
+    <subsection name="context.xml - approach #2">
       <p>
         Create a structure under <code>$CATALINA_HOME/conf/Catalina</code>
         corresponding to your virtual hosts, e.g.:
@@ -118,6 +135,5 @@
       </p>
     </subsection>
   </section>
-
 </body>
 </document>



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