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 2007/01/01 20:42:38 UTC
svn commit: r491620 - in /tomcat/tc6.0.x/trunk/webapps/docs: changelog.xml
index.xml project.xml virtual-hosting-howto.xml
Author: markt
Date: Mon Jan 1 11:42:37 2007
New Revision: 491620
URL: http://svn.apache.org/viewvc?view=rev&rev=491620
Log:
Add virtual hosting howto to TC6 docs (copied from TC5)
Added:
tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml (with props)
Modified:
tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml
tomcat/tc6.0.x/trunk/webapps/docs/index.xml
tomcat/tc6.0.x/trunk/webapps/docs/project.xml
Modified: tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml
URL: http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml?view=diff&rev=491620&r1=491619&r2=491620
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml (original)
+++ tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml Mon Jan 1 11:42:37 2007
@@ -34,6 +34,13 @@
</fix>
</changelog>
</subsection>
+ <subsection name="Webapps">
+ <changelog>
+ <docs>
+ Add a virtual hosting how-to contributed by Hassan Schroeder. (markt)
+ </docs>
+ </changelog>
+ </subsection>
</section>
<section name="Tomcat 6.0.7 (remm)">
<subsection name="General">
Modified: tomcat/tc6.0.x/trunk/webapps/docs/index.xml
URL: http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/index.xml?view=diff&rev=491620&r1=491619&r2=491620
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/index.xml (original)
+++ tomcat/tc6.0.x/trunk/webapps/docs/index.xml Mon Jan 1 11:42:37 2007
@@ -100,7 +100,16 @@
<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>
+<li><a href="aio.html"><strong>Advanced IO</strong></a> -
+ Extensions available over regular, blocking IO.</li>
+<li><a href="extras.html"><strong>Additional Components</strong></a> -
+ Obtaining additional, optional components.</li>
</ol>
Modified: tomcat/tc6.0.x/trunk/webapps/docs/project.xml
URL: http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/project.xml?view=diff&rev=491620&r1=491619&r2=491620
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/project.xml (original)
+++ tomcat/tc6.0.x/trunk/webapps/docs/project.xml Mon Jan 1 11:42:37 2007
@@ -44,8 +44,9 @@
href="monitoring.html"/>
<item name="22) Logging" href="logging.html"/>
<item name="23) APR" href="apr.html"/>
- <item name="24) Advanced IO" href="aio.html"/>
- <item name="25) Additional Components"
+ <item name="24) Virtual Hosting" href="virtual-hosting-howto.html"/>
+ <item name="25) Advanced IO" href="aio.html"/>
+ <item name="26) Additional Components"
href="extras.html"/>
</menu>
Added: 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?view=auto&rev=491620
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml (added)
+++ tomcat/tc6.0.x/trunk/webapps/docs/virtual-hosting-howto.xml Mon Jan 1 11:42:37 2007
@@ -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/tc6.0.x/trunk/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