Return-Path: Delivered-To: apmail-apache-cvs-archive@apache.org Received: (qmail 82032 invoked by uid 500); 10 May 2000 21:25:22 -0000 Mailing-List: contact apache-cvs-help@apache.org; run by ezmlm Precedence: bulk X-No-Archive: yes Reply-To: new-httpd@apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list apache-cvs@apache.org Received: (qmail 81831 invoked by uid 500); 10 May 2000 21:25:18 -0000 Delivered-To: apmail-apache-1.3-cvs@apache.org Date: 10 May 2000 21:25:17 -0000 Message-ID: <20000510212517.81720.qmail@locus.apache.org> From: wrowe@locus.apache.org To: apache-1.3-cvs@apache.org Subject: cvs commit: apache-1.3/htdocs/manual windows.html wrowe 00/05/10 14:25:14 Modified: htdocs/manual windows.html Log: Must make these clearer for Win32 folks, since many, many newsgroup questions would be answered by following the expanded instructions! Revision Changes Path 1.33 +81 -22 apache-1.3/htdocs/manual/windows.html Index: windows.html =================================================================== RCS file: /home/cvs/apache-1.3/htdocs/manual/windows.html,v retrieving revision 1.32 retrieving revision 1.33 diff -u -r1.32 -r1.33 --- windows.html 2000/05/05 02:38:28 1.32 +++ windows.html 2000/05/10 21:25:11 1.33 @@ -59,23 +59,21 @@ Apache 1.3 is designed to run on Windows NT 4.0. The binary installer will only work with the x86 family of processors, such as Intel's. Apache -may also run on Windows 95, Windows 98 and Windows NT 3.5.1, but these -have not been tested. In all cases TCP/IP networking must be installed. +may also run on Windows 95 and 98, but these have not been tested. In all +cases TCP/IP networking must be installed. -

- -If running on Windows 95, using the "Winsock2" upgrade is recommended -but may not be necessary. If running on NT 4.0, installing Service Pack 2 -is recommended. +

If running on NT 4.0, installing Service Pack 3 is recommended, and + Service Pack 4 created known issues with Tcpip/winsock integrety that + were resolved in Service Pack 5.

+ +

If running on Windows 95, the "Winsock2" upgrade MUST BE INSTALLED. + "Winsock2" for Windows 95 is available + here.

Note: "Winsock 2" is required for Apache 1.3.7 and later. -

- -"Winsock 2" for Windows 95 is available here. -

Downloading Apache for Windows

Information on the latest version of Apache can be found on the @@ -164,6 +162,37 @@ Windows 95 users. +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 +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 Console Apache when Running for how +to control Apache from the command line. + +

If the Apache console window closes immediately (or unexpectedly), + run the "Command Prompt" from the Start Menu - Programs list. Change + to the folder to which you installed Apache, type the command apache, + and read the error message. Then change to the logs folder, and review + the error.log file for configuration mistakes. If you accepted the + defaults when you installed Apache, the commands would be:

+ +
  +  c:
  +  cd "\program files\apache group\apache"
  +  apache
  +  Wait for Apache to exit, or press Ctrl+C
  +  cd logs
  +  more <error.log
  +
+ +

Complete the steps above before you proceed to attempt to + start Apache as a Window NT/2000 service!

+ +

+ To start Apache as a service, you first need to install it as a service. Multiple Apache services can be installed, each with a different name and configuration. To install the default Apache @@ -183,18 +212,11 @@ See Signalling Service Apache when Running for more information on installing and controlling Apache services. -

+

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 not find Apache error + details in the Windows NT Event Log.

-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 -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 Console Apache when Running for how -to control Apache from the command line. -

After starting Apache running (either in a console window or as a @@ -323,6 +345,43 @@ 

       apache -n "service name"
+ +

Important Note on service dependencies:

+ +

Prior to Apache release 1.3.13, the dependencies required to + successfully start an installed service were not configured. + After installing a service using earlier versions of Apache, + you must follow these steps: + +

  +    Run regedt32
  +    Select Window - "HKEY_LOCAL_MACHINE on Local Machine" from the menu
  +    Double-click to open the SYSTEM, then the CurrentControlSet keys
  +    Scroll down and click on the Apache servicename
  +    Select Edit - Add Value... from the menu
  +    Fill in the Add Value dialog with 
  +        Value Name: DependOnGroup 
  +        Data Type: REG_MULTI_SZ
  +        and click OK
  +    Leave the Multi-String Editor dialog empty and click OK
  +    Select Edit - Add Value... from the menu
  +    Fill in the Add Value dialog with 
  +        Value Name: DependOnService
  +        Data Type: REG_MULTI_SZ
  +        and click OK
  +    Type the following list (one per line) in the Multi-String Editor dialog
  +        Tcpip
  +        Afd
  +        and click OK
  +
+ +

If you are using COM or DCOM components from a third party module, ISAPI, + or other add-in scripting technologies such as ActiveState Perl, you may + also need to add the entry Rpcss to the DependOnService list. To avoid + exposing the TCP port 135 when it is unnecessary, Apache does not create + that entry upon installation. Follow the directions above to find or + create the DependOnService value, double click that value if it already + exists, and add the Rpcss entry to the list.

Running Apache for Windows from the Command Line