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-ByExample/upgrades.html

    r368 r411  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 8. Updating Samba-3</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-3 by Example"><link rel="up" href="DMSMig.html" title="Part II. Domain Members, Updating Samba and Migration"><link rel="prev" href="unixclients.html" title="Chapter 7. Adding Domain Member Servers and Clients"><link rel="next" href="ntmigration.html" title="Chapter 9. Migrating NT4 Domain to Samba-3"></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 8. Updating Samba-3</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="unixclients.html">Prev</a> </td><th width="60%" align="center">Part II. Domain Members, Updating Samba and Migration</th><td width="20%" align="right"> <a accesskey="n" href="ntmigration.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 8. Updating Samba-3"><div class="titlepage"><div><div><h2 class="title"><a name="upgrades"></a>Chapter 8. Updating Samba-3</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="upgrades.html#id2604185">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2604281">Cautions and Notes</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2605610">Upgrading from Samba 1.x and 2.x to Samba-3</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#sbeug2">Samba 1.9.x and 2.x Versions Without LDAP</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2605979">Applicable to All Samba 2.x to Samba-3 Upgrades</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2606312">Samba-2.x with LDAP Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2606494">Updating a Samba-3 Installation</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2606604">Samba-3 to Samba-3 Updates on the Same Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2606808">Migrating Samba-3 to a New Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2607222">Migration of Samba Accounts to Active Directory</a></span></dt></dl></dd></dl></div><p>
    2 <a class="indexterm" name="id2604100"></a>
    3 <a class="indexterm" name="id2604107"></a>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 8. Updating Samba-3</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-3 by Example"><link rel="up" href="DMSMig.html" title="Part II. Domain Members, Updating Samba and Migration"><link rel="prev" href="unixclients.html" title="Chapter 7. Adding Domain Member Servers and Clients"><link rel="next" href="ntmigration.html" title="Chapter 9. Migrating NT4 Domain to Samba-3"></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 8. Updating Samba-3</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="unixclients.html">Prev</a> </td><th width="60%" align="center">Part II. Domain Members, Updating Samba and Migration</th><td width="20%" align="right"> <a accesskey="n" href="ntmigration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="upgrades"></a>Chapter 8. Updating Samba-3</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="upgrades.html#id2598100">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2598196">Cautions and Notes</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2599525">Upgrading from Samba 1.x and 2.x to Samba-3</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#sbeug2">Samba 1.9.x and 2.x Versions Without LDAP</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2599894">Applicable to All Samba 2.x to Samba-3 Upgrades</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2600227">Samba-2.x with LDAP Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2600409">Updating a Samba-3 Installation</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2600519">Samba-3 to Samba-3 Updates on the Same Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2600723">Migrating Samba-3 to a New Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2601137">Migration of Samba Accounts to Active Directory</a></span></dt></dl></dd></dl></div><p>
     2<a class="indexterm" name="id2598015"></a>
     3<a class="indexterm" name="id2598022"></a>
    44It was a little difficult to select an appropriate title for this chapter.
    55From email messages on the Samba mailing lists it is clear that many people
     
    88installing a new Samba server to replace an older existing Samba server.
    99</p><p>
    10 <a class="indexterm" name="id2604124"></a>
    11 <a class="indexterm" name="id2604130"></a>
     10<a class="indexterm" name="id2598039"></a>
     11<a class="indexterm" name="id2598045"></a>
    1212There has also been much talk about migration of Samba-3 from an smbpasswd
    1313passdb backend to the use of the tdbsam or ldapsam facilities that are new
     
    1818highlighted by an email posting that included the following neat remark:
    1919</p><div class="blockquote"><blockquote class="blockquote"><p>
    20 <a class="indexterm" name="id2604152"></a>
    21 I like the <span class="quote">&#8220;<span class="quote">net rpc vampire</span>&#8221;</span> on NT4, but that to my surprise does
     20<a class="indexterm" name="id2598067"></a>
     21I like the &#8220;<span class="quote">net rpc vampire</span>&#8221; on NT4, but that to my surprise does
    2222not seem to work against a Samba PDC and, if addressed in the Samba to Samba
    2323context in either book, I could not find it.
    2424</p></blockquote></div><p>
    25 <a class="indexterm" name="id2604173"></a>
     25<a class="indexterm" name="id2598088"></a>
    2626So in response to the significant request for these situations to be better
    2727documented, this chapter has now been added. User contributions and documentation
    2828of real-world experiences are a most welcome addition to this chapter.
    29 </p><div class="sect1" title="Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2604185"></a>Introduction</h2></div></div></div><p>
    30 <a class="indexterm" name="id2604193"></a>
    31 <a class="indexterm" name="id2604199"></a>
    32 <a class="indexterm" name="id2604206"></a>
     29</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2598100"></a>Introduction</h2></div></div></div><p>
     30<a class="indexterm" name="id2598108"></a>
     31<a class="indexterm" name="id2598114"></a>
     32<a class="indexterm" name="id2598121"></a>
    3333A Windows network administrator explained in an email what changes he was
    34 planning to make and followed with the question: <span class="quote">&#8220;<span class="quote">Anyone done this
    35 before?</span>&#8221;</span> Many of us have upgraded and updated Samba without incident.
     34planning to make and followed with the question: &#8220;<span class="quote">Anyone done this
     35before?</span>&#8221; Many of us have upgraded and updated Samba without incident.
    3636Others have experienced much pain and user frustration. So it is to be hoped
    3737that the notes in this chapter will make a positive difference by assuring
     
    4444fails to take adequate steps to avoid situations that may inflict lost
    4545productivity on them.
    46 </p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
    47 <a class="indexterm" name="id2604237"></a>
    48 <a class="indexterm" name="id2604244"></a>
     46</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
     47<a class="indexterm" name="id2598152"></a>
     48<a class="indexterm" name="id2598159"></a>
    4949Samba makes it possible to upgrade and update configuration files, but it
    5050is not possible to downgrade the configuration files. Please ensure that
     
    5252in the rare event that this may be necessary.
    5353</p></div><p>
    54 <a class="indexterm" name="id2604259"></a>
    55 <a class="indexterm" name="id2604266"></a>
     54<a class="indexterm" name="id2598174"></a>
     55<a class="indexterm" name="id2598181"></a>
    5656It is prudent also to backup all data files on the server before attempting
    5757to perform a major upgrade. Many administrators have experienced the consequences
     
    6060the precautions taken were inadequate. If a backup was not needed, but was available,
    6161caution was on the side of the victor.
    62 </p><div class="sect2" title="Cautions and Notes"><div class="titlepage"><div><div><h3 class="title"><a name="id2604281"></a>Cautions and Notes</h3></div></div></div><p>
    63         Someone once said, <span class="quote">&#8220;<span class="quote">It is good to be sorry, but better never to need to be!</span>&#8221;</span>
     62</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2598196"></a>Cautions and Notes</h3></div></div></div><p>
     63        Someone once said, &#8220;<span class="quote">It is good to be sorry, but better never to need to be!</span>&#8221;
    6464        These are wise words of advice to those contemplating a Samba upgrade or update.
    6565        </p><p>
    66         <a class="indexterm" name="id2604299"></a>
    67         <a class="indexterm" name="id2604305"></a>
    68         <a class="indexterm" name="id2604312"></a>
     66        <a class="indexterm" name="id2598214"></a>
     67        <a class="indexterm" name="id2598220"></a>
     68        <a class="indexterm" name="id2598227"></a>
    6969        This is as good a time as any to define the terms <code class="constant">upgrade</code> and
    7070        <code class="constant">update</code>. The term <code class="constant">upgrade</code> refers to
     
    7474        is in development.
    7575        </p><p>
    76         <a class="indexterm" name="id2604339"></a>
     76        <a class="indexterm" name="id2598254"></a>
    7777        The term <code class="constant">update</code> refers to a minor version number installation
    7878        in place of one of the same generation. For example, updating from Samba 3.0.10 to 3.0.14
    7979        is an update. The move from Samba 2.0.7 to 3.0.14 is an upgrade.
    8080        </p><p>
    81         <a class="indexterm" name="id2604356"></a>
     81        <a class="indexterm" name="id2598271"></a>
    8282        While the use of these terms is an exercise in semantics, what needs to be realized
    8383        is that there are major functional differences between a Samba 2.x release and a Samba
     
    8787        modified to preserve prior functionality.
    8888        </p><p>
    89         There is an old axiom that says, <span class="quote">&#8220;<span class="quote">The greater the volume of the documentation,
     89        There is an old axiom that says, &#8220;<span class="quote">The greater the volume of the documentation,
    9090        the greater the risk that noone will read it, but where there is no documentation,
    91         noone can read it!</span>&#8221;</span> While true, some documentation is an evil necessity.
     91        noone can read it!</span>&#8221; While true, some documentation is an evil necessity.
    9292        It is hoped that this update to the documentation will avoid both extremes.
    93         </p><div class="sect3" title="Security Identifiers (SIDs)"><div class="titlepage"><div><div><h4 class="title"><a name="id2604385"></a>Security Identifiers (SIDs)</h4></div></div></div><p>
    94         <a class="indexterm" name="id2604393"></a>
    95         <a class="indexterm" name="id2604402"></a>
    96         <a class="indexterm" name="id2604409"></a>
    97         <a class="indexterm" name="id2604416"></a>
    98         <a class="indexterm" name="id2604422"></a>
    99         <a class="indexterm" name="id2604432"></a>
     93        </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2598300"></a>Security Identifiers (SIDs)</h4></div></div></div><p>
     94        <a class="indexterm" name="id2598308"></a>
     95        <a class="indexterm" name="id2598317"></a>
     96        <a class="indexterm" name="id2598324"></a>
     97        <a class="indexterm" name="id2598331"></a>
     98        <a class="indexterm" name="id2598337"></a>
     99        <a class="indexterm" name="id2598346"></a>
    100100        Before the days of Windows NT and OS/2, every Windows and DOS networking client
    101101        that used the SMB protocols was an entirely autonomous entity. There was no concept
     
    105105        Windows NT 3.10.
    106106        </p><p>
    107         <a class="indexterm" name="id2604451"></a>
    108         <a class="indexterm" name="id2604458"></a>
    109         <a class="indexterm" name="id2604465"></a>
    110         <a class="indexterm" name="id2604472"></a>
    111         <a class="indexterm" name="id2604478"></a>
    112         <a class="indexterm" name="id2604485"></a>
     107        <a class="indexterm" name="id2598366"></a>
     108        <a class="indexterm" name="id2598373"></a>
     109        <a class="indexterm" name="id2598380"></a>
     110        <a class="indexterm" name="id2598387"></a>
     111        <a class="indexterm" name="id2598393"></a>
     112        <a class="indexterm" name="id2598400"></a>
    113113        Versions of Samba prior to 1.9 did not make use of a SID. Instead they make exclusive use
    114114        of the username that is embedded in the SessionSetUpAndX component of the connection
    115115        setup process between a Windows client and an SMB/CIFS server.
    116116        </p><p>
    117         <a class="indexterm" name="id2604502"></a>
    118         <a class="indexterm" name="id2604509"></a>
    119         <a class="indexterm" name="id2604515"></a>
     117        <a class="indexterm" name="id2598417"></a>
     118        <a class="indexterm" name="id2598424"></a>
     119        <a class="indexterm" name="id2598430"></a>
    120120        Around November 1997 support was added to Samba-1.9 to handle the Windows security
    121121        RPC-based protocols that implemented support for Samba to store a machine SID. This
    122122        information was stored in a file called <code class="filename">MACHINE.SID.</code>
    123123        </p><p>
    124         <a class="indexterm" name="id2604535"></a>
    125         <a class="indexterm" name="id2604542"></a>
    126         <a class="indexterm" name="id2604548"></a>
     124        <a class="indexterm" name="id2598450"></a>
     125        <a class="indexterm" name="id2598456"></a>
     126        <a class="indexterm" name="id2598463"></a>
    127127        Within the lifetime of the early Samba 2.x series, the machine SID information was
    128128        relocated into a tdb file called <code class="filename">secrets.tdb</code>, which is where
     
    130130        local machine and its role within a domain security context.
    131131        </p><p>
    132         <a class="indexterm" name="id2604569"></a>
    133         <a class="indexterm" name="id2604578"></a>
    134         <a class="indexterm" name="id2604587"></a>
    135         <a class="indexterm" name="id2604594"></a>
     132        <a class="indexterm" name="id2598484"></a>
     133        <a class="indexterm" name="id2598493"></a>
     134        <a class="indexterm" name="id2598502"></a>
     135        <a class="indexterm" name="id2598509"></a>
    136136        There are two types of SID, those pertaining to the machine itself and the domain to
    137137        which it may belong, and those pertaining to users and groups within the security
     
    139139        servers (DMS).
    140140        </p><p>
    141         <a class="indexterm" name="id2604608"></a>
    142         <a class="indexterm" name="id2604615"></a>
    143         <a class="indexterm" name="id2604622"></a>
    144         <a class="indexterm" name="id2604629"></a>
    145         <a class="indexterm" name="id2604636"></a>
    146         <a class="indexterm" name="id2604642"></a>
     141        <a class="indexterm" name="id2598523"></a>
     142        <a class="indexterm" name="id2598530"></a>
     143        <a class="indexterm" name="id2598537"></a>
     144        <a class="indexterm" name="id2598544"></a>
     145        <a class="indexterm" name="id2598551"></a>
     146        <a class="indexterm" name="id2598557"></a>
    147147        When the Samba <code class="literal">smbd</code> daemon is first started, if the <code class="filename">secrets.tdb</code>
    148148        file does not exist, it is created at the first client connection attempt. If this file does
     
    154154        (hostname) and domain name (workgroup), it will be different.
    155155        </p><p>
    156         <a class="indexterm" name="id2604692"></a>
     156        <a class="indexterm" name="id2598607"></a>
    157157        The SID is the key used by MS Windows networking for all networking operations. This means
    158158        that when the machine or domain SID changes, all security-encoded objects such as profiles
    159159        and ACLs may become unusable.
    160         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     160        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    161161        It is of paramount importance that the machine and domain SID be backed up so that in
    162162        the event of a change of hostname (machine name) or domain name (workgroup) the SID can
    163163        be restored to its previous value.
    164164        </p></div><p>
    165         <a class="indexterm" name="id2604713"></a>
    166         <a class="indexterm" name="id2604720"></a>
    167         <a class="indexterm" name="id2604727"></a>
    168         <a class="indexterm" name="id2604733"></a>
    169         <a class="indexterm" name="id2604740"></a>
    170         <a class="indexterm" name="id2604747"></a>
    171         <a class="indexterm" name="id2604754"></a>
    172         <a class="indexterm" name="id2604761"></a>
    173         <a class="indexterm" name="id2604768"></a>
    174         <a class="indexterm" name="id2604774"></a>
     165        <a class="indexterm" name="id2598628"></a>
     166        <a class="indexterm" name="id2598635"></a>
     167        <a class="indexterm" name="id2598642"></a>
     168        <a class="indexterm" name="id2598648"></a>
     169        <a class="indexterm" name="id2598655"></a>
     170        <a class="indexterm" name="id2598662"></a>
     171        <a class="indexterm" name="id2598669"></a>
     172        <a class="indexterm" name="id2598676"></a>
     173        <a class="indexterm" name="id2598683"></a>
     174        <a class="indexterm" name="id2598689"></a>
    175175        In Samba-3 on a domain controller (PDC or BDC), the domain name controls the domain
    176176        SID. On all prior versions the hostname (computer name, or NetBIOS name) controlled
    177177        the SID. On a standalone server the hostname still controls the SID.
    178178        </p><p>
    179         <a class="indexterm" name="id2604788"></a>
    180         <a class="indexterm" name="id2604797"></a>
     179        <a class="indexterm" name="id2598703"></a>
     180        <a class="indexterm" name="id2598712"></a>
    181181        The local machine SID can be backed up using this procedure (Samba-3):
    182182</p><pre class="screen">
     
    201201        This is not a reversible process  it is a one-way upgrade.
    202202        </p><p>
    203         <a class="indexterm" name="id2604886"></a>
     203        <a class="indexterm" name="id2598801"></a>
    204204        In the course of the Samba 2.0.x series the <code class="literal">smbpasswd</code> was modified to
    205205        permit the domain SID to be captured to the <code class="filename">secrets.tdb</code> file by executing:
     
    218218</pre><p>
    219219        </p><p>
    220         <a class="indexterm" name="id2604959"></a>
    221         <a class="indexterm" name="id2604966"></a>
     220        <a class="indexterm" name="id2598874"></a>
     221        <a class="indexterm" name="id2598881"></a>
    222222        Domain security information, which includes the domain SID, can be obtained from Samba-2.2.x
    223223        systems by executing:
     
    238238        case it is ever needed at a later date.
    239239        </p><p>
    240         <a class="indexterm" name="id2605013"></a>
    241         <a class="indexterm" name="id2605020"></a>
    242         <a class="indexterm" name="id2605026"></a>
     240        <a class="indexterm" name="id2598928"></a>
     241        <a class="indexterm" name="id2598935"></a>
     242        <a class="indexterm" name="id2598941"></a>
    243243        Take note that the domain SID is used extensively in Samba. Where LDAP is used for the
    244244        <em class="parameter"><code>passdb backend</code></em>, all user, group, and trust accounts are encoded
     
    251251</pre><p>
    252252        </p><p>
    253         <a class="indexterm" name="id2605062"></a>
    254         <a class="indexterm" name="id2605069"></a>
    255         <a class="indexterm" name="id2605076"></a>
     253        <a class="indexterm" name="id2598977"></a>
     254        <a class="indexterm" name="id2598984"></a>
     255        <a class="indexterm" name="id2598991"></a>
    256256        When the domain SID has changed, roaming profiles cease to be functional. The recovery
    257257        of roaming profiles necessitates resetting of the domain portion of the user SID
     
    262262        addressed to the creator of the RPM package. The Samba Team do their best to make
    263263        available all the tools needed to manage a Samba-based Windows networking environment.
    264         </p></div><div class="sect3" title="Change of hostname"><div class="titlepage"><div><div><h4 class="title"><a name="id2605113"></a>Change of hostname</h4></div></div></div><p>
    265         <a class="indexterm" name="id2605121"></a>
    266         <a class="indexterm" name="id2605130"></a>
     264        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2599028"></a>Change of hostname</h4></div></div></div><p>
     265        <a class="indexterm" name="id2599036"></a>
     266        <a class="indexterm" name="id2599045"></a>
    267267        Samba uses two methods by which the primary NetBIOS machine name (also known as a computer
    268268        name or the hostname) may be determined: If the <code class="filename">smb.conf</code> file contains a
     
    274274        SID to be generated. If this happens on a domain controller, it will also change the
    275275        domain SID. These SIDs can be updated (restored) using the procedure outlined previously.
    276         </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     276        </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    277277        Do NOT change the hostname or the <em class="parameter"><code>netbios name</code></em>. If this
    278278        is changed, be sure to reset the machine SID to the original setting. Otherwise
    279279        there may be serious interoperability and/or operational problems.
    280         </p></div></div><div class="sect3" title="Change of Workgroup (Domain) Name"><div class="titlepage"><div><div><h4 class="title"><a name="id2605179"></a>Change of Workgroup (Domain) Name</h4></div></div></div><p>
    281         <a class="indexterm" name="id2605187"></a>
     280        </p></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2599094"></a>Change of Workgroup (Domain) Name</h4></div></div></div><p>
     281        <a class="indexterm" name="id2599102"></a>
    282282        The domain name of a Samba server is identical to the workgroup name and is
    283283        set in the <code class="filename">smb.conf</code> file using the <em class="parameter"><code>workgroup</code></em> parameter.
    284284        This has been consistent throughout the history of Samba and across all versions.
    285285        </p><p>
    286         <a class="indexterm" name="id2605212"></a>
     286        <a class="indexterm" name="id2599127"></a>
    287287        Be aware that when the workgroup name is changed, a new SID will be generated.
    288288        The old domain SID can be reset using the procedure outlined earlier in this chapter.
    289         </p></div><div class="sect3" title="Location of config files"><div class="titlepage"><div><div><h4 class="title"><a name="sbeug1"></a>Location of config files</h4></div></div></div><p>
     289        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="sbeug1"></a>Location of config files</h4></div></div></div><p>
    290290        The Samba-Team has maintained a constant default location for all Samba control files
    291291        throughout the life of the project. People who have produced binary packages of Samba
     
    293293        for network administrators.
    294294        </p><p>
    295         <a class="indexterm" name="id2605243"></a>
     295        <a class="indexterm" name="id2599158"></a>
    296296        The Samba 1.9.x <code class="filename">smb.conf</code> file may be found either in the <code class="filename">/etc</code>
    297297        directory or in <code class="filename">/usr/local/samba/lib</code>.
     
    301301        remains located also for Samba 3.0.x installations.
    302302        </p><p>
    303         <a class="indexterm" name="id2605290"></a>
     303        <a class="indexterm" name="id2599205"></a>
    304304        Samba 2.x introduced the <code class="filename">secrets.tdb</code> file that is also stored in the
    305305        <code class="filename">/etc/samba</code> directory, or in the <code class="filename">/usr/local/samba/lib</code>
    306306        directory subsystem.
    307307        </p><p>
    308         <a class="indexterm" name="id2605320"></a>
     308        <a class="indexterm" name="id2599234"></a>
    309309        The location at which <code class="literal">smbd</code> expects to find all configuration and control
    310310        files is determined at the time of compilation of Samba. For versions of Samba prior to
     
    318318        <code class="filename">/usr/local/samba/sbin</code>.
    319319        </p><p>
    320         <a class="indexterm" name="id2605378"></a>
     320        <a class="indexterm" name="id2599292"></a>
    321321        Samba-3 provides a neat new way to track the location of all control files as well as to
    322322        find the compile-time options used as the Samba package was built. Here  is how the dark
     
    349349</pre><p>
    350350        </p><p>
    351         <a class="indexterm" name="id2605415"></a>
     351        <a class="indexterm" name="id2599330"></a>
    352352        It is important that both the <code class="filename">smb.conf</code> file and the <code class="filename">secrets.tdb</code>
    353353        be backed up before attempting any upgrade. The <code class="filename">secrets.tdb</code> file
     
    355355        of Samba. A backup means that it is always possible to revert a failed or problematic
    356356        upgrade.
    357         </p></div><div class="sect3" title="International Language Support"><div class="titlepage"><div><div><h4 class="title"><a name="id2605445"></a>International Language Support</h4></div></div></div><p>
    358         <a class="indexterm" name="id2605453"></a>
    359         <a class="indexterm" name="id2605460"></a>
    360         <a class="indexterm" name="id2605467"></a>
    361         <a class="indexterm" name="id2605474"></a>
     357        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2599360"></a>International Language Support</h4></div></div></div><p>
     358        <a class="indexterm" name="id2599368"></a>
     359        <a class="indexterm" name="id2599375"></a>
     360        <a class="indexterm" name="id2599382"></a>
     361        <a class="indexterm" name="id2599388"></a>
    362362        Samba-2.x had no support for Unicode; instead, all national language character-set support in file names
    363363        was done using particular locale codepage mapping techniques. Samba-3 supports Unicode in file names, thus
    364364        providing true internationalization support.
    365365        </p><p>
    366         <a class="indexterm" name="id2605488"></a>
     366        <a class="indexterm" name="id2599403"></a>
    367367        Non-English users whose national language character set has special characters and who upgrade naively will
    368368        find that many files that have the special characters in the file name will see them garbled and jumbled up.
     
    370370        that was in use with Samba-2.x using an 8-bit encoding scheme.
    371371        </p><p>
    372         <a class="indexterm" name="id2605505"></a>
     372        <a class="indexterm" name="id2599420"></a>
    373373        Files that are created with Samba-3 will use UTF-8 encoding. Should the file system ever end up with a
    374374        mix of codepage (unix charset)-encoded file names and UTF-8-encoded file names, the mess will take some
    375375        effort to set straight.
    376376        </p><p>
    377         <a class="indexterm" name="id2605519"></a>
     377        <a class="indexterm" name="id2599434"></a>
    378378        A very helpful tool is available from Bjorn Jacke's <a class="ulink" href="http://j3e.de/linux/convmv/" target="_top">convmv</a>
    379379        work. Convmv is a tool that can be used to convert file and directory names from one encoding method to
    380380        another. The most common use for this tool is to convert locale-encoded files to UTF-8 Unicode encoding.
    381         </p></div><div class="sect3" title="Updates and Changes in Idealx smbldap-tools"><div class="titlepage"><div><div><h4 class="title"><a name="id2605539"></a>Updates and Changes in Idealx smbldap-tools</h4></div></div></div><p>
     381        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2599454"></a>Updates and Changes in Idealx smbldap-tools</h4></div></div></div><p>
    382382        The smbldap-tools have been maturing rapidly over the past year. With maturation comes change.
    383383        The location of the <code class="filename">smbldap.conf</code> and the <code class="filename">smbldap_bind.conf</code>
     
    393393        current release should note that the information stored under <code class="constant">NextFreeUnixId</code>
    394394        must now be relocated to the DIT object <code class="constant">sambaDomainName</code>.
    395         </p></div></div></div><div class="sect1" title="Upgrading from Samba 1.x and 2.x to Samba-3"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2605610"></a>Upgrading from Samba 1.x and 2.x to Samba-3</h2></div></div></div><p>
     395        </p></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2599525"></a>Upgrading from Samba 1.x and 2.x to Samba-3</h2></div></div></div><p>
    396396Sites that are being upgraded from Samba-2 (or earlier versions) to Samba-3
    397397may experience little difficulty or may require a lot of effort, depending
     
    403403does not use LDAP, the other does. Samba-1.9.x did not provide LDAP support.
    404404Samba-2.x could be compiled with LDAP support.
    405 </p><div class="sect2" title="Samba 1.9.x and 2.x Versions Without LDAP"><div class="titlepage"><div><div><h3 class="title"><a name="sbeug2"></a>Samba 1.9.x and 2.x Versions Without LDAP</h3></div></div></div><p>
     405</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="sbeug2"></a>Samba 1.9.x and 2.x Versions Without LDAP</h3></div></div></div><p>
    406406        Where it is necessary to upgrade an old Samba installation to Samba-3,
    407407        the following procedure can be followed:
    408         </p><div class="procedure" title="Procedure 8.1. Upgrading from a Pre-Samba-3 Version"><a name="id2605648"></a><p class="title"><b>Procedure 8.1. Upgrading from a Pre-Samba-3 Version</b></p><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
    409                 <a class="indexterm" name="id2605659"></a>
    410                 <a class="indexterm" name="id2605666"></a>
    411                 <a class="indexterm" name="id2605673"></a>
     408        </p><div class="procedure"><a name="id2599563"></a><p class="title"><b>Procedure 8.1. Upgrading from a Pre-Samba-3 Version</b></p><ol type="1"><li><p>
     409                <a class="indexterm" name="id2599574"></a>
     410                <a class="indexterm" name="id2599581"></a>
     411                <a class="indexterm" name="id2599588"></a>
    412412                Stop Samba. This can be done using the appropriate system tool
    413413                that is particular for each operating system or by executing the
    414414                <code class="literal">kill</code> command on <code class="literal">smbd</code>,
    415415                <code class="literal">nmbd</code>, and <code class="literal">winbindd</code>.
    416                 </p></li><li class="step" title="Step 2"><p>
     416                </p></li><li><p>
    417417                Find the location of the Samba <code class="filename">smb.conf</code> file and back it up to a
    418418                safe location.
    419                 </p></li><li class="step" title="Step 3"><p>
     419                </p></li><li><p>
    420420                Find the location of the <code class="filename">smbpasswd</code> file and
    421421                back it up to a safe location.
    422                 </p></li><li class="step" title="Step 4"><p>
     422                </p></li><li><p>
    423423                Find the location of the <code class="filename">secrets.tdb</code> file and
    424424                back it up to a safe location.
    425                 </p></li><li class="step" title="Step 5"><p>
    426                 <a class="indexterm" name="id2605754"></a>
    427                 <a class="indexterm" name="id2605761"></a>
    428                 <a class="indexterm" name="id2605768"></a>
    429                 <a class="indexterm" name="id2605775"></a>
     425                </p></li><li><p>
     426                <a class="indexterm" name="id2599669"></a>
     427                <a class="indexterm" name="id2599676"></a>
     428                <a class="indexterm" name="id2599683"></a>
     429                <a class="indexterm" name="id2599690"></a>
    430430                Find the location of the lock directory. This is the directory
    431431                in which Samba stores all its tdb control files. The default
     
    437437                <code class="filename">/var/lib/samba</code> directory. Copy all the
    438438                tdb files to a safe location.
    439                 </p></li><li class="step" title="Step 6"><p>
    440                 <a class="indexterm" name="id2605814"></a>
     439                </p></li><li><p>
     440                <a class="indexterm" name="id2599728"></a>
    441441                It is now safe to upgrade the Samba installation. On Linux systems
    442442                it is not necessary to remove the Samba RPMs because a simple
     
    447447                move it out of the way by renaming the directories that contain the
    448448                Samba binary files.
    449                 </p></li><li class="step" title="Step 7"><p>
     449                </p></li><li><p>
    450450                When the Samba upgrade has been installed, the first step that should
    451451                be completed is to identify the new target locations for the control
    452452                files. Follow the steps shown in <a class="link" href="upgrades.html#sbeug1" title="Location of config files">&#8220;Location of config files&#8221;</a> to locate
    453453                the correct directories to which each control file must be moved.
    454                 </p></li><li class="step" title="Step 8"><p>
     454                </p></li><li><p>
    455455                Do not change the hostname.
    456                 </p></li><li class="step" title="Step 9"><p>
     456                </p></li><li><p>
    457457                Do not change the workgroup name.
    458                 </p></li><li class="step" title="Step 10"><p>
    459                 <a class="indexterm" name="id2605869"></a>
     458                </p></li><li><p>
     459                <a class="indexterm" name="id2599784"></a>
    460460                Execute the <code class="literal">testparm</code> to validate the <code class="filename">smb.conf</code> file.
    461461                This process will flag any parameters that are no longer supported.
     
    469469<code class="prompt">root# </code> testparm -s smb.conf.master &gt; smb.conf
    470470</pre><p>
    471         <a class="indexterm" name="id2605926"></a>
     471        <a class="indexterm" name="id2599841"></a>
    472472                The resulting <code class="filename">smb.conf</code> file will be stripped of all comments
    473473                and of all nonconforming configuration settings.
    474                 </p></li><li class="step" title="Step 11"><p>
    475                 <a class="indexterm" name="id2605948"></a>
     474                </p></li><li><p>
     475                <a class="indexterm" name="id2599863"></a>
    476476                It is now safe to start Samba using the appropriate system tool.
    477477                Alternately, it is possible to just execute <code class="literal">nmbd</code>,
    478478                <code class="literal">smbd</code>, and <code class="literal">winbindd</code> for the command
    479479                line while logged in as the root user.
    480                 </p></li></ol></div></div><div class="sect2" title="Applicable to All Samba 2.x to Samba-3 Upgrades"><div class="titlepage"><div><div><h3 class="title"><a name="id2605979"></a>Applicable to All Samba 2.x to Samba-3 Upgrades</h3></div></div></div><p>
    481         <a class="indexterm" name="id2605987"></a>
    482         <a class="indexterm" name="id2605994"></a>
    483         <a class="indexterm" name="id2606000"></a>
     480                </p></li></ol></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2599894"></a>Applicable to All Samba 2.x to Samba-3 Upgrades</h3></div></div></div><p>
     481        <a class="indexterm" name="id2599902"></a>
     482        <a class="indexterm" name="id2599908"></a>
     483        <a class="indexterm" name="id2599915"></a>
    484484        Samba 2.x servers that were running as a domain controller (PDC)
    485485        require changes to the configuration of the scripting interface
     
    487487        users, groups, and trust accounts (machines and interdomain).
    488488        </p><p>
    489         <a class="indexterm" name="id2606015"></a>
     489        <a class="indexterm" name="id2599930"></a>
    490490        The following parameters are new to Samba-3 and should be correctly configured.
    491491        Please refer to <a class="link" href="secure.html" title="Chapter 3. Secure Office Networking">&#8220;Secure Office Networking&#8221;</a> through <a class="link" href="2000users.html" title="Chapter 6. A Distributed 2000-User Network">&#8220;A Distributed 2000-User Network&#8221;</a>
    492492        in this book for examples of use of the new parameters shown here:
    493         <a class="indexterm" name="id2606036"></a>
    494         <a class="indexterm" name="id2606043"></a>
    495         <a class="indexterm" name="id2606050"></a>
    496         <a class="indexterm" name="id2606057"></a>
    497         <a class="indexterm" name="id2606064"></a>
    498         <a class="indexterm" name="id2606071"></a>
    499         <a class="indexterm" name="id2606078"></a>
    500         </p><p>
    501         </p><table border="0" summary="Simple list" class="simplelist"><tr><td><p>add group script</p></td></tr><tr><td><p>add machine script</p></td></tr><tr><td><p>add user to group script</p></td></tr><tr><td><p>delete group script</p></td></tr><tr><td><p>delete user from group script</p></td></tr><tr><td><p>passdb backend</p></td></tr><tr><td><p>set primary group script</p></td></tr></table><p>
    502         </p><p>
    503         <a class="indexterm" name="id2606130"></a>
    504         <a class="indexterm" name="id2606137"></a>
     493        <a class="indexterm" name="id2599951"></a>
     494        <a class="indexterm" name="id2599958"></a>
     495        <a class="indexterm" name="id2599964"></a>
     496        <a class="indexterm" name="id2599972"></a>
     497        <a class="indexterm" name="id2599978"></a>
     498        <a class="indexterm" name="id2599986"></a>
     499        <a class="indexterm" name="id2599993"></a>
     500        </p><p>
     501        </p><table class="simplelist" border="0" summary="Simple list"><tr><td><p>add group script</p></td></tr><tr><td><p>add machine script</p></td></tr><tr><td><p>add user to group script</p></td></tr><tr><td><p>delete group script</p></td></tr><tr><td><p>delete user from group script</p></td></tr><tr><td><p>passdb backend</p></td></tr><tr><td><p>set primary group script</p></td></tr></table><p>
     502        </p><p>
     503        <a class="indexterm" name="id2600045"></a>
     504        <a class="indexterm" name="id2600052"></a>
    505505        The <em class="parameter"><code>add machine script</code></em> functionality was previously
    506506        handled by the <em class="parameter"><code>add user script</code></em>, which in Samba-3 is
    507507        used exclusively to add user accounts.
    508508        </p><p>
    509         <a class="indexterm" name="id2606161"></a>
    510         <a class="indexterm" name="id2606168"></a>
    511         <a class="indexterm" name="id2606175"></a>
    512         <a class="indexterm" name="id2606182"></a>
    513         <a class="indexterm" name="id2606188"></a>
    514         <a class="indexterm" name="id2606195"></a>
    515         <a class="indexterm" name="id2606202"></a>
    516         <a class="indexterm" name="id2606209"></a>
    517         <a class="indexterm" name="id2606216"></a>
     509        <a class="indexterm" name="id2600076"></a>
     510        <a class="indexterm" name="id2600083"></a>
     511        <a class="indexterm" name="id2600090"></a>
     512        <a class="indexterm" name="id2600096"></a>
     513        <a class="indexterm" name="id2600103"></a>
     514        <a class="indexterm" name="id2600110"></a>
     515        <a class="indexterm" name="id2600117"></a>
     516        <a class="indexterm" name="id2600124"></a>
     517        <a class="indexterm" name="id2600130"></a>
    518518        Where the <em class="parameter"><code>passdb backend</code></em> used is either <code class="constant">smbpasswd</code>
    519519        (the default) or the new <code class="constant">tdbsam</code>, the system interface scripts
     
    522522        <code class="literal">groupmod</code>, <code class="literal">groupdel</code>, and so on.
    523523        </p><p>
    524         <a class="indexterm" name="id2606276"></a>
    525         <a class="indexterm" name="id2606283"></a>
    526         <a class="indexterm" name="id2606290"></a>
     524        <a class="indexterm" name="id2600191"></a>
     525        <a class="indexterm" name="id2600198"></a>
     526        <a class="indexterm" name="id2600205"></a>
    527527        Where the <em class="parameter"><code>passdb backend</code></em> makes use of an LDAP directory,
    528528        it is necessary either to use the <code class="constant">smbldap-tools</code> provided
    529529        by Idealx or to use an alternate toolset provided by a third
    530530        party or else home-crafted to manage the LDAP directory accounts.
    531         </p></div><div class="sect2" title="Samba-2.x with LDAP Support"><div class="titlepage"><div><div><h3 class="title"><a name="id2606312"></a>Samba-2.x with LDAP Support</h3></div></div></div><p>
     531        </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2600227"></a>Samba-2.x with LDAP Support</h3></div></div></div><p>
    532532        Samba version 2.x could be compiled for use either with or without LDAP.
    533533        The LDAP control settings in the <code class="filename">smb.conf</code> file in this old version are
     
    539539        of all files to the correct locations.
    540540        </p><p>
    541         <a class="indexterm" name="id2606347"></a>
    542         <a class="indexterm" name="id2606353"></a>
     541        <a class="indexterm" name="id2600262"></a>
     542        <a class="indexterm" name="id2600268"></a>
    543543        The Samba SAM schema required for Samba-3 is significantly different from that
    544544        used with Samba 2.x. This means that the LDAP directory must be updated
     
    695695the DN's with quotation marks.
    696696</pre><p>
    697         </p></div></div><div class="sect1" title="Updating a Samba-3 Installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2606494"></a>Updating a Samba-3 Installation</h2></div></div></div><p>
     697        </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2600409"></a>Updating a Samba-3 Installation</h2></div></div></div><p>
    698698The key concern in this section is to deal with the changes that have been
    699699affected in Samba-3 between the Samba-3.0.0 release and the current update.
     
    701701taken to update Samba-3 versions.
    702702</p><p>
    703 <a class="indexterm" name="id2606510"></a>
     703<a class="indexterm" name="id2600425"></a>
    704704The information in <a class="link" href="upgrades.html#sbeug1" title="Location of config files">&#8220;Location of config files&#8221;</a> would not be necessary if every
    705705person who has ever produced Samba executable (binary) files could agree on
     
    707707Clearly, such agreement is further away than a pipedream.
    708708</p><p>
    709 <a class="indexterm" name="id2606536"></a>
     709<a class="indexterm" name="id2600451"></a>
    710710Vendors and packagers who produce Samba binary installable packages do not,
    711711as a rule, use the default paths used by the Samba-Team for the location of
     
    720720effect.
    721721</p><p>
    722 <a class="indexterm" name="id2606569"></a>
     722<a class="indexterm" name="id2600484"></a>
    723723The best advice for those lacking in code compilation experience is to use
    724724only vendor (or Samba-Team) provided binary packages. The Samba packages
     
    726726that are compatible with the original OS vendor's practices.
    727727</p><p>
    728 <a class="indexterm" name="id2606584"></a>
    729 <a class="indexterm" name="id2606591"></a>
     728<a class="indexterm" name="id2600499"></a>
     729<a class="indexterm" name="id2600506"></a>
    730730If you are not sure whether a binary package complies with the OS
    731731vendor's practices, it is better to ask the package maintainer via
     
    733733Alternately, just diagnose the paths specified by the binary files following
    734734the procedure outlined above.
    735 </p><div class="sect2" title="Samba-3 to Samba-3 Updates on the Same Server"><div class="titlepage"><div><div><h3 class="title"><a name="id2606604"></a>Samba-3 to Samba-3 Updates on the Same Server</h3></div></div></div><p>
     735</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2600519"></a>Samba-3 to Samba-3 Updates on the Same Server</h3></div></div></div><p>
    736736        The guidance in this section deals with updates to an existing
    737737        Samba-3 server installation.
    738         </p><div class="sect3" title="Updating from Samba Versions Earlier than 3.0.5"><div class="titlepage"><div><div><h4 class="title"><a name="id2606616"></a>Updating from Samba Versions Earlier than 3.0.5</h4></div></div></div><p>
     738        </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600530"></a>Updating from Samba Versions Earlier than 3.0.5</h4></div></div></div><p>
    739739        With the provision that the binary Samba-3 package has been built
    740740        with the same path and feature settings as the existing Samba-3
     
    743743        and without need to change either the <code class="filename">smb.conf</code> file or, where
    744744        used, the LDAP schema.
    745         </p></div><div class="sect3" title="Updating from Samba Versions between 3.0.6 and 3.0.10"><div class="titlepage"><div><div><h4 class="title"><a name="id2606638"></a>Updating from Samba Versions between 3.0.6 and 3.0.10</h4></div></div></div><p>
    746         <a class="indexterm" name="id2606646"></a>
    747         <a class="indexterm" name="id2606653"></a>
     745        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600553"></a>Updating from Samba Versions between 3.0.6 and 3.0.10</h4></div></div></div><p>
     746        <a class="indexterm" name="id2600561"></a>
     747        <a class="indexterm" name="id2600568"></a>
    748748        When updating versions of Samba-3 prior to 3.0.6 to 3.0.6 through 3.0.10,
    749749        it is necessary only to update the LDAP schema (where LDAP is used).
     
    751751        update.
    752752        </p><p>
    753         <a class="indexterm" name="id2606670"></a>
    754         <a class="indexterm" name="id2606676"></a>
    755         <a class="indexterm" name="id2606683"></a>
     753        <a class="indexterm" name="id2600585"></a>
     754        <a class="indexterm" name="id2600591"></a>
     755        <a class="indexterm" name="id2600598"></a>
    756756        Samba-3.0.6 introduced the ability to remember the last <span class="emphasis"><em>n</em></span> number
    757757        of passwords a user has used. This information will work only with
     
    760760        </p><p>
    761761        After updating the LDAP schema, do not forget to re-index the LDAP database.
    762         </p></div><div class="sect3" title="Updating from Samba Versions after 3.0.6 to a Current Release"><div class="titlepage"><div><div><h4 class="title"><a name="id2606717"></a>Updating from Samba Versions after 3.0.6 to a Current Release</h4></div></div></div><p>
    763         <a class="indexterm" name="id2606725"></a>
     762        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600632"></a>Updating from Samba Versions after 3.0.6 to a Current Release</h4></div></div></div><p>
     763        <a class="indexterm" name="id2600640"></a>
    764764        Samba-3.0.8 introduced changes in how the <em class="parameter"><code>username map</code></em>
    765765        behaves. It also included a change in behavior of <code class="literal">winbindd</code>.
     
    767767        from versions prior to 3.0.8 to a current version.
    768768        </p><p>
    769         <a class="indexterm" name="id2606757"></a>
     769        <a class="indexterm" name="id2600672"></a>
    770770        In Samba-3.0.11 a new privileges interface was implemented. Please
    771771        refer to <a class="link" href="happy.html#sbehap-ppc" title="Addition of Machines to the Domain">&#8220;Addition of Machines to the Domain&#8221;</a> for information regarding this new
     
    789789back to searching the 'ldap suffix' in some cases.
    790790</pre><p>
    791         </p></div></div><div class="sect2" title="Migrating Samba-3 to a New Server"><div class="titlepage"><div><div><h3 class="title"><a name="id2606808"></a>Migrating Samba-3 to a New Server</h3></div></div></div><p>
     791        </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2600723"></a>Migrating Samba-3 to a New Server</h3></div></div></div><p>
    792792        The two most likely candidates for replacement of a server are
    793793        domain member servers and domain controllers. Each needs to be
    794794        handled slightly differently.
    795         </p><div class="sect3" title="Replacing a Domain Member Server"><div class="titlepage"><div><div><h4 class="title"><a name="id2606820"></a>Replacing a Domain Member Server</h4></div></div></div><p>
    796         <a class="indexterm" name="id2606828"></a>
     795        </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600735"></a>Replacing a Domain Member Server</h4></div></div></div><p>
     796        <a class="indexterm" name="id2600743"></a>
    797797        Replacement of a domain member server should be done
    798798        using the same procedure as outlined in <a class="link" href="unixclients.html" title="Chapter 7. Adding Domain Member Servers and Clients">&#8220;Adding Domain Member Servers and Clients&#8221;</a>.
     
    803803        change its SID and will necessitate rejoining to the domain.
    804804        </p><p>
    805         <a class="indexterm" name="id2606854"></a>
    806         <a class="indexterm" name="id2606860"></a>
    807         <a class="indexterm" name="id2606867"></a>
    808         <a class="indexterm" name="id2606874"></a>
    809         <a class="indexterm" name="id2606880"></a>
    810         <a class="indexterm" name="id2606887"></a>
     805        <a class="indexterm" name="id2600768"></a>
     806        <a class="indexterm" name="id2600775"></a>
     807        <a class="indexterm" name="id2600782"></a>
     808        <a class="indexterm" name="id2600789"></a>
     809        <a class="indexterm" name="id2600795"></a>
     810        <a class="indexterm" name="id2600802"></a>
    811811        Following a change of hostname (NetBIOS name) it is a good idea on all servers
    812812        to shut down the Samba <code class="literal">smbd</code>, <code class="literal">nmbd</code>, and
     
    818818        change, but can persist for a longer period of time.
    819819        </p><p>
    820         <a class="indexterm" name="id2606935"></a>
    821         <a class="indexterm" name="id2606941"></a>
    822         <a class="indexterm" name="id2606948"></a>
    823         <a class="indexterm" name="id2606955"></a>
     820        <a class="indexterm" name="id2600850"></a>
     821        <a class="indexterm" name="id2600856"></a>
     822        <a class="indexterm" name="id2600863"></a>
     823        <a class="indexterm" name="id2600870"></a>
    824824        If the old domain member server had local accounts, it is necessary to create
    825825        on the new domain member server the same accounts with the same UID and GID
     
    832832        account entries to the new target server.
    833833        </p><p>
    834         <a class="indexterm" name="id2607003"></a>
     834        <a class="indexterm" name="id2600918"></a>
    835835        Where the user accounts for both UNIX and Samba are stored in LDAP, the new
    836836        target server must be configured to use the <code class="literal">nss_ldap</code> tool set.
    837837        This will automatically ensure that the appropriate user entities are
    838838        available on the new server.
    839         </p></div><div class="sect3" title="Replacing a Domain Controller"><div class="titlepage"><div><div><h4 class="title"><a name="id2607022"></a>Replacing a Domain Controller</h4></div></div></div><p>
    840         <a class="indexterm" name="id2607030"></a>
     839        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600937"></a>Replacing a Domain Controller</h4></div></div></div><p>
     840        <a class="indexterm" name="id2600945"></a>
    841841        In the past, people who replaced a Windows NT4 domain controller typically
    842842        installed a new server, created printers and file shares on it, then migrate across
     
    848848        the same name as the old one. In this case, simply follow the same process
    849849        as for upgrading a Samba 2.x system and do the following:
    850         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     850        </p><div class="itemizedlist"><ul type="disc"><li><p>
    851851                Where UNIX (POSIX) user and group accounts are stored in the system
    852852                <code class="filename">/etc/passwd</code>, <code class="filename">/etc/shadow</code>, and
     
    863863                the <code class="literal">nss_ldap</code> tool and the <code class="filename">/etc/nsswitch.conf</code>
    864864                (as shown in <a class="link" href="happy.html" title="Chapter 5. Making Happy Users">&#8220;Making Happy Users&#8221;</a>).
    865                 </p></li><li class="listitem"><p>
     865                </p></li><li><p>
    866866                Copy the <code class="filename">smb.conf</code> file from the old server to the new server into the correct
    867867                location as indicated previously in this chapter.
    868                 </p></li><li class="listitem"><p>
     868                </p></li><li><p>
    869869                Copy the <code class="filename">secrets.tdb</code> file, the <code class="filename">smbpasswd</code>
    870870                file (if it is used), the <code class="filename">/etc/samba/passdb.tdb</code> file (only
    871871                used by the <code class="constant">tdbsam</code> backend), and all the tdb control files
    872872                from the old system to the correct location on the new system.
    873                 </p></li><li class="listitem"><p>
     873                </p></li><li><p>
    874874                Before starting the Samba daemons, verify that the hostname of the new server
    875875                is identical to that of the old one. Note: The IP address can be different
    876876                from that of the old server.
    877                 </p></li><li class="listitem"><p>
     877                </p></li><li><p>
    878878                Copy all files from the old server to the new server, taking precaution to
    879879                preserve all file ownership and permissions as well as any POSIX ACLs that
     
    891891        should correctly pick up the original SID and preserve all other settings. It is
    892892        sound advice to validate this before turning the system over to users.
    893         </p></div></div><div class="sect2" title="Migration of Samba Accounts to Active Directory"><div class="titlepage"><div><div><h3 class="title"><a name="id2607222"></a>Migration of Samba Accounts to Active Directory</h3></div></div></div><p>
     893        </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2601137"></a>Migration of Samba Accounts to Active Directory</h3></div></div></div><p>
    894894        Yes, it works. The Windows ADMT tool can be used to migrate Samba accounts
    895895        to MS Active Directory.  There are a few pitfalls to be aware of:
    896         </p><div class="procedure" title="Procedure 8.2. Migration to Active Directory"><a name="id2607234"></a><p class="title"><b>Procedure 8.2. Migration to Active Directory</b></p><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
     896        </p><div class="procedure"><a name="id2601149"></a><p class="title"><b>Procedure 8.2. Migration to Active Directory</b></p><ol type="1"><li><p>
    897897                Administrator password must be THE SAME on the Samba server,
    898898                the 2003 ADS, and the local Administrator account on the workstations.
     
    900900                called <code class="constant">Administrator</code> in your Samba domain, with
    901901                full administrative (root) rights to that domain.
    902                 </p></li><li class="step" title="Step 2"><p>
     902                </p></li><li><p>
    903903                In the Advanced/DNS section of the TCP/IP settings on your Windows
    904904                workstations, make sure the <em class="parameter"><code>DNS suffix for this
    905905                connection</code></em> field is blank.
    906                 </p></li><li class="step" title="Step 3"><p>
     906                </p></li><li><p>
    907907                Because you are migrating from Samba, user passwords cannot be
    908908                migrated. You'll have to reset everyone's passwords. (If you were
     
    911911                To date this has not been attempted with roaming profile support;
    912912                it has been documented as working with local profiles.
    913                 </p></li><li class="step" title="Step 4"><p>
     913                </p></li><li><p>
    914914                Disable the Windows Firewall on all workstations. Otherwise,
    915915                workstations won't be migrated to the new domain.
    916                 </p></li><li class="step" title="Step 5"><p>
    917                 <a class="indexterm" name="id2607301"></a>
     916                </p></li><li><p>
     917                <a class="indexterm" name="id2601216"></a>
    918918                When migrating machines, always test first (using ADMT's test mode)
    919919                and satisfy all errors before committing the migration. Note that the
     
    923923                a test.
    924924                </p></li></ol></div><p>
    925         <a class="indexterm" name="id2607318"></a>
     925        <a class="indexterm" name="id2601233"></a>
    926926        There are some significant benefits of using the ADMT, besides just
    927927        migrating user accounts. ADMT can be found on the Windows 2003 CD.
    928         </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     928        </p><div class="itemizedlist"><ul type="disc"><li><p>
    929929                You can migrate workstations remotely. You can specify that SIDs
    930930                be simply added instead of replaced, giving you the option of joining a
    931931                workstation back to the old domain if something goes awry. The
    932932                workstations will be joined to the new domain.
    933                 </p></li><li class="listitem"><p>
     933                </p></li><li><p>
    934934                Not only are user accounts migrated from the old domain to the new
    935935                domain, but ACLs on the workstations are migrated as well. Like SIDs,
    936936                ACLs can be added instead of replaced.
    937                 </p></li><li class="listitem"><p>
     937                </p></li><li><p>
    938938                Locally stored user profiles on workstations are migrated as well,
    939939                presenting almost no disruption to the user. Saved passwords will be
    940940                lost, just as when you administratively reset the password in Windows ADS.
    941                 </p></li><li class="listitem"><p>
     941                </p></li><li><p>
    942942                The ADMT lets you test all operations before actually performing the
    943943                migration. Accounts and workstations can be migrated individually or in
Note: See TracChangeset for help on using the changeset viewer.