View | Details | Raw Unified | Return to bug 54931
Collapse All | Expand All

(-)windows-service-howto.xml (+68 lines)
Lines 320-326 Link Here
320
C:\> service.bat install
320
C:\> service.bat install
321
</source>
321
</source>
322
</p>
322
</p>
323
<p>There is a 2nd optional parameter that lets you specify the name of the service, as displayed in Windows services</p>
323
<p>
324
<p>
325
<source>
326
Install the service named 'MyService'
327
C:\> service.bat install MyService
328
</source>
329
</p>
330
<p>
324
If using tomcat7.exe, you need to use the <b>//IS//</b> parameter.
331
If using tomcat7.exe, you need to use the <b>//IS//</b> parameter.
325
</p>
332
</p>
326
<p>
333
<p>
Lines 345-350 Link Here
345
C:\> --Startup=auto --Classpath=%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\bin\bootstrap.jar
352
C:\> --Startup=auto --Classpath=%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\bin\bootstrap.jar
346
</source>
353
</source>
347
</p>
354
</p>
355
<p>If you gave the service an optional name, you need to specify it like this</p>
356
<p>
357
<source>
358
Update the service named 'MyService'
359
C:\> tomcat7 //US//MyService --Description="Apache Tomcat Server - http://tomcat.apache.org/ " \
360
C:\> --Startup=auto --Classpath=%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\bin\bootstrap.jar
361
</source>
362
</p>
348
</section>
363
</section>
349
<section name="Removing services">
364
<section name="Removing services">
350
<p>
365
<p>
Lines 357-362 Link Here
357
C:\> tomcat7 //DS//Tomcat7
372
C:\> tomcat7 //DS//Tomcat7
358
</source>
373
</source>
359
</p>
374
</p>
375
<p>If you gave the service an optional name, you need to specify it like this</p>
376
<p>
377
<source>
378
Remove the service named 'MyService'
379
C:\> tomcat7 //DS//MyService
380
</source>
381
</p>
360
</section>
382
</section>
361
<section name="Debugging services">
383
<section name="Debugging services">
362
<p>
384
<p>
Lines 375-379 Link Here
375
</source>
397
</source>
376
</p>
398
</p>
377
</section>
399
</section>
400
<section name="Multiple Instances">
401
<p>
402
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 1 or more instances on different IP/Ports.
403
</p>
404
<p>
405
Each Instance folder will need the following structure
406
</p>
407
<ul>
408
<li>conf</li>
409
<li>logs</li>
410
<li>temp</li>
411
<li>webapps</li>
412
</ul>
413
<p>
414
At a minimum, conf should contain a copy of the following files from CATALINA_HOME\conf\server.xml. 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.
415
</p>
416
<ul>
417
<li>server.xml</li>
418
<li>web.xml</li>
419
</ul>
420
<p>
421
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>&lt;Connector port="8080"</pre> and update the port number so as to specify a unique port
422
</p>
423
<p>
424
To install an instance, first set the CATALINA_HOME environment variable to the name of the tomcat 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
425
</p>
426
<p>
427
<source>
428
set CATALINA_HOME=c:\tomcat_7
429
set CATALINA_BASE=c:\tomcat_7\instances\instance1
430
service install instance1
431
</source>
432
</p>
433
<p>
434
To modify the service settings, you can run <b>tomcat7w //ES//instance1</b>
435
</p>
436
<p>
437
For additional instances, create additional instance folder, update the CATALINA_BASE environment variable, and run the service install again
438
</p>
439
<p>
440
<source>
441
set CATALINA_BASE=c:\tomcat_7\instances\instance2
442
service install instance2
443
</source>
444
</p>
445
</section>
378
</body>
446
</body>
379
</document>
447
</document>

Return to bug 54931