diff options
| author | Jeff Trawick <trawick@apache.org> | 2010-12-03 19:03:08 +0100 |
|---|---|---|
| committer | Jeff Trawick <trawick@apache.org> | 2010-12-03 19:03:08 +0100 |
| commit | 71b0e5bac93ac7bdddb957272cdd0134e4c7b3a2 (patch) | |
| tree | 31a1d540e732be009d6a96597ea3c5d794d2acb7 /docs | |
| parent | Reverted r1040177 due to Joe's objection. (diff) | |
| download | apache2-71b0e5bac93ac7bdddb957272cdd0134e4c7b3a2.tar.xz apache2-71b0e5bac93ac7bdddb957272cdd0134e4c7b3a2.zip | |
describe UNC paths vs mapped drive letters
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1041937 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/manual/platform/windows.xml | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/docs/manual/platform/windows.xml b/docs/manual/platform/windows.xml index 2011d46196..5adb7cbff9 100644 --- a/docs/manual/platform/windows.xml +++ b/docs/manual/platform/windows.xml @@ -757,4 +757,46 @@ 80 to attempt to bypass firewall issues.</p> </section> + <section id="windrivemap"> + <title>Configuring Access to Network Resources</title> + + <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> + + <example><title>Example directives with UNC paths</title> + + DocumentRoot //dochost/www/html/<br /> + <br /> + DocumentRoot //192.168.1.50/docs/<br /> + <br /> + Alias /images/ //imagehost/www/images/<br /> + <br /> + <Directory //imagehost/www/images/><br /> + ...<br /> + <Directory><br /> + </example> + + <p>When running Apache httpd as a service, you must create a + separate account in order to access network resources, as described + above.</p> + </section> + </manualpage> |