diff options
Diffstat (limited to 'docs/manual/platform/windows.html.en')
| -rw-r--r-- | docs/manual/platform/windows.html.en | 664 |
1 files changed, 664 insertions, 0 deletions
diff --git a/docs/manual/platform/windows.html.en b/docs/manual/platform/windows.html.en new file mode 100644 index 0000000..5f0ef46 --- /dev/null +++ b/docs/manual/platform/windows.html.en @@ -0,0 +1,664 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Using Apache HTTP Server on Microsoft Windows - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Using Apache HTTP Server on Microsoft Windows</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/windows.html" title="English"> en </a> | +<a href="../fr/platform/windows.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + <p>This document explains how to install, configure and run + Apache 2.4 under Microsoft Windows. If you have questions after + reviewing the documentation (and any event and error logs), you + should consult the peer-supported + <a href="http://httpd.apache.org/userslist.html">users' mailing + list</a>.</p> + + <p>This document assumes that you are installing a binary + distribution of Apache. If you want to compile Apache yourself + (possibly to help with development or tracking down bugs), + see <a href="win_compiling.html">Compiling Apache for Microsoft + Windows</a>.</p> + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">Operating System Requirements</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#down">Downloading Apache for Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cust">Customizing Apache for Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#winsvc">Running Apache as a Service</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#wincons">Running Apache as a Console Application</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#test">Testing the Installation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#windrivemap">Configuring Access to Network Resources</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#tuning">Windows Tuning</a></li> +</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="req" id="req">Operating System Requirements</a></h2> + + + <p>The primary Windows platform for running Apache 2.4 is Windows + 2000 or later. Always obtain and + install the current service pack to avoid operating system bugs.</p> + + <div class="note">Apache HTTP Server versions later than 2.2 will not run on any + operating system earlier than Windows 2000.</div> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="down" id="down">Downloading Apache for Windows</a></h2> + + + <p>The Apache HTTP Server Project itself does not provide binary releases of + software, only source code. Individual committers <em>may</em> provide + binary packages as a convenience, but it is not a release deliverable.</p> + <p>If you cannot compile the Apache HTTP Server + yourself, you can obtain a binary package from numerous binary distributions + available on the Internet.</p> + + <p>Popular options for deploying Apache httpd, and, optionally, PHP + and MySQL, on Microsoft Windows, include:</p> + <ul> + <li><a href="http://www.apachehaus.com/cgi-bin/download.plx">ApacheHaus</a></li> + <li><a href="http://www.apachelounge.com/download/">Apache Lounge</a></li> + <li><a href="http://bitnami.com/stack/wamp">Bitnami WAMP Stack</a></li> + <li><a href="http://www.wampserver.com/">WampServer</a></li> + <li><a href="http://www.apachefriends.org/en/xampp.html">XAMPP</a></li> + </ul> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cust" id="cust">Customizing Apache for Windows</a></h2> + + + <p>Apache is configured by the files in the <code>conf</code> + subdirectory. These are the same files used to configure the Unix + version, but there are a few different directives for Apache on + Windows. See the <a href="../mod/directives.html">directive index</a> + for all the available directives.</p> + + <p>The main differences in Apache for Windows are:</p> + <ul> + <li><p>Because Apache for Windows is multithreaded, it does not + use a separate process for each request, as Apache can on Unix. + Instead there are usually only two Apache processes running: a + parent process, and a child which handles the requests. Within + the child process each request is handled by a separate thread. + </p> + + <p>The process management directives are also different:</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>: + Like the Unix directive, this controls how many connections a single + child process will serve before exiting. + However, unlike on Unix, a replacement process is not instantly + available. Use the default <code>MaxConnectionsPerChild 0</code>, + unless instructed to change the behavior to overcome a memory leak + in third party modules or in-process applications.</p> + + <div class="warning"><strong>Warning: The server configuration + file is reread when a new child process is started. If you have + modified <code>httpd.conf</code>, the new child may not start or + you may receive unexpected results.</strong></div> + + <p><code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>: + This directive is new. It tells the server how many threads it + should use. This is the maximum number of connections the server + can handle at once, so be sure to set this number high enough for + your site if you get a lot of hits. The recommended default is + <code>ThreadsPerChild 150</code>, but this must be adjusted to + reflect the greatest anticipated number of simultaneous + connections to accept.</p></li> + + <li><p>The directives that accept filenames as arguments must use + Windows filenames instead of Unix ones. However, because Apache + may interpret backslashes as an "escape character" sequence, you + should consistently use forward slashes in path names, not + backslashes.</p></li> + + <li><p>While filenames are generally case-insensitive on + Windows, URLs are still treated internally as case-sensitive + before they are mapped to the filesystem. For example, the + <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, + <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, and <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> directives all use + case-sensitive arguments. For this reason, it is particularly + important to use the <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> directive when attempting + to limit access to content in the filesystem, since this + directive applies to any content in a directory, regardless of + how it is accessed. If you wish to assure that only lowercase + is used in URLs, you can use something like:</p> + + <pre class="prettyprint lang-config">RewriteEngine On +RewriteMap lowercase int:tolower +RewriteCond "%{REQUEST_URI}" "[A-Z]" +RewriteRule "(.*)" "${lowercase:$1}" [R,L]</pre> +</li> + + <li><p>When running, Apache needs write access only to the logs + directory and any configured cache directory tree. Due to the + issue of case insensitive and short 8.3 format names, Apache must + validate all path names given. This means that each directory + which Apache evaluates, from the drive root up to the directory + leaf, must have read, list and traverse directory permissions. + If Apache2.4 is installed at C:\Program Files, then the root + directory, Program Files and Apache2.4 must all be visible + to Apache.</p></li> + + <li><p>Apache for Windows contains the ability to load modules at + runtime, without recompiling the server. If Apache is compiled + normally, it will install a number of optional modules in the + <code>\Apache2.4\modules</code> directory. To activate these or + other modules, the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> + directive must be used. For example, to activate the status + module, use the following (in addition to the status-activating + directives in <code>access.conf</code>):</p> + + <pre class="prettyprint lang-config">LoadModule status_module "modules/mod_status.so"</pre> + + + <p>Information on <a href="../mod/mod_so.html#creating">creating + loadable modules</a> is also available.</p></li> + + <li><p>Apache can also load ISAPI (Internet Server Application + Programming Interface) extensions such as those used by Microsoft + IIS and other Windows servers. <a href="../mod/mod_isapi.html">More + information is available</a>. Note that Apache <strong>cannot</strong> + load ISAPI Filters, and ISAPI Handlers with some Microsoft feature + extensions will not work.</p></li> + + <li><p>When running CGI scripts, the method Apache uses to find + the interpreter for the script is configurable using the + <code class="directive"><a href="../mod/core.html#scriptinterpretersource">ScriptInterpreterSource</a></code> + directive.</p></li> + + <li><p>Since it is often difficult to manage files with names + like <code>.htaccess</code> in Windows, you may find it useful to + change the name of this per-directory configuration file using + the <code class="directive"><a href="../mod/core.html#accessfilename">AccessFilename</a></code> + directive.</p></li> + + <li><p>Any errors during Apache startup are logged into the + Windows event log when running on Windows NT. This mechanism + acts as a backup for those situations where Apache is not yet + prepared to use the <code>error.log</code> file. You can + review the Windows Application Event Log by using the Event Viewer, + e.g. Start - Settings - Control Panel - Administrative Tools + - Event Viewer.</p></li> + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="winsvc" id="winsvc">Running Apache as a Service</a></h2> + + + <p>Apache comes with a utility called the Apache Service Monitor. + With it you can see and manage the state of all installed Apache + services on any machine on your network. To be able to manage an + Apache service with the monitor, you have to first install the + service (either automatically via the installation or manually). + </p> + + <p>You can install Apache as a Windows NT service as follows from + the command prompt at the Apache <code>bin</code> subdirectory:</p> + + <div class="example"><p><code> + httpd.exe -k install + </code></p></div> + + <p>If you need to specify the name of the service you want to + install, use the following command. You have to do this if you + have several different service installations of Apache on your + computer. If you specify a name during the install, you have to + also specify it during any other -k operation.</p> + + <div class="example"><p><code> + httpd.exe -k install -n "MyServiceName" + </code></p></div> + + <p>If you need to have specifically named configuration files for + different services, you must use this:</p> + + <div class="example"><p><code> + httpd.exe -k install -n "MyServiceName" -f "c:\files\my.conf" + </code></p></div> + + <p>If you use the first command without any special parameters except + <code>-k install</code>, the service will be called <code>Apache2.4</code> + and the configuration will be assumed to be <code>conf\httpd.conf</code>. + </p> + + <p>Removing an Apache service is easy. Just use:</p> + + <div class="example"><p><code> + httpd.exe -k uninstall + </code></p></div> + + <p>The specific Apache service to be uninstalled can be specified by using:</p> + + <div class="example"><p><code> + httpd.exe -k uninstall -n "MyServiceName" + </code></p></div> + + <p>Normal starting, restarting and shutting down of an Apache + service is usually done via the Apache Service Monitor, by using + commands like <code>NET START Apache2.4</code> and <code>NET STOP + Apache2.4</code> or via normal Windows service management. Before + starting Apache as a service by any means, you should test the + service's configuration file by using:</p> + + <div class="example"><p><code> + httpd.exe -n "MyServiceName" -t + </code></p></div> + + <p>You can control an Apache service by its command line switches, + too. To start an installed Apache service you'll use this:</p> + + <div class="example"><p><code> + httpd.exe -k start -n "MyServiceName" + </code></p></div> + + <p>To stop an Apache service via the command line switches, use + this:</p> + + <div class="example"><p><code> + httpd.exe -k stop -n "MyServiceName" + </code></p></div> + + <p>or</p> + + <div class="example"><p><code> + httpd.exe -k shutdown -n "MyServiceName" + </code></p></div> + + <p>You can also restart a running service and force it to reread + its configuration file by using:</p> + + <div class="example"><p><code> + httpd.exe -k restart -n "MyServiceName" + </code></p></div> + + <p>By default, all Apache services are registered to run as the + system user (the <code>LocalSystem</code> account). The + <code>LocalSystem</code> account has no privileges to your network + via any Windows-secured mechanism, including the file system, named + pipes, DCOM, or secure RPC. It has, however, wide privileges locally. + </p> + + <div class="warning"><strong>Never grant any network privileges to + the <code>LocalSystem</code> account! If you need Apache to be able + to access network resources, create a separate account for Apache as + noted below.</strong></div> + + <p>It is recommended that users create a separate account for running + Apache service(s). If you have to access network resources via Apache, + this is required.</p> + + <ol> + <li>Create a normal domain user account, and be sure to + memorize its password.</li> + + <li>Grant the newly-created user a privilege of <code>Log on + as a service</code> and <code>Act as part of the operating + system</code>. On Windows NT 4.0 these privileges are granted via + User Manager for Domains, but on Windows 2000 and XP you probably + want to use Group Policy for propagating these settings. You can + also manually set these via the Local Security Policy MMC snap-in. + </li> + + <li>Confirm that the created account is a member of the Users + group.</li> + + <li>Grant the account read and execute (RX) rights to all document + and script folders (<code>htdocs</code> and <code>cgi-bin</code> + for example).</li> + + <li>Grant the account change (RWXD) rights to the + Apache <code>logs</code> directory.</li> + + <li>Grant the account read and execute (RX) rights to the + <code>httpd.exe</code> binary executable.</li> + </ol> + + <div class="note">It is usually a good practice to grant the user the Apache + service runs as read and execute (RX) access to the whole Apache2.4 + directory, except the <code>logs</code> subdirectory, where the + user has to have at least change (RWXD) rights.</div> + + <p>If you allow the account to log in as a user and as a service, + then you can log on with that account and test that the account has + the privileges to execute the scripts, read the web pages, and that + you can start Apache in a console window. If this works, and you + have followed the steps above, Apache should execute as a service + with no problems.</p> + + <div class="note"><strong>Error code 2186</strong> is a good indication that + you need to review the "Log On As" configuration for the service, + since Apache cannot access a required network resource. Also, pay + close attention to the privileges of the user Apache is + configured to run as.</div> + + <p>When starting Apache as a service you may encounter an error + message from the Windows Service Control Manager. For example, + if you try to start Apache by using the Services applet in the + Windows Control Panel, you may get the following message:</p> + + <div class="example"><p><code> + Could not start the Apache2.4 service on \\COMPUTER <br /> + Error 1067; The process terminated unexpectedly. + </code></p></div> + + <p>You will get this generic error if there is any problem with + starting the Apache service. In order to see what is really causing + the problem you should follow the instructions for Running Apache + for Windows from the Command Prompt.</p> + + <p>If you are having problems with the service, it is suggested + you follow the instructions below to try starting httpd.exe from + a console window, and work out the errors before struggling to + start it as a service again.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="wincons" id="wincons">Running Apache as a Console Application</a></h2> + + + <p>Running Apache as a service is usually the recommended way to + use it, but it is sometimes easier to work from the command line, + especially during initial configuration and testing.</p> + + <p>To run Apache from the command line as a console application, + use the following command:</p> + + <div class="example"><p><code> + httpd.exe + </code></p></div> + + <p>Apache will execute, and will remain running until it is stopped + by pressing Control-C.</p> + + <p>You can also run Apache via the shortcut Start Apache in Console + placed to <code>Start Menu --> Programs --> Apache HTTP Server + 2.4.xx --> Control Apache Server</code> during the installation. + This will open a console window and start Apache inside it. If you + don't have Apache installed as a service, the window will remain + visible until you stop Apache by pressing Control-C in the console + window where Apache is running in. The server will exit in a few + seconds. However, if you do have Apache installed as a service, the + shortcut starts the service. If the Apache service is running + already, the shortcut doesn't do anything.</p> + + <p>If Apache is running as a service, you can tell it to stop by opening another console + window and entering:</p> + + <div class="example"><p><code> + httpd.exe -k shutdown + </code></p></div> + + <p>Running as a service should be preferred over running in a + console window because this lets Apache end any current operations + and clean up gracefully.</p> + + <p>But if the server is running in a console window, you can + only stop it by pressing Control-C in the same window.</p> + + <p>You can also tell Apache to restart. This forces it to reread + the configuration file. Any operations in progress are allowed to + complete without interruption. To restart Apache, either press + Control-Break in the console window you used for starting Apache, + or enter</p> + + <div class="example"><p><code> + httpd.exe -k restart + </code></p></div> + + <p>if the server is running as a service.</p> + + <div class="note">Note for people familiar with the Unix version of Apache: + these commands provide a Windows equivalent to <code>kill -TERM + <em>pid</em></code> and <code>kill -USR1 <em>pid</em></code>. The + command line option used, <code>-k</code>, was chosen as a reminder + of the <code>kill</code> command used on Unix.</div> + + <p>If the Apache console window closes immediately or unexpectedly + after startup, open the Command Prompt from the Start Menu --> + Programs. Change to the folder to which you installed Apache, type + the command <code>httpd.exe</code>, and read the error message. Then + change to the logs folder, and review the <code>error.log</code> + file for configuration mistakes. Assuming httpd was installed into + <code>C:\Program Files\Apache Software Foundation\Apache2.4\</code>, + you can do the following:</p> + + <div class="example"><p><code> + c: <br /> + cd "\Program Files\Apache Software Foundation\Apache2.4\bin" <br /> + httpd.exe + </code></p></div> + + <p>Then wait for Apache to stop, or press Control-C. Then enter the + following:</p> + + <div class="example"><p><code> + cd ..\logs <br /> + more < error.log + </code></p></div> + + <p>When working with Apache it is important to know how it will + find the configuration file. You can specify a configuration file + on the command line in two ways:</p> + + <ul> + <li><p><code>-f</code> specifies an absolute or relative path to + a particular configuration file:</p> + + <div class="example"><p><code> + httpd.exe -f "c:\my server files\anotherconfig.conf" + </code></p></div> + + <p>or</p> + + <div class="example"><p><code> + httpd.exe -f files\anotherconfig.conf + </code></p></div></li> + + <li><p><code>-n</code> specifies the installed Apache service + whose configuration file is to be used:</p> + + <div class="example"><p><code> + httpd.exe -n "MyServiceName" + </code></p></div> + </li> + </ul> + + <p>In both of these cases, the proper + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> should be set in + the configuration file.</p> + + <p>If you don't specify a configuration file with <code>-f</code> + or <code>-n</code>, Apache will use the file name compiled into the + server, such as <code>conf\httpd.conf</code>. This built-in path + is relative to the installation directory. You can verify the compiled + file name from a value labelled as <code>SERVER_CONFIG_FILE</code> when + invoking Apache with the <code>-V</code> switch, like this:</p> + + <div class="example"><p><code> + httpd.exe -V + </code></p></div> + + <p>Apache will then try to determine its <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> by trying the following, in this order:</p> + + <ol> + <li>A <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directive + via the <code>-C</code> command line switch.</li> + + <li>The <code>-d</code> switch on the command line.</li> + + <li>Current working directory.</li> + + <li>A registry entry which was created if you did a binary + installation.</li> + + <li>The server root compiled into the server. This is <code> + /apache</code> by default, you can verify it by using <code> + httpd.exe -V</code> and looking for a value labelled as + <code>HTTPD_ROOT</code>.</li> + </ol> + + <p>If you did not do a binary install, Apache will in some + scenarios complain about the missing registry key. This warning can + be ignored if the server was otherwise able to find its + configuration file.</p> + + <p>The value of this key is the + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directory which + contains the <code>conf</code> subdirectory. When Apache starts it + reads the <code>httpd.conf</code> file from that directory. If + this file contains a <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + directive which contains a different directory from the one + obtained from the registry key above, Apache will forget the + registry key and use the directory from the configuration file. If + you copy the Apache directory or configuration files to a new + location it is vital that you update the + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directive in the + <code>httpd.conf</code> file to reflect the new location.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="test" id="test">Testing the Installation</a></h2> + + + <p>After starting Apache (either in a console window or as a + service) it will be listening on port 80 (unless you changed the + <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive in the + configuration files or installed Apache only for the current user). + To connect to the server and access the default page, launch a + browser and enter this URL:</p> + + <div class="example"><p><code> + http://localhost/ + </code></p></div> + + <p>Apache should respond with a welcome page and you should see + "It Works!". If nothing happens or you get an error, look in the + <code>error.log</code> file in the <code>logs</code> subdirectory. + If your host is not connected to the net, or if you have serious + problems with your DNS (Domain Name Service) configuration, you + may have to use this URL:</p> + + <div class="example"><p><code> + http://127.0.0.1/ + </code></p></div> + + <p>If you happen to be running Apache on an alternate port, you + need to explicitly put that in the URL:</p> + + <div class="example"><p><code> + http://127.0.0.1:8080/ + </code></p></div> + + <p>Once your basic installation is working, you should configure it + properly by editing the files in the <code>conf</code> subdirectory. + Again, if you change the configuration of the Windows NT service + for Apache, first attempt to start it from the command line to + make sure that the service starts with no errors.</p> + + <p>Because Apache <strong>cannot</strong> share the same port with + another TCP/IP application, you may need to stop, uninstall or reconfigure + certain other services before running Apache. These conflicting + services include other WWW servers, some firewall implementations, + and even some client applications (such as Skype) which will use port + 80 to attempt to bypass firewall issues.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="windrivemap" id="windrivemap">Configuring Access to Network Resources</a></h2> + + + <p>Access to files over the network can be specified using two + mechanisms provided by Windows:</p> + + <dl> + <dt>Mapped drive letters</dt> + <dd>e.g., <code>Alias "/images/" "Z:/"</code></dd> + + <dt>UNC paths</dt> + <dd>e.g., <code>Alias "/images/" "//imagehost/www/images/"</code></dd> + </dl> + + <p>Mapped drive letters allow the administrator to maintain the + mapping to a specific machine and path outside of the Apache httpd + configuration. However, these mappings are associated only with + interactive sessions and are not directly available to Apache httpd + when it is started as a service. <strong>Use only UNC paths for + network resources in httpd.conf</strong> so that the resources can + be accessed consistently regardless of how Apache httpd is started. + (Arcane and error prone procedures may work around the restriction + on mapped drive letters, but this is not recommended.)</p> + + <div class="example"><h3>Example DocumentRoot with UNC path</h3><pre class="prettyprint lang-config">DocumentRoot "//dochost/www/html/"</pre> +</div> + + <div class="example"><h3>Example DocumentRoot with IP address in UNC path</h3><pre class="prettyprint lang-config">DocumentRoot "//192.168.1.50/docs/"</pre> +</div> + + <div class="example"><h3>Example Alias and corresponding Directory with UNC path</h3><pre class="prettyprint lang-config">Alias "/images/" "//imagehost/www/images/" + +<Directory "//imagehost/www/images/"> +#... +</Directory></pre> +</div> + + <p>When running Apache httpd as a service, you must create a + separate account in order to access network resources, as described + above.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="tuning" id="tuning">Windows Tuning</a></h2> + + <ul> + <li><p>If more than a few dozen piped loggers are used on an operating system + instance, scaling up the "desktop heap" is often necessary. For + more detailed information, refer to the <a href="../logs.html#piped">piped logging</a> documentation.</p></li> + </ul> + </div></div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/windows.html" title="English"> en </a> | +<a href="../fr/platform/windows.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/windows.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file |