wrowe 01/10/03 20:30:07 Modified: htdocs/manual win_compiling.html win_service.html.en windows.html Log: Someone maintaining .ja.jis needs to pick up the win_service.html.en changes and port them ;) Revision Changes Path 1.12 +13 -52 httpd-docs-1.3/htdocs/manual/win_compiling.html Index: win_compiling.html =================================================================== RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/win_compiling.html,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- win_compiling.html 2001/10/02 11:02:58 1.11 +++ win_compiling.html 2001/10/04 03:30:07 1.12 @@ -42,8 +42,8 @@ <p>Note that DevStudio will only find awk.exe if its location is listed under the <u>T</u>ools menu <u>O</u>ptions... - Directories settings for the Executable files. Add the path for - awk.exe to this list, as needed.</p> + Directories settings for the Executable files. Add the path where + awk.exe resides to this list, as needed.</p> <p>Then unpack the Apache distribution into an appropriate directory. Open a command-line prompt, and change to the @@ -91,8 +91,8 @@ date. Without a recent update, Apache will issue warnings under MSVC++ 5.0 that some mod_isapi features will be disabled. Look for the update at <a - href="http://msdn.microsoft.com/downloads/sdks/platform/platform.asp"> - http://msdn.microsoft.com/downloads/sdks/platform/platform.asp</a>.</p> + href="http://msdn.microsoft.com/platformsdk/"> + http://msdn.microsoft.com/platformsdk/</a>.</p> <p>Apache can also be compiled using VC++'s Visual Studio development environment. To simplify this process, a Visual @@ -126,79 +126,56 @@ <p>The core .dsp projects built by Apache.dsw and makefile.win are:</p> - <ol> + <ul> <li><code>os\win32\ApacheOS.dsp</code></li> - <li><code>os\win32\Win9xConHook.dsp</code></li> - <li><code>regex\regex.dsp</code></li> - <li><code>ap\ap.dsp</code></li> - <li><code>lib\expat-lite\xmltok.dsp</code></li> - <li><code>lib\expat-lite\xmlparse.dsp <em>requires xmltok</em></code></li> - <li><code>lib\sdbm.dsp</code></li> - <li><code>main\gen_uri_delims.dsp</code></li> - <li><code>main\gen_test_char.dsp</code></li> - <li><code>ApacheCore.dsp <em>requires all of the above</em></code></li> - <li><code>Apache.dsp <em>requires ApacheCore</em></code></li> - </ol> + </ul> <p>In addition, the <code>os\win32</code> subdirectory contains project files for the optional modules, all of which require ApacheCore.</p> - <ol> + <ul> <li><code>os\win32\mod_auth_anon.dsp</code></li> - <li><code>os\win32\mod_auth_dbm.dsp <em>also requires sdbm</em></code></li> - <li><code>os\win32\mod_auth_digest.dsp</code></li> - <li><code>os\win32\mod_cern_meta.dsp</code></li> - <li><code>os\win32\mod_digest.dsp</code></li> - <li><code>os\win32\mod_expires.dsp</code></li> - <li><code>os\win32\mod_headers.dsp</code></li> - <li><code>os\win32\mod_info.dsp</code></li> - + <li><code>os\win32\mod_proxy.dsp</code></li> <li><code>os\win32\mod_rewrite.dsp</code></li> - <li><code>os\win32\mod_speling.dsp</code></li> - <li><code>os\win32\mod_status.dsp</code></li> - + <li><code>os\win32\mod_unique_id.dsp</code></li> <li><code>os\win32\mod_usertrack.dsp</code></li> - - <li><code>os\win32\mod_proxy.dsp</code></li> - </ol> + <li><code>os\win32\mod_vhost_alias.dsp</code></li> + </ul> <p>The <code>support\</code> folder contains project files for additional programs that are not part of the Apache runtime, but are used by the administrator to maintain password and log files.</p> - <ol> + <ul> <li><code>support\htdigest.dsp</code></li> - <li><code>support\htpasswd.dsp</code></li> - <li><code>support\logresolve.dsp</code></li> - <li><code>support\rotatelogs.dsp</code></li> - </ol> + </ul> <p>Once Apache has been compiled, it needs to be installed in its server root directory. The default is the @@ -212,7 +189,6 @@ <li><code>nmake /f Makefile.win installr INSTDIR=<em>c:\ServerRoot</em></code> (for release build)</li> - <li><code>nmake /f Makefile.win installd INSTDIR=<em>c:\ServerRoot</em></code> (for debug build)</li> </ul> @@ -226,49 +202,34 @@ <ul> <li><code><em>c:\ServerRoot</em>\Apache.exe</code> - Apache program</li> - <li><code><em>c:\ServerRoot</em>\ApacheCore.dll</code> - Apache runtime [shared library]</li> - <li><code><em>c:\ServerRoot</em>\Win9xConHook.dll</code> - Win9x console fixups [shared library]</li> - <li><code><em>c:\ServerRoot</em>\xmlparse.dll</code> - XML parser [shared library]</li> - <li><code><em>c:\ServerRoot</em>\xmltok.dll</code> - XML token engine [shared library]</li> - <li><code><em>c:\ServerRoot</em>\bin\*.exe</code> - Administration programs</li> - <li><code><em>c:\ServerRoot</em>\cgi-bin</code> - Example CGI scripts</li> - <li><code><em>c:\ServerRoot</em>\conf</code> - Configuration files directory</li> - <li><code><em>c:\ServerRoot</em>\icons</code> - Icons for FancyIndexing</li> - <li><code><em>c:\ServerRoot</em>\include\*.h</code> - Apache header files</li> - <li><code><em>c:\ServerRoot</em>\htdocs</code> - Welcome index.html pages</li> - <li><code><em>c:\ServerRoot</em>\htdocs\manual</code> - Apache documentation</li> - <li><code><em>c:\ServerRoot</em>\lib</code> - Static library files</li> - <li><code><em>c:\ServerRoot</em>\libexec</code> - Dynamic link libraries</li> - <li><code><em>c:\ServerRoot</em>\logs</code> - Empty logging directory</li> - <li><code><em>c:\ServerRoot</em>\modules\mod_*.dll</code> - Loadable Apache modules</li> </ul> 1.9 +34 -10 httpd-docs-1.3/htdocs/manual/win_service.html.en Index: win_service.html.en =================================================================== RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/win_service.html.en,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- win_service.html.en 2001/10/02 11:02:58 1.8 +++ win_service.html.en 2001/10/04 03:30:07 1.9 @@ -16,7 +16,7 @@ <h1 align="CENTER">Running Apache for Windows as a Service</h1> <p>Apache can be run as a service on Windows NT/2000. (There is - also some HIGHLY EXPERIMENTAL support for similar behavior on + also some experimental support for similar behavior on <a href="#win95svc">Windows 95/98</a>, introduced with Apache 1.3.13).</p> @@ -36,16 +36,17 @@ problems running a version of Apache prior to 1.3.13 to resolve the issue. If you have this problem with version 1.3.13 or greater, first try uninstalling (-u) and re-installing (-i) the - Apache service.</p> + Apache service. Better yet, upgrade to the most recent version.</p> <hr /> <p>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 service named "Apache", run the "Install Apache as - Service (NT only)" option from the Start menu. Once this is - done you can start the "Apache" service by opening the Services - window (in the Control Panel), selecting Apache, then clicking + Apache service named "Apache", choose the "Install as Service for + All Users" option when launching the Apache installation package. + Once this is done you can start the "Apache" service by opening + the Services window (in the Control Panel, hidden in "Administrative + Tools" on Windows 2000), selecting Apache, then clicking on Start. Apache will now be running, hidden in the background. You can later stop Apache by clicking on Stop. As an alternative to using the Services window, you can start and @@ -63,7 +64,7 @@ logs most errors to its 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 + Apache attempts to start are captured in the Application Event Log.</strong></p> <p>After starting Apache as a service (or if you have trouble @@ -83,7 +84,8 @@ <p><strong>Note: The -n option to specify a service name is only available with Apache 1.3.7 and later.</strong> Earlier versions of Apache only support the default service name - 'Apache'.</p> + 'Apache'. Only version 1.3.21 supports Windows 2000 ability + to 'rename' the display name of a service.</p> <p>You can install Apache as a Windows NT service as follows:</p> @@ -176,6 +178,28 @@ DependOnService value, double click that value if it already exists, and add the Rpcss entry to the list.</p> + <p>Other installations may require additional dependencies. + If any files required at startup reside on a network drive, you + may need to first configure the service to depend on the network + redirector (usually lanmanworkstation) and follow the directions + below under the "User Account for Apache Service to Run As" section.</p> + + <p>Attempting to use both IIS and Apache, on the same port but on + two different IP addresses may require the W3SVC (IIS) to start prior + to Apache, because IIS tries to glom onto all IP addresses (0.0.0.0) + as it starts, and will fail if Apache has already started on a + specific IP address.</p> + + <p>Apache 1.3.21 introduces a MUCH simpler way to add a dependency. + The -W "servicename" argument modifies the -k install or -k config + commands to configure a dependency for Apache. Multiple -W arguments + may be given, but they should all occur after the -k option. + For example, to add the LanmanWorkstation dependency to an installed + "Apache" service, use this command:</p> +<pre> + apache -k config -n Apache -W LanmanWorkstation +</pre> + <h2>User Account for Apache Service to Run As (NT/2000)</h2> <p>When Apache is first installed as a service (e.g. with the @@ -354,7 +378,7 @@ command. If options are required, use one of the other two methods instead.</p> - <h2><a id="win95svc" name="win95svc">HIGHLY EXPERIMENTAL + <h2><a id="win95svc" name="win95svc">Experimental Windows 95/98 Service</a></h2> <p><strong>Note: The service options for Windows 95 and 98 are @@ -364,7 +388,7 @@ <p>There is some support for Apache on Windows 95/98 to behave in a similar manner as a service on Windows NT/2000. It is - <em>highly experimental</em>, if it works (at all) the Apache + <em>experimental</em>, if it works (at all) the Apache Software Foundation will not attest to its reliability or future support. Proceed at your own risk!</p> 1.54 +17 -13 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.53 retrieving revision 1.54 diff -u -r1.53 -r1.54 --- windows.html 2001/10/02 11:02:58 1.53 +++ windows.html 2001/10/04 03:30:07 1.54 @@ -100,10 +100,10 @@ <p>If running on NT 4.0, installing Service Pack 3 or 6 is recommended, as Service Pack 4 created known issues with - TCPIP/WinSock integrity that were resolved in later Service - Packs.</p> + TCP/IP and WinSock integrity that were resolved in Service + Pack 5 and later.</p> - <p><strong>Note: "Winsock 2" is required for Apache 1.3.7 and + <p><strong>Note: "Winsock2" is required for Apache 1.3.7 and later.</strong></p> <p>If running on Windows 95, the "Winsock2" upgrade must be @@ -115,14 +115,16 @@ Be warned that the Dialup Networking 1.2 (MS DUN) updates include a Winsock2 that is entirely insufficient, and the Winsock2 update must be reinstalled after installing Windows 95 - dialup networking.</p> + dialup networking. Windows 98, NT (Service Pack 3 or later) and + 2000 users need to take no special action, those versions provide + Winsock2 as distributed.</p> <h2><a id="down" name="down">Downloading Apache for Windows</a></h2> <p>Information on the latest version of Apache can be found on the Apache web server at <a - href="http://httpd.apache.org/">http://www.apache.org/httpd</a>. + href="http://httpd.apache.org/">http://httpd.apache.org/</a>. This will list the current release, any more recent alpha or beta-test releases, together with details of mirror web and anonymous FTP sites.</p> @@ -138,18 +140,20 @@ distributions. Windows 2000 and Windows ME are both delivered with the Microsoft Installer support, others will need to download it. Instructions on locating the Microsoft Installer, - as well as the binary distributions of Apache, are found at <a - href="http://httpd.apache.org/dist/httpd/binaries/win32/">http://httpd.apache.org/dist/httpd/binaries/win32/</a></p> + as well as the binary distributions of Apache, are found at + <a href="http://httpd.apache.org/dist/httpd/binaries/win32/" + >http://httpd.apache.org/dist/httpd/binaries/win32/</a></p> <p>The source code is available in the <code>-src.msi</code> - distribution, or from the <a - href="http://httpd.apache.org/dist/httpd/">http://httpd.apache.org/dist/httpd/</a> + distribution, or from the + <a href="http://httpd.apache.org/dist/httpd/" + >http://httpd.apache.org/dist/httpd/</a> distribution directory as a <code>.zip</code> file. If you plan on compiling Apache yourself, there is no need to install either <code>.msi</code> package. The <code>.zip</code> file contains only source code, with MS-DOS line endings (that is cr/lf line endings, instead of the single lf used for Unix - files.)</p> + files distributed in .tar.gz or .tar.Z archives.)</p> <p>While the source is also available as a <samp>.tar.gz</samp> <samp>.tar.Z</samp> archive, these contain unix lf line endings @@ -222,11 +226,11 @@ start really using Apache. However to get started quickly the files should work as installed.</p> - <p>If you eventually uninstall Apache, your configuration files - will not be removed. You will need to delete the installation + <p>If you eventually uninstall Apache, your configuration and log + files will not be removed. You will need to delete the installation directory tree ("C:\Program Files\Apache Group" by default) yourself if you do not care to keep your configuration and - other web files. Since the httpd.conf file is a your + other web files. Since the httpd.conf file is your accumulated effort in using Apache, you need to take the effort to remove it. The same happens for all other files you may have created, as well as any log files Apache created.</p>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]