summaryrefslogtreecommitdiff
path: root/docs/Samba3-HOWTO/TOSHARG-msdfs.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/Samba3-HOWTO/TOSHARG-msdfs.xml')
-rw-r--r--docs/Samba3-HOWTO/TOSHARG-msdfs.xml89
1 files changed, 52 insertions, 37 deletions
diff --git a/docs/Samba3-HOWTO/TOSHARG-msdfs.xml b/docs/Samba3-HOWTO/TOSHARG-msdfs.xml
index b9dbb84865..528f41d8cb 100644
--- a/docs/Samba3-HOWTO/TOSHARG-msdfs.xml
+++ b/docs/Samba3-HOWTO/TOSHARG-msdfs.xml
@@ -23,6 +23,11 @@
<title>Features and Benefits</title>
<para>
+<indexterm><primary>distributed file system</primary><see>DFS</see></indexterm>
+<indexterm><primary>physical locations</primary></indexterm>
+<indexterm><primary>higher availability</primary></indexterm>
+<indexterm><primary>load balancing</primary></indexterm>
+<indexterm><primary>logical directories</primary></indexterm>
The distributed file system (DFS) provides a means of separating the logical
view of files and directories that users see from the actual physical locations
of these resources on the network. It allows for higher availability, smoother
@@ -30,24 +35,34 @@
</para>
<para>
- For information about DFS, refer to the
-<ulink url="http://www.microsoft.com/NTServer/nts/downloads/winfeatures/NTSDistrFile/AdminGuide.asp">Microsoft documentation</ulink>.
- This document explains how to host a DFS tree on a UNIX machine (for DFS-aware
- clients to browse) using Samba.
+<indexterm><primary>DFS</primary></indexterm>
+<indexterm><primary>DFS tree</primary></indexterm>
+<indexterm><primary>DFS-aware</primary></indexterm>
+ For information about DFS, refer to the <ulink
+ url="http://www.microsoft.com/NTServer/nts/downloads/winfeatures/NTSDistrFile/AdminGuide.asp">Microsoft
+ documentation</ulink>. This document explains how to host a DFS tree on a UNIX machine (for DFS-aware clients
+ to browse) using Samba.
</para>
<para>
- A Samba server can be made a DFS server by setting the global
- Boolean <smbconfoption name="host msdfs"/>
- parameter in the &smb.conf; file. You designate a share as a DFS
- root using the share-level Boolean <smbconfoption name="msdfs root"/> parameter. A DFS root directory on Samba hosts DFS
- links in the form of symbolic links that point to other servers. For example, a symbolic link
- <filename>junction-&gt;msdfs:storage1\share1</filename> in the share directory acts
- as the DFS junction. When DFS-aware clients attempt to access the junction link,
- they are redirected to the storage location (in this case, <parameter>\\storage1\share1</parameter>).
+<indexterm><primary>DFS server</primary></indexterm>
+<indexterm><primary>share-level</primary></indexterm>
+<indexterm><primary>DFS junction</primary></indexterm>
+<indexterm><primary>DFS-aware</primary></indexterm>
+ A Samba server can be made a DFS server by setting the global Boolean <smbconfoption name="host msdfs"/>
+ parameter in the &smb.conf; file. You designate a share as a DFS root using the share-level Boolean
+ <smbconfoption name="msdfs root"/> parameter. A DFS root directory on Samba hosts DFS links in the form of
+ symbolic links that point to other servers. For example, a symbolic link
+ <filename>junction-&gt;msdfs:storage1\share1</filename> in the share directory acts as the DFS junction. When
+ DFS-aware clients attempt to access the junction link, they are redirected to the storage location (in this
+ case, <parameter>\\storage1\share1</parameter>).
</para>
<para>
+<indexterm><primary>DFS-aware</primary></indexterm>
+<indexterm><primary>DFS tree</primary></indexterm>
+<indexterm><primary>DFS links</primary></indexterm>
+<indexterm><primary>DFS</primary></indexterm>
DFS trees on Samba work with all DFS-aware clients ranging from Windows 95 to 200x.
<link linkend="dfscfg">The following sample configuration</link> shows how to setup a DFS tree on a Samba server.
In the <filename>/export/dfsroot</filename> directory, you set up your DFS links to
@@ -74,18 +89,24 @@
</smbconfblock>
</example>
- <para>You should set up the permissions and ownership of
- the directory acting as the DFS root so that only designated
- users can create, delete, or modify the msdfs links. Also note
- that symlink names should be all lowercase. This limitation exists
- to have Samba avoid trying all the case combinations to get at
- the link name. Finally, set up the symbolic links to point to the
- network shares you want and start Samba.</para>
-
- <para>Users on DFS-aware clients can now browse the DFS tree
- on the Samba server at <constant>\\samba\dfs</constant>. Accessing
- links linka or linkb (which appear as directories to the client)
- takes users directly to the appropriate shares on the network.</para>
+ <para>
+<indexterm><primary>DFS root</primary></indexterm>
+<indexterm><primary>msdfs links</primary></indexterm>
+<indexterm><primary>symbolic links</primary></indexterm>
+ You should set up the permissions and ownership of the directory acting as the DFS root so that only
+ designated users can create, delete, or modify the msdfs links. Also note that symlink names should be all
+ lowercase. This limitation exists to have Samba avoid trying all the case combinations to get at the link
+ name. Finally, set up the symbolic links to point to the network shares you want and start Samba.
+ </para>
+
+ <para>
+<indexterm><primary>DFS-aware clients</primary></indexterm>
+<indexterm><primary>DFS tree</primary></indexterm>
+ Users on DFS-aware clients can now browse the DFS tree on the Samba server at
+ <constant>\\samba\dfs</constant>. Accessing links linka or linkb (which appear as directories to the client)
+ takes users directly to the appropriate shares on the network.
+ </para>
+
</sect1>
<sect1>
@@ -127,29 +148,23 @@
<para>
<quote>For example, I had a share defined as such:</quote>
-
+ <smbconfblock>
+ <smbconfsection name="[pub]"/>
+ <smbconfoption name="path">/export/home/Shares/public_share</smbconfoption>
+ <smbconfoption name="msdfs root">yes</smbconfoption>
+ </smbconfblock>
+ <quote>and I could not make my Windows 9x/Me (with the dfs client installed) follow this symlink:</quote>
<screen>
- [pub]
- path = /export/home/Shares/public_share
- msdfs root = yes
- </screen>
-
- <quote>and I could not make my Windows 9x/Me (with the dfs client installed)
- follow this symlink:</quote>
-
- <screen>
- damage1 -> msdfs:damage\test-share
+ damage1 -> msdfs:damage\test-share
</screen>
</para>
<para>
<quote>Running a debug level of 10 reveals:</quote>
-
<programlisting>
[2003/08/20 11:40:33, 5] msdfs/msdfs.c:is_msdfs_link(176)
is_msdfs_link: /export/home/shares/public_share/* does not exist.
</programlisting>
-
<quote>Curious. So I changed the directory name from <constant>.../Shares/...</constant> to
<constant>.../shares/...</constant> (along with my service definition) and it worked!</quote>
</para>