Author: markt
Date: Tue May 28 09:44:00 2013
New Revision: 1486835
URL: http://svn.apache.org/r1486835
Log:
Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=54931
Add information on creating multiple services.
Based on a patch by Chris Derham
Modified:
tomcat/tc7.0.x/trunk/ (props changed)
tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml
tomcat/tc7.0.x/trunk/webapps/docs/windows-service-howto.xml
Propchange: tomcat/tc7.0.x/trunk/
------------------------------------------------------------------------------
Merged /tomcat/trunk:r1485114,1486834
Modified: tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml
URL:
http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml?rev=1486835&r1=1486834&r2=1486835&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml Tue May 28 09:44:00 2013
@@ -132,6 +132,11 @@
<subsection name="Web applications">
<changelog>
<fix>
+ <bug>54931</bug>: Add information to the Window Service how-to about
+ installing and running multiple instances. Based on a patch by Chris
+ Derham. (markt)
+ </fix>
+ <fix>
<bug>54932</bug>: Correct the link to Tribes documentation. (violetagg)
</fix>
</changelog>
Modified: tomcat/tc7.0.x/trunk/webapps/docs/windows-service-howto.xml
URL:
http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/windows-service-howto.xml?rev=1486835&r1=1486834&r2=1486835&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/windows-service-howto.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/windows-service-howto.xml Tue May 28
09:44:00 2013
@@ -320,10 +320,17 @@ Install the service named 'Tomcat7'
C:\> service.bat install
</source>
</p>
+<p>There is a 2nd optional parameter that lets you specify the name of the
+service, as displayed in Windows services.</p>
<p>
-If using tomcat7.exe, you need to use the <b>//IS//</b> parameter.
+<source>
+Install the service named 'MyService'
+C:\> service.bat install MyService
+</source>
</p>
<p>
+If using tomcat7.exe, you need to use the <b>//IS//</b> parameter.</p>
+<p>
<source>
Install the service named 'Tomcat7'
C:\> tomcat7 //IS//Tomcat7 --DisplayName="Apache Tomcat 7" \
@@ -345,18 +352,34 @@ C:\> tomcat7 //US//Tomcat7 --Description
C:\> --Startup=auto
--Classpath=%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\bin\bootstrap.jar
</source>
</p>
+<p>If you gave the service an optional name, you need to specify it like this:
+</p>
+<p>
+<source>
+Update the service named 'MyService'
+C:\> tomcat7 //US//MyService --Description="Apache Tomcat Server -
http://tomcat.apache.org/ " \
+C:\> --Startup=auto
--Classpath=%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\bin\bootstrap.jar
+</source>
+</p>
</section>
<section name="Removing services">
<p>
To remove the service, you need to use the <b>//DS//</b> parameter.<br/>
-If the service is running it will be stopped and then deleted.
-</p>
+If the service is running it will be stopped and then deleted.</p>
<p>
<source>
Remove the service named 'Tomcat7'
C:\> tomcat7 //DS//Tomcat7
</source>
</p>
+<p>If you gave the service an optional name, you need to specify it like this:
+</p>
+<p>
+<source>
+Remove the service named 'MyService'
+C:\> tomcat7 //DS//MyService
+</source>
+</p>
</section>
<section name="Debugging services">
<p>
@@ -364,8 +387,7 @@ To run the service in console mode, you
The service shutdown can be initiated by pressing <b>CTRL+C</b> or
<b>CTRL+BREAK</b>.
If you rename the tomcat7.exe to testservice.exe then you can just execute the
-testservice.exe and this command mode will be executed by default.
-</p>
+testservice.exe and this command mode will be executed by default.</p>
<p>
<source>
Run the service named 'Tomcat7' in console mode
@@ -375,5 +397,60 @@ C:\> tomcat7
</source>
</p>
</section>
+<section name="Multiple Instances">
+<p>
+Tomcat supports installation of multiple instances. You can have a single
+installation of Tomcat with multiple instances running on different IP/port
+combinations, or multiple Tomcat versions, each running one or more instances
on
+different IP/ports.</p>
+<p>
+Each instance folder will need the following structure:
+</p>
+<ul>
+<li>conf</li>
+<li>logs</li>
+<li>temp</li>
+<li>webapps</li>
+<li>work</li>
+</ul>
+<p>
+At a minimum, conf should contain a copy of the following files from
+CATALINA_HOME\conf\. Any files not copied and edited, will be picked up by
+default from CATALINA_HOME\conf, i.e. CATALINA_BASE\conf files override
defaults
+from CATALINA_HOME\conf.</p>
+<ul>
+<li>server.xml</li>
+<li>web.xml</li>
+</ul>
+<p>
+You must edit CATALINA_BASE\conf\server.xml to specify a unique IP/port for the
+instance to listen on. Find the line that contains
+<pre><Connector port="8080" ...</pre> and add an address attribute and/or
+update the port number so as to specify a unique IP/port combination.</p>
+<p>
+To install an instance, first set the CATALINA_HOME environment variable to the
+name of the Tomcat installation directory. Then create a second environment
+variable CATALINA_BASE and point this to the instance folder. Then run "service
+install" command specifying a service name.</p>
+<p>
+<source>
+set CATALINA_HOME=c:\tomcat_7
+set CATALINA_BASE=c:\tomcat_7\instances\instance1
+service install instance1
+</source>
+</p>
+<p>
+To modify the service settings, you can run <b>tomcat7w //ES//instance1</b>.
+</p>
+<p>
+For additional instances, create additional instance folder, update the
+CATALINA_BASE environment variable, and run the service install again.</p>
+<p>
+<source>
+set CATALINA_BASE=c:\tomcat_7\instances\instance2
+service install instance2
+</source>
+</p>
+</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
