You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2006/12/31 23:19:58 UTC
svn commit: r491502 - in /tomcat/container/tc5.5.x/webapps/docs:
changelog.xml index.xml project.xml virtual-hosting-howto.xml
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>
+<Engine name="Catalina" defaultHost="ren">
+ <Host name="ren" appBase="webapps/ren"/>
+ <Host name="stimpy" appBase="webapps/stimpy"/>
+</Engine>
+ </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