windows.xml revision 562571db843e5415fcdaae07f4b0ccfbac1ec763
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
9eb6a481980d81a55898ba418fba72fc3c09d8c8Dominik Luecke<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke<!-- $LastChangedRevision$ -->
2eeec5240b424984e3ee26296da1eeab6c6d739eChristian Maeder Licensed to the Apache Software Foundation (ASF) under one or more
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke contributor license agreements. See the NOTICE file distributed with
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke this work for additional information regarding copyright ownership.
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke The ASF licenses this file to You under the Apache License, Version 2.0
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke (the "License"); you may not use this file except in compliance with
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder the License. You may obtain a copy of the License at
cf04ba46b9eb495d334466e24e082e391055ca7bDominik Luecke Unless required by applicable law or agreed to in writing, software
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke distributed under the License is distributed on an "AS IS" BASIS,
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
926b3c5491f1c608f5b79e2d8014d7a1385558c3Dominik Luecke See the License for the specific language governing permissions and
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke limitations under the License.
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder <parentdocument href="./">Platform Specific Notes</parentdocument>
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder <title>Using Apache with Microsoft Windows</title>
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder <p>This document explains how to install, configure and run
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder Apache 2.0 under Microsoft Windows. If you find any bugs, or
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder wish to contribute in other ways, please use our <a
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder href="http://httpd.apache.org/bug_report.html">bug reporting
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke <p>This document assumes that you are installing a binary
fcac596b16bb10f475066c323b9b1ca44db2b755Dominik Luecke distribution of Apache. If you want to compile Apache yourself
fcac596b16bb10f475066c323b9b1ca44db2b755Dominik Luecke (possibly to help with development or tracking down bugs),
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke see <a href="win_compiling.html">Compiling Apache for Microsoft
5b9f5c1b3592b99fc74d3438740ebcf9eb4c94beDominik Luecke <p><strong>Because of the current versioning policies on Microsoft
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke Windows operating system families, this document assumes the
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke <li><strong>Windows NT:</strong> This means all versions of
da955132262baab309a50fdffe228c9efe68251dCui Jian Windows that are based on the Windows NT kernel. Includes Windows
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder NT, Windows 2000, Windows XP and Windows .Net Server 2003.</li>
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke <li><strong>Windows 9x:</strong> This means older,
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder consumer-oriented versions of Windows. Includes Windows 95 (also
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder OSR2), Windows 98 and Windows ME.</li>
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke <p>The primary Windows platform for running Apache 2.0 is Windows
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder NT. The binary installer only works with the x86 family of
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke processors, such as Intel and AMD processors. Running Apache on
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke Windows 9x is not thoroughly tested, and it is never recommended on
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke production systems.
548f3850942936a8c6021185c8391dfcd3b03018Dominik Luecke <p>On all operating systems, TCP/IP networking must be installed
548f3850942936a8c6021185c8391dfcd3b03018Dominik Luecke and working. If running on Windows 95, the Winsock 2 upgrade must
0b53895114b00141ec17ffdc7e26acded4487328Christian Maeder be installed. Winsock 2 for Windows 95 can be downloaded from <a
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder href="http://www.microsoft.com/windows95/downloads/contents/WUAdminTools/S_WUNetworkingTools/W95Sockets2/Default.asp">here</a>.
548f3850942936a8c6021185c8391dfcd3b03018Dominik Luecke <p>On Windows NT 4.0, installing Service Pack 6 is strongly
548f3850942936a8c6021185c8391dfcd3b03018Dominik Luecke recommended, as Service Pack 4 created known issues with TCP/IP
548f3850942936a8c6021185c8391dfcd3b03018Dominik Luecke and Winsock integrity that were resolved in later Service Packs.</p>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <title>Downloading Apache for Windows</title>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <p>Information on the latest versions of Apache can be found on the
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder web site of the Apache web server at
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder <a href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</a>.
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke There you will find the current release, as well as more recent alpha
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke or beta test versions, and a list of HTTP and FTP mirrors from which
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke you can download the Apache web server. Please use a mirror near to
a23e572c8f957cc051a1b0831abd6fe9380d45c7Christian Maeder you for a fast and reliable download.</p>
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder <p>For Windows installations you should download the version of
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder Apache for Windows with the <code>.msi</code> extension. This is a
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder single Microsoft Installer file, which contains a ready-to-run
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder version of Apache. There is a separate <code>.zip</code> file,
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder which contains only the source code. You can compile Apache
fcac596b16bb10f475066c323b9b1ca44db2b755Dominik Luecke yourself with the Microsoft Visual C++ (Visual Studio) tools.</p>
b694e4b3f771a2f32042c9c505dd698bde969558Dominik Luecke <p>You need Microsoft Installer 1.2 or above for the installation
5b9f5c1b3592b99fc74d3438740ebcf9eb4c94beDominik Luecke to work. On Windows 9x you can update your Microsoft Installer to
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder version 2.0 <a
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder href="http://www.microsoft.com/downloads/release.asp?ReleaseID=32831">here</a>
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder and on Windows NT 4.0 and 2000 the version 2.0 update can be found
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder <a href="http://www.microsoft.com/downloads/release.asp?ReleaseID=32832">here</a>.
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder Windows XP does not need this update.</p>
2ea0ce749d2525f96d5d2f285f519ab07b005b8dDominik Luecke <p>Note that you cannot install two versions of Apache 2.0 on the
2ea0ce749d2525f96d5d2f285f519ab07b005b8dDominik Luecke same computer with the binary installer. You can, however, install
2ea0ce749d2525f96d5d2f285f519ab07b005b8dDominik Luecke a version of the 1.3 series <strong>and</strong> a version of the
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder 2.0 series on the same computer without problems. If you need to
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder have two different 2.0 versions on the same computer, you have to
2ea0ce749d2525f96d5d2f285f519ab07b005b8dDominik Luecke <a href="win_compiling.html">compile and install Apache from the
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder <p>Run the Apache <code>.msi</code> file you downloaded above. The
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder installation will ask you for these things:</p>
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder <li><p><strong>Network Domain.</strong> Enter the DNS domain in which
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder your server is or will be registered in. For example, if your
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder server's full DNS name is <code>server.mydomain.net</code>, you would
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder type <code>mydomain.net</code> here.</p></li>
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder <li><p><strong>Server Name.</strong> Your server's full DNS name.
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder From the example above, you would type <code>server.mydomain.net</code>
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder <li><p><strong>Administrator's Email Address.</strong> Enter the
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder server administrator's or webmaster's email address here. This
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder address will be displayed along with error messages to the client
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder <li><p><strong>For whom to install Apache</strong> Select <code>for
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder All Users, on Port 80, as a Service - Recommended</code> if you'd
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder like your new Apache to listen at port 80 for incoming traffic.
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder It will run as a service (that is, Apache will run even if no one
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder is logged in on the server at the moment) Select <code>only for
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder the Current User, on Port 8080, when started Manually</code> if
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder you'd like to install Apache for your personal experimenting or
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder if you already have another WWW server running on port 80.</p></li>
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder <li><p><strong>The installation type.</strong> Select <code>Typical</code>
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder for everything except the source code and libraries for module
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder development. With <code>Custom</code> you can specify what to
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder install. A full install will require about 13 megabytes of free
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder disk space. This does <em>not</em> include the size of your web
Programming Interface) extensions (i.e. internet server
httpd -k install -n "MyServiceName" -f "c:\files\my.conf"
such as incorrect entries in the httpd.conf configuration file,
more < error.log
httpd -f "c:\my server files\anotherconfig.conf"
httpd -f files\anotherconfig.conf
httpd.exe -V