httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From br...@hyperreal.org
Subject cvs commit: apache-1.3/htdocs/manual windows.html
Date Tue, 16 Jun 1998 02:40:34 GMT
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>
  
  
  

Mime
View raw message