source: trunk/samba-3.0.25pre1/docs/htmldocs/Samba3-Developers-Guide/wins.html @ 1

Last change on this file since 1 was 1, checked in by Paul Smedley, 14 years ago

Initial code import

File size: 4.4 KB
Line 
1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 12. Samba WINS Internals</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="SAMBA Developers Guide"><link rel="up" href="pt03.html" title="Part III. Samba Subsystems"><link rel="prev" href="parsing.html" title="Chapter 11. The smb.conf file"><link rel="next" href="pwencrypt.html" title="Chapter 13. LanMan and NT Password Encryption"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 12. Samba WINS Internals</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="parsing.html">Prev</a> </td><th width="60%" align="center">Part III. Samba Subsystems</th><td width="20%" align="right"> <a accesskey="n" href="pwencrypt.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="wins"></a>Chapter 12. Samba WINS Internals</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Gerald</span> <span class="surname">Carter</span></h3></div></div><div><p class="pubdate">October 2002</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="wins.html#id295771">WINS Failover</a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id295771"></a>WINS Failover</h2></div></div></div><p>
2The current Samba codebase possesses the capability to use groups of WINS
3servers that share a common namespace for NetBIOS name registration and
4resolution.  The formal parameter syntax is
5</p><pre class="programlisting">
6        WINS_SERVER_PARAM       = SERVER [ SEPARATOR SERVER_LIST ]
7        WINS_SERVER_PARAM       = "wins server"
8        SERVER                  = ADDR[:TAG]
9        ADDR                    = ip_addr | fqdn
10        TAG                     = string
11        SEPARATOR               = comma | \s+
12        SERVER_LIST             = SERVER [ SEPARATOR SERVER_LIST ]
13</pre><p>
14A simple example of a valid wins server setting is
15</p><pre class="programlisting">
16[global]
17        wins server = 192.168.1.2 192.168.1.3
18</pre><p>
19In the event that no TAG is defined in for a SERVER in the list, smbd assigns a default
20TAG of "*".  A TAG is used to group servers of a shared NetBIOS namespace together.  Upon
21startup, nmbd will attempt to register the netbios name value with one server in each
22tagged group.
23</p><p>
24An example using tags to group WINS servers together is show here.  Note that the use of
25interface names in the tags is only by convention and is not a technical requirement.
26</p><pre class="programlisting">
27[global]
28        wins server = 192.168.1.2:eth0 192.168.1.3:eth0 192.168.2.2:eth1
29</pre><p>
30Using this configuration, nmbd would attempt to register the server's NetBIOS name
31with one WINS server in each group.  Because the "eth0" group has two servers, the
32second server would only be used when a registration (or resolution) request to
33the first server in that group timed out.
34</p><p>
35NetBIOS name resolution follows a similar pattern as name registration.  When resolving
36a NetBIOS name via WINS, smbd and other Samba programs will attempt to query a single WINS
37server in a tagged group until either a positive response is obtained at least once or
38until a server from every tagged group has responded negatively to the name query request.
39If a timeout occurs when querying a specific WINS server, that server is marked as down to
40prevent further timeouts and the next server in the WINS group is contacted.  Once marked as
41dead, Samba will not attempt to contact that server for name registration/resolution queries
42for a period of 10 minutes.
43</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="parsing.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="pwencrypt.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 11. The smb.conf file </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 13. LanMan and NT Password Encryption</td></tr></table></div></body></html>
Note: See TracBrowser for help on using the repository browser.