tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ma...@apache.org
Subject svn commit: r491502 - in /tomcat/container/tc5.5.x/webapps/docs: changelog.xml index.xml project.xml virtual-hosting-howto.xml
Date Sun, 31 Dec 2006 22:19:58 GMT
Author: markt
Date: Sun Dec 31 14:19:58 2006
New Revision: 491502

URL: http://svn.apache.org/viewvc?view=rev&rev=491502
Log:
Add a virtual hosting how-to contributed by Hassan Schroeder.

Added:
    tomcat/container/tc5.5.x/webapps/docs/virtual-hosting-howto.xml   (with props)
Modified:
    tomcat/container/tc5.5.x/webapps/docs/changelog.xml
    tomcat/container/tc5.5.x/webapps/docs/index.xml
    tomcat/container/tc5.5.x/webapps/docs/project.xml

Modified: tomcat/container/tc5.5.x/webapps/docs/changelog.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/changelog.xml?view=diff&rev=491502&r1=491501&r2=491502
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/changelog.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/changelog.xml Sun Dec 31 14:19:58 2006
@@ -302,13 +302,16 @@
       </fix>
       <fix>
         <bug>40257</bug>: Update Manager webapp howto on remote deployment to
reflect
-        need for explicit path in one specific use-case.  Thank to Venkatesh Jayaraman. (yoavs)
+        need for explicit path in one specific use-case.  Thanks to Venkatesh Jayaraman.
(yoavs)
       </fix>
       <update>
         <bug>40160</bug>: add reference to the Filter proposed in this Bugzilla
item to the WebdavServlet.
         While at it, give the WebdavServlet some long-overdue TLC by cleaning up some of
the old data
         structures in favor of modern (but still JDK 1.4-compliant) interfaces. (yoavs)
       </update>
+      <docs>
+        Add a virtual hosting how-to contributed by Hassan Schroeder. (markt)
+      </docs>
     </changelog>
   </subsection> 
   <subsection name="Cluster">

Modified: tomcat/container/tc5.5.x/webapps/docs/index.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/index.xml?view=diff&rev=491502&r1=491501&r2=491502
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/index.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/index.xml Sun Dec 31 14:19:58 2006
@@ -100,8 +100,12 @@
 <li><a href="monitoring.html"><strong>Monitoring and Management</strong></a>
-
     Enabling JMX Remote support, and using tools to monitor and manage Apache Tomcat.</li>
 <li><a href="logging.html"><strong>Logging</strong></a> -
-    Confuguring logging in Apache Tomcat.</li>
-
+    Configuring logging in Apache Tomcat.</li>
+<li><a href="apr.html"><strong>Apache Portable Runtime</strong></a>
-
+    Using APR to provide superior performance, scalability and better
+    integration with native server technologies.</li>
+<li><a href="virtual-hosting-howto.html"><strong>Virtual Hosting</strong></a>
-
+    Configuring vitual hosting in Apache Tomcat.</li>
 </ol>
 
 </section>

Modified: tomcat/container/tc5.5.x/webapps/docs/project.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/project.xml?view=diff&rev=491502&r1=491501&r2=491502
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/project.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/project.xml Sun Dec 31 14:19:58 2006
@@ -44,6 +44,7 @@
               href="monitoring.html"/>
         <item name="22) Logging"            href="logging.html"/>
         <item name="23) APR"                href="apr.html"/>
+        <item name="24) Virtual Hosting"    href="virtual-hosting-howto.html"/>
     </menu>
 
     <menu name="Reference">

Added: tomcat/container/tc5.5.x/webapps/docs/virtual-hosting-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/virtual-hosting-howto.xml?view=auto&rev=491502
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/virtual-hosting-howto.xml (added)
+++ tomcat/container/tc5.5.x/webapps/docs/virtual-hosting-howto.xml Sun Dec 31 14:19:58 2006
@@ -0,0 +1,107 @@
+<?xml version="1.0"?>
+<!DOCTYPE document [
+  <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="virtual-hosting-howto.html">
+
+    &project;
+
+  <properties>
+    <title>Virtual Hosting and Tomcat</title>
+  </properties>
+
+<body>
+
+  <section name="Assumptions">
+    <p>
+      For the sake of this how-to, assume you have a development host with two
+      host names, <code>ren</code> and <code>stimpy</code>. Let's
also assume
+      one instance of Tomcat running, so <code>$CATALINA_HOME</code> refers to
+      wherever it's installed, perhaps <code>/usr/local/tomcat</code>.
+    </p>
+    <p>
+      Also, this how-to uses Unix-style path separators and commands; if you're
+      on Windows modify accordingly. 
+    </p>
+  </section>
+
+  <section name="server.xml">
+    <p>
+      At the simplest, edit the <a href="config/engine.html">Engine</a> portion
+      of your <code>server.xml</code> file to look like this:
+    </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;/Engine&gt;
+    </source>
+    <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.
+    </p>
+  </section>
+
+  <section name="Webapps Directory">
+    <p>
+      Create directories for each of the virtual hosts:
+    </p>
+    <source>
+mkdir $CATALINA_HOME/webapps/ren
+mkdir $CATALINA_HOME/webapps/stimpy
+    </source>
+  </section>
+
+  <section name="Configuring Your Contexts">
+    <subsection name="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>
+        This makes deployment easier, particularly if you're distributing a WAR
+        file.
+      </p>
+    </subsection>
+    <subsection name="Approach #2">
+      <p>
+        Create a structure under <code>$CATALINA_HOME/conf/Catalina</code>
+        corresponding to your virtual hosts, e.g.:
+      </p>
+      <source>
+mkdir $CATALINA_HOME/conf/Catalina/ren
+mkdir $CATALINA_HOME/conf/Catalina/stimpy
+      </source>
+      <p>
+        Note that the ending directory name "Catalina" represents the
+        <code>name</code> attribute of the
+        <a href="config/engine.html">Engine</a> element as shown above.
+      </p>
+      <p>
+        Now, for your default webapps, add:
+      </p>
+      <source>
+$CATALINA_HOME/conf/Catalina/ren/ROOT.xml
+$CATALINA_HOME/conf/Catalina/stimpy/ROOT.xml
+      </source>
+      <p>
+        If you want to use the Tomcat manager webapp for each host, you'll also
+        need to add it here:
+      </p>
+      <source>
+cd $CATALINA_HOME/conf/Catalina
+cp localhost/manager.xml ren/
+cp localhost/manager.xml stimpy/
+      </source>
+    </subsection>
+    <subsection name="Further Information">
+      <p>
+        Consult the configuration documentation for other attributes of the
+        <a href="config/context.html">Context</a> element.
+      </p>
+    </subsection>
+  </section>
+
+</body>
+</document>

Propchange: tomcat/container/tc5.5.x/webapps/docs/virtual-hosting-howto.xml
------------------------------------------------------------------------------
    svn:eol-style = native



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


Mime
View raw message