From: brian Date: Tue, 16 Jun 1998 02:40:32 +0000 (+0000) Subject: PR: X-Git-Tag: 1.3.1~20 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=17b2b264931011d15851c0e3ea4b528d8ce02284;p=thirdparty%2Fapache%2Fhttpd.git PR: Submitted by: bhyde@pobox.com Reviewed by: Brian More good details added, more work needed... git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@81557 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/platform/windows.html b/docs/manual/platform/windows.html index f8c1928b97a..587a4193b05 100644 --- a/docs/manual/platform/windows.html +++ b/docs/manual/platform/windows.html @@ -47,6 +47,7 @@ to help with development, or to track down bugs), see the section on
  • Running Apache for Windows
  • Using Apache for Windows
  • Running Apache for Windows from the Command Line +
  • Signalling Apache when running
  • Compiling Apache for Windows @@ -152,7 +153,7 @@ subdirectory htdocs. There are lots of other options which should be set before you start really using Apache. However to get started quickly the files should work as installed. -

    Running Apache for Windows

    +

    Running Apache for Windows

    There are two ways you can run Apache: @@ -161,7 +162,7 @@ There are two ways you can run Apache: you want Apache to automatically start when you machine boots, and to keep Apache running when you log-off. -
  • From a console window. This is the only option available for +
  • From a console window. This is the only option available for Windows 95 users. @@ -272,32 +273,57 @@ interafce for administering Apache. But in some cases it is easier to work from the command line.

    - When working with Apache it is important to know how it will find the -configuration files. During installation, a registry key will have -been installed. For the 1.3 beta releases the key is: +configuration files. Apache will try one of the following, in this order. -

    -  HKEY_LOCAL_MACHINE\Software\Apache Group\Apache\1.3 beta\ServerRoot
-
    + -While for the final 1.3.0 release it is called: +

    +The server root compiled into the server is usually "/apache". +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. + +

    +Under windows, when invoked from the start menu or the Service Manager Apache is +usually passed no arguments. So using the registry entry is the perfered +technique. +

    +During a binary installation, a registry key will have +been installed, for example: 

       HKEY_LOCAL_MACHINE\Software\Apache Group\Apache\1.3.0\ServerRoot
    -(The use of different keys lets you install later versions without -affect any previous versions already installed. For example, when -1.3.1 comes out it will use "1.3.1" instead of "1.3.0" in the registry -key, so you can install and test 1.3.1 without affecting you existing -1.3.0 installation. Note however that Windows NT service manager only -ever allows one service with the same name, so you cannot install the -newer version as a service whilst the older version is still -installed). +For the 1.3 beta releases the key was: +
    +  HKEY_LOCAL_MACHINE\Software\Apache Group\Apache\1.3 beta\ServerRoot
+

    +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 can not run two invocations +of Apache on Windows simultaneously. +

    +If you did not do a binary install then Apache will in some +senarios complain that about the missing registry key. This +warning can be ignored if it otherwise was able to find it's +configuration files. + +

    The value of this key is the "ServerRoot" directory, containing the conf directory. When Apache starts it will read the httpd.conf file from this directory. If this file @@ -309,7 +335,6 @@ location it is vital that you update the ServerRoot directory in the httpd.conf file to the new location.

    - To run Apache from the command line as a console application, use the following command: @@ -317,14 +342,13 @@ following command: apache -s -(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). Apache will execute, and will remain running until it -is stopped by pressing control-C. +Apache 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.)

    -To install Apache as a Windows NT service, use the following: +To install Apache as a Windows NT service as follows: 

         apache -i
@@ -336,15 +360,34 @@ and to remove the Apache service, use
     apache -u
    -If you want to run an installation of Apache in a directory other than -the one in the registry key as above, use the -f -command-line to specify the path to the httpd.conf file, -or the -d option to specify the server root -directory. These options can be used with any of the other flags as -listed above. Again note that once Apache has read the -httpd.conf file it will then start using the directory -given on the ServerRoot directive line instead of the -f -or -d command line argument. + +

    Signalling Apache when running

    + +

    When Apache is running you may request that it reread it's +configuration files as follows: + +

    +    apache -Z @@whatever?@@>
+
    + +and to request that it shutdown gracefully, via: + +
    +    apache -Z @@whatever?@@>
+
    + +and you can force it to stop via: + +
    +    apache -Z @@whatever?@@
+
    + + +

    +Other techinques of shutting down the server (e.g. using the +task manager to "End Process", distroying the command +window containing the server, or using control-C to interupt +it) all have the downside of @@whatever@@.

    Compiling Apache for Windows

    @@ -412,6 +455,13 @@ be omitted if Apache is to be installed into \Apache.

    If you do not have nmake, or wish to install in a different directory, be sure to use a similar naming scheme.

    +

    +Before running the server you must fill out the conf directory. +Copy the *.conf-dist-win from the distribution conf directory +and rename *.conf. Edit the @@ServerRoot@@ entries to your +actual server root (for example "C:\apache"). Copy over +the conf/magic and conf/mime.types files as well. +