From 345ce1f2088badf3dbd32398fa008ab7f5abb036 Mon Sep 17 00:00:00 2001 From: Jeff Trawick Date: Fri, 3 Dec 2010 18:10:10 +0000 Subject: [PATCH] Merge r1041937 from trunk: describe UNC paths vs mapped drive letters git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@1041941 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/platform/windows.xml | 42 ++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/docs/manual/platform/windows.xml b/docs/manual/platform/windows.xml index 7c818bf4d45..9966c565bc6 100644 --- a/docs/manual/platform/windows.xml +++ b/docs/manual/platform/windows.xml @@ -692,4 +692,46 @@ 80 to attempt to bypass firewall issues.

+
+ Configuring Access to Network Resources + +

Access to files over the network can be specified using two + mechanisms provided by Windows:

+ +
+
Mapped drive letters
+
e.g., Alias /images/ Z:/
+ +
UNC paths
+
e.g., Alias /images/ //imagehost/www/images/
+
+ +

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. Use only UNC paths for + network resources in httpd.conf 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.)

+ + Example directives with UNC paths + + DocumentRoot //dochost/www/html/
+
+ DocumentRoot //192.168.1.50/docs/
+
+ Alias /images/ //imagehost/www/images/
+
+ <Directory //imagehost/www/images/>
+ ...
+ <Directory>
+ + +

When running Apache httpd as a service, you must create a + separate account in order to access network resources, as described + above.

+
+ -- 2.47.2