diff options
Diffstat (limited to 'docs/htmldocs/Samba3-ByExample/upgrades.html')
| -rw-r--r-- | docs/htmldocs/Samba3-ByExample/upgrades.html | 416 |
1 files changed, 208 insertions, 208 deletions
diff --git a/docs/htmldocs/Samba3-ByExample/upgrades.html b/docs/htmldocs/Samba3-ByExample/upgrades.html index e7e781e9ad..0d98656798 100644 --- a/docs/htmldocs/Samba3-ByExample/upgrades.html +++ b/docs/htmldocs/Samba3-ByExample/upgrades.html @@ -1,14 +1,14 @@ -<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> -<a class="indexterm" name="id2604100"></a> -<a class="indexterm" name="id2604107"></a> +<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> +<a class="indexterm" name="id2598015"></a> +<a class="indexterm" name="id2598022"></a> It was a little difficult to select an appropriate title for this chapter. From email messages on the Samba mailing lists it is clear that many people consider the updating and upgrading of Samba to be a migration matter. Others talk about migrating Samba servers when in fact the issue at hand is one of installing a new Samba server to replace an older existing Samba server. </p><p> -<a class="indexterm" name="id2604124"></a> -<a class="indexterm" name="id2604130"></a> +<a class="indexterm" name="id2598039"></a> +<a class="indexterm" name="id2598045"></a> There has also been much talk about migration of Samba-3 from an smbpasswd passdb backend to the use of the tdbsam or ldapsam facilities that are new to Samba-3. @@ -17,22 +17,22 @@ Clearly, there is not a great deal of clarity in the terminology that various people apply to these modes by which Samba servers are updated. This is further highlighted by an email posting that included the following neat remark: </p><div class="blockquote"><blockquote class="blockquote"><p> -<a class="indexterm" name="id2604152"></a> -I like the <span class="quote">“<span class="quote">net rpc vampire</span>”</span> on NT4, but that to my surprise does +<a class="indexterm" name="id2598067"></a> +I like the “<span class="quote">net rpc vampire</span>” on NT4, but that to my surprise does not seem to work against a Samba PDC and, if addressed in the Samba to Samba context in either book, I could not find it. </p></blockquote></div><p> -<a class="indexterm" name="id2604173"></a> +<a class="indexterm" name="id2598088"></a> So in response to the significant request for these situations to be better documented, this chapter has now been added. User contributions and documentation of real-world experiences are a most welcome addition to this chapter. -</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> -<a class="indexterm" name="id2604193"></a> -<a class="indexterm" name="id2604199"></a> -<a class="indexterm" name="id2604206"></a> +</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> +<a class="indexterm" name="id2598108"></a> +<a class="indexterm" name="id2598114"></a> +<a class="indexterm" name="id2598121"></a> A Windows network administrator explained in an email what changes he was -planning to make and followed with the question: <span class="quote">“<span class="quote">Anyone done this -before?</span>”</span> Many of us have upgraded and updated Samba without incident. +planning to make and followed with the question: “<span class="quote">Anyone done this +before?</span>” Many of us have upgraded and updated Samba without incident. Others have experienced much pain and user frustration. So it is to be hoped that the notes in this chapter will make a positive difference by assuring that someone will be saved a lot of discomfort. @@ -43,29 +43,29 @@ case it is necessary to revert to the old version. Even if you do not like this precautionary step, users will punish an administrator who fails to take adequate steps to avoid situations that may inflict lost productivity on them. -</p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p> -<a class="indexterm" name="id2604237"></a> -<a class="indexterm" name="id2604244"></a> +</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p> +<a class="indexterm" name="id2598152"></a> +<a class="indexterm" name="id2598159"></a> Samba makes it possible to upgrade and update configuration files, but it is not possible to downgrade the configuration files. Please ensure that all configuration and control files are backed up to permit a down-grade in the rare event that this may be necessary. </p></div><p> -<a class="indexterm" name="id2604259"></a> -<a class="indexterm" name="id2604266"></a> +<a class="indexterm" name="id2598174"></a> +<a class="indexterm" name="id2598181"></a> It is prudent also to backup all data files on the server before attempting to perform a major upgrade. Many administrators have experienced the consequences of failure to take adequate precautions. So what is adequate? That is simple! If data is lost during an upgrade or update and it can not be restored, the precautions taken were inadequate. If a backup was not needed, but was available, caution was on the side of the victor. -</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> - Someone once said, <span class="quote">“<span class="quote">It is good to be sorry, but better never to need to be!</span>”</span> +</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> + Someone once said, “<span class="quote">It is good to be sorry, but better never to need to be!</span>” These are wise words of advice to those contemplating a Samba upgrade or update. </p><p> - <a class="indexterm" name="id2604299"></a> - <a class="indexterm" name="id2604305"></a> - <a class="indexterm" name="id2604312"></a> + <a class="indexterm" name="id2598214"></a> + <a class="indexterm" name="id2598220"></a> + <a class="indexterm" name="id2598227"></a> This is as good a time as any to define the terms <code class="constant">upgrade</code> and <code class="constant">update</code>. The term <code class="constant">upgrade</code> refers to the installation of a version of Samba that is a whole generation or more ahead of @@ -73,12 +73,12 @@ caution was on the side of the victor. number. So far Samba has been released in generations 1.x, 2.x, 3.x, and currently 4.0 is in development. </p><p> - <a class="indexterm" name="id2604339"></a> + <a class="indexterm" name="id2598254"></a> The term <code class="constant">update</code> refers to a minor version number installation in place of one of the same generation. For example, updating from Samba 3.0.10 to 3.0.14 is an update. The move from Samba 2.0.7 to 3.0.14 is an upgrade. </p><p> - <a class="indexterm" name="id2604356"></a> + <a class="indexterm" name="id2598271"></a> While the use of these terms is an exercise in semantics, what needs to be realized is that there are major functional differences between a Samba 2.x release and a Samba 3.0.x release. Such differences may require a significantly different approach to @@ -86,17 +86,17 @@ caution was on the side of the victor. latest documentation to identify precisely how the new installation may need to be modified to preserve prior functionality. </p><p> - There is an old axiom that says, <span class="quote">“<span class="quote">The greater the volume of the documentation, + There is an old axiom that says, “<span class="quote">The greater the volume of the documentation, the greater the risk that noone will read it, but where there is no documentation, - noone can read it!</span>”</span> While true, some documentation is an evil necessity. + noone can read it!</span>” While true, some documentation is an evil necessity. It is hoped that this update to the documentation will avoid both extremes. - </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> - <a class="indexterm" name="id2604393"></a> - <a class="indexterm" name="id2604402"></a> - <a class="indexterm" name="id2604409"></a> - <a class="indexterm" name="id2604416"></a> - <a class="indexterm" name="id2604422"></a> - <a class="indexterm" name="id2604432"></a> + </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> + <a class="indexterm" name="id2598308"></a> + <a class="indexterm" name="id2598317"></a> + <a class="indexterm" name="id2598324"></a> + <a class="indexterm" name="id2598331"></a> + <a class="indexterm" name="id2598337"></a> + <a class="indexterm" name="id2598346"></a> Before the days of Windows NT and OS/2, every Windows and DOS networking client that used the SMB protocols was an entirely autonomous entity. There was no concept of a security identifier for a machine or a user outside of the username, the @@ -104,46 +104,46 @@ caution was on the side of the victor. in the same context as the way that the SID is used since the development of Windows NT 3.10. </p><p> - <a class="indexterm" name="id2604451"></a> - <a class="indexterm" name="id2604458"></a> - <a class="indexterm" name="id2604465"></a> - <a class="indexterm" name="id2604472"></a> - <a class="indexterm" name="id2604478"></a> - <a class="indexterm" name="id2604485"></a> + <a class="indexterm" name="id2598366"></a> + <a class="indexterm" name="id2598373"></a> + <a class="indexterm" name="id2598380"></a> + <a class="indexterm" name="id2598387"></a> + <a class="indexterm" name="id2598393"></a> + <a class="indexterm" name="id2598400"></a> Versions of Samba prior to 1.9 did not make use of a SID. Instead they make exclusive use of the username that is embedded in the SessionSetUpAndX component of the connection setup process between a Windows client and an SMB/CIFS server. </p><p> - <a class="indexterm" name="id2604502"></a> - <a class="indexterm" name="id2604509"></a> - <a class="indexterm" name="id2604515"></a> + <a class="indexterm" name="id2598417"></a> + <a class="indexterm" name="id2598424"></a> + <a class="indexterm" name="id2598430"></a> Around November 1997 support was added to Samba-1.9 to handle the Windows security RPC-based protocols that implemented support for Samba to store a machine SID. This information was stored in a file called <code class="filename">MACHINE.SID.</code> </p><p> - <a class="indexterm" name="id2604535"></a> - <a class="indexterm" name="id2604542"></a> - <a class="indexterm" name="id2604548"></a> + <a class="indexterm" name="id2598450"></a> + <a class="indexterm" name="id2598456"></a> + <a class="indexterm" name="id2598463"></a> Within the lifetime of the early Samba 2.x series, the machine SID information was relocated into a tdb file called <code class="filename">secrets.tdb</code>, which is where it is still located in Samba 3.0.x along with other information that pertains to the local machine and its role within a domain security context. </p><p> - <a class="indexterm" name="id2604569"></a> - <a class="indexterm" name="id2604578"></a> - <a class="indexterm" name="id2604587"></a> - <a class="indexterm" name="id2604594"></a> + <a class="indexterm" name="id2598484"></a> + <a class="indexterm" name="id2598493"></a> + <a class="indexterm" name="id2598502"></a> + <a class="indexterm" name="id2598509"></a> There are two types of SID, those pertaining to the machine itself and the domain to which it may belong, and those pertaining to users and groups within the security context of the local machine, in the case of standalone servers (SAS) and domain member servers (DMS). </p><p> - <a class="indexterm" name="id2604608"></a> - <a class="indexterm" name="id2604615"></a> - <a class="indexterm" name="id2604622"></a> - <a class="indexterm" name="id2604629"></a> - <a class="indexterm" name="id2604636"></a> - <a class="indexterm" name="id2604642"></a> + <a class="indexterm" name="id2598523"></a> + <a class="indexterm" name="id2598530"></a> + <a class="indexterm" name="id2598537"></a> + <a class="indexterm" name="id2598544"></a> + <a class="indexterm" name="id2598551"></a> + <a class="indexterm" name="id2598557"></a> When the Samba <code class="literal">smbd</code> daemon is first started, if the <code class="filename">secrets.tdb</code> file does not exist, it is created at the first client connection attempt. If this file does exist, <code class="literal">smbd</code> checks that there is a machine SID (if it is a domain controller, @@ -153,31 +153,31 @@ caution was on the side of the victor. manner. This means that each time it is generated for a particular combination of machine name (hostname) and domain name (workgroup), it will be different. </p><p> - <a class="indexterm" name="id2604692"></a> + <a class="indexterm" name="id2598607"></a> The SID is the key used by MS Windows networking for all networking operations. This means that when the machine or domain SID changes, all security-encoded objects such as profiles and ACLs may become unusable. - </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> + </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> It is of paramount importance that the machine and domain SID be backed up so that in the event of a change of hostname (machine name) or domain name (workgroup) the SID can be restored to its previous value. </p></div><p> - <a class="indexterm" name="id2604713"></a> - <a class="indexterm" name="id2604720"></a> - <a class="indexterm" name="id2604727"></a> - <a class="indexterm" name="id2604733"></a> - <a class="indexterm" name="id2604740"></a> - <a class="indexterm" name="id2604747"></a> - <a class="indexterm" name="id2604754"></a> - <a class="indexterm" name="id2604761"></a> - <a class="indexterm" name="id2604768"></a> - <a class="indexterm" name="id2604774"></a> + <a class="indexterm" name="id2598628"></a> + <a class="indexterm" name="id2598635"></a> + <a class="indexterm" name="id2598642"></a> + <a class="indexterm" name="id2598648"></a> + <a class="indexterm" name="id2598655"></a> + <a class="indexterm" name="id2598662"></a> + <a class="indexterm" name="id2598669"></a> + <a class="indexterm" name="id2598676"></a> + <a class="indexterm" name="id2598683"></a> + <a class="indexterm" name="id2598689"></a> In Samba-3 on a domain controller (PDC or BDC), the domain name controls the domain SID. On all prior versions the hostname (computer name, or NetBIOS name) controlled the SID. On a standalone server the hostname still controls the SID. </p><p> - <a class="indexterm" name="id2604788"></a> - <a class="indexterm" name="id2604797"></a> + <a class="indexterm" name="id2598703"></a> + <a class="indexterm" name="id2598712"></a> The local machine SID can be backed up using this procedure (Samba-3): </p><pre class="screen"> <code class="prompt">root# </code> net getlocalsid > /etc/samba/my-local-SID @@ -200,7 +200,7 @@ SID for domain FRODO is: S-1-5-21-726309263-4128913605-1168186429 ability to read the older tdb file and to perform an in-situ update to the latest tdb format. This is not a reversible process it is a one-way upgrade. </p><p> - <a class="indexterm" name="id2604886"></a> + <a class="indexterm" name="id2598801"></a> In the course of the Samba 2.0.x series the <code class="literal">smbpasswd</code> was modified to permit the domain SID to be captured to the <code class="filename">secrets.tdb</code> file by executing: </p><pre class="screen"> @@ -217,8 +217,8 @@ SID for domain FRODO is: S-1-5-21-726309263-4128913605-1168186429 <code class="prompt">root# </code> smbpasswd -W S-1-5-21-726309263-4128913605-1168186429 </pre><p> </p><p> - <a class="indexterm" name="id2604959"></a> - <a class="indexterm" name="id2604966"></a> + <a class="indexterm" name="id2598874"></a> + <a class="indexterm" name="id2598881"></a> Domain security information, which includes the domain SID, can be obtained from Samba-2.2.x systems by executing: </p><pre class="screen"> @@ -237,9 +237,9 @@ Num local groups: 0 It is a very good practice to store this SID information in a safely kept file, just in case it is ever needed at a later date. </p><p> - <a class="indexterm" name="id2605013"></a> - <a class="indexterm" name="id2605020"></a> - <a class="indexterm" name="id2605026"></a> + <a class="indexterm" name="id2598928"></a> + <a class="indexterm" name="id2598935"></a> + <a class="indexterm" name="id2598941"></a> Take note that the domain SID is used extensively in Samba. Where LDAP is used for the <em class="parameter"><code>passdb backend</code></em>, all user, group, and trust accounts are encoded with the domain SID. This means that if the domain SID changes for any reason, the entire @@ -250,9 +250,9 @@ Num local groups: 0 <code class="prompt">root# </code> slapcat -v -l filename.ldif </pre><p> </p><p> - <a class="indexterm" name="id2605062"></a> - <a class="indexterm" name="id2605069"></a> - <a class="indexterm" name="id2605076"></a> + <a class="indexterm" name="id2598977"></a> + <a class="indexterm" name="id2598984"></a> + <a class="indexterm" name="id2598991"></a> When the domain SID has changed, roaming profiles cease to be functional. The recovery of roaming profiles necessitates resetting of the domain portion of the user SID that owns the profile. This is encoded in the <code class="filename">NTUser.DAT</code> and can be @@ -261,9 +261,9 @@ Num local groups: 0 complain to the Samba Team if this utility is missing; that issue that must be addressed to the creator of the RPM package. The Samba Team do their best to make available all the tools needed to manage a Samba-based Windows networking environment. - </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> - <a class="indexterm" name="id2605121"></a> - <a class="indexterm" name="id2605130"></a> + </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> + <a class="indexterm" name="id2599036"></a> + <a class="indexterm" name="id2599045"></a> Samba uses two methods by which the primary NetBIOS machine name (also known as a computer name or the hostname) may be determined: If the <code class="filename">smb.conf</code> file contains a <em class="parameter"><code>netbios name</code></em> entry, its value will be used directly. In the absence @@ -273,26 +273,26 @@ Num local groups: 0 hostname was changed for one reason or another. Such a change will cause a new machine SID to be generated. If this happens on a domain controller, it will also change the domain SID. These SIDs can be updated (restored) using the procedure outlined previously. - </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> + </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> Do NOT change the hostname or the <em class="parameter"><code>netbios name</code></em>. If this is changed, be sure to reset the machine SID to the original setting. Otherwise there may be serious interoperability and/or operational problems. - </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> - <a class="indexterm" name="id2605187"></a> + </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> + <a class="indexterm" name="id2599102"></a> The domain name of a Samba server is identical to the workgroup name and is set in the <code class="filename">smb.conf</code> file using the <em class="parameter"><code>workgroup</code></em> parameter. This has been consistent throughout the history of Samba and across all versions. </p><p> - <a class="indexterm" name="id2605212"></a> + <a class="indexterm" name="id2599127"></a> Be aware that when the workgroup name is changed, a new SID will be generated. The old domain SID can be reset using the procedure outlined earlier in this chapter. - </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> + </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> The Samba-Team has maintained a constant default location for all Samba control files throughout the life of the project. People who have produced binary packages of Samba have varied the location of the Samba control files. This has led to some confusion for network administrators. </p><p> - <a class="indexterm" name="id2605243"></a> + <a class="indexterm" name="id2599158"></a> The Samba 1.9.x <code class="filename">smb.conf</code> file may be found either in the <code class="filename">/etc</code> directory or in <code class="filename">/usr/local/samba/lib</code>. </p><p> @@ -300,12 +300,12 @@ Num local groups: 0 on Linux systems to the <code class="filename">/etc/samba</code> directory where it remains located also for Samba 3.0.x installations. </p><p> - <a class="indexterm" name="id2605290"></a> + <a class="indexterm" name="id2599205"></a> Samba 2.x introduced the <code class="filename">secrets.tdb</code> file that is also stored in the <code class="filename">/etc/samba</code> directory, or in the <code class="filename">/usr/local/samba/lib</code> directory subsystem. </p><p> - <a class="indexterm" name="id2605320"></a> + <a class="indexterm" name="id2599234"></a> The location at which <code class="literal">smbd</code> expects to find all configuration and control files is determined at the time of compilation of Samba. For versions of Samba prior to 3.0, one way to find the expected location of these files is to execute: @@ -317,7 +317,7 @@ Num local groups: 0 Note: The <code class="literal">smbd</code> executable may be located in the path <code class="filename">/usr/local/samba/sbin</code>. </p><p> - <a class="indexterm" name="id2605378"></a> + <a class="indexterm" name="id2599292"></a> Samba-3 provides a neat new way to track the location of all control files as well as to find the compile-time options used as the Samba package was built. Here is how the dark secrets of the internals of the location of control files within Samba executables can @@ -348,37 +348,37 @@ Paths: ... </pre><p> </p><p> - <a class="indexterm" name="id2605415"></a> + <a class="indexterm" name="id2599330"></a> It is important that both the <code class="filename">smb.conf</code> file and the <code class="filename">secrets.tdb</code> be backed up before attempting any upgrade. The <code class="filename">secrets.tdb</code> file is version-encoded, and therefore a newer version may not work with an older version of Samba. A backup means that it is always possible to revert a failed or problematic upgrade. - </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> - <a class="indexterm" name="id2605453"></a> - <a class="indexterm" name="id2605460"></a> - <a class="indexterm" name="id2605467"></a> - <a class="indexterm" name="id2605474"></a> + </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> + <a class="indexterm" name="id2599368"></a> + <a class="indexterm" name="id2599375"></a> + <a class="indexterm" name="id2599382"></a> + <a class="indexterm" name="id2599388"></a> Samba-2.x had no support for Unicode; instead, all national language character-set support in file names was done using particular locale codepage mapping techniques. Samba-3 supports Unicode in file names, thus providing true internationalization support. </p><p> - <a class="indexterm" name="id2605488"></a> + <a class="indexterm" name="id2599403"></a> Non-English users whose national language character set has special characters and who upgrade naively will find that many files that have the special characters in the file name will see them garbled and jumbled up. This typically happens with umlauts and accents because these characters were particular to the codepage that was in use with Samba-2.x using an 8-bit encoding scheme. </p><p> - <a class="indexterm" name="id2605505"></a> + <a class="indexterm" name="id2599420"></a> Files that are created with Samba-3 will use UTF-8 encoding. Should the file system ever end up with a mix of codepage (unix charset)-encoded file names and UTF-8-encoded file names, the mess will take some effort to set straight. </p><p> - <a class="indexterm" name="id2605519"></a> + <a class="indexterm" name="id2599434"></a> A very helpful tool is available from Bjorn Jacke's <a class="ulink" href="http://j3e.de/linux/convmv/" target="_top">convmv</a> work. Convmv is a tool that can be used to convert file and directory names from one encoding method to another. The most common use for this tool is to convert locale-encoded files to UTF-8 Unicode encoding. - </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> + </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> The smbldap-tools have been maturing rapidly over the past year. With maturation comes change. The location of the <code class="filename">smbldap.conf</code> and the <code class="filename">smbldap_bind.conf</code> configuration files have been moved from the directory <code class="filename">/etc/smbldap-tools</code> to @@ -392,7 +392,7 @@ Paths: <code class="constant">sambaDomainName</code>. Anyone who updates from an older version to the current release should note that the information stored under <code class="constant">NextFreeUnixId</code> must now be relocated to the DIT object <code class="constant">sambaDomainName</code>. - </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> + </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> Sites that are being upgraded from Samba-2 (or earlier versions) to Samba-3 may experience little difficulty or may require a lot of effort, depending on the complexity of the configuration. Samba-1.9.x upgrades to Samba-3 will @@ -402,31 +402,31 @@ attempted without proper planning and preparation. There are two basic modes of use of Samba versions prior to Samba-3. The first does not use LDAP, the other does. Samba-1.9.x did not provide LDAP support. Samba-2.x could be compiled with LDAP support. -</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> +</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> Where it is necessary to upgrade an old Samba installation to Samba-3, the following procedure can be followed: - </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> - <a class="indexterm" name="id2605659"></a> - <a class="indexterm" name="id2605666"></a> - <a class="indexterm" name="id2605673"></a> + </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> + <a class="indexterm" name="id2599574"></a> + <a class="indexterm" name="id2599581"></a> + <a class="indexterm" name="id2599588"></a> Stop Samba. This can be done using the appropriate system tool that is particular for each operating system or by executing the <code class="literal">kill</code> command on <code class="literal">smbd</code>, <code class="literal">nmbd</code>, and <code class="literal">winbindd</code>. - </p></li><li class="step" title="Step 2"><p> + </p></li><li><p> Find the location of the Samba <code class="filename">smb.conf</code> file and back it up to a safe location. - </p></li><li class="step" title="Step 3"><p> + </p></li><li><p> Find the location of the <code class="filename">smbpasswd</code> file and back it up to a safe location. - </p></li><li class="step" title="Step 4"><p> + </p></li><li><p> Find the location of the <code class="filename">secrets.tdb</code> file and back it up to a safe location. - </p></li><li class="step" title="Step 5"><p> - <a class="indexterm" name="id2605754"></a> - <a class="indexterm" name="id2605761"></a> - <a class="indexterm" name="id2605768"></a> - <a class="indexterm" name="id2605775"></a> + </p></li><li><p> + <a class="indexterm" name="id2599669"></a> + <a class="indexterm" name="id2599676"></a> + <a class="indexterm" name="id2599683"></a> + <a class="indexterm" name="id2599690"></a> Find the location of the lock directory. This is the directory in which Samba stores all its tdb control files. The default location used by the Samba Team is in @@ -436,8 +436,8 @@ Samba-2.x could be compiled with LDAP support. Linux Standards Base specified location is now under the <code class="filename">/var/lib/samba</code> directory. Copy all the tdb files to a safe location. - </p></li><li class="step" title="Step 6"><p> - <a class="indexterm" name="id2605814"></a> + </p></li><li><p> + <a class="indexterm" name="id2599728"></a> It is now safe to upgrade the Samba installation. On Linux systems it is not necessary to remove the Samba RPMs because a simple upgrade installation will automatically remove the old files. @@ -446,17 +446,17 @@ Samba-2.x could be compiled with LDAP support. it is advisable either to delete the Samba old installation or to move it out of the way by renaming the directories that contain the Samba binary files. - </p></li><li class="step" title="Step 7"><p> + </p></li><li><p> When the Samba upgrade has been installed, the first step that should be completed is to identify the new target locations for the control files. Follow the steps shown in <a class="link" href="upgrades.html#sbeug1" title="Location of config files">“Location of config files”</a> to locate the correct directories to which each control file must be moved. - </p></li><li class="step" title="Step 8"><p> + </p></li><li><p> Do not change the hostname. - </p></li><li class="step" title="Step 9"><p> + </p></li><li><p> Do not change the workgroup name. - </p></li><li class="step" title="Step 10"><p> - <a class="indexterm" name="id2605869"></a> + </p></li><li><p> + <a class="indexterm" name="id2599784"></a> Execute the <code class="literal">testparm</code> to validate the <code class="filename">smb.conf</code> file. This process will flag any parameters that are no longer supported. It will also flag configuration settings that may be in conflict. @@ -468,67 +468,67 @@ Samba-2.x could be compiled with LDAP support. <code class="prompt">root# </code> cd /etc/samba <code class="prompt">root# </code> testparm -s smb.conf.master > smb.conf </pre><p> - <a class="indexterm" name="id2605926"></a> + <a class="indexterm" name="id2599841"></a> The resulting <code class="filename">smb.conf</code> file will be stripped of all comments and of all nonconforming configuration settings. - </p></li><li class="step" title="Step 11"><p> - <a class="indexterm" name="id2605948"></a> + </p></li><li><p> + <a class="indexterm" name="id2599863"></a> It is now safe to start Samba using the appropriate system tool. Alternately, it is possible to just execute <code class="literal">nmbd</code>, <code class="literal">smbd</code>, and <code class="literal">winbindd</code> for the command line while logged in as the root user. - </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> - <a class="indexterm" name="id2605987"></a> - <a class="indexterm" name="id2605994"></a> - <a class="indexterm" name="id2606000"></a> + </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> + <a class="indexterm" name="id2599902"></a> + <a class="indexterm" name="id2599908"></a> + <a class="indexterm" name="id2599915"></a> Samba 2.x servers that were running as a domain controller (PDC) require changes to the configuration of the scripting interface tools that Samba uses to perform OS updates for users, groups, and trust accounts (machines and interdomain). </p><p> - <a class="indexterm" name="id2606015"></a> + <a class="indexterm" name="id2599930"></a> The following parameters are new to Samba-3 and should be correctly configured. Please refer to <a class="link" href="secure.html" title="Chapter 3. Secure Office Networking">“Secure Office Networking”</a> through <a class="link" href="2000users.html" title="Chapter 6. A Distributed 2000-User Network">“A Distributed 2000-User Network”</a> in this book for examples of use of the new parameters shown here: - <a class="indexterm" name="id2606036"></a> - <a class="indexterm" name="id2606043"></a> - <a class="indexterm" name="id2606050"></a> - <a class="indexterm" name="id2606057"></a> - <a class="indexterm" name="id2606064"></a> - <a class="indexterm" name="id2606071"></a> - <a class="indexterm" name="id2606078"></a> - </p><p> - </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> - </p><p> - <a class="indexterm" name="id2606130"></a> - <a class="indexterm" name="id2606137"></a> + <a class="indexterm" name="id2599951"></a> + <a class="indexterm" name="id2599958"></a> + <a class="indexterm" name="id2599964"></a> + <a class="indexterm" name="id2599972"></a> + <a class="indexterm" name="id2599978"></a> + <a class="indexterm" name="id2599986"></a> + <a class="indexterm" name="id2599993"></a> + </p><p> + </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> + </p><p> + <a class="indexterm" name="id2600045"></a> + <a class="indexterm" name="id2600052"></a> The <em class="parameter"><code>add machine script</code></em> functionality was previously handled by the <em class="parameter"><code>add user script</code></em>, which in Samba-3 is used exclusively to add user accounts. </p><p> - <a class="indexterm" name="id2606161"></a> - <a class="indexterm" name="id2606168"></a> - <a class="indexterm" name="id2606175"></a> - <a class="indexterm" name="id2606182"></a> - <a class="indexterm" name="id2606188"></a> - <a class="indexterm" name="id2606195"></a> - <a class="indexterm" name="id2606202"></a> - <a class="indexterm" name="id2606209"></a> - <a class="indexterm" name="id2606216"></a> + <a class="indexterm" name="id2600076"></a> + <a class="indexterm" name="id2600083"></a> + <a class="indexterm" name="id2600090"></a> + <a class="indexterm" name="id2600096"></a> + <a class="indexterm" name="id2600103"></a> + <a class="indexterm" name="id2600110"></a> + <a class="indexterm" name="id2600117"></a> + <a class="indexterm" name="id2600124"></a> + <a class="indexterm" name="id2600130"></a> Where the <em class="parameter"><code>passdb backend</code></em> used is either <code class="constant">smbpasswd</code> (the default) or the new <code class="constant">tdbsam</code>, the system interface scripts are typically used. These involve use of OS tools such as <code class="literal">useradd</code>, <code class="literal">usermod</code>, <code class="literal">userdel</code>, <code class="literal">groupadd</code>, <code class="literal">groupmod</code>, <code class="literal">groupdel</code>, and so on. </p><p> - <a class="indexterm" name="id2606276"></a> - <a class="indexterm" name="id2606283"></a> - <a class="indexterm" name="id2606290"></a> + <a class="indexterm" name="id2600191"></a> + <a class="indexterm" name="id2600198"></a> + <a class="indexterm" name="id2600205"></a> Where the <em class="parameter"><code>passdb backend</code></em> makes use of an LDAP directory, it is necessary either to use the <code class="constant">smbldap-tools</code> provided by Idealx or to use an alternate toolset provided by a third party or else home-crafted to manage the LDAP directory accounts. - </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> + </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> Samba version 2.x could be compiled for use either with or without LDAP. The LDAP control settings in the <code class="filename">smb.conf</code> file in this old version are completely different (and less complete) than they are with Samba-3. This @@ -538,8 +538,8 @@ Samba-2.x could be compiled with LDAP support. Follow the procedure outlined in <a class="link" href="upgrades.html#sbeug2" title="Samba 1.9.x and 2.x Versions Without LDAP">“Samba 1.9.x and 2.x Versions Without LDAP”</a> to affect a migration of all files to the correct locations. </p><p> - <a class="indexterm" name="id2606347"></a> - <a class="indexterm" name="id2606353"></a> + <a class="indexterm" name="id2600262"></a> + <a class="indexterm" name="id2600268"></a> The Samba SAM schema required for Samba-3 is significantly different from that used with Samba 2.x. This means that the LDAP directory must be updated using the procedure outlined in the Samba WHATSNEW.txt file that accompanies @@ -694,19 +694,19 @@ in the list. Due to a limitation in Samba's smb.conf parsing, you should not surround the DN's with quotation marks. </pre><p> - </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> + </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> The key concern in this section is to deal with the changes that have been affected in Samba-3 between the Samba-3.0.0 release and the current update. Network administrators have expressed concerns over the steps that should be taken to update Samba-3 versions. </p><p> -<a class="indexterm" name="id2606510"></a> +<a class="indexterm" name="id2600425"></a> The information in <a class="link" href="upgrades.html#sbeug1" title="Location of config files">“Location of config files”</a> would not be necessary if every person who has ever produced Samba executable (binary) files could agree on the preferred location of the <code class="filename">smb.conf</code> file and other Samba control files. Clearly, such agreement is further away than a pipedream. </p><p> -<a class="indexterm" name="id2606536"></a> +<a class="indexterm" name="id2600451"></a> Vendors and packagers who produce Samba binary installable packages do not, as a rule, use the default paths used by the Samba-Team for the location of the binary files, the <code class="filename">smb.conf</code> file, and the Samba control files (tdb's @@ -719,54 +719,54 @@ by the Samba-Team. This can lead to confusion and to much lost time as the uninformed administrator deals with apparent failure of the update to take effect. </p><p> -<a class="indexterm" name="id2606569"></a> +<a class="indexterm" name="id2600484"></a> The best advice for those lacking in code compilation experience is to use only vendor (or Samba-Team) provided binary packages. The Samba packages that are provided by the Samba-Team are generally built to use file paths that are compatible with the original OS vendor's practices. </p><p> -<a class="indexterm" name="id2606584"></a> -<a class="indexterm" name="id2606591"></a> +<a class="indexterm" name="id2600499"></a> +<a class="indexterm" name="id2600506"></a> If you are not sure whether a binary package complies with the OS vendor's practices, it is better to ask the package maintainer via email than to waste much time dealing with the nuances. Alternately, just diagnose the paths specified by the binary files following the procedure outlined above. -</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> +</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> The guidance in this section deals with updates to an existing Samba-3 server installation. - </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> + </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> With the provision that the binary Samba-3 package has been built with the same path and feature settings as the existing Samba-3 package that is being updated, an update of Samba-3 versions 3.0.0 through 3.0.4 can be updated to 3.0.5 without loss of functionality and without need to change either the <code class="filename">smb.conf</code> file or, where used, the LDAP schema. - </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> - <a class="indexterm" name="id2606646"></a> - <a class="indexterm" name="id2606653"></a> + </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> + <a class="indexterm" name="id2600561"></a> + <a class="indexterm" name="id2600568"></a> When updating versions of Samba-3 prior to 3.0.6 to 3.0.6 through 3.0.10, it is necessary only to update the LDAP schema (where LDAP is used). Always use the LDAP schema file that is shipped with the latest Samba-3 update. </p><p> - <a class="indexterm" name="id2606670"></a> - <a class="indexterm" name="id2606676"></a> - <a class="indexterm" name="id2606683"></a> + <a class="indexterm" name="id2600585"></a> + <a class="indexterm" name="id2600591"></a> + <a class="indexterm" name="id2600598"></a> Samba-3.0.6 introduced the ability to remember the last <span class="emphasis"><em>n</em></span> number of passwords a user has used. This information will work only with the <code class="constant">tdbsam</code> and <code class="constant">ldapsam</code> <em class="parameter"><code>passdb backend</code></em> facilities. </p><p> After updating the LDAP schema, do not forget to re-index the LDAP database. - </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> - <a class="indexterm" name="id2606725"></a> + </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> + <a class="indexterm" name="id2600640"></a> Samba-3.0.8 introduced changes in how the <em class="parameter"><code>username map</code></em> behaves. It also included a change in behavior of <code class="literal">winbindd</code>. Please refer to the man page for <code class="filename">smb.conf</code> before implementing any update from versions prior to 3.0.8 to a current version. </p><p> - <a class="indexterm" name="id2606757"></a> + <a class="indexterm" name="id2600672"></a> In Samba-3.0.11 a new privileges interface was implemented. Please refer to <a class="link" href="happy.html#sbehap-ppc" title="Addition of Machines to the Domain">“Addition of Machines to the Domain”</a> for information regarding this new feature. It is not necessary to implement the privileges interface, but it @@ -788,12 +788,12 @@ and all machine and inter-domain trust-accounts must be located below the machine suffix. Previous Samba releases would fall back to searching the 'ldap suffix' in some cases. </pre><p> - </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> + </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> The two most likely candidates for replacement of a server are domain member servers and domain controllers. Each needs to be handled slightly differently. - </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> - <a class="indexterm" name="id2606828"></a> + </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> + <a class="indexterm" name="id2600743"></a> Replacement of a domain member server should be done using the same procedure as outlined in <a class="link" href="unixclients.html" title="Chapter 7. Adding Domain Member Servers and Clients">“Adding Domain Member Servers and Clients”</a>. </p><p> @@ -802,12 +802,12 @@ back to searching the 'ldap suffix' in some cases. that the new server be renamed to that of the old server. This will change its SID and will necessitate rejoining to the domain. </p><p> - <a class="indexterm" name="id2606854"></a> - <a class="indexterm" name="id2606860"></a> - <a class="indexterm" name="id2606867"></a> - <a class="indexterm" name="id2606874"></a> - <a class="indexterm" name="id2606880"></a> - <a class="indexterm" name="id2606887"></a> + <a class="indexterm" name="id2600768"></a> + <a class="indexterm" name="id2600775"></a> + <a class="indexterm" name="id2600782"></a> + <a class="indexterm" name="id2600789"></a> + <a class="indexterm" name="id2600795"></a> + <a class="indexterm" name="id2600802"></a> Following a change of hostname (NetBIOS name) it is a good idea on all servers to shut down the Samba <code class="literal">smbd</code>, <code class="literal">nmbd</code>, and <code class="literal">winbindd</code> services, delete the <code class="filename">wins.dat</code> @@ -817,10 +817,10 @@ back to searching the 'ldap suffix' in some cases. resolution problems. These problems usually clear within 45 minutes of a name change, but can persist for a longer period of time. </p><p> - <a class="indexterm" name="id2606935"></a> - <a class="indexterm" name="id2606941"></a> - <a class="indexterm" name="id2606948"></a> - <a class="indexterm" name="id2606955"></a> + <a class="indexterm" name="id2600850"></a> + <a class="indexterm" name="id2600856"></a> + <a class="indexterm" name="id2600863"></a> + <a class="indexterm" name="id2600870"></a> If the old domain member server had local accounts, it is necessary to create on the new domain member server the same accounts with the same UID and GID for each account. Where the <em class="parameter"><code>passdb backend</code></em> database @@ -831,13 +831,13 @@ back to searching the 'ldap suffix' in some cases. <code class="filename">/etc/group</code> files. In this case, be sure to copy these account entries to the new target server. </p><p> - <a class="indexterm" name="id2607003"></a> + <a class="indexterm" name="id2600918"></a> Where the user accounts for both UNIX and Samba are stored in LDAP, the new target server must be configured to use the <code class="literal">nss_ldap</code> tool set. This will automatically ensure that the appropriate user entities are available on the new server. - </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> - <a class="indexterm" name="id2607030"></a> + </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> + <a class="indexterm" name="id2600945"></a> In the past, people who replaced a Windows NT4 domain controller typically installed a new server, created printers and file shares on it, then migrate across all data that was destined to reside on it. The same can of course be done with @@ -847,7 +847,7 @@ back to searching the 'ldap suffix' in some cases. have the intent to just replace the old Samba server with a new one with the same name as the old one. In this case, simply follow the same process as for upgrading a Samba 2.x system and do the following: - </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> + </p><div class="itemizedlist"><ul type="disc"><li><p> Where UNIX (POSIX) user and group accounts are stored in the system <code class="filename">/etc/passwd</code>, <code class="filename">/etc/shadow</code>, and <code class="filename">/etc/group</code> files, be sure to add the same accounts @@ -862,19 +862,19 @@ back to searching the 'ldap suffix' in some cases. <code class="literal">slapadd</code> command. Do not forget to install and configure the <code class="literal">nss_ldap</code> tool and the <code class="filename">/etc/nsswitch.conf</code> (as shown in <a class="link" href="happy.html" title="Chapter 5. Making Happy Users">“Making Happy Users”</a>). - </p></li><li class="listitem"><p> + </p></li><li><p> Copy the <code class="filename">smb.conf</code> file from the old server to the new server into the correct location as indicated previously in this chapter. - </p></li><li class="listitem"><p> + </p></li><li><p> Copy the <code class="filename">secrets.tdb</code> file, the <code class="filename">smbpasswd</code> file (if it is used), the <code class="filename">/etc/samba/passdb.tdb</code> file (only used by the <code class="constant">tdbsam</code> backend), and all the tdb control files from the old system to the correct location on the new system. - </p></li><li class="listitem"><p> + </p></li><li><p> Before starting the Samba daemons, verify that the hostname of the new server is identical to that of the old one. Note: The IP address can be different from that of the old server. - </p></li><li class="listitem"><p> + </p></li><li><p> Copy all files from the old server to the new server, taking precaution to preserve all file ownership and permissions as well as any POSIX ACLs that may have been created on the old server. @@ -890,31 +890,31 @@ back to searching the 'ldap suffix' in some cases. or the <em class="parameter"><code>netbios name</code></em> is set to the original server name, Samba should correctly pick up the original SID and preserve all other settings. It is sound advice to validate this before turning the system over to users. - </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> + </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> Yes, it works. The Windows ADMT tool can be used to migrate Samba accounts to MS Active Directory. There are a few pitfalls to be aware of: - </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> + </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> Administrator password must be THE SAME on the Samba server, the 2003 ADS, and the local Administrator account on the workstations. Perhaps this goes without saying, but there needs to be an account called <code class="constant">Administrator</code> in your Samba domain, with full administrative (root) rights to that domain. - </p></li><li class="step" title="Step 2"><p> + </p></li><li><p> In the Advanced/DNS section of the TCP/IP settings on your Windows workstations, make sure the <em class="parameter"><code>DNS suffix for this connection</code></em> field is blank. - </p></li><li class="step" title="Step 3"><p> + </p></li><li><p> Because you are migrating from Samba, user passwords cannot be migrated. You'll have to reset everyone's passwords. (If you were migrating from NT4 to ADS, you could migrate passwords as well.) </p><p> To date this has not been attempted with roaming profile support; it has been documented as working with local profiles. - </p></li><li class="step" title="Step 4"><p> + </p></li><li><p> Disable the Windows Firewall on all workstations. Otherwise, workstations won't be migrated to the new domain. - </p></li><li class="step" title="Step 5"><p> - <a class="indexterm" name="id2607301"></a> + </p></li><li><p> + <a class="indexterm" name="id2601216"></a> When migrating machines, always test first (using ADMT's test mode) and satisfy all errors before committing the migration. Note that the test will always fail, because the machine will not have been actually @@ -922,23 +922,23 @@ back to searching the 'ldap suffix' in some cases. failure was due to a problem or simply to the fact that it was just a test. </p></li></ol></div><p> - <a class="indexterm" name="id2607318"></a> + <a class="indexterm" name="id2601233"></a> There are some significant benefits of using the ADMT, besides just migrating user accounts. ADMT can be found on the Windows 2003 CD. - </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> + </p><div class="itemizedlist"><ul type="disc"><li><p> You can migrate workstations remotely. You can specify that SIDs be simply added instead of replaced, giving you the option of joining a workstation back to the old domain if something goes awry. The workstations will be joined to the new domain. - </p></li><li class="listitem"><p> + </p></li><li><p> Not only are user accounts migrated from the old domain to the new domain, but ACLs on the workstations are migrated as well. Like SIDs, ACLs can be added instead of replaced. - </p></li><li class="listitem"><p> + </p></li><li><p> Locally stored user profiles on workstations are migrated as well, presenting almost no disruption to the user. Saved passwords will be lost, just as when you administratively reset the password in Windows ADS. - </p></li><li class="listitem"><p> + </p></li><li><p> The ADMT lets you test all operations before actually performing the migration. Accounts and workstations can be migrated individually or in batches. User accounts can be safely migrated all at once (since no |