|
|
<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.75.2"><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" title="Chapter 12. Samba WINS Internals"><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#id332165">WINS Failover</a></span></dt></dl></div><div class="sect1" title="WINS Failover"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id332165"></a>WINS Failover</h2></div></div></div><p>
|
|
|
The current Samba codebase possesses the capability to use groups of WINS
|
|
|
servers that share a common namespace for NetBIOS name registration and
|
|
|
resolution. The formal parameter syntax is
|
|
|
</p><pre class="programlisting">
|
|
|
WINS_SERVER_PARAM = SERVER [ SEPARATOR SERVER_LIST ]
|
|
|
WINS_SERVER_PARAM = "wins server"
|
|
|
SERVER = ADDR[:TAG]
|
|
|
ADDR = ip_addr | fqdn
|
|
|
TAG = string
|
|
|
SEPARATOR = comma | \s+
|
|
|
SERVER_LIST = SERVER [ SEPARATOR SERVER_LIST ]
|
|
|
</pre><p>
|
|
|
A simple example of a valid wins server setting is
|
|
|
</p><pre class="programlisting">
|
|
|
[global]
|
|
|
wins server = 192.168.1.2 192.168.1.3
|
|
|
</pre><p>
|
|
|
In the event that no TAG is defined in for a SERVER in the list, smbd assigns a default
|
|
|
TAG of "*". A TAG is used to group servers of a shared NetBIOS namespace together. Upon
|
|
|
startup, nmbd will attempt to register the netbios name value with one server in each
|
|
|
tagged group.
|
|
|
</p><p>
|
|
|
An example using tags to group WINS servers together is show here. Note that the use of
|
|
|
interface names in the tags is only by convention and is not a technical requirement.
|
|
|
</p><pre class="programlisting">
|
|
|
[global]
|
|
|
wins server = 192.168.1.2:eth0 192.168.1.3:eth0 192.168.2.2:eth1
|
|
|
</pre><p>
|
|
|
Using this configuration, nmbd would attempt to register the server's NetBIOS name
|
|
|
with one WINS server in each group. Because the "eth0" group has two servers, the
|
|
|
second server would only be used when a registration (or resolution) request to
|
|
|
the first server in that group timed out.
|
|
|
</p><p>
|
|
|
NetBIOS name resolution follows a similar pattern as name registration. When resolving
|
|
|
a NetBIOS name via WINS, smbd and other Samba programs will attempt to query a single WINS
|
|
|
server in a tagged group until either a positive response is obtained at least once or
|
|
|
until a server from every tagged group has responded negatively to the name query request.
|
|
|
If a timeout occurs when querying a specific WINS server, that server is marked as down to
|
|
|
prevent further timeouts and the next server in the WINS group is contacted. Once marked as
|
|
|
dead, Samba will not attempt to contact that server for name registration/resolution queries
|
|
|
for a period of 10 minutes.
|
|
|
</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>
|