wrowe 00/12/27 13:59:18
Modified: htdocs/manual windows.html win_service.html
Log:
Document a slew of recent changes for the Win32 user.
Revision Changes Path
1.44 +3 -2 httpd-docs-1.3/htdocs/manual/windows.html
Index: windows.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/windows.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- windows.html 2000/12/20 23:48:32 1.43
+++ windows.html 2000/12/27 21:59:18 1.44
@@ -190,8 +190,9 @@
with version 1.3.13, Apache will also gladly stop if you select 'Close'
from the system menu (clicking the icon on the top-left corner of the
console window) or click the close (X) button on the top-right corner.
- But do <EM>not</em> try any of these approaches on earlier versions of the
- Apache server, since Apache did not shut down cleanly.</P>
+ The Close menu item and close (X) button also work on Windows 95/98 as of
+ Apache version 1.3.15. But do <EM>not</em> try any of these approaches on
+ earlier versions of the Apache server, since Apache would not clean
up.</P>
<H2><A NAME="test">Testing Apache for Windows</A></H2>
1.4 +53 -14 httpd-docs-1.3/htdocs/manual/win_service.html
Index: win_service.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/win_service.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- win_service.html 2000/08/08 14:56:23 1.3
+++ win_service.html 2000/12/27 21:59:18 1.4
@@ -56,10 +56,11 @@
<P>See <A HREF="#signal">Controlling Apache as a Service</A>
for more information on installing and controlling Apache services.</P>
-<P><STRONG>Apache, unlike many other Windows NT/2000 services, logs any
- errors to it's own error.log file in the logs folder within the
- Apache server root folder. You will <EM>not</EM> find Apache error
- details in the Windows NT Event Log.</STRONG></P>
+<P><STRONG>Apache, unlike many other Windows NT/2000 services, logs most
+ errors to it's own error.log file, in the logs folder within the
+ Apache server root folder. You will find few Apache error details in
+ the Windows NT Event Log. Only errors as Apache attempts to start are
+ captured in the Event Log.</STRONG></P>
<P>After starting Apache as a service (or if you have trouble starting it)
you can test it using the same <A HREF="windows.html#test">procedure</a>
@@ -69,9 +70,8 @@
apache -n "service name"
</PRE>
-<P>to assure you are using the service's configuration.</P>
-
-
+<P>to assure you are using the service's default configuration.</P>
+
<H2><A NAME="service">Running Apache for Windows as a Service</A></H2>
<P><STRONG>Note: The -n option to specify a service name is only available
@@ -91,6 +91,16 @@
apache -i -n "service name" -f "\my server\conf\my.conf"
</PRE>
+<P>You can pass any other arguments, such as -d to change the default
+ server root directory, -D, -C or -c to change the config file processing,
+ etc. Since these are stored in the registry and are difficult to modify,
+ use this command to clear the options and replace them with a new list
+ of options;</P>
+
+<PRE>
+ apache -k config -n "service name" -f "\my server\conf\my.conf"
+</PRE>
+
<P>To remove an Apache service, use:</P>
<PRE>
@@ -103,16 +113,24 @@
conjunction with other options, to refer to a service's configuration
file.
For example:</P>
-<P>To test a service's configuration file:</P>
+<P>To test a service's configuration file and report the default options for
+ the service (configured with -i, -k install or -k config) use:</P>
<PRE>
apache -n "service name" -t
</PRE>
-<P>To start a console Apache using a service's configuration file:</P>
+<P>To start a console Apache using a service's configuration file and its
+ default options, use:</P>
<PRE>
apache -n "service name"
</PRE>
+<P>Effective with Apache release 1.3.15, the -k install option was added
+ as an alias to -i, and the -k uninstall option was added as an alias
+ to -u. The original -i and -u options are depreciated in Apache 2.0.
+ These aliases were added to ease the transition for administrators
+ running both versions.</P>
+
<H2><A NAME="depends">Important Note on service dependencies:</A></H2>
<P>Prior to Apache release 1.3.13, the dependencies required to
@@ -265,16 +283,36 @@
in Apache version 1.3.13.</STRONG> Earlier versions of Apache will only
recognize the -k shutdown option. Prior to 1.3.3, Apache did not
recognize
<EM>any</EM> -k options at all!</P>
+
+<P>Note that you may specify startup options on the apache -k start command
+ line, including the -D, -C and -c options. These affect the processing of
+ the service configuration, and may be used with the <IfDefine>
block
+ to conditionally process directives. You may also override the server
root
+ path or configuration file with the -d or -f options. The options should
+ also be passed to the -k restart command, but they are ignored if the
+ service is running, and only processed if the service is started.</P>
+
+<P>The service also appears in the Service Control applet on Windows NT/2000.
+ For NT, this is found in the Settings -- Control Panel -- Services entry,
+ and on 2000 it is found in the Settings -- Control Panel -- Administrative
+ Tools -- Services entry. Here you can select the desired Apache service
+ to start or stop it. Pass additional options such as -D, -C, and -c, or
+ override the default -d or -f options in the Start Parameters box before
+ clicking the Start button. These options behave the identically to the
+ apache -k start command.</P>
-<P>In addition, you can use the native NT NET command to
- start and stop Apache services as follows:</P>
+<P>In addition, you can use the native Windows NT/2000 command NET to
+ start and stop Apache services:</P>
<PRE>
NET START "service name"
NET STOP "service name"
</PRE>
-<P>Again, quotes are only required if the service name contains spaces.</P>
+<P>Again, quotes are only required if the service name contains spaces.
There
+ is no way using the NET START command to pass additional options such as
+ -D, -c or -C using the NET START command. If options are requied, use one
+ of the other two methods instead.</P>
<H2><A NAME="win95svc">HIGHLY EXPERIMENTAL Windows 95/98 Service</A></H2>
@@ -303,9 +341,10 @@
via a shortcut on your desktop, for example, then if the service starts
successfully a console window will flash up but immediately disappears.
If Apache detects any errors on startup such as a incorrect entries in
the
- httpd.conf file, then the console window will remain visible. This will
+ httpd.conf file, then the console window will remain visible. This may
display an error message which will be useful in tracking down the cause
of
- the problem.</P>
+ the problem, and you should also review the error.log file in the Apache
+ logs directory.</P>
<P>Windows 95/98 does not support NET START or NET STOP commands so you must
use Apache's Service Control options at a command prompt. You may wish to
