Ignore:
Timestamp:
May 27, 2009, 9:08:03 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update 3.2 branch to 3.2.8 docs

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/samba-3.2.x/docs/htmldocs/Samba3-ByExample/upgrades.html

    r226 r231  
    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.73.1"><link rel="start" 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#id2591226">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2591322">Cautions and Notes</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2592651">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#id2593019">Applicable to All Samba 2.x to Samba-3 Upgrades</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2593353">Samba-2.x with LDAP Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2593535">Updating a Samba-3 Installation</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2593645">Samba-3 to Samba-3 Updates on the Same Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2593848">Migrating Samba-3 to a New Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2594263">Migration of Samba Accounts to Active Directory</a></span></dt></dl></dd></dl></div><p>
    2 <a class="indexterm" name="id2591142"></a>
    3 <a class="indexterm" name="id2591148"></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#id2598126">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2598223">Cautions and Notes</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2599552">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#id2599920">Applicable to All Samba 2.x to Samba-3 Upgrades</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2600254">Samba-2.x with LDAP Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="upgrades.html#id2600436">Updating a Samba-3 Installation</a></span></dt><dd><dl><dt><span class="sect2"><a href="upgrades.html#id2600546">Samba-3 to Samba-3 Updates on the Same Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2600749">Migrating Samba-3 to a New Server</a></span></dt><dt><span class="sect2"><a href="upgrades.html#id2601164">Migration of Samba Accounts to Active Directory</a></span></dt></dl></dd></dl></div><p>
     2<a class="indexterm" name="id2598042"></a>
     3<a class="indexterm" name="id2598049"></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="id2591165"></a>
    11 <a class="indexterm" name="id2591172"></a>
     10<a class="indexterm" name="id2598065"></a>
     11<a class="indexterm" name="id2598072"></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="id2591193"></a>
     20<a class="indexterm" name="id2598093"></a>
    2121I 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="id2591214"></a>
     25<a class="indexterm" name="id2598114"></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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2591226"></a>Introduction</h2></div></div></div><p>
    30 <a class="indexterm" name="id2591234"></a>
    31 <a class="indexterm" name="id2591241"></a>
    32 <a class="indexterm" name="id2591247"></a>
     29</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2598126"></a>Introduction</h2></div></div></div><p>
     30<a class="indexterm" name="id2598134"></a>
     31<a class="indexterm" name="id2598141"></a>
     32<a class="indexterm" name="id2598148"></a>
    3333A Windows network administrator explained in an email what changes he was
    3434planning to make and followed with the question: &#8220;<span class="quote">Anyone done this
     
    4545productivity on them.
    4646</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
    47 <a class="indexterm" name="id2591279"></a>
    48 <a class="indexterm" name="id2591286"></a>
     47<a class="indexterm" name="id2598179"></a>
     48<a class="indexterm" name="id2598186"></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="id2591300"></a>
    55 <a class="indexterm" name="id2591307"></a>
     54<a class="indexterm" name="id2598200"></a>
     55<a class="indexterm" name="id2598208"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2591322"></a>Cautions and Notes</h3></div></div></div><p>
     62</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2598223"></a>Cautions and Notes</h3></div></div></div><p>
    6363        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="id2591340"></a>
    67         <a class="indexterm" name="id2591347"></a>
    68         <a class="indexterm" name="id2591353"></a>
     66        <a class="indexterm" name="id2598240"></a>
     67        <a class="indexterm" name="id2598247"></a>
     68        <a class="indexterm" name="id2598254"></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="id2591380"></a>
     76        <a class="indexterm" name="id2598281"></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="id2591398"></a>
     81        <a class="indexterm" name="id2598298"></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
     
    9191        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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2591426"></a>Security Identifiers (SIDs)</h4></div></div></div><p>
    94         <a class="indexterm" name="id2591434"></a>
    95         <a class="indexterm" name="id2591443"></a>
    96         <a class="indexterm" name="id2591450"></a>
    97         <a class="indexterm" name="id2591456"></a>
    98         <a class="indexterm" name="id2591463"></a>
    99         <a class="indexterm" name="id2591472"></a>
     93        </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2598326"></a>Security Identifiers (SIDs)</h4></div></div></div><p>
     94        <a class="indexterm" name="id2598334"></a>
     95        <a class="indexterm" name="id2598344"></a>
     96        <a class="indexterm" name="id2598350"></a>
     97        <a class="indexterm" name="id2598357"></a>
     98        <a class="indexterm" name="id2598364"></a>
     99        <a class="indexterm" name="id2598373"></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="id2591492"></a>
    108         <a class="indexterm" name="id2591499"></a>
    109         <a class="indexterm" name="id2591505"></a>
    110         <a class="indexterm" name="id2591512"></a>
    111         <a class="indexterm" name="id2591518"></a>
    112         <a class="indexterm" name="id2591525"></a>
     107        <a class="indexterm" name="id2598393"></a>
     108        <a class="indexterm" name="id2598400"></a>
     109        <a class="indexterm" name="id2598407"></a>
     110        <a class="indexterm" name="id2598414"></a>
     111        <a class="indexterm" name="id2598420"></a>
     112        <a class="indexterm" name="id2598427"></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="id2591542"></a>
    118         <a class="indexterm" name="id2591549"></a>
    119         <a class="indexterm" name="id2591555"></a>
     117        <a class="indexterm" name="id2598444"></a>
     118        <a class="indexterm" name="id2598450"></a>
     119        <a class="indexterm" name="id2598457"></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="id2591575"></a>
    125         <a class="indexterm" name="id2591582"></a>
    126         <a class="indexterm" name="id2591588"></a>
     124        <a class="indexterm" name="id2598476"></a>
     125        <a class="indexterm" name="id2598483"></a>
     126        <a class="indexterm" name="id2598490"></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="id2591609"></a>
    133         <a class="indexterm" name="id2591618"></a>
    134         <a class="indexterm" name="id2591627"></a>
    135         <a class="indexterm" name="id2591634"></a>
     132        <a class="indexterm" name="id2598510"></a>
     133        <a class="indexterm" name="id2598520"></a>
     134        <a class="indexterm" name="id2598529"></a>
     135        <a class="indexterm" name="id2598536"></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="id2591649"></a>
    142         <a class="indexterm" name="id2591656"></a>
    143         <a class="indexterm" name="id2591662"></a>
    144         <a class="indexterm" name="id2591669"></a>
    145         <a class="indexterm" name="id2591676"></a>
    146         <a class="indexterm" name="id2591683"></a>
     141        <a class="indexterm" name="id2598550"></a>
     142        <a class="indexterm" name="id2598557"></a>
     143        <a class="indexterm" name="id2598564"></a>
     144        <a class="indexterm" name="id2598570"></a>
     145        <a class="indexterm" name="id2598577"></a>
     146        <a class="indexterm" name="id2598584"></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="id2591732"></a>
     156        <a class="indexterm" name="id2598634"></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
     
    163163        be restored to its previous value.
    164164        </p></div><p>
    165         <a class="indexterm" name="id2591754"></a>
    166         <a class="indexterm" name="id2591761"></a>
    167         <a class="indexterm" name="id2591767"></a>
    168         <a class="indexterm" name="id2591774"></a>
    169         <a class="indexterm" name="id2591781"></a>
    170         <a class="indexterm" name="id2591787"></a>
    171         <a class="indexterm" name="id2591794"></a>
    172         <a class="indexterm" name="id2591801"></a>
    173         <a class="indexterm" name="id2591808"></a>
    174         <a class="indexterm" name="id2591815"></a>
     165        <a class="indexterm" name="id2598655"></a>
     166        <a class="indexterm" name="id2598662"></a>
     167        <a class="indexterm" name="id2598668"></a>
     168        <a class="indexterm" name="id2598675"></a>
     169        <a class="indexterm" name="id2598682"></a>
     170        <a class="indexterm" name="id2598689"></a>
     171        <a class="indexterm" name="id2598696"></a>
     172        <a class="indexterm" name="id2598702"></a>
     173        <a class="indexterm" name="id2598709"></a>
     174        <a class="indexterm" name="id2598716"></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="id2591829"></a>
    180         <a class="indexterm" name="id2591838"></a>
     179        <a class="indexterm" name="id2598730"></a>
     180        <a class="indexterm" name="id2598739"></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="id2591926"></a>
     203        <a class="indexterm" name="id2598827"></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="id2592000"></a>
    221         <a class="indexterm" name="id2592006"></a>
     220        <a class="indexterm" name="id2598901"></a>
     221        <a class="indexterm" name="id2598908"></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="id2592053"></a>
    241         <a class="indexterm" name="id2592060"></a>
    242         <a class="indexterm" name="id2592067"></a>
     240        <a class="indexterm" name="id2598954"></a>
     241        <a class="indexterm" name="id2598961"></a>
     242        <a class="indexterm" name="id2598968"></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="id2592103"></a>
    254         <a class="indexterm" name="id2592109"></a>
    255         <a class="indexterm" name="id2592116"></a>
     253        <a class="indexterm" name="id2599004"></a>
     254        <a class="indexterm" name="id2599011"></a>
     255        <a class="indexterm" name="id2599017"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2592154"></a>Change of hostname</h4></div></div></div><p>
    265         <a class="indexterm" name="id2592161"></a>
    266         <a class="indexterm" name="id2592171"></a>
     264        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2599055"></a>Change of hostname</h4></div></div></div><p>
     265        <a class="indexterm" name="id2599063"></a>
     266        <a class="indexterm" name="id2599072"></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
     
    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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2592219"></a>Change of Workgroup (Domain) Name</h4></div></div></div><p>
    281         <a class="indexterm" name="id2592227"></a>
     280        </p></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2599120"></a>Change of Workgroup (Domain) Name</h4></div></div></div><p>
     281        <a class="indexterm" name="id2599129"></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="id2592253"></a>
     286        <a class="indexterm" name="id2599154"></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.
     
    293293        for network administrators.
    294294        </p><p>
    295         <a class="indexterm" name="id2592284"></a>
     295        <a class="indexterm" name="id2599185"></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="id2592331"></a>
     303        <a class="indexterm" name="id2599231"></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="id2592360"></a>
     308        <a class="indexterm" name="id2599261"></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="id2592418"></a>
     320        <a class="indexterm" name="id2599319"></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="id2592456"></a>
     351        <a class="indexterm" name="id2599356"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2592486"></a>International Language Support</h4></div></div></div><p>
    358         <a class="indexterm" name="id2592494"></a>
    359         <a class="indexterm" name="id2592501"></a>
    360         <a class="indexterm" name="id2592508"></a>
    361         <a class="indexterm" name="id2592514"></a>
     357        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2599386"></a>International Language Support</h4></div></div></div><p>
     358        <a class="indexterm" name="id2599395"></a>
     359        <a class="indexterm" name="id2599401"></a>
     360        <a class="indexterm" name="id2599408"></a>
     361        <a class="indexterm" name="id2599415"></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="id2592529"></a>
     366        <a class="indexterm" name="id2599430"></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="id2592546"></a>
     372        <a class="indexterm" name="id2599447"></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="id2592560"></a>
     377        <a class="indexterm" name="id2599461"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2592580"></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="id2599480"></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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2592651"></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="id2599552"></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
     
    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"><a name="id2592689"></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="id2592700"></a>
    410                 <a class="indexterm" name="id2592707"></a>
    411                 <a class="indexterm" name="id2592714"></a>
     408        </p><div class="procedure"><a name="id2599590"></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="id2599601"></a>
     410                <a class="indexterm" name="id2599608"></a>
     411                <a class="indexterm" name="id2599615"></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
     
    424424                back it up to a safe location.
    425425                </p></li><li><p>
    426                 <a class="indexterm" name="id2592795"></a>
    427                 <a class="indexterm" name="id2592802"></a>
    428                 <a class="indexterm" name="id2592809"></a>
    429                 <a class="indexterm" name="id2592816"></a>
     426                <a class="indexterm" name="id2599696"></a>
     427                <a class="indexterm" name="id2599703"></a>
     428                <a class="indexterm" name="id2599710"></a>
     429                <a class="indexterm" name="id2599717"></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
     
    438438                tdb files to a safe location.
    439439                </p></li><li><p>
    440                 <a class="indexterm" name="id2592854"></a>
     440                <a class="indexterm" name="id2599755"></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
     
    457457                Do not change the workgroup name.
    458458                </p></li><li><p>
    459                 <a class="indexterm" name="id2592910"></a>
     459                <a class="indexterm" name="id2599810"></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="id2592967"></a>
     471        <a class="indexterm" name="id2599868"></a>
    472472                The resulting <code class="filename">smb.conf</code> file will be stripped of all comments
    473473                and of all nonconforming configuration settings.
    474474                </p></li><li><p>
    475                 <a class="indexterm" name="id2592988"></a>
     475                <a class="indexterm" name="id2599889"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2593019"></a>Applicable to All Samba 2.x to Samba-3 Upgrades</h3></div></div></div><p>
    481         <a class="indexterm" name="id2593028"></a>
    482         <a class="indexterm" name="id2593034"></a>
    483         <a class="indexterm" name="id2593041"></a>
     480                </p></li></ol></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2599920"></a>Applicable to All Samba 2.x to Samba-3 Upgrades</h3></div></div></div><p>
     481        <a class="indexterm" name="id2599929"></a>
     482        <a class="indexterm" name="id2599935"></a>
     483        <a class="indexterm" name="id2599942"></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="id2593056"></a>
     489        <a class="indexterm" name="id2599956"></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="id2593077"></a>
    494         <a class="indexterm" name="id2593083"></a>
    495         <a class="indexterm" name="id2593090"></a>
    496         <a class="indexterm" name="id2593097"></a>
    497         <a class="indexterm" name="id2593104"></a>
    498         <a class="indexterm" name="id2593112"></a>
    499         <a class="indexterm" name="id2593119"></a>
     493        <a class="indexterm" name="id2599978"></a>
     494        <a class="indexterm" name="id2599984"></a>
     495        <a class="indexterm" name="id2599991"></a>
     496        <a class="indexterm" name="id2599998"></a>
     497        <a class="indexterm" name="id2600005"></a>
     498        <a class="indexterm" name="id2600012"></a>
     499        <a class="indexterm" name="id2600019"></a>
    500500        </p><p>
    501501        </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>
    502502        </p><p>
    503         <a class="indexterm" name="id2593171"></a>
    504         <a class="indexterm" name="id2593178"></a>
     503        <a class="indexterm" name="id2600071"></a>
     504        <a class="indexterm" name="id2600078"></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="id2593202"></a>
    510         <a class="indexterm" name="id2593209"></a>
    511         <a class="indexterm" name="id2593216"></a>
    512         <a class="indexterm" name="id2593222"></a>
    513         <a class="indexterm" name="id2593229"></a>
    514         <a class="indexterm" name="id2593236"></a>
    515         <a class="indexterm" name="id2593243"></a>
    516         <a class="indexterm" name="id2593250"></a>
    517         <a class="indexterm" name="id2593256"></a>
     509        <a class="indexterm" name="id2600103"></a>
     510        <a class="indexterm" name="id2600110"></a>
     511        <a class="indexterm" name="id2600116"></a>
     512        <a class="indexterm" name="id2600123"></a>
     513        <a class="indexterm" name="id2600130"></a>
     514        <a class="indexterm" name="id2600137"></a>
     515        <a class="indexterm" name="id2600144"></a>
     516        <a class="indexterm" name="id2600150"></a>
     517        <a class="indexterm" name="id2600157"></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="id2593317"></a>
    525         <a class="indexterm" name="id2593324"></a>
    526         <a class="indexterm" name="id2593331"></a>
     524        <a class="indexterm" name="id2600218"></a>
     525        <a class="indexterm" name="id2600225"></a>
     526        <a class="indexterm" name="id2600231"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2593353"></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="id2600254"></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="id2593388"></a>
    542         <a class="indexterm" name="id2593394"></a>
     541        <a class="indexterm" name="id2600288"></a>
     542        <a class="indexterm" name="id2600295"></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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2593535"></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="id2600436"></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="id2593551"></a>
     703<a class="indexterm" name="id2600451"></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="id2593576"></a>
     709<a class="indexterm" name="id2600477"></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="id2593610"></a>
     722<a class="indexterm" name="id2600511"></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="id2593625"></a>
    729 <a class="indexterm" name="id2593632"></a>
     728<a class="indexterm" name="id2600526"></a>
     729<a class="indexterm" name="id2600533"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2593645"></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="id2600546"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2593656"></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="id2600557"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2593679"></a>Updating from Samba Versions between 3.0.6 and 3.0.10</h4></div></div></div><p>
    746         <a class="indexterm" name="id2593687"></a>
    747         <a class="indexterm" name="id2593694"></a>
     745        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600580"></a>Updating from Samba Versions between 3.0.6 and 3.0.10</h4></div></div></div><p>
     746        <a class="indexterm" name="id2600588"></a>
     747        <a class="indexterm" name="id2600595"></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="id2593710"></a>
    754         <a class="indexterm" name="id2593717"></a>
    755         <a class="indexterm" name="id2593724"></a>
     753        <a class="indexterm" name="id2600611"></a>
     754        <a class="indexterm" name="id2600618"></a>
     755        <a class="indexterm" name="id2600625"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2593757"></a>Updating from Samba Versions after 3.0.6 to a Current Release</h4></div></div></div><p>
    763         <a class="indexterm" name="id2593766"></a>
     762        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600658"></a>Updating from Samba Versions after 3.0.6 to a Current Release</h4></div></div></div><p>
     763        <a class="indexterm" name="id2600667"></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="id2593797"></a>
     769        <a class="indexterm" name="id2600699"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2593848"></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="id2600749"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2593860"></a>Replacing a Domain Member Server</h4></div></div></div><p>
    796         <a class="indexterm" name="id2593868"></a>
     795        </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600761"></a>Replacing a Domain Member Server</h4></div></div></div><p>
     796        <a class="indexterm" name="id2600770"></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="id2593894"></a>
    806         <a class="indexterm" name="id2593900"></a>
    807         <a class="indexterm" name="id2593907"></a>
    808         <a class="indexterm" name="id2593914"></a>
    809         <a class="indexterm" name="id2593921"></a>
    810         <a class="indexterm" name="id2593928"></a>
     805        <a class="indexterm" name="id2600795"></a>
     806        <a class="indexterm" name="id2600802"></a>
     807        <a class="indexterm" name="id2600808"></a>
     808        <a class="indexterm" name="id2600815"></a>
     809        <a class="indexterm" name="id2600822"></a>
     810        <a class="indexterm" name="id2600829"></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="id2593975"></a>
    821         <a class="indexterm" name="id2593982"></a>
    822         <a class="indexterm" name="id2593988"></a>
    823         <a class="indexterm" name="id2593995"></a>
     820        <a class="indexterm" name="id2600876"></a>
     821        <a class="indexterm" name="id2600883"></a>
     822        <a class="indexterm" name="id2600890"></a>
     823        <a class="indexterm" name="id2600896"></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="id2594044"></a>
     834        <a class="indexterm" name="id2600945"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2594062"></a>Replacing a Domain Controller</h4></div></div></div><p>
    840         <a class="indexterm" name="id2594071"></a>
     839        </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2600964"></a>Replacing a Domain Controller</h4></div></div></div><p>
     840        <a class="indexterm" name="id2600972"></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
     
    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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2594263"></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="id2601164"></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"><a name="id2594275"></a><p class="title"><b>Procedure 8.2. Migration to Active Directory</b></p><ol type="1"><li><p>
     896        </p><div class="procedure"><a name="id2601176"></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.
     
    915915                workstations won't be migrated to the new domain.
    916916                </p></li><li><p>
    917                 <a class="indexterm" name="id2594341"></a>
     917                <a class="indexterm" name="id2601242"></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="id2594358"></a>
     925        <a class="indexterm" name="id2601260"></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.
Note: See TracChangeset for help on using the changeset viewer.