| 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.74.0"><link rel="home" 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#id2560674">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="id2560674"></a>WINS Failover</h2></div></div></div><p>
|
|---|
| 2 | The current Samba codebase possesses the capability to use groups of WINS
|
|---|
| 3 | servers that share a common namespace for NetBIOS name registration and
|
|---|
| 4 | resolution. 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>
|
|---|
| 14 | A 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>
|
|---|
| 19 | In the event that no TAG is defined in for a SERVER in the list, smbd assigns a default
|
|---|
| 20 | TAG of "*". A TAG is used to group servers of a shared NetBIOS namespace together. Upon
|
|---|
| 21 | startup, nmbd will attempt to register the netbios name value with one server in each
|
|---|
| 22 | tagged group.
|
|---|
| 23 | </p><p>
|
|---|
| 24 | An example using tags to group WINS servers together is show here. Note that the use of
|
|---|
| 25 | interface 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>
|
|---|
| 30 | Using this configuration, nmbd would attempt to register the server's NetBIOS name
|
|---|
| 31 | with one WINS server in each group. Because the "eth0" group has two servers, the
|
|---|
| 32 | second server would only be used when a registration (or resolution) request to
|
|---|
| 33 | the first server in that group timed out.
|
|---|
| 34 | </p><p>
|
|---|
| 35 | NetBIOS name resolution follows a similar pattern as name registration. When resolving
|
|---|
| 36 | a NetBIOS name via WINS, smbd and other Samba programs will attempt to query a single WINS
|
|---|
| 37 | server in a tagged group until either a positive response is obtained at least once or
|
|---|
| 38 | until a server from every tagged group has responded negatively to the name query request.
|
|---|
| 39 | If a timeout occurs when querying a specific WINS server, that server is marked as down to
|
|---|
| 40 | prevent further timeouts and the next server in the WINS group is contacted. Once marked as
|
|---|
| 41 | dead, Samba will not attempt to contact that server for name registration/resolution queries
|
|---|
| 42 | for 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>
|
|---|
