diff options
Diffstat (limited to 'docs/Samba3-HOWTO/TOSHARG-msdfs.xml')
-rw-r--r-- | docs/Samba3-HOWTO/TOSHARG-msdfs.xml | 89 |
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->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->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> |