You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by wr...@apache.org on 2001/10/04 05:30:07 UTC
cvs commit: httpd-docs-1.3/htdocs/manual win_compiling.html win_service.html.en windows.html
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>