Ignore:
Timestamp:
Mar 1, 2010, 3:05:48 PM (15 years ago)
Author:
Herwig Bauernfeind
Message:

Update Samba 3.3.x to 3.3.11

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/samba-3.3.x/docs/htmldocs/Samba3-HOWTO/samba-bdc.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 5. Backup Domain Control</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="The Official Samba 3.3.x HOWTO and Reference Guide"><link rel="up" href="type.html" title="Part II. Server Configuration Basics"><link rel="prev" href="samba-pdc.html" title="Chapter 4. Domain Control"><link rel="next" href="domain-member.html" title="Chapter 6. Domain Membership"></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 5. Backup Domain Control</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="samba-pdc.html">Prev</a> </td><th width="60%" align="center">Part II. Server Configuration Basics</th><td width="20%" align="right"> <a accesskey="n" href="domain-member.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 5. Backup Domain Control"><div class="titlepage"><div><div><h2 class="title"><a name="samba-bdc"></a>Chapter 5. Backup Domain Control</h2></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Volker</span> <span class="surname">Lendecke</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:Volker.Lendecke@SerNet.DE">Volker.Lendecke@SerNet.DE</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Guenther</span> <span class="surname">Deschner</span></h3><span class="contrib">LDAP updates</span> <div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:gd@samba.org">gd@samba.org</a>&gt;</code></p></div></div></div></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="samba-bdc.html#id2571862">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="samba-bdc.html#id2572268">Essential Background Information</a></span></dt><dd><dl><dt><span class="sect2"><a href="samba-bdc.html#id2572337">MS Windows NT4-style Domain Control</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2573025">LDAP Configuration Notes</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2573390">Active Directory Domain Control</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2573448">What Qualifies a Domain Controller on the Network?</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2573539">How Does a Workstation find its Domain Controller?</a></span></dt></dl></dd><dt><span class="sect1"><a href="samba-bdc.html#id2573721">Backup Domain Controller Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="samba-bdc.html#id2574222">Example Configuration</a></span></dt></dl></dd><dt><span class="sect1"><a href="samba-bdc.html#id2574686">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="samba-bdc.html#id2574730">Machine Accounts Keep Expiring</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2574784">Can Samba Be a Backup Domain Controller to an NT4 PDC?</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2574840">How Do I Replicate the smbpasswd File?</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2574945">Can I Do This All with LDAP?</a></span></dt></dl></dd></dl></div><p>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 5. Backup Domain Control</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="The Official Samba 3.3.x HOWTO and Reference Guide"><link rel="up" href="type.html" title="Part II. Server Configuration Basics"><link rel="prev" href="samba-pdc.html" title="Chapter 4. Domain Control"><link rel="next" href="domain-member.html" title="Chapter 6. Domain Membership"></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 5. Backup Domain Control</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="samba-pdc.html">Prev</a> </td><th width="60%" align="center">Part II. Server Configuration Basics</th><td width="20%" align="right"> <a accesskey="n" href="domain-member.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="samba-bdc"></a>Chapter 5. Backup Domain Control</h2></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="orgname">Samba Team</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Volker</span> <span class="orgname">Samba Team</span> <span class="surname">Lendecke</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:Volker.Lendecke@SerNet.DE">Volker.Lendecke@SerNet.DE</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Guenther</span> <span class="orgname">Samba Team</span> <span class="surname">Deschner</span></h3><span class="contrib">LDAP updates</span> <div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:gd@samba.org">gd@samba.org</a>&gt;</code></p></div></div></div></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="samba-bdc.html#id2565776">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="samba-bdc.html#id2566182">Essential Background Information</a></span></dt><dd><dl><dt><span class="sect2"><a href="samba-bdc.html#id2566252">MS Windows NT4-style Domain Control</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2566940">LDAP Configuration Notes</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2567305">Active Directory Domain Control</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2567363">What Qualifies a Domain Controller on the Network?</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2567454">How Does a Workstation find its Domain Controller?</a></span></dt></dl></dd><dt><span class="sect1"><a href="samba-bdc.html#id2567635">Backup Domain Controller Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="samba-bdc.html#id2568136">Example Configuration</a></span></dt></dl></dd><dt><span class="sect1"><a href="samba-bdc.html#id2568600">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="samba-bdc.html#id2568644">Machine Accounts Keep Expiring</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2568699">Can Samba Be a Backup Domain Controller to an NT4 PDC?</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2568754">How Do I Replicate the smbpasswd File?</a></span></dt><dt><span class="sect2"><a href="samba-bdc.html#id2568859">Can I Do This All with LDAP?</a></span></dt></dl></dd></dl></div><p>
    22Before you continue reading this section, please make sure that you are comfortable
    33with configuring a Samba domain controller as described in <a class="link" href="samba-pdc.html" title="Chapter 4. Domain Control">Domain Control</a>.
    4 </p><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2571862"></a>Features and Benefits</h2></div></div></div><p>
     4</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2565776"></a>Features and Benefits</h2></div></div></div><p>
    55This is one of the most difficult chapters to summarize. It does not matter what we say here, for someone will
    66still draw conclusions and/or approach the Samba Team with expectations that are either not yet capable of
     
    99we will do our best to provide a solution.
    1010</p><p>
    11 <a class="indexterm" name="id2571888"></a>
    12 <a class="indexterm" name="id2571897"></a>
    13 <a class="indexterm" name="id2571904"></a>
    14 <a class="indexterm" name="id2571910"></a>
    15 <a class="indexterm" name="id2571919"></a>
     11<a class="indexterm" name="id2565803"></a>
     12<a class="indexterm" name="id2565812"></a>
     13<a class="indexterm" name="id2565818"></a>
     14<a class="indexterm" name="id2565825"></a>
     15<a class="indexterm" name="id2565834"></a>
    1616Samba-3 can act as a Backup Domain Controller (BDC) to another Samba Primary Domain Controller (PDC). A
    1717Samba-3 PDC can operate with an LDAP account backend. The LDAP backend can be either a common master LDAP
     
    2222you will have stability and operational problems.
    2323</p><p>
    24 <a class="indexterm" name="id2571944"></a>
    25 <a class="indexterm" name="id2571953"></a>
    26 <a class="indexterm" name="id2571962"></a>
    27 <a class="indexterm" name="id2571971"></a>
     24<a class="indexterm" name="id2565859"></a>
     25<a class="indexterm" name="id2565867"></a>
     26<a class="indexterm" name="id2565876"></a>
     27<a class="indexterm" name="id2565885"></a>
    2828While it is possible to run a Samba-3 BDC with a non-LDAP backend, that backend must allow some form of
    2929"two-way" propagation of changes from the BDC to the master.  At this time only LDAP delivers the capability
     
    3131is preferable for the PDC to use as its primary an LDAP master server.
    3232</p><p>
    33 <a class="indexterm" name="id2571988"></a>
    34 <a class="indexterm" name="id2571997"></a>
    35 <a class="indexterm" name="id2572006"></a>
    36 <a class="indexterm" name="id2572018"></a>
    37 <a class="indexterm" name="id2572024"></a>
    38 <a class="indexterm" name="id2572031"></a>
    39 <a class="indexterm" name="id2572038"></a>
     33<a class="indexterm" name="id2565902"></a>
     34<a class="indexterm" name="id2565911"></a>
     35<a class="indexterm" name="id2565920"></a>
     36<a class="indexterm" name="id2565932"></a>
     37<a class="indexterm" name="id2565939"></a>
     38<a class="indexterm" name="id2565945"></a>
     39<a class="indexterm" name="id2565952"></a>
    4040The use of a non-LDAP backend SAM database is particularly problematic because domain member
    4141servers and workstations periodically change the Machine Trust Account password. The new
     
    4747breakage of the domain trust.
    4848</p><p>
    49 <a class="indexterm" name="id2572059"></a>
    50 <a class="indexterm" name="id2572068"></a>
    51 <a class="indexterm" name="id2572077"></a>
    52 <a class="indexterm" name="id2572086"></a>
     49<a class="indexterm" name="id2565974"></a>
     50<a class="indexterm" name="id2565982"></a>
     51<a class="indexterm" name="id2565992"></a>
     52<a class="indexterm" name="id2566001"></a>
    5353Considering the number of comments and questions raised concerning how to configure a BDC,
    5454let's consider each possible option and look at the pros and cons for each possible solution.
     
    7171        and also suffers
    7272        from the issue of domain trust breakdown.
    73         </p></td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect1" title="Essential Background Information"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2572268"></a>Essential Background Information</h2></div></div></div><p>
    74 <a class="indexterm" name="id2572276"></a>
    75 <a class="indexterm" name="id2572283"></a>
    76 <a class="indexterm" name="id2572290"></a>
    77 <a class="indexterm" name="id2572296"></a>
     73        </p></td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2566182"></a>Essential Background Information</h2></div></div></div><p>
     74<a class="indexterm" name="id2566190"></a>
     75<a class="indexterm" name="id2566197"></a>
     76<a class="indexterm" name="id2566204"></a>
     77<a class="indexterm" name="id2566211"></a>
    7878A domain controller is a machine that is able to answer logon requests from network
    7979workstations. Microsoft LanManager and IBM LanServer were two early products that
    8080provided this capability. The technology has become known as the LanMan Netlogon service.
    8181</p><p>
    82 <a class="indexterm" name="id2572311"></a>
    83 <a class="indexterm" name="id2572322"></a>
     82<a class="indexterm" name="id2566225"></a>
     83<a class="indexterm" name="id2566237"></a>
    8484When MS Windows NT3.10 was first released, it supported a new style of Domain Control
    8585and with it a new form of the network logon service that has extended functionality.
     
    8787changed with the evolution of MS Windows NT and today provides a complex array of
    8888services that are implemented over an intricate spectrum of technologies.
    89 </p><div class="sect2" title="MS Windows NT4-style Domain Control"><div class="titlepage"><div><div><h3 class="title"><a name="id2572337"></a>MS Windows NT4-style Domain Control</h3></div></div></div><p>
    90 <a class="indexterm" name="id2572346"></a>
    91 <a class="indexterm" name="id2572352"></a>
    92 <a class="indexterm" name="id2572360"></a>
    93 <a class="indexterm" name="id2572366"></a>
    94 <a class="indexterm" name="id2572373"></a>
    95 <a class="indexterm" name="id2572380"></a>
    96 <a class="indexterm" name="id2572389"></a>
     89</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566252"></a>MS Windows NT4-style Domain Control</h3></div></div></div><p>
     90<a class="indexterm" name="id2566260"></a>
     91<a class="indexterm" name="id2566267"></a>
     92<a class="indexterm" name="id2566274"></a>
     93<a class="indexterm" name="id2566281"></a>
     94<a class="indexterm" name="id2566288"></a>
     95<a class="indexterm" name="id2566294"></a>
     96<a class="indexterm" name="id2566303"></a>
    9797Whenever a user logs into a Windows NT4/200x/XP Professional workstation,
    9898the workstation connects to a domain controller (authentication server) to validate that
     
    102102codes is returned to the workstation that has made the authentication request.
    103103</p><p>
    104 <a class="indexterm" name="id2572409"></a>
    105 <a class="indexterm" name="id2572416"></a>
    106 <a class="indexterm" name="id2572423"></a>
    107 <a class="indexterm" name="id2572430"></a>
    108 <a class="indexterm" name="id2572437"></a>
     104<a class="indexterm" name="id2566324"></a>
     105<a class="indexterm" name="id2566331"></a>
     106<a class="indexterm" name="id2566338"></a>
     107<a class="indexterm" name="id2566344"></a>
     108<a class="indexterm" name="id2566352"></a>
    109109When the username/password pair has been validated, the domain controller
    110110(authentication server) will respond with full enumeration of the account information
     
    118118in all versions of MS Windows NT (3.10, 3.50, 3.51, 4.0).
    119119</p><p>
    120 <a class="indexterm" name="id2572474"></a>
    121 <a class="indexterm" name="id2572483"></a>
    122 <a class="indexterm" name="id2572490"></a>
    123 <a class="indexterm" name="id2572497"></a>
    124 <a class="indexterm" name="id2572504"></a>
     120<a class="indexterm" name="id2566389"></a>
     121<a class="indexterm" name="id2566398"></a>
     122<a class="indexterm" name="id2566405"></a>
     123<a class="indexterm" name="id2566412"></a>
     124<a class="indexterm" name="id2566418"></a>
    125125The account information (user and machine) on domain controllers is stored in two files,
    126126one containing the security information and the other the SAM. These are stored in files
     
    131131</p><p>
    132132There are two situations in which it is desirable to install BDCs:
    133 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    134         <a class="indexterm" name="id2572540"></a>
    135         <a class="indexterm" name="id2572546"></a>
     133</p><div class="itemizedlist"><ul type="disc"><li><p>
     134        <a class="indexterm" name="id2566454"></a>
     135        <a class="indexterm" name="id2566461"></a>
    136136        On the local network that the PDC is on, if there are many
    137137        workstations and/or where the PDC is generally very busy. In this case the BDCs
    138138        will pick up network logon requests and help to add robustness to network services.
    139         </p></li><li class="listitem"><p>
    140         <a class="indexterm" name="id2572561"></a>
     139        </p></li><li><p>
     140        <a class="indexterm" name="id2566476"></a>
    141141        At each remote site, to reduce wide-area network traffic and to add stability to
    142142        remote network operations. The design of the network, and the strategic placement of
     
    145145        (and thus costs).
    146146        </p></li></ul></div><p>
    147 <a class="indexterm" name="id2572581"></a>
    148 <a class="indexterm" name="id2572587"></a>
    149 <a class="indexterm" name="id2572594"></a>
    150 <a class="indexterm" name="id2572601"></a>
    151 <a class="indexterm" name="id2572607"></a>
     147<a class="indexterm" name="id2566495"></a>
     148<a class="indexterm" name="id2566502"></a>
     149<a class="indexterm" name="id2566508"></a>
     150<a class="indexterm" name="id2566515"></a>
     151<a class="indexterm" name="id2566522"></a>
    152152The interoperation of a PDC and its BDCs in a true Windows NT4 environment is worth
    153153mentioning here. The PDC contains the master copy of the SAM. In the event that an
     
    161161trigger them to obtain the update and then apply that to their own copy of the SAM.
    162162</p><p>
    163 <a class="indexterm" name="id2572631"></a>
    164 <a class="indexterm" name="id2572640"></a>
    165 <a class="indexterm" name="id2572649"></a>
    166 <a class="indexterm" name="id2572656"></a>
     163<a class="indexterm" name="id2566546"></a>
     164<a class="indexterm" name="id2566555"></a>
     165<a class="indexterm" name="id2566564"></a>
     166<a class="indexterm" name="id2566570"></a>
    167167Samba-3 cannot participate in true SAM replication and is therefore not able to
    168168employ precisely the same protocols used by MS Windows NT4. A Samba-3 BDC will
     
    170170to synchronize the SAM from delta files that are held by BDCs.
    171171</p><p>
    172 <a class="indexterm" name="id2572671"></a>
    173 <a class="indexterm" name="id2572677"></a>
     172<a class="indexterm" name="id2566585"></a>
     173<a class="indexterm" name="id2566592"></a>
    174174Samba-3 cannot function as a BDC to an MS Windows NT4 PDC, and Samba-3 cannot
    175175function correctly as a PDC to an MS Windows NT4 BDC. Both Samba-3 and MS Windows
    176176NT4 can function as a BDC to its own type of PDC.
    177177</p><p>
    178 <a class="indexterm" name="id2572691"></a>
    179 <a class="indexterm" name="id2572697"></a>
    180 <a class="indexterm" name="id2572704"></a>
     178<a class="indexterm" name="id2566605"></a>
     179<a class="indexterm" name="id2566612"></a>
     180<a class="indexterm" name="id2566618"></a>
    181181The BDC is said to hold a <span class="emphasis"><em>read-only</em></span> of the SAM from which
    182182it is able to process network logon requests and authenticate users. The BDC can
     
    185185maintenance of domain security as well as in network integrity.
    186186</p><p>
    187 <a class="indexterm" name="id2572724"></a>
    188 <a class="indexterm" name="id2572730"></a>
    189 <a class="indexterm" name="id2572737"></a>
    190 <a class="indexterm" name="id2572744"></a>
     187<a class="indexterm" name="id2566638"></a>
     188<a class="indexterm" name="id2566644"></a>
     189<a class="indexterm" name="id2566651"></a>
     190<a class="indexterm" name="id2566658"></a>
    191191In the event that the NT4 PDC should need to be taken out of service, or if it dies, one of the NT4 BDCs can
    192192be promoted to a PDC. If this happens while the original NT4 PDC is online, it is automatically demoted to an
     
    195195promoted in this manner because reconfiguration of Samba requires changes to the <code class="filename">smb.conf</code> file. It is easy
    196196enough to manuall change the <code class="filename">smb.conf</code> file and then restart relevant Samba network services.
    197 </p><div class="sect3" title="Example PDC Configuration"><div class="titlepage"><div><div><h4 class="title"><a name="id2572774"></a>Example PDC Configuration</h4></div></div></div><p>
    198 <a class="indexterm" name="id2572782"></a>
    199 <a class="indexterm" name="id2572789"></a>
     197</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2566688"></a>Example PDC Configuration</h4></div></div></div><p>
     198<a class="indexterm" name="id2566696"></a>
     199<a class="indexterm" name="id2566703"></a>
    200200Beginning with Version 2.2, Samba officially supports domain logons for all current Windows clients, including
    201201Windows NT4, 2003, and XP Professional. For Samba to be enabled as a PDC, some parameters in the
    202202<em class="parameter"><code>[global]</code></em> section of the <code class="filename">smb.conf</code> have to be set.  Refer to <a class="link" href="samba-bdc.html#minimalPDC" title="Example 5.1. Minimal smb.conf for a PDC in Use with a BDC LDAP Server on PDC">the Minimal smb.conf for a PDC in Use with a BDC  LDAP Server on PDC
    203203section</a> for an example of the minimum required settings.
    204 </p><div class="example"><a name="minimalPDC"></a><p class="title"><b>Example 5.1. Minimal smb.conf for a PDC in Use with a BDC  LDAP Server on PDC</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id2572842"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td><a class="indexterm" name="id2572854"></a><em class="parameter"><code>passdb backend = ldapsam://localhost:389</code></em></td></tr><tr><td><a class="indexterm" name="id2572866"></a><em class="parameter"><code>domain master = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2572878"></a><em class="parameter"><code>domain logons = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2572890"></a><em class="parameter"><code>ldap suffix = dc=quenya,dc=org</code></em></td></tr><tr><td><a class="indexterm" name="id2572901"></a><em class="parameter"><code>ldap user suffix = ou=Users</code></em></td></tr><tr><td><a class="indexterm" name="id2572913"></a><em class="parameter"><code>ldap group suffix = ou=Groups</code></em></td></tr><tr><td><a class="indexterm" name="id2572925"></a><em class="parameter"><code>ldap machine suffix = ou=Computers</code></em></td></tr><tr><td><a class="indexterm" name="id2572937"></a><em class="parameter"><code>ldap idmap suffix = ou=Idmap</code></em></td></tr><tr><td><a class="indexterm" name="id2572949"></a><em class="parameter"><code>ldap admin dn = cn=sambadmin,dc=quenya,dc=org</code></em></td></tr></table></div></div><br class="example-break"><p>
    205 <a class="indexterm" name="id2572965"></a>
    206 <a class="indexterm" name="id2572972"></a>
     204</p><div class="example"><a name="minimalPDC"></a><p class="title"><b>Example 5.1. Minimal smb.conf for a PDC in Use with a BDC  LDAP Server on PDC</b></p><div class="example-contents"><table class="simplelist" border="0" summary="Simple list"><tr><td><a class="indexterm" name="id2566757"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td><a class="indexterm" name="id2566768"></a><em class="parameter"><code>passdb backend = ldapsam://localhost:389</code></em></td></tr><tr><td><a class="indexterm" name="id2566780"></a><em class="parameter"><code>domain master = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2566792"></a><em class="parameter"><code>domain logons = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2566804"></a><em class="parameter"><code>ldap suffix = dc=quenya,dc=org</code></em></td></tr><tr><td><a class="indexterm" name="id2566816"></a><em class="parameter"><code>ldap user suffix = ou=Users</code></em></td></tr><tr><td><a class="indexterm" name="id2566828"></a><em class="parameter"><code>ldap group suffix = ou=Groups</code></em></td></tr><tr><td><a class="indexterm" name="id2566840"></a><em class="parameter"><code>ldap machine suffix = ou=Computers</code></em></td></tr><tr><td><a class="indexterm" name="id2566852"></a><em class="parameter"><code>ldap idmap suffix = ou=Idmap</code></em></td></tr><tr><td><a class="indexterm" name="id2566864"></a><em class="parameter"><code>ldap admin dn = cn=sambadmin,dc=quenya,dc=org</code></em></td></tr></table></div></div><br class="example-break"><p>
     205<a class="indexterm" name="id2566879"></a>
     206<a class="indexterm" name="id2566886"></a>
    207207Several other things like a <em class="parameter"><code>[homes]</code></em> and a <em class="parameter"><code>[netlogon]</code></em> share
    208208also need to be set along with settings for the profile path, the user's home drive, and so on. This is not
     
    210210Refer to <a class="link" href="samba-pdc.html" title="Chapter 4. Domain Control">the Domain Control chapter</a> for specific recommendations for PDC
    211211configuration. Alternately, fully documented working example network configurations using OpenLDAP and Samba
    212 as available in the <a class="ulink" href="http://www.samba.org/samba/docs/Samba3-ByExample" target="_top">book</a> <span class="quote">&#8220;<span class="quote">Samba-3
    213 by Example</span>&#8221;</span> that may be obtained from local and on-line book stores.
    214 </p></div></div><div class="sect2" title="LDAP Configuration Notes"><div class="titlepage"><div><div><h3 class="title"><a name="id2573025"></a>LDAP Configuration Notes</h3></div></div></div><p>
    215 <a class="indexterm" name="id2573033"></a>
    216 <a class="indexterm" name="id2573042"></a>
    217 <a class="indexterm" name="id2573052"></a>
     212as available in the <a class="ulink" href="http://www.samba.org/samba/docs/Samba3-ByExample" target="_top">book</a> &#8220;<span class="quote">Samba-3
     213by Example</span>&#8221; that may be obtained from local and on-line book stores.
     214</p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566940"></a>LDAP Configuration Notes</h3></div></div></div><p>
     215<a class="indexterm" name="id2566948"></a>
     216<a class="indexterm" name="id2566957"></a>
     217<a class="indexterm" name="id2566966"></a>
    218218When configuring a master and a slave LDAP server, it is advisable to use the master LDAP server
    219219for the PDC and slave LDAP servers for the BDCs. It is not essential to use slave LDAP servers; however,
     
    222222entire network.
    223223</p><p>
    224 <a class="indexterm" name="id2573069"></a>
    225 <a class="indexterm" name="id2573078"></a>
    226 <a class="indexterm" name="id2573087"></a>
    227 <a class="indexterm" name="id2573094"></a>
    228 <a class="indexterm" name="id2573100"></a>
     224<a class="indexterm" name="id2566983"></a>
     225<a class="indexterm" name="id2566992"></a>
     226<a class="indexterm" name="id2567001"></a>
     227<a class="indexterm" name="id2567008"></a>
     228<a class="indexterm" name="id2567015"></a>
    229229When configuring a master LDAP server that will have slave LDAP servers, do not forget to configure this in
    230230the <code class="filename">/etc/openldap/slapd.conf</code> file. It must be noted that the DN of a server certificate
     
    233233on server certificate names are in RFC2830.
    234234</p><p>
    235 <a class="indexterm" name="id2573124"></a>
    236 <a class="indexterm" name="id2573131"></a>
    237 <a class="indexterm" name="id2573137"></a>
    238 <a class="indexterm" name="id2573144"></a>
    239 <a class="indexterm" name="id2573154"></a>
    240 <a class="indexterm" name="id2573161"></a>
    241 <a class="indexterm" name="id2573168"></a>
     235<a class="indexterm" name="id2567038"></a>
     236<a class="indexterm" name="id2567045"></a>
     237<a class="indexterm" name="id2567052"></a>
     238<a class="indexterm" name="id2567059"></a>
     239<a class="indexterm" name="id2567068"></a>
     240<a class="indexterm" name="id2567075"></a>
     241<a class="indexterm" name="id2567082"></a>
    242242It does not really fit within the scope of this document, but a working LDAP installation is basic to
    243243LDAP-enabled Samba operation. When using an OpenLDAP server with Transport Layer Security (TLS), the machine
    244244name in <code class="filename">/etc/ssl/certs/slapd.pem</code> must be the same as in
    245245<code class="filename">/etc/openldap/sldap.conf</code>. The Red Hat Linux startup script creates the
    246 <code class="filename">slapd.pem</code> file with hostname <span class="quote">&#8220;<span class="quote">localhost.localdomain.</span>&#8221;</span> It is impossible to
     246<code class="filename">slapd.pem</code> file with hostname &#8220;<span class="quote">localhost.localdomain.</span>&#8221; It is impossible to
    247247access this LDAP server from a slave LDAP server (i.e., a Samba BDC) unless the certificate is re-created with
    248248a correct hostname.
    249249</p><p>
    250 <a class="indexterm" name="id2573208"></a>
    251 <a class="indexterm" name="id2573214"></a>
    252 <a class="indexterm" name="id2573221"></a>
    253 <a class="indexterm" name="id2573228"></a>
    254 <a class="indexterm" name="id2573235"></a>
    255 <a class="indexterm" name="id2573242"></a>
     250<a class="indexterm" name="id2567122"></a>
     251<a class="indexterm" name="id2567129"></a>
     252<a class="indexterm" name="id2567136"></a>
     253<a class="indexterm" name="id2567142"></a>
     254<a class="indexterm" name="id2567149"></a>
     255<a class="indexterm" name="id2567156"></a>
    256256Do not install a Samba PDC so that is uses an LDAP slave server. Joining client machines to the domain
    257257will fail in this configuration because the change to the machine account in the LDAP tree must take place on
     
    264264</p><p>
    265265Possible PDC/BDC plus LDAP configurations include:
    266 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     266</p><div class="itemizedlist"><ul type="disc"><li><p>
    267267        PDC+BDC -&gt; One Central LDAP Server.
    268         </p></li><li class="listitem"><p>
     268        </p></li><li><p>
    269269        PDC -&gt; LDAP master server, BDC -&gt; LDAP slave server.
    270         </p></li><li class="listitem"><p>
     270        </p></li><li><p>
    271271        PDC -&gt; LDAP master, with secondary slave LDAP server.
    272272        </p><p>
    273273        BDC -&gt; LDAP master, with secondary slave LDAP server.
    274         </p></li><li class="listitem"><p>
     274        </p></li><li><p>
    275275        PDC -&gt; LDAP master, with secondary slave LDAP server.
    276276        </p><p>
     
    280280the secondary LDAP server in the <code class="filename">smb.conf</code> file as shown in <a class="link" href="samba-bdc.html#mulitldapcfg" title="Example 5.2. Multiple LDAP Servers in smb.conf">the Multiple LDAP
    281281Servers in <code class="filename">smb.conf</code> example</a>.
    282 </p><div class="example"><a name="mulitldapcfg"></a><p class="title"><b>Example 5.2. Multiple LDAP Servers in <code class="filename">smb.conf</code></b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id2573376"></a><em class="parameter"><code>passdb backend = ldapsam:"ldap://master.quenya.org ldap://slave.quenya.org"</code></em></td></tr></table></div></div><br class="example-break"></div><div class="sect2" title="Active Directory Domain Control"><div class="titlepage"><div><div><h3 class="title"><a name="id2573390"></a>Active Directory Domain Control</h3></div></div></div><p>
    283 <a class="indexterm" name="id2573398"></a>
    284 <a class="indexterm" name="id2573405"></a>
    285 <a class="indexterm" name="id2573412"></a>
    286 <a class="indexterm" name="id2573419"></a>
    287 <a class="indexterm" name="id2573426"></a>
    288 <a class="indexterm" name="id2573432"></a>
     282</p><div class="example"><a name="mulitldapcfg"></a><p class="title"><b>Example 5.2. Multiple LDAP Servers in <code class="filename">smb.conf</code></b></p><div class="example-contents"><table class="simplelist" border="0" summary="Simple list"><tr><td><a class="indexterm" name="id2567290"></a><em class="parameter"><code>passdb backend = ldapsam:"ldap://master.quenya.org ldap://slave.quenya.org"</code></em></td></tr></table></div></div><br class="example-break"></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567305"></a>Active Directory Domain Control</h3></div></div></div><p>
     283<a class="indexterm" name="id2567313"></a>
     284<a class="indexterm" name="id2567320"></a>
     285<a class="indexterm" name="id2567327"></a>
     286<a class="indexterm" name="id2567333"></a>
     287<a class="indexterm" name="id2567340"></a>
     288<a class="indexterm" name="id2567347"></a>
    289289As of the release of MS Windows 2000 and Active Directory, this information is now stored
    290290in a directory that can be replicated and for which partial or full administrative control
     
    292292tree, and it cannot be an Active Directory server. This means that Samba-3 also cannot
    293293act as a BDC to an Active Directory domain controller.
    294 </p></div><div class="sect2" title="What Qualifies a Domain Controller on the Network?"><div class="titlepage"><div><div><h3 class="title"><a name="id2573448"></a>What Qualifies a Domain Controller on the Network?</h3></div></div></div><p>
    295 <a class="indexterm" name="id2573457"></a>
    296 <a class="indexterm" name="id2573463"></a>
    297 <a class="indexterm" name="id2573470"></a>
    298 <a class="indexterm" name="id2573477"></a>
     294</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567363"></a>What Qualifies a Domain Controller on the Network?</h3></div></div></div><p>
     295<a class="indexterm" name="id2567371"></a>
     296<a class="indexterm" name="id2567378"></a>
     297<a class="indexterm" name="id2567384"></a>
     298<a class="indexterm" name="id2567391"></a>
    299299Every machine that is a domain controller for the domain MIDEARTH has to register the NetBIOS
    300300group name MIDEARTH&lt;1C&gt; with the WINS server and/or by broadcast on the local network.
     
    304304implementation requires the DMB to be on the same machine as the PDC.
    305305</p><p>
    306 <a class="indexterm" name="id2573499"></a>
    307 <a class="indexterm" name="id2573505"></a>
    308 <a class="indexterm" name="id2573512"></a>
     306<a class="indexterm" name="id2567413"></a>
     307<a class="indexterm" name="id2567420"></a>
     308<a class="indexterm" name="id2567427"></a>
    309309Where a WINS server is not used, broadcast name registrations alone must suffice. Refer to
    310310<a class="link" href="NetworkBrowsing.html" title="Chapter 10. Network Browsing">Network Browsing</a>,<a class="link" href="NetworkBrowsing.html#netdiscuss" title="Discussion">Discussion</a>
    311311for more information regarding TCP/IP network protocols and how SMB/CIFS names are handled.
    312 </p></div><div class="sect2" title="How Does a Workstation find its Domain Controller?"><div class="titlepage"><div><div><h3 class="title"><a name="id2573539"></a>How Does a Workstation find its Domain Controller?</h3></div></div></div><p>
    313 <a class="indexterm" name="id2573548"></a>
    314 <a class="indexterm" name="id2573555"></a>
     312</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567454"></a>How Does a Workstation find its Domain Controller?</h3></div></div></div><p>
     313<a class="indexterm" name="id2567462"></a>
     314<a class="indexterm" name="id2567469"></a>
    315315There are two different mechanisms to locate a domain controller: one method is used when
    316316NetBIOS over TCP/IP is enabled and the other when it has been disabled in the TCP/IP
    317317network configuration.
    318318</p><p>
    319 <a class="indexterm" name="id2573568"></a>
    320 <a class="indexterm" name="id2573575"></a>
     319<a class="indexterm" name="id2567483"></a>
     320<a class="indexterm" name="id2567489"></a>
    321321Where NetBIOS over TCP/IP is disabled, all name resolution involves the use of DNS, broadcast
    322322messaging over UDP, as well as Active Directory communication technologies. In this type of
    323323environment all machines require appropriate DNS entries. More information may be found in
    324324<a class="link" href="NetworkBrowsing.html#adsdnstech" title="DNS and Active Directory">DNS and Active Directory</a>.
    325 </p><div class="sect3" title="NetBIOS Over TCP/IP Enabled"><div class="titlepage"><div><div><h4 class="title"><a name="id2573596"></a>NetBIOS Over TCP/IP Enabled</h4></div></div></div><p>
    326 <a class="indexterm" name="id2573604"></a>
    327 <a class="indexterm" name="id2573611"></a>
    328 <a class="indexterm" name="id2573618"></a>
    329 <a class="indexterm" name="id2573624"></a>
     325</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2567510"></a>NetBIOS Over TCP/IP Enabled</h4></div></div></div><p>
     326<a class="indexterm" name="id2567518"></a>
     327<a class="indexterm" name="id2567525"></a>
     328<a class="indexterm" name="id2567532"></a>
     329<a class="indexterm" name="id2567539"></a>
    330330An MS Windows NT4/200x/XP Professional workstation in the domain MIDEARTH that wants a
    331331local user to be authenticated has to find the domain controller for MIDEARTH. It does this
     
    335335authenticate each other. After that the workstation sends the user's credentials (name and
    336336password) to the local domain controller for validation.
    337 </p></div><div class="sect3" title="NetBIOS Over TCP/IP Disabled"><div class="titlepage"><div><div><h4 class="title"><a name="id2573662"></a>NetBIOS Over TCP/IP Disabled</h4></div></div></div><p>
    338 <a class="indexterm" name="id2573670"></a>
    339 <a class="indexterm" name="id2573676"></a>
    340 <a class="indexterm" name="id2573684"></a>
    341 <a class="indexterm" name="id2573690"></a>
     337</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2567576"></a>NetBIOS Over TCP/IP Disabled</h4></div></div></div><p>
     338<a class="indexterm" name="id2567584"></a>
     339<a class="indexterm" name="id2567591"></a>
     340<a class="indexterm" name="id2567598"></a>
     341<a class="indexterm" name="id2567604"></a>
    342342An MS Windows NT4/200x/XP Professional workstation in the realm <code class="constant">quenya.org</code>
    343343that has a need to affect user logon authentication will locate the domain controller by
    344344re-querying DNS servers for the <code class="constant">_ldap._tcp.pdc._msdcs.quenya.org</code> record.
    345345More information regarding this subject may be found in <a class="link" href="NetworkBrowsing.html#adsdnstech" title="DNS and Active Directory">DNS and Active Directory</a>.
    346 </p></div></div></div><div class="sect1" title="Backup Domain Controller Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2573721"></a>Backup Domain Controller Configuration</h2></div></div></div><p>
    347 <a class="indexterm" name="id2573728"></a>
     346</p></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2567635"></a>Backup Domain Controller Configuration</h2></div></div></div><p>
     347<a class="indexterm" name="id2567642"></a>
    348348The creation of a BDC requires some steps to prepare the Samba server before
    349349<span class="application">smbd</span> is executed for the first time. These steps are as follows:
    350 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    351         <a class="indexterm" name="id2573749"></a>
    352         <a class="indexterm" name="id2573756"></a>
    353         <a class="indexterm" name="id2573762"></a>
    354         <a class="indexterm" name="id2573769"></a>
    355         <a class="indexterm" name="id2573776"></a>
    356         <a class="indexterm" name="id2573783"></a>
     350</p><div class="itemizedlist"><ul type="disc"><li><p>
     351        <a class="indexterm" name="id2567664"></a>
     352        <a class="indexterm" name="id2567670"></a>
     353        <a class="indexterm" name="id2567677"></a>
     354        <a class="indexterm" name="id2567683"></a>
     355        <a class="indexterm" name="id2567690"></a>
     356        <a class="indexterm" name="id2567697"></a>
    357357        The domain SID has to be the same on the PDC and the BDC. In Samba versions pre-2.2.5, the domain SID was
    358358        stored in the file <code class="filename">private/MACHINE.SID</code>.  For all versions of Samba released since 2.2.5
     
    362362        domain SID. This is described here.
    363363        </p><p>
    364         <a class="indexterm" name="id2573813"></a>
    365         <a class="indexterm" name="id2573820"></a>
    366         <a class="indexterm" name="id2573827"></a>
    367         <a class="indexterm" name="id2573833"></a>
    368         <a class="indexterm" name="id2573840"></a>
     364        <a class="indexterm" name="id2567728"></a>
     365        <a class="indexterm" name="id2567734"></a>
     366        <a class="indexterm" name="id2567741"></a>
     367        <a class="indexterm" name="id2567748"></a>
     368        <a class="indexterm" name="id2567754"></a>
    369369        To retrieve the domain SID from the PDC or an existing BDC and store it in the
    370370        <code class="filename">secrets.tdb</code>, execute:
    371371        </p><pre class="screen">
    372372<code class="prompt">root# </code><strong class="userinput"><code>net rpc getsid</code></strong>
    373 </pre></li><li class="listitem"><p>
    374         <a class="indexterm" name="id2573880"></a>
    375         <a class="indexterm" name="id2573887"></a>
    376         <a class="indexterm" name="id2573894"></a>
     373</pre></li><li><p>
     374        <a class="indexterm" name="id2567794"></a>
     375        <a class="indexterm" name="id2567801"></a>
     376        <a class="indexterm" name="id2567808"></a>
    377377        Specification of the <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> is obligatory.
    378378        This also requires the LDAP administration password to be set in the <code class="filename">secrets.tdb</code>
    379379        using the <code class="literal">smbpasswd -w <em class="replaceable"><code>mysecret</code></em></code>.
    380         </p></li><li class="listitem"><p>
     380        </p></li><li><p>
    381381        The <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> parameter and the <a class="link" href="smb.conf.5.html#LDAPIDMAPSUFFIX" target="_top">ldap idmap suffix</a>
    382382        parameter must be specified in the <code class="filename">smb.conf</code> file.
    383         </p></li><li class="listitem"><p>
    384         <a class="indexterm" name="id2573968"></a>
    385         <a class="indexterm" name="id2573977"></a>
    386         <a class="indexterm" name="id2573984"></a>
    387         <a class="indexterm" name="id2573991"></a>
     383        </p></li><li><p>
     384        <a class="indexterm" name="id2567883"></a>
     385        <a class="indexterm" name="id2567892"></a>
     386        <a class="indexterm" name="id2567899"></a>
     387        <a class="indexterm" name="id2567906"></a>
    388388        The UNIX user database has to be synchronized from the PDC to the
    389389        BDC. This means that both the <code class="filename">/etc/passwd</code> and
     
    395395        a PDC failure. NIS is by no means the only method to synchronize
    396396        passwords. An LDAP solution would also work.
    397         </p></li><li class="listitem"><p>
    398         <a class="indexterm" name="id2574024"></a>
    399         <a class="indexterm" name="id2574031"></a>
    400         <a class="indexterm" name="id2574038"></a>
    401         <a class="indexterm" name="id2574044"></a>
    402         <a class="indexterm" name="id2574051"></a>
    403         <a class="indexterm" name="id2574058"></a>
    404         <a class="indexterm" name="id2574064"></a>
    405         <a class="indexterm" name="id2574071"></a>
     397        </p></li><li><p>
     398        <a class="indexterm" name="id2567938"></a>
     399        <a class="indexterm" name="id2567945"></a>
     400        <a class="indexterm" name="id2567952"></a>
     401        <a class="indexterm" name="id2567959"></a>
     402        <a class="indexterm" name="id2567965"></a>
     403        <a class="indexterm" name="id2567972"></a>
     404        <a class="indexterm" name="id2567979"></a>
     405        <a class="indexterm" name="id2567985"></a>
    406406        The Samba password database must be replicated from the PDC to the BDC.
    407407        Although it is possible to synchronize the <code class="filename">smbpasswd</code>
     
    418418        or when it takes place.
    419419        </p><p>
    420         <a class="indexterm" name="id2574117"></a>
    421         <a class="indexterm" name="id2574123"></a>
    422         <a class="indexterm" name="id2574130"></a>
    423         <a class="indexterm" name="id2574137"></a>
     420        <a class="indexterm" name="id2568031"></a>
     421        <a class="indexterm" name="id2568038"></a>
     422        <a class="indexterm" name="id2568044"></a>
     423        <a class="indexterm" name="id2568051"></a>
    424424        The use of LDAP for both the POSIX (UNIX user and group) accounts and for the
    425425        SambaSAMAccount data automatically ensures that all account change information
    426426        will be written to the shared directory. This eliminates the need for any special
    427427        action to synchronize account information because LDAP will meet that requirement.
    428         </p></li><li class="listitem"><p>
    429         <a class="indexterm" name="id2574154"></a>
    430         <a class="indexterm" name="id2574161"></a>
    431         <a class="indexterm" name="id2574167"></a>
    432         <a class="indexterm" name="id2574174"></a>
    433         <a class="indexterm" name="id2574180"></a>
    434         <a class="indexterm" name="id2574187"></a>
     428        </p></li><li><p>
     429        <a class="indexterm" name="id2568068"></a>
     430        <a class="indexterm" name="id2568075"></a>
     431        <a class="indexterm" name="id2568082"></a>
     432        <a class="indexterm" name="id2568088"></a>
     433        <a class="indexterm" name="id2568095"></a>
     434        <a class="indexterm" name="id2568102"></a>
    435435        The netlogon share has to be replicated from the PDC to the BDC. This can be done manually whenever login
    436436        scripts are changed, or it can be done automatically using a <code class="literal">cron</code> job that will replicate
     
    439439        that can be manually managed given that the administrator will make all changes to the netlogon share as part
    440440        of a conscious move.
    441         </p></li></ul></div><div class="sect2" title="Example Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="id2574222"></a>Example Configuration</h3></div></div></div><p>
     441        </p></li></ul></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2568136"></a>Example Configuration</h3></div></div></div><p>
    442442Finally, the BDC has to be capable of being found by the workstations. This can be done by configuring the
    443443Samba <code class="filename">smb.conf</code> file <em class="parameter"><code>[global]</code></em> section as shown in <a class="link" href="samba-bdc.html#minim-bdc" title="Example 5.3. Minimal Setup for Being a BDC">Minimal
    444444Setup for Being a BDC</a>.
    445 </p><div class="example"><a name="minim-bdc"></a><p class="title"><b>Example 5.3. Minimal Setup for Being a BDC</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id2574267"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td><a class="indexterm" name="id2574279"></a><em class="parameter"><code>passdb backend = ldapsam:ldap://slave-ldap.quenya.org</code></em></td></tr><tr><td><a class="indexterm" name="id2574292"></a><em class="parameter"><code>domain master = no</code></em></td></tr><tr><td><a class="indexterm" name="id2574303"></a><em class="parameter"><code>domain logons = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2574315"></a><em class="parameter"><code>ldap suffix = dc=abmas,dc=biz</code></em></td></tr><tr><td><a class="indexterm" name="id2574327"></a><em class="parameter"><code>ldap user suffix = ou=Users</code></em></td></tr><tr><td><a class="indexterm" name="id2574339"></a><em class="parameter"><code>ldap group suffix = ou=Groups</code></em></td></tr><tr><td><a class="indexterm" name="id2574351"></a><em class="parameter"><code>ldap machine suffix = ou=Computers</code></em></td></tr><tr><td><a class="indexterm" name="id2574363"></a><em class="parameter"><code>ldap idmap suffix = ou=Idmap</code></em></td></tr><tr><td><a class="indexterm" name="id2574375"></a><em class="parameter"><code>ldap admin dn = cn=sambadmin,dc=quenya,dc=org</code></em></td></tr><tr><td><a class="indexterm" name="id2574387"></a><em class="parameter"><code>idmap backend = ldap:ldap://master-ldap.quenya.org</code></em></td></tr><tr><td><a class="indexterm" name="id2574399"></a><em class="parameter"><code>idmap uid = 10000-20000</code></em></td></tr><tr><td><a class="indexterm" name="id2574411"></a><em class="parameter"><code>idmap gid = 10000-20000</code></em></td></tr></table></div></div><br class="example-break"><p>
     445</p><div class="example"><a name="minim-bdc"></a><p class="title"><b>Example 5.3. Minimal Setup for Being a BDC</b></p><div class="example-contents"><table class="simplelist" border="0" summary="Simple list"><tr><td><a class="indexterm" name="id2568182"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td><a class="indexterm" name="id2568194"></a><em class="parameter"><code>passdb backend = ldapsam:ldap://slave-ldap.quenya.org</code></em></td></tr><tr><td><a class="indexterm" name="id2568206"></a><em class="parameter"><code>domain master = no</code></em></td></tr><tr><td><a class="indexterm" name="id2568218"></a><em class="parameter"><code>domain logons = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2568229"></a><em class="parameter"><code>ldap suffix = dc=abmas,dc=biz</code></em></td></tr><tr><td><a class="indexterm" name="id2568241"></a><em class="parameter"><code>ldap user suffix = ou=Users</code></em></td></tr><tr><td><a class="indexterm" name="id2568253"></a><em class="parameter"><code>ldap group suffix = ou=Groups</code></em></td></tr><tr><td><a class="indexterm" name="id2568265"></a><em class="parameter"><code>ldap machine suffix = ou=Computers</code></em></td></tr><tr><td><a class="indexterm" name="id2568277"></a><em class="parameter"><code>ldap idmap suffix = ou=Idmap</code></em></td></tr><tr><td><a class="indexterm" name="id2568289"></a><em class="parameter"><code>ldap admin dn = cn=sambadmin,dc=quenya,dc=org</code></em></td></tr><tr><td><a class="indexterm" name="id2568301"></a><em class="parameter"><code>idmap backend = ldap:ldap://master-ldap.quenya.org</code></em></td></tr><tr><td><a class="indexterm" name="id2568314"></a><em class="parameter"><code>idmap uid = 10000-20000</code></em></td></tr><tr><td><a class="indexterm" name="id2568325"></a><em class="parameter"><code>idmap gid = 10000-20000</code></em></td></tr></table></div></div><br class="example-break"><p>
    446446Fully documented working example network configurations using OpenLDAP and Samba
    447 as available in the <a class="ulink" href="http://www.samba.org/samba/docs/Samba3-ByExample" target="_top">book</a> <span class="quote">&#8220;<span class="quote">Samba-3
    448 by Example</span>&#8221;</span> that may be obtained from local and on-line book stores.
    449 </p><p>
    450 <a class="indexterm" name="id2574442"></a>
    451 <a class="indexterm" name="id2574449"></a>
    452 <a class="indexterm" name="id2574455"></a>
    453 <a class="indexterm" name="id2574462"></a>
     447as available in the <a class="ulink" href="http://www.samba.org/samba/docs/Samba3-ByExample" target="_top">book</a> &#8220;<span class="quote">Samba-3
     448by Example</span>&#8221; that may be obtained from local and on-line book stores.
     449</p><p>
     450<a class="indexterm" name="id2568356"></a>
     451<a class="indexterm" name="id2568363"></a>
     452<a class="indexterm" name="id2568370"></a>
     453<a class="indexterm" name="id2568377"></a>
    454454This configuration causes the BDC to register only the name MIDEARTH&lt;1C&gt; with the WINS server. This is
    455455not a problem, as the name MIDEARTH&lt;1C&gt; is a NetBIOS group name that is meant to be registered by more
     
    457457register MIDEARTH&lt;1B&gt;, which is a unique NetBIOS name that is reserved for the PDC.
    458458</p><p>
    459 <a class="indexterm" name="id2574494"></a>
    460 <a class="indexterm" name="id2574501"></a>
    461 <a class="indexterm" name="id2574508"></a>
    462 <a class="indexterm" name="id2574514"></a>
    463 <a class="indexterm" name="id2574521"></a>
    464 <a class="indexterm" name="id2574528"></a>
    465 <a class="indexterm" name="id2574535"></a>
    466 <a class="indexterm" name="id2574542"></a>
    467 <a class="indexterm" name="id2574549"></a>
     459<a class="indexterm" name="id2568409"></a>
     460<a class="indexterm" name="id2568416"></a>
     461<a class="indexterm" name="id2568422"></a>
     462<a class="indexterm" name="id2568429"></a>
     463<a class="indexterm" name="id2568436"></a>
     464<a class="indexterm" name="id2568443"></a>
     465<a class="indexterm" name="id2568450"></a>
     466<a class="indexterm" name="id2568456"></a>
     467<a class="indexterm" name="id2568463"></a>
    468468The <em class="parameter"><code>idmap backend</code></em> will redirect the <code class="literal">winbindd</code> utility to use the LDAP
    469469database to store all mappings for Windows SIDs to  UIDs and GIDs for UNIX accounts in a repository that is
    470470shared. The BDC will however depend on local resolution of UIDs and GIDs via NSS and the
    471471<code class="literal">nss_ldap</code> utility.
    472 </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    473 <a class="indexterm" name="id2574582"></a>
    474 <a class="indexterm" name="id2574591"></a>
    475 <a class="indexterm" name="id2574598"></a>
    476 <a class="indexterm" name="id2574605"></a>
     472</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     473<a class="indexterm" name="id2568496"></a>
     474<a class="indexterm" name="id2568506"></a>
     475<a class="indexterm" name="id2568512"></a>
     476<a class="indexterm" name="id2568519"></a>
    477477Samba-3 has introduced a new ID mapping facility. One of the features of this facility is that it
    478478allows greater flexibility in how user and group IDs are handled in respect to NT domain user and group
     
    482482regarding its behavior.
    483483</p></div><p>
    484 <a class="indexterm" name="id2574642"></a>
    485 <a class="indexterm" name="id2574649"></a>
    486 <a class="indexterm" name="id2574656"></a>
     484<a class="indexterm" name="id2568557"></a>
     485<a class="indexterm" name="id2568563"></a>
     486<a class="indexterm" name="id2568570"></a>
    487487The use of the <a class="link" href="smb.conf.5.html#IDMAPBACKEND" target="_top">idmap backend = ldap:ldap://master.quenya.org</a>
    488488option on a BDC only makes sense where ldapsam is used on a PDC. The purpose of an LDAP-based idmap backend is
     
    490490and groups to common UID/GIDs. In other words, this option is generally intended for use on BDCs and on domain
    491491member servers.
    492 </p></div></div><div class="sect1" title="Common Errors"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2574686"></a>Common Errors</h2></div></div></div><p>
    493 <a class="indexterm" name="id2574694"></a>
     492</p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2568600"></a>Common Errors</h2></div></div></div><p>
     493<a class="indexterm" name="id2568608"></a>
    494494Domain control was a new area for Samba, but there are now many examples that we may refer to.
    495495Updated information will be published as they become available and may be found in later Samba releases or
    496496from the Samba Web <a class="ulink" href="http://samba.org" target="_top">site</a>; refer in particular to the
    497 <code class="filename">WHATSNEW.txt</code> in the Samba release tarball. The book, <span class="quote">&#8220;<span class="quote">Samba-3 by Example</span>&#8221;</span>
     497<code class="filename">WHATSNEW.txt</code> in the Samba release tarball. The book, &#8220;<span class="quote">Samba-3 by Example</span>&#8221;
    498498documents well tested and proven configuration examples. You can obtain a copy of this
    499499<a class="ulink" href="http://www.samba.org/samba/docs/Samba3-ByExample.pdf" target="_top">book</a> for the Samba web site.
    500 </p><div class="sect2" title="Machine Accounts Keep Expiring"><div class="titlepage"><div><div><h3 class="title"><a name="id2574730"></a>Machine Accounts Keep Expiring</h3></div></div></div><p>
    501 <a class="indexterm" name="id2574738"></a>
    502 <a class="indexterm" name="id2574745"></a>
    503 <a class="indexterm" name="id2574752"></a>
    504 <a class="indexterm" name="id2574758"></a>
     500</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2568644"></a>Machine Accounts Keep Expiring</h3></div></div></div><p>
     501<a class="indexterm" name="id2568652"></a>
     502<a class="indexterm" name="id2568659"></a>
     503<a class="indexterm" name="id2568666"></a>
     504<a class="indexterm" name="id2568672"></a>
    505505This problem will occur when the passdb (SAM) files are copied  from a central
    506506server but the local BDC is acting as a PDC. This results in the application of
     
    514514The solution is to use a more robust passdb backend, such as the ldapsam backend, setting up
    515515a slave LDAP server for each BDC and a master LDAP server for the PDC.
    516 </p></div><div class="sect2" title="Can Samba Be a Backup Domain Controller to an NT4 PDC?"><div class="titlepage"><div><div><h3 class="title"><a name="id2574784"></a>Can Samba Be a Backup Domain Controller to an NT4 PDC?</h3></div></div></div><p>
    517 <a class="indexterm" name="id2574793"></a>
    518 <a class="indexterm" name="id2574802"></a>
     516</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2568699"></a>Can Samba Be a Backup Domain Controller to an NT4 PDC?</h3></div></div></div><p>
     517<a class="indexterm" name="id2568707"></a>
     518<a class="indexterm" name="id2568716"></a>
    519519No. The native NT4 SAM replication protocols have not yet been fully implemented.
    520520</p><p>
    521 <a class="indexterm" name="id2574813"></a>
    522 <a class="indexterm" name="id2574820"></a>
    523 <a class="indexterm" name="id2574826"></a>
     521<a class="indexterm" name="id2568728"></a>
     522<a class="indexterm" name="id2568734"></a>
     523<a class="indexterm" name="id2568741"></a>
    524524Can I get the benefits of a BDC with Samba?  Yes, but only to a Samba PDC.The
    525525main reason for implementing a BDC is availability. If the PDC is a Samba
    526526machine, a second Samba machine can be set up to service logon requests whenever
    527527the PDC is down.
    528 </p></div><div class="sect2" title="How Do I Replicate the smbpasswd File?"><div class="titlepage"><div><div><h3 class="title"><a name="id2574840"></a>How Do I Replicate the smbpasswd File?</h3></div></div></div><p>
    529 <a class="indexterm" name="id2574848"></a>
    530 <a class="indexterm" name="id2574857"></a>
    531 <a class="indexterm" name="id2574864"></a>
     528</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2568754"></a>How Do I Replicate the smbpasswd File?</h3></div></div></div><p>
     529<a class="indexterm" name="id2568762"></a>
     530<a class="indexterm" name="id2568771"></a>
     531<a class="indexterm" name="id2568778"></a>
    532532Replication of the smbpasswd file is sensitive. It has to be done whenever changes
    533533to the SAM are made. Every user's password change is done in the smbpasswd file and
    534534has to be replicated to the BDC. So replicating the smbpasswd file very often is necessary.
    535535</p><p>
    536 <a class="indexterm" name="id2574878"></a>
    537 <a class="indexterm" name="id2574885"></a>
    538 <a class="indexterm" name="id2574891"></a>
     536<a class="indexterm" name="id2568792"></a>
     537<a class="indexterm" name="id2568799"></a>
     538<a class="indexterm" name="id2568806"></a>
    539539As the smbpasswd file contains plaintext password equivalents, it must not be
    540540sent unencrypted over the wire. The best way to set up smbpasswd replication from
     
    543543<code class="literal">rsync</code> transfer without requiring the user to type a password.
    544544</p><p>
    545 <a class="indexterm" name="id2574922"></a>
    546 <a class="indexterm" name="id2574929"></a>
     545<a class="indexterm" name="id2568836"></a>
     546<a class="indexterm" name="id2568843"></a>
    547547As said a few times before, use of this method is broken and flawed. Machine trust
    548548accounts will go out of sync, resulting in a broken domain. This method is
    549549<span class="emphasis"><em>not</em></span> recommended. Try using LDAP instead.
    550 </p></div><div class="sect2" title="Can I Do This All with LDAP?"><div class="titlepage"><div><div><h3 class="title"><a name="id2574945"></a>Can I Do This All with LDAP?</h3></div></div></div><p>
    551 <a class="indexterm" name="id2574953"></a>
    552 <a class="indexterm" name="id2574960"></a>
     550</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2568859"></a>Can I Do This All with LDAP?</h3></div></div></div><p>
     551<a class="indexterm" name="id2568867"></a>
     552<a class="indexterm" name="id2568874"></a>
    553553The simple answer is yes. Samba's pdb_ldap code supports binding to a replica
    554554LDAP server and will also follow referrals and rebind to the master if it ever
Note: See TracChangeset for help on using the changeset viewer.