From c3c1991a8dd7e0def487e449d269950707141976 Mon Sep 17 00:00:00 2001 From: John Terpstra Date: Thu, 23 Jun 2005 22:42:21 +0000 Subject: Update. (This used to be commit b9723ad0367bae2064a147f42730bc3efd0688ac) --- docs/Samba3-HOWTO/TOSHARG-msdfs.xml | 89 ++++++++++++++++++++++--------------- 1 file changed, 52 insertions(+), 37 deletions(-) (limited to 'docs/Samba3-HOWTO/TOSHARG-msdfs.xml') 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 @@ Features and Benefits +distributed file systemDFS +physical locations +higher availability +load balancing +logical directories 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 @@ - For information about DFS, refer to the -Microsoft documentation. - This document explains how to host a DFS tree on a UNIX machine (for DFS-aware - clients to browse) using Samba. +DFS +DFS tree +DFS-aware + For information about DFS, refer to the Microsoft + documentation. This document explains how to host a DFS tree on a UNIX machine (for DFS-aware clients + to browse) using Samba. - A Samba server can be made a DFS server by setting the global - Boolean - parameter in the &smb.conf; file. You designate a share as a DFS - root using the share-level Boolean 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 - junction->msdfs:storage1\share1 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, \\storage1\share1). +DFS server +share-level +DFS junction +DFS-aware + A Samba server can be made a DFS server by setting the global Boolean + parameter in the &smb.conf; file. You designate a share as a DFS root using the share-level Boolean + 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 + junction->msdfs:storage1\share1 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, \\storage1\share1). +DFS-aware +DFS tree +DFS links +DFS DFS trees on Samba work with all DFS-aware clients ranging from Windows 95 to 200x. The following sample configuration shows how to setup a DFS tree on a Samba server. In the /export/dfsroot directory, you set up your DFS links to @@ -74,18 +89,24 @@ - 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. - - Users on DFS-aware clients can now browse the DFS tree - on the Samba server at \\samba\dfs. Accessing - links linka or linkb (which appear as directories to the client) - takes users directly to the appropriate shares on the network. + +DFS root +msdfs links +symbolic links + 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. + + + +DFS-aware clients +DFS tree + Users on DFS-aware clients can now browse the DFS tree on the Samba server at + \\samba\dfs. Accessing links linka or linkb (which appear as directories to the client) + takes users directly to the appropriate shares on the network. + + @@ -127,29 +148,23 @@ For example, I had a share defined as such: - + + + /export/home/Shares/public_share + yes + + and I could not make my Windows 9x/Me (with the dfs client installed) follow this symlink: - [pub] - path = /export/home/Shares/public_share - msdfs root = yes - - - and I could not make my Windows 9x/Me (with the dfs client installed) - follow this symlink: - - - damage1 -> msdfs:damage\test-share + damage1 -> msdfs:damage\test-share Running a debug level of 10 reveals: - [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. - Curious. So I changed the directory name from .../Shares/... to .../shares/... (along with my service definition) and it worked! -- cgit