diff --git a/docs/manual/platform/windows.html b/docs/manual/platform/windows.html index 67eee003a2..641577a8c2 100644 --- a/docs/manual/platform/windows.html +++ b/docs/manual/platform/windows.html @@ -47,7 +47,9 @@ to help with development, or to track down bugs), see the section on
@@ -168,6 +172,11 @@ line with NET STOP APACHE+See Signalling Service Apache when Running +for more information on installing and controlling Apache services. + +
+ To run Apache from a console window, select the "Start Apache as console app" option from the Start menu (in Apache 1.3.4 and earlier, this option was called "Apache Server"). This will open a console @@ -175,7 +184,7 @@ window and start Apache running inside it. The window will remain active until you stop Apache. To stop Apache running, either select the "Shutdown Apache console app" icon option from the Start menu (this is not available in Apache 1.3.4 or earlier), or see Signalling Apache when Running for how +HREF="#signal">Signalling Console Apache when Running for how to control Apache from the command line.
@@ -258,6 +267,44 @@ The main differences in Apache for Windows are: is available. +
+ apache -i -n "service name" ++ +To install a service to use a particular configuration, specify the +configuration file when the service is installed: + +
+ apache -i -n "service name" -f "\my server\conf\my.conf" ++ +To remove an Apache service, use + +
+ apache -u -n "service name" ++ +The default "service name", if one is not specified, is "Apache". + +
+
+Once a service is installed, you can use the -n option, in conjunction
+with other options, to refer to a service's configuration file. For example:
+
+To test a service's configuration file:
+
+ apache -n "service name" -t ++ +To start a console Apache using a service's configuration file: +
+ apache -n "service name" ++
When working with Apache it is important to know how it will find the -configuration files. Apache will try one of the following, in this order. +configuration files. You can specify a configuration file on the command line +in two ways: + +
apache -f "c:\my server\conf\my.conf"+
apache -f test\test.conf+
apache -n "service name"+ +In these cases, the proper ServerRoot should be set in the configuration file. + +
+ +If you don't specify a configuration file name with -f or -n, Apache will +use the file name compiled into the server, usually "conf/httpd.conf". Invoking +Apache with the -V switch will display this value labeled as SERVER_CONFIG_FILE. +Apache will then determine it's ServerRoot by trying the following, in this order:
The server root compiled into the server is usually "/apache". -invoking apache with the -v switch will display this value +invoking apache with the -V switch will display this value labeled as HTTPD_ROOT.
-Your current working directory when Apache is started up has no -effect on Apache's behavior. - -
-When invoked from the start menu or the Service Manager, Apache is -usually passed no arguments, so using the registry entry is the preferred -technique. +When invoked from the start menu, Apache is usually passed no arguments, +so using the registry entry is the preferred technique for console Apache.
During a binary installation, a registry key will have @@ -301,8 +363,7 @@ been installed, for example: This key is compiled into the server and can enable you to test new versions without affecting the current version. Of course you must take care not to install the new version on top of the -old version in the file system. You cannot run two invocations -of Apache on Windows simultaneously. +old version in the file system.
If you did not do a binary install then Apache will in some @@ -326,29 +387,32 @@ To run Apache from the command line as a console application, use the following command:
- apache -s + apacheApache will execute, and will remain running until it is stopped by pressing -control-C. (The -s option is not required by Windows 95, but on Windows NT it -prevents Apache waiting to see if Apache is running as a service.) +control-C. -
+
- apache -i + apache -n "service name" -k start + apache -n "service name" -k restart + apache -n "service name" -k shutdown-and to remove the Apache service, use +In addition, you can use the native NT NET command to +start and stop Apache services as follows:
- apache -u + NET START "service name" + NET STOP "service name"- -