summaryrefslogtreecommitdiff
path: root/docs/docbook/projdoc/msdfs_setup.xml
diff options
context:
space:
mode:
authorGerald Carter <jerry@samba.org>2003-09-09 02:58:53 +0000
committerGerald Carter <jerry@samba.org>2003-09-09 02:58:53 +0000
commit99bde6889d3d8b7a9e950c86c30e82662e1dacdd (patch)
treebb7d34722e3b2b98ae7e36c11f4e7e4d4538b6fb /docs/docbook/projdoc/msdfs_setup.xml
parenta50367ee119d0acf1bcaaf93f8c6fcc8fa68c999 (diff)
downloadsamba-99bde6889d3d8b7a9e950c86c30e82662e1dacdd.tar.gz
samba-99bde6889d3d8b7a9e950c86c30e82662e1dacdd.tar.bz2
samba-99bde6889d3d8b7a9e950c86c30e82662e1dacdd.zip
syncing files from 3.0 into HEAD again
(This used to be commit bca0bba209255d0effbae6a3d3b6d298f0952c3a)
Diffstat (limited to 'docs/docbook/projdoc/msdfs_setup.xml')
-rw-r--r--docs/docbook/projdoc/msdfs_setup.xml54
1 files changed, 26 insertions, 28 deletions
diff --git a/docs/docbook/projdoc/msdfs_setup.xml b/docs/docbook/projdoc/msdfs_setup.xml
index c21c9ec6bf..90259f6a51 100644
--- a/docs/docbook/projdoc/msdfs_setup.xml
+++ b/docs/docbook/projdoc/msdfs_setup.xml
@@ -27,23 +27,21 @@
</para>
<para>
- For information about DFS, refer to
- <ulink url="http://www.microsoft.com/NTServer/nts/downloads/winfeatures/NTSDistrFile/AdminGuide.asp">
- Microsoft documentation at http://www.microsoft.com/NTServer/nts/downloads/winfeatures/NTSDistrFile/AdminGuide.asp</ulink>.
+ For information about DFS, refer to the
+<ulink url="http://www.microsoft.com/NTServer/nts/downloads/winfeatures/NTSDistrFile/AdminGuide.asp">Microsoft documentation</ulink>.
</para>
<para>
- This document explains how to host a DFS tree on a Unix machine (for DFS-aware
+ This document explains how to host a DFS tree on a UNIX machine (for DFS-aware
clients to browse) using Samba.
</para>
<para>
- To enable SMB-based DFS for Samba, configure it with the <parameter>--with-msdfs</parameter>
+ To enable SMB-based DFS for Samba, configure it with the <option>--with-msdfs</option>
option. Once built, a Samba server can be made a DFS server by setting the global
- boolean <ulink url="smb.conf.5.html#HOSTMSDFS"><parameter> host msdfs</parameter></ulink>
- parameter in the <filename>smb.conf </filename> file. You designate a share as a DFS
- root using the share level boolean <ulink url="smb.conf.5.html#MSDFSROOT"><parameter>
- msdfs root</parameter></ulink> parameter. A DFS root directory on Samba hosts DFS
+ boolean <smbconfoption><name>host msdfs</name></smbconfoption>
+ parameter in the &smb.conf; file. You designate a share as a DFS
+ root using the share level boolean <smbconfoption><name>msdfs root</name></smbconfoption> 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,
@@ -58,28 +56,28 @@
Here's an example of setting up a DFS tree on a Samba server.
</para>
- <para><programlisting>
-# The smb.conf file:
-[global]
- netbios name = SMOKEY
- host msdfs = yes
+ <para><smbconfexample>
+ <title>smb.conf with DFS configured</title>
+<smbconfsection>[global]</smbconfsection>
+<smbconfoption><name>netbios name</name><value>&example.server.samba;</value></smbconfoption>
+<smbconfoption><name>host msdfs </name><value>yes</value></smbconfoption>
-[dfs]
- path = /export/dfsroot
- msdfs root = yes
- </programlisting></para>
+<smbconfsection>[dfs]</smbconfsection>
+<smbconfoption><name>path</name><value>/export/dfsroot</value></smbconfoption>
+<smbconfoption><name>msdfs root</name><value>yes</value></smbconfoption>
+ </smbconfexample></para>
- <para>In the /export/dfsroot directory we set up our dfs links to
+ <para>In the /export/dfsroot directory we set up our DFS links to
other servers on the network.</para>
- <screen>
- &rootprompt;<userinput>cd /export/dfsroot</userinput>
- &rootprompt;<userinput>chown root /export/dfsroot</userinput>
- &rootprompt;<userinput>chmod 755 /export/dfsroot</userinput>
- &rootprompt;<userinput>ln -s msdfs:storageA\\shareA linka</userinput>
- &rootprompt;<userinput>ln -s msdfs:serverB\\share,serverC\\share linkb</userinput>
- </screen>
+<screen>
+&rootprompt;<userinput>cd /export/dfsroot</userinput>
+&rootprompt;<userinput>chown root /export/dfsroot</userinput>
+&rootprompt;<userinput>chmod 755 /export/dfsroot</userinput>
+&rootprompt;<userinput>ln -s msdfs:storageA\\shareA linka</userinput>
+&rootprompt;<userinput>ln -s msdfs:serverB\\share,serverC\\share linkb</userinput>
+</screen>
<para>You should set up the permissions and ownership of
the directory acting as the DFS root such that only designated
@@ -99,9 +97,9 @@
<title>Common Errors</title>
<itemizedlist>
<listitem><para>Windows clients need to be rebooted
- if a previously mounted non-dfs share is made a dfs
+ if a previously mounted non-dfs share is made a DFS
root or vice versa. A better way is to introduce a
- new share and make it the dfs root.</para>
+ new share and make it the DFS root.</para>
</listitem>
<listitem><para>Currently there's a restriction that msdfs