diff options
author | Jelmer Vernooij <jelmer@samba.org> | 2003-03-18 16:48:14 +0000 |
---|---|---|
committer | Jelmer Vernooij <jelmer@samba.org> | 2003-03-18 16:48:14 +0000 |
commit | 20967627378194121bc48bf387838b8bd7682478 (patch) | |
tree | 7f9c31e2688d9c9ccb2d1ab385cad16b290e92d5 /docs/htmldocs/improved-browsing.html | |
parent | 404d5ba54d009f0d86fa28a34ae9f6761443e58c (diff) | |
download | samba-20967627378194121bc48bf387838b8bd7682478.tar.gz samba-20967627378194121bc48bf387838b8bd7682478.tar.bz2 samba-20967627378194121bc48bf387838b8bd7682478.zip |
Regenerate
(This used to be commit 25db62e3101dbcae8e9daee3cb16430297afa223)
Diffstat (limited to 'docs/htmldocs/improved-browsing.html')
-rw-r--r-- | docs/htmldocs/improved-browsing.html | 152 |
1 files changed, 84 insertions, 68 deletions
diff --git a/docs/htmldocs/improved-browsing.html b/docs/htmldocs/improved-browsing.html index b912cb57e5..b58945a0b5 100644 --- a/docs/htmldocs/improved-browsing.html +++ b/docs/htmldocs/improved-browsing.html @@ -5,7 +5,7 @@ >Improved browsing in samba</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.77+"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="SAMBA Project Documentation" HREF="samba-howto-collection.html"><LINK @@ -80,9 +80,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2700" -></A ->15.1. Overview of browsing</H1 +NAME="AEN2603" +>15.1. Overview of browsing</A +></H1 ><P >SMB networking provides a mechanism by which clients can access a list of machines in a network, a so-called "browse list". This list @@ -93,8 +93,13 @@ list is heavily used by all SMB clients. Configuration of SMB browsing has been problematic for some Samba users, hence this document.</P ><P ->Browsing will NOT work if name resolution from NetBIOS names to IP -addresses does not function correctly. Use of a WINS server is highly +>MS Windows 2000 and later, as with Samba-3 and later, can be +configured to not use NetBIOS over TCP/IP. When configured this way +it is imperative that name resolution (using DNS/LDAP/ADS) be correctly +configured and operative. Browsing will NOT work if name resolution +from SMB machine names to IP addresses does not function correctly.</P +><P +>Where NetBIOS over TCP/IP is enabled use of a WINS server is highly recommended to aid the resolution of NetBIOS (SMB) names to IP addresses. WINS allows remote segment clients to obtain NetBIOS name_type information that can NOT be provided by any other means of name resolution.</P @@ -104,16 +109,14 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2704" -></A ->15.2. Browsing support in samba</H1 +NAME="AEN2608" +>15.2. Browsing support in samba</A +></H1 ><P ->Samba now fully supports browsing. The browsing is supported by nmbd -and is also controlled by options in the smb.conf file (see smb.conf(5)).</P -><P ->Samba can act as a local browse master for a workgroup and the ability -for samba to support domain logons and scripts is now available. See -DOMAIN.txt for more information on domain logons.</P +>Samba facilitates browsing. The browsing is supported by nmbd +and is also controlled by options in the smb.conf file (see smb.conf(5)). +Samba can act as a local browse master for a workgroup and the ability +for samba to support domain logons and scripts is now available.</P ><P >Samba can also act as a domain master browser for a workgroup. This means that it will collate lists from local browse masters into a @@ -128,12 +131,12 @@ regardless of whether it is NT, Samba or any other type of domain master that is providing this service.</P ><P >[Note that nmbd can be configured as a WINS server, but it is not -necessary to specifically use samba as your WINS server. NTAS can -be configured as your WINS server. In a mixed NT server and -samba environment on a Wide Area Network, it is recommended that -you use the NT server's WINS server capabilities. In a samba-only -environment, it is recommended that you use one and only one nmbd -as your WINS server].</P +necessary to specifically use samba as your WINS server. MS Windows +NT4, Server or Advanced Server 2000 or 2003 can be configured as +your WINS server. In a mixed NT/2000/2003 server and samba environment on +a Wide Area Network, it is recommended that you use the Microsoft +WINS server capabilities. In a samba-only environment, it is +recommended that you use one and only one Samba server as your WINS server.</P ><P >To get browsing to work you need to run nmbd as usual, but will need to use the "workgroup" option in smb.conf to control what workgroup @@ -149,9 +152,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2713" -></A ->15.3. Problem resolution</H1 +NAME="AEN2616" +>15.3. Problem resolution</A +></H1 ><P >If something doesn't work then hopefully the log.nmb file will help you track down the problem. Try a debug level of 2 or 3 for finding @@ -167,6 +170,19 @@ filemanager should display the list of available shares.</P connection that lists the shares is done as guest, and thus you must have a valid guest account.</P ><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>MS Windows 2000 and upwards (as with Samba) can be configured to disallow +anonymous (ie: Guest account) access to the IPC$ share. In that case, the +MS Windows 2000/XP/2003 machine acting as an SMB/CIFS client will use the +name of the currently logged in user to query the IPC$ share. MS Windows +9X clients are not able to do this and thus will NOT be able to browse +server resources.</I +></SPAN +></P +><P >Also, a lot of people are getting bitten by the problem of too many parameters on the command line of nmbd in inetd.conf. This trick is to not use spaces between the option and the parameter (eg: -d2 instead @@ -183,11 +199,11 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2720" -></A ->15.4. Browsing across subnets</H1 +NAME="AEN2625" +>15.4. Browsing across subnets</A +></H1 ><P ->With the release of Samba 1.9.17(alpha1 and above) Samba has been +>Since the release of Samba 1.9.17(alpha1) Samba has been updated to enable it to support the replication of browse lists across subnet boundaries. New code and options have been added to achieve this. This section describes how to set this feature up @@ -214,15 +230,14 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2725" -></A ->15.4.1. How does cross subnet browsing work ?</H2 +NAME="AEN2630" +>15.4.1. How does cross subnet browsing work ?</A +></H2 ><P >Cross subnet browsing is a complicated dance, containing multiple moving parts. It has taken Microsoft several years to get the code that achieves this correct, and Samba lags behind in some areas. -However, with the 1.9.17 release, Samba is capable of cross subnet -browsing when configured correctly.</P +Samba is capable of cross subnet browsing when configured correctly.</P ><P >Consider a network set up as follows :</P ><P @@ -303,7 +318,7 @@ machine is seen across any of the subnets.</P master browser it looks for a Domain master browser to synchronize its browse list with. It does this by querying the WINS server (N2_D) for the IP address associated with the NetBIOS name -WORKGROUP>1B<. This name was registerd by the Domain master +WORKGROUP>1B<. This name was registerd by the Domain master browser (N1_C) with the WINS server as soon as it was booted.</P ><P >Once N2_B knows the address of the Domain master browser it @@ -426,9 +441,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2760" -></A ->15.5. Setting up a WINS server</H1 +NAME="AEN2665" +>15.5. Setting up a WINS server</A +></H1 ><P >Either a Samba machine or a Windows NT Server machine may be set up as a WINS server. To set a Samba machine to be a WINS server you must @@ -440,9 +455,9 @@ CLASS="COMMAND" > wins support = yes</B ></P ><P ->Versions of Samba previous to 1.9.17 had this parameter default to +>Versions of Samba prior to 1.9.17 had this parameter default to yes. If you have any older versions of Samba on your network it is -strongly suggested you upgrade to 1.9.17 or above, or at the very +strongly suggested you upgrade to a recent version, or at the very least set the parameter to 'no' on all these machines.</P ><P >Machines with "<B @@ -480,10 +495,10 @@ all smb.conf files :</P ><P ><B CLASS="COMMAND" ->wins server = >name or IP address<</B +>wins server = >name or IP address<</B ></P ><P ->where >name or IP address< is either the DNS name of the WINS server +>where >name or IP address< is either the DNS name of the WINS server machine or its IP address.</P ><P >Note that this line MUST NOT BE SET in the smb.conf file of the Samba @@ -494,7 +509,7 @@ CLASS="COMMAND" >" option and the "<B CLASS="COMMAND" ->wins server = >name<</B +>wins server = <name></B >" option then nmbd will fail to start.</P ><P @@ -509,9 +524,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2779" -></A ->15.6. Setting up Browsing in a WORKGROUP</H1 +NAME="AEN2684" +>15.6. Setting up Browsing in a WORKGROUP</A +></H1 ><P >To set up cross subnet browsing on a network containing machines in up to be in a WORKGROUP, not an NT Domain you need to set up one @@ -552,11 +567,12 @@ server, if you require.</P ><P >Next, you should ensure that each of the subnets contains a machine that can act as a local master browser for the -workgroup. Any NT machine should be able to do this, as will -Windows 95 machines (although these tend to get rebooted more -often, so it's not such a good idea to use these). To make a -Samba server a local master browser set the following -options in the [global] section of the smb.conf file :</P +workgroup. Any MS Windows NT/2K/XP/2003 machine should be +able to do this, as will Windows 9x machines (although these +tend to get rebooted more often, so it's not such a good idea +to use these). To make a Samba server a local master browser +set the following options in the [global] section of the +smb.conf file :</P ><P ><PRE CLASS="PROGRAMLISTING" @@ -593,16 +609,16 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2797" -></A ->15.7. Setting up Browsing in a DOMAIN</H1 +NAME="AEN2702" +>15.7. Setting up Browsing in a DOMAIN</A +></H1 ><P >If you are adding Samba servers to a Windows NT Domain then you must not set up a Samba server as a domain master browser. By default, a Windows NT Primary Domain Controller for a Domain name is also the Domain master browser for that name, and many things will break if a Samba server registers the Domain master -browser NetBIOS name (DOMAIN>1B<) with WINS instead of the PDC.</P +browser NetBIOS name (DOMAIN<1B>) with WINS instead of the PDC.</P ><P >For subnets other than the one containing the Windows NT PDC you may set up Samba servers as local master browsers as @@ -644,9 +660,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2807" -></A ->15.8. Forcing samba to be the master</H1 +NAME="AEN2712" +>15.8. Forcing samba to be the master</A +></H1 ><P >Who becomes the "master browser" is determined by an election process using broadcasts. Each election packet contains a number of parameters @@ -659,8 +675,8 @@ option in smb.conf to a higher number. It defaults to 0. Using 34 would make it win all elections over every other system (except other samba systems!)</P ><P ->A "os level" of 2 would make it beat WfWg and Win95, but not NTAS. A -NTAS domain controller uses level 32.</P +>A "os level" of 2 would make it beat WfWg and Win95, but not MS Windows +NT/2K Server. A MS Windows NT/2K Server domain controller uses level 32.</P ><P >The maximum os level is 255</P ><P @@ -692,9 +708,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2816" -></A ->15.9. Making samba the domain master</H1 +NAME="AEN2721" +>15.9. Making samba the domain master</A +></H1 ><P >The domain master is responsible for collating the browse lists of multiple subnets so that browsing can occur between subnets. You can @@ -765,9 +781,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2834" -></A ->15.10. Note about broadcast addresses</H1 +NAME="AEN2739" +>15.10. Note about broadcast addresses</A +></H1 ><P >If your network uses a "0" based broadcast address (for example if it ends in a 0) then you will strike problems. Windows for Workgroups @@ -779,9 +795,9 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2837" -></A ->15.11. Multiple interfaces</H1 +NAME="AEN2742" +>15.11. Multiple interfaces</A +></H1 ><P >Samba now supports machines with multiple network interfaces. If you have multiple interfaces then you will need to use the "interfaces" |