You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by br...@hyperreal.org on 1998/06/16 04:40:34 UTC
cvs commit: apache-1.3/htdocs/manual windows.html
brian 98/06/15 19:40:33
Modified: htdocs/manual windows.html
Log:
Submitted by: bhyde@pobox.com
Reviewed by: Brian
More good details added, more work needed...
Revision Changes Path
1.17 +82 -32 apache-1.3/htdocs/manual/windows.html
Index: windows.html
===================================================================
RCS file: /export/home/cvs/apache-1.3/htdocs/manual/windows.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- windows.html 1998/05/30 12:18:01 1.16
+++ windows.html 1998/06/16 02:40:32 1.17
@@ -47,6 +47,7 @@
<LI><A HREF="#run">Running Apache for Windows</A>
<LI><A HREF="#use">Using Apache for Windows</A>
<LI><A HREF="#cmdline">Running Apache for Windows from the Command Line</A>
+ <LI><A HREF="#signal">Signalling Apache when running</A>
<LI><A HREF="#comp">Compiling Apache for Windows</A>
</UL>
@@ -152,7 +153,7 @@
which should be set before you start really using Apache. However to
get started quickly the files should work as installed.
-<H2><A NAME="inst">Running Apache for Windows</A></H2>
+<H2><A NAME="run">Running Apache for Windows</A></H2>
There are two ways you can run Apache:
@@ -161,7 +162,7 @@
you want Apache to automatically start when you machine boots, and to
keep Apache running when you log-off.
- <LI>From a console window. This is the only option available for
+ <LI>From a <a ref="#cmdline">console window</a>. This is the only option available for
Windows 95 users.
</UL>
@@ -272,32 +273,57 @@
work from the command line.
<P>
-
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.
-<PRE>
- HKEY_LOCAL_MACHINE\Software\Apache Group\Apache\1.3 beta\ServerRoot
-</PRE>
+<ul>
+<li>A ServerRoot directive via a -C switch.
+<li>The -f switch on the command line.
+<li>The -d switch on the command line.
+<li>A registry entry, created if you did a binary install.
+<li>The server root compiled into the server.
+</ul>
-While for the final 1.3.0 release it is called:
+<P>
+The server root compiled into the server is usually "/apache".
+invoking apache with the -v switch will display this value
+labeled as HTTPD_ROOT.
+
+<P>
+Your current working directory when Apache is started up has no
+effect on Apache's behavior.
+
+<P>
+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.
+<P>
+During a binary installation, a registry key will have
+been installed, for example:
<PRE>
HKEY_LOCAL_MACHINE\Software\Apache Group\Apache\1.3.0\ServerRoot
</PRE>
-(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:
+<PRE>
+ HKEY_LOCAL_MACHINE\Software\Apache Group\Apache\1.3 beta\ServerRoot
+</PRE>
<P>
+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.
+<P>
+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.
+
+<P>
The value of this key is the "ServerRoot" directory, containing the
<SAMP>conf</SAMP> directory. When Apache starts it will read the
<SAMP>httpd.conf</SAMP> file from this directory. If this file
@@ -309,7 +335,6 @@
directory in the <SAMP>httpd.conf</SAMP> file to the new location.
<P>
-
To run Apache from the command line as a console application, use the
following command:
@@ -317,14 +342,13 @@
apache -s
</PRE>
-(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.)
<P>
-To install Apache as a Windows NT service, use the following:
+To install Apache as a Windows NT service as follows:
<PRE>
apache -i
@@ -336,16 +360,35 @@
apache -u
</PRE>
-If you want to run an installation of Apache in a directory other than
-the one in the registry key as above, use the <CODE>-f</CODE>
-command-line to specify the path to the <SAMP>httpd.conf</SAMP> file,
-or the <CODE>-d</CODE> 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
-<SAMP>httpd.conf</SAMP> file it will then start using the directory
-given on the <SAMP>ServerRoot</SAMP> directive line instead of the -f
-or -d command line argument.
+<H2><A NAME="signal">Signalling Apache when running</A></H2>
+
+<P>When Apache is running you may request that it reread it's
+configuration files as follows:
+
+<PRE>
+ apache -Z @@whatever?@@>
+</PRE>
+
+and to request that it shutdown gracefully, via:
+
+<PRE>
+ apache -Z @@whatever?@@>
+</PRE>
+
+and you can force it to stop via:
+
+<PRE>
+ apache -Z @@whatever?@@
+</PRE>
+
+
+<P>
+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@@.
+
<H2><A NAME="comp">Compiling Apache for Windows</A></H2>
<P>Compiling Apache requires Microsoft Visual C++ 5.0 to be properly
@@ -411,6 +454,13 @@
<P>If you do not have nmake, or wish to install in a different directory,
be sure to use a similar naming scheme.</P>
+
+<P>
+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.
<!--#include virtual="footer.html" -->
</BODY>
Re: cvs commit: apache-1.3/htdocs/manual windows.html
Posted by Paul Sutton <pa...@c2.net>.
Not to put a downer on this good work, but the -Z and signalling stuff
isn't in Apache. I posted a patch a couple of weeks ago (after 1.3b7) but
on-one tested it in time for 1.3.0 (which I where I think it should have
gone).
Anyway perhaps people could test the patch now for 1.3.1? I think this is
an important (required) feature. Or a bug fix, since not being able to
stop the server is a moderately important bug.
> +<H2><A NAME="signal">Signalling Apache when running</A></H2>
> +
> +<P>When Apache is running you may request that it reread it's
> +configuration files as follows:
> +
> +<PRE>
> + apache -Z @@whatever?@@>
> +</PRE>
apache -Z restart
> +and to request that it shutdown gracefully, via:
> +
> +<PRE>
> + apache -Z @@whatever?@@>
> +</PRE>
apache -Z shutdown
> +and you can force it to stop via:
> +
> +<PRE>
> + apache -Z @@whatever?@@
> +</PRE>
You cannot do a non-graceful shutdown in Windows...
> +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@@.
... except this way.
Paul