httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wr...@locus.apache.org
Subject cvs commit: httpd-docs-1.3/htdocs/manual windows.html win_service.html
Date Wed, 27 Dec 2000 21:59:19 GMT
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 &lt;IfDefine&gt; 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 
  
  
  

Mime
View raw message