mturk 2003/09/28 00:19:38
Modified: daemon/xdocs procrun.xml
Log:
Apply the Bill's patches with some minor adjustments.
Thanks Bill.
Revision Changes Path
1.4 +64 -7 jakarta-commons/daemon/xdocs/procrun.xml
Index: procrun.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/daemon/xdocs/procrun.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- procrun.xml 26 Sep 2003 19:30:52 -0000 1.3
+++ procrun.xml 28 Sep 2003 07:19:38 -0000 1.4
@@ -5,6 +5,8 @@
<properties>
<title>Daemon : Procrun</title>
<author email="[EMAIL PROTECTED]">Jean-Frederic Clere</author>
+ <author email="[EMAIL PROTECTED]">Bill Barker</author>
+ <author email="[EMAIL PROTECTED]">Mladen Turk</author>
</properties>
<body>
@@ -23,7 +25,7 @@
open the corresponding build project file.
<ul>
<li>For MSVC 6.x, use <code>procrun.dsw</code></li>
- <li>For MSVC.NET, use <code>procrun.vcproj</code></li>
+ <li>For MSVC.NET, use <code>procrun.sln</code></li>
</ul>
At this point, you need to select from the build menu which version you
want to build (select either the release or debug build, depending on
@@ -31,11 +33,12 @@
<ul>
<li><code>procrun</code> if you want the GUI interface</li>
<li><code>procrun CONSOLE</code> if you don't want the GUI interface</li>
- <li><code>procrun DLL</code> if you want to launch via
<code>rundll</code></li>
+ <li><code>procrun DLL</code> if you want the Control Panel
application</code></li>
</ul>
</p>
</section>
<section name="Using procrun">
+<subsection name="Installing the service">
<p>
The first thing that you must do is to install your service. As a
special case, if you haved installed Tomcat 5 via the installer, then it
@@ -43,15 +46,16 @@
</p>
<p>
To install the service, you need to use the <code>//IS//</code> parameter.
- For example:
- <pre>
- procrun //IS//Tomcat5 --DisplayName "Tomcat 5.0.11" \
- --Description "Tomcat 5.0.11 JDK 1.4 http://jakarta.apache.org"; \
+ Use <code>tomcatw.exe</code> if you want to run the Graphical version,
+ or <code>tomcat.exe</code> for the non-Graphical version. For example:
+ <source>
+ tomcat //IS//Tomcat5 --DisplayName "Tomcat 5.0.12" \
+ --Description "Tomcat 5.0.12 JDK 1.4 http://jakarta.apache.org"; \
--ImagePath "c:\devtools\tomcat\5.0\bin\bootstrap.jar" \
--StartupClass org.apache.catalina.startup.Bootstrap;main;start \
--ShutdownClass org.apache.catalina.startup.Bootstrap;main;stop \
--Java auto
- </pre>
+ </source>
<table>
<caption>The options available for installation are</caption>
<tr><th>--DisplayName</th>
@@ -124,6 +128,59 @@
service from installation program using procrunw.</td></tr>
</table>
</p>
+</subsection>
+<subsection name="Running the service">
+<p>
+ You can use the Windows Service Manager to stop and start the
+ service, as you would for any other service. This is the recommended way
+ to manage the service.</p>
+<p>
+ To test the service, or to simply run the process manually, use the //GT//
+ option for the Graphical version. For example:
+ <source>
+ tomcatw //GT//Tomcat5
+ </source>
+ To test the non-Graphical version, use the //TS// option. For example:
+ <source>
+ tomcat //TS//Tomcat5
+ </source>
+ Either of these will start your service as a normal program running under
+ the identity of the currently logged in user. It is
+ <strong>Important</strong> that the Service is stopped before testing, or
+ these commands will fail.</p>
+</subsection>
+<subsection name="Changing the Service Parameters from the GUI">
+<p>
+ To change the Service settings using the GUI interface, use the //ES// option
with
+ <code>tomcatw.exe</code>. You can then change the settings by entering
+ the new values in the correct boxes. For example:
+ <source>
+ tomcatw //ES//Tomcat5
+ </source>
+</p>
+</subsection>
+<subsection name="Changing the Service Parameters from the Command Line">
+<p>
+ To change the Service settings from the command line, use the //US// option.
+ The parameters are the same as for <a href="#Installing%20the%20service">
+ Installing the service</a>. For example:
+ <source>
+ tomcat //US//Tomcat5 --Java c:\jsdk1.4.1_02\jre\bin\client\jvm.dll \
+ --StdOutputFile c:\Tomcat5\logs\stdout.txt \
+ --StdErrorFile c:\Tomcat5\logs\stderr.txt
+ </source>
+</p>
+</subsection>
+<subsection name="Removing the Service">
+<p>
+ To remove the service, use the //DS// option. For example:
+ <source>
+ tomcat //DS//Tomcat5
+ </source>
+ This command will remove the service from the Windows Service Manager, but
+ it will still allow you to run it via the //GT// or //TS// options.
+</p>
+</subsection>
</section>
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
