source4/msdfs/README

   1 Setting up MS Dfs in Samba
   2 kalele@veritas.com March 2000
   3
   4 Currently, MS Dfs support is a configure time parameter (--with-msdfs). Can be changed later to always compile it in..
   5
   6 To have a server announce itself as a Dfs server, add a "host msdfs=yes" entry to smb.conf.
   7
   8 To make a share a Dfs root, add a "msdfs root=yes" entry to the share definition
   9 in the smb.conf file.
  10 e.g.
  11 [pub]
  12         path = /export/publicsmb
  13         msdfs root = yes
  14
  15 To create dfs volumes/junctions in the share, create symbolic links of the
  16 format msdfs:server1\share1,server2\share2 and so on.
  17
  18 In the above example, create a dfs volume "dfsstorage" in the [pub] share as:
  19 cd /export/publicsmb
  20 ln -s msdfs:serverA\\share dfsstorage
  21
  22 Clicking on dfsstorage from a dfs-aware client will show you the contents of
  23 \\serverA\share
  24
  25 Shares with "msdfs root = no" (which is the default) entries are served as normal
  26 shares and the client stops talking Dfs with Samba after a tconX.
  27
  28 NOTES:
  29 * Windows clients need to be rebooted if a non-dfs root is made a dfs root or
  30   vice versa. A better option is to introduce a new share and make it the dfs root.
  31 * Currently there's a restriction that msdfs symlink names should be all
  32   lowercase.