- Timestamp:
- Mar 1, 2010, 3:05:48 PM (15 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.3.x/docs/htmldocs/Samba3-HOWTO/install.html
r368 r411 1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 1. How to Install and Test SAMBA</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.7 5.2"><link rel="home" href="index.html" title="The Official Samba 3.3.x HOWTO and Reference Guide"><link rel="up" href="introduction.html" title="Part I. General Installation"><link rel="prev" href="introduction.html" title="Part I. General Installation"><link rel="next" href="FastStart.html" title="Chapter 2. Fast Start: Cure for Impatience"></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 1. How to Install and Test SAMBA</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="introduction.html">Prev</a> </td><th width="60%" align="center">Part I. General Installation</th><td width="20%" align="right"> <a accesskey="n" href="FastStart.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 1. How to Install and Test SAMBA"><div class="titlepage"><div><div><h2 class="title"><a name="install"></a>Chapter 1. How to Install and Test SAMBA</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Andrew</span> <span class="surname">Tridgell</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:tridge@samba.org">tridge@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Jelmer</span> <span class="othername">R.</span> <span class="surname">Vernooij</span></h3><div class="affiliation"><span class="orgname">The Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:jelmer@samba.org">jelmer@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Karl</span> <span class="surname">Auer</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:kauer@biplane.com.au">kauer@biplane.com.au</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Dan</span> <span class="surname">Shearer</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:dan@samba.org">dan@samba.org</a>></code></p></div></div></div></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="install.html#id2557993">Obtaining and Installing Samba</a></span></dt><dt><span class="sect1"><a href="install.html#id2558033">Configuring Samba (smb.conf)</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2558075">Configuration File Syntax</a></span></dt><dt><span class="sect2"><a href="install.html#tdbdocs">TDB Database File Information</a></span></dt><dt><span class="sect2"><a href="install.html#id2558977">Starting Samba</a></span></dt><dt><span class="sect2"><a href="install.html#id2559157">Example Configuration</a></span></dt><dt><span class="sect2"><a href="install.html#id2559561">SWAT</a></span></dt></dl></dd><dt><span class="sect1"><a href="install.html#id2559619">List Shares Available on the Server</a></span></dt><dt><span class="sect1"><a href="install.html#id2559671">Connect with a UNIX Client</a></span></dt><dt><span class="sect1"><a href="install.html#id2559762">Connect from a Remote SMB Client</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2559843">What If Things Don't Work?</a></span></dt><dt><span class="sect2"><a href="install.html#id2559884">Still Stuck?</a></span></dt></dl></dd><dt><span class="sect1"><a href="install.html#id2559917">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2559927">Large Number of smbd Processes</a></span></dt><dt><span class="sect2"><a href="install.html#id2560014">Error Message: open_oplock_ipc</a></span></dt><dt><span class="sect2"><a href="install.html#id2560047"><span class="quote">“<span class="quote"><span class="errorname">The network name cannot be found</span></span>”</span></a></span></dt></dl></dd></dl></div><div class="sect1" title="Obtaining and Installing Samba"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2557993"></a>Obtaining and Installing Samba</h2></div></div></div><p>2 <a class="indexterm" name="id255 8001"></a>1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 1. How to Install and Test SAMBA</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="index.html" title="The Official Samba 3.3.x HOWTO and Reference Guide"><link rel="up" href="introduction.html" title="Part I. General Installation"><link rel="prev" href="introduction.html" title="Part I. General Installation"><link rel="next" href="FastStart.html" title="Chapter 2. Fast Start: Cure for Impatience"></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 1. How to Install and Test SAMBA</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="introduction.html">Prev</a> </td><th width="60%" align="center">Part I. General Installation</th><td width="20%" align="right"> <a accesskey="n" href="FastStart.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="install"></a>Chapter 1. How to Install and Test SAMBA</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Andrew</span> <span class="orgname">Samba Team</span> <span class="surname">Tridgell</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:tridge@samba.org">tridge@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Jelmer</span> <span class="othername">R.</span> <span class="orgname">The Samba Team</span> <span class="surname">Vernooij</span></h3><div class="affiliation"><span class="orgname">The Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:jelmer@samba.org">jelmer@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="orgname">Samba Team</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Karl</span> <span class="orgname">Samba Team</span> <span class="surname">Auer</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:kauer@biplane.com.au">kauer@biplane.com.au</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Dan</span> <span class="orgname">Samba Team</span> <span class="surname">Shearer</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a class="email" href="mailto:dan@samba.org">dan@samba.org</a>></code></p></div></div></div></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="install.html#id2551909">Obtaining and Installing Samba</a></span></dt><dt><span class="sect1"><a href="install.html#id2551950">Configuring Samba (smb.conf)</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2551991">Configuration File Syntax</a></span></dt><dt><span class="sect2"><a href="install.html#tdbdocs">TDB Database File Information</a></span></dt><dt><span class="sect2"><a href="install.html#id2552892">Starting Samba</a></span></dt><dt><span class="sect2"><a href="install.html#id2553073">Example Configuration</a></span></dt><dt><span class="sect2"><a href="install.html#id2553476">SWAT</a></span></dt></dl></dd><dt><span class="sect1"><a href="install.html#id2553534">List Shares Available on the Server</a></span></dt><dt><span class="sect1"><a href="install.html#id2553587">Connect with a UNIX Client</a></span></dt><dt><span class="sect1"><a href="install.html#id2553678">Connect from a Remote SMB Client</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2553759">What If Things Don't Work?</a></span></dt><dt><span class="sect2"><a href="install.html#id2553800">Still Stuck?</a></span></dt></dl></dd><dt><span class="sect1"><a href="install.html#id2553832">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2553842">Large Number of smbd Processes</a></span></dt><dt><span class="sect2"><a href="install.html#id2553930">Error Message: open_oplock_ipc</a></span></dt><dt><span class="sect2"><a href="install.html#id2553962">The network name cannot be found</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2551909"></a>Obtaining and Installing Samba</h2></div></div></div><p> 2 <a class="indexterm" name="id2551917"></a> 3 3 Binary packages of Samba are included in almost any Linux or UNIX distribution. There are also some 4 4 packages available at <a class="ulink" href="http://samba.org/" target="_top">the Samba home page</a>. Refer to the manual of your 5 5 operating system for details on installing packages for your specific operating system. 6 6 </p><p> 7 <a class="indexterm" name="id255 8019"></a>7 <a class="indexterm" name="id2551935"></a> 8 8 If you need to compile Samba from source, check <a class="link" href="compiling.html" title="Chapter 42. How to Compile Samba">How to Compile Samba</a>. 9 </p></div><div class="sect1" title="Configuring Samba (smb.conf)"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2558033"></a>Configuring Samba (smb.conf)</h2></div></div></div><p>10 <a class="indexterm" name="id255 8041"></a>11 <a class="indexterm" name="id255 8047"></a>9 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2551950"></a>Configuring Samba (smb.conf)</h2></div></div></div><p> 10 <a class="indexterm" name="id2551957"></a> 11 <a class="indexterm" name="id2551963"></a> 12 12 Samba's configuration is stored in the <code class="filename">smb.conf</code> file, which usually resides in 13 13 <code class="filename">/etc/samba/smb.conf</code> or <code class="filename">/usr/local/samba/lib/smb.conf</code>. You can either 14 14 edit this file yourself or do it using one of the many graphical tools that are available, such as the 15 15 Web-based interface SWAT, that is included with Samba. 16 </p><div class="sect2" title="Configuration File Syntax"><div class="titlepage"><div><div><h3 class="title"><a name="id2558075"></a>Configuration File Syntax</h3></div></div></div><p>17 <a class="indexterm" name="id255 8083"></a>16 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551991"></a>Configuration File Syntax</h3></div></div></div><p> 17 <a class="indexterm" name="id2551999"></a> 18 18 The <code class="filename">smb.conf</code> file uses the same syntax as the various old <code class="filename">.ini</code> files in Windows 19 19 3.1: Each file consists of various sections, which are started by putting the section name between brackets … … 22 22 editing tool. 23 23 </p><p> 24 <a class="indexterm" name="id255 8120"></a>25 <a class="indexterm" name="id255 8126"></a>26 <a class="indexterm" name="id255 8134"></a>27 <a class="indexterm" name="id255 8141"></a>28 <a class="indexterm" name="id255 8147"></a>29 <a class="indexterm" name="id255 8155"></a>24 <a class="indexterm" name="id2552036"></a> 25 <a class="indexterm" name="id2552042"></a> 26 <a class="indexterm" name="id2552051"></a> 27 <a class="indexterm" name="id2552057"></a> 28 <a class="indexterm" name="id2552063"></a> 29 <a class="indexterm" name="id2552072"></a> 30 30 Each section in the <code class="filename">smb.conf</code> file represents either a share or a meta-service on the Samba server. The 31 31 section <code class="literal">[global]</code> is special, since it contains settings that apply to the whole Samba … … 36 36 from Windows clients prior to being dispatched to the UNIX/Linux print spooler. 37 37 </p><p> 38 <a class="indexterm" name="id255 8198"></a>39 <a class="indexterm" name="id255 8205"></a>40 <a class="indexterm" name="id255 8211"></a>41 <a class="indexterm" name="id255 8217"></a>42 <a class="indexterm" name="id255 8224"></a>43 <a class="indexterm" name="id255 8230"></a>38 <a class="indexterm" name="id2552115"></a> 39 <a class="indexterm" name="id2552121"></a> 40 <a class="indexterm" name="id2552127"></a> 41 <a class="indexterm" name="id2552133"></a> 42 <a class="indexterm" name="id2552140"></a> 43 <a class="indexterm" name="id2552146"></a> 44 44 The <code class="literal">printers</code> meta-service will cause every printer that is either specified in a 45 45 <code class="literal">printcap</code> file, via the <code class="literal">lpstat</code>, or via the CUPS API, to be … … 50 50 of it will be displayed as part of the printer name in Windows Explorer browse lists. 51 51 </p><p> 52 <a class="indexterm" name="id255 8280"></a>52 <a class="indexterm" name="id2552196"></a> 53 53 Each section of the <code class="filename">smb.conf</code> file that specifies a share, or a meta-service, is called a stanza. 54 54 The <code class="literal">global</code> stanza specifies settings that affect all the other stanzas in the … … 57 57 and some can be used globally or just within a share or meta-service stanza. 58 58 </p><p> 59 <a class="indexterm" name="id255 8322"></a>59 <a class="indexterm" name="id2552238"></a> 60 60 <a class="link" href="install.html#smbconfminimal" title="Example 1.1. A minimal smb.conf">A minimal smb.conf</a> contains a very minimal <code class="filename">smb.conf</code>. 61 <a class="indexterm" name="id255 8341"></a>62 </p><div class="example"><a name="smbconfminimal"></a><p class="title"><b>Example 1.1. A minimal smb.conf</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2558369"></a><em class="parameter"><code>workgroup = WKG</code></em></td></tr><tr><td><a class="indexterm" name="id2558380"></a><em class="parameter"><code>netbios name = MYNAME</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[share1]</code></em></td></tr><tr><td><a class="indexterm" name="id2558399"></a><em class="parameter"><code>path = /tmp</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[share2]</code></em></td></tr><tr><td><a class="indexterm" name="id2558417"></a><em class="parameter"><code>path = /my_shared_folder</code></em></td></tr><tr><td><a class="indexterm" name="id2558428"></a><em class="parameter"><code>comment = Some random files</code></em></td></tr></table></div></div><br class="example-break"></div><div class="sect2" title="TDB Database File Information"><div class="titlepage"><div><div><h3 class="title"><a name="tdbdocs"></a>TDB Database File Information</h3></div></div></div><p>61 <a class="indexterm" name="id2552257"></a> 62 </p><div class="example"><a name="smbconfminimal"></a><p class="title"><b>Example 1.1. A minimal smb.conf</b></p><div class="example-contents"><table class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2552286"></a><em class="parameter"><code>workgroup = WKG</code></em></td></tr><tr><td><a class="indexterm" name="id2552296"></a><em class="parameter"><code>netbios name = MYNAME</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[share1]</code></em></td></tr><tr><td><a class="indexterm" name="id2552315"></a><em class="parameter"><code>path = /tmp</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[share2]</code></em></td></tr><tr><td><a class="indexterm" name="id2552334"></a><em class="parameter"><code>path = /my_shared_folder</code></em></td></tr><tr><td><a class="indexterm" name="id2552344"></a><em class="parameter"><code>comment = Some random files</code></em></td></tr></table></div></div><br class="example-break"></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="tdbdocs"></a>TDB Database File Information</h3></div></div></div><p> 63 63 This section contains brief descriptions of the databases that are used by Samba-3. 64 64 </p><p> 65 <a class="indexterm" name="id255 8455"></a>65 <a class="indexterm" name="id2552371"></a> 66 66 The directory in which Samba stores the tdb files is determined by compile-time directives. Samba-3 stores 67 67 tdb files in two locations. The best way to determine these locations is to execute the following … … 81 81 <code class="filename">/var/lib/samba</code> directory. 82 82 </p><p> 83 <a class="indexterm" name="id255 8507"></a>83 <a class="indexterm" name="id2552423"></a> 84 84 The persistent tdb files are described in <a class="link" href="install.html#tdbpermfiledesc" title="Table 1.1. Persistent TDB File Descriptions">the Persistent TDB File 85 85 Descriptions table</a>. All persistent tdb files should be regularly backed up. Use the … … 107 107 needing to renegotiate the connection setup process. 108 108 </p></td><td align="left">no</td></tr><tr><td align="left">sessionid</td><td align="justify"><p>Temporary cache for miscellaneous session information and for utmp handling.</p></td><td align="left">no</td></tr><tr><td align="left">unexpected</td><td align="justify"><p>Stores packets received for which no process is actively listening.</p></td><td align="left">no</td></tr><tr><td align="left">winbindd_cache</td><td align="justify"><p>Cache of Identity information received from an NT4 domain or from ADS. Includes user 109 lists, etc.</p></td><td align="left">yes</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2" title="Starting Samba"><div class="titlepage"><div><div><h3 class="title"><a name="id2558977"></a>Starting Samba</h3></div></div></div><p>110 <a class="indexterm" name="id255 8984"></a>109 lists, etc.</p></td><td align="left">yes</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552892"></a>Starting Samba</h3></div></div></div><p> 110 <a class="indexterm" name="id2552900"></a> 111 111 Samba essentially consists of two or three daemons. A daemon is a UNIX application that runs in the background and provides services. 112 112 An example of a service is the Apache Web server for which the daemon is called <code class="literal">httpd</code>. In the case of Samba there … … 115 115 The Samba server is made up of the following daemons: 116 116 </p><div class="variablelist"><dl><dt><span class="term">nmbd</span></dt><dd><p> 117 <a class="indexterm" name="id255 9016"></a>118 <a class="indexterm" name="id255 9022"></a>117 <a class="indexterm" name="id2552931"></a> 118 <a class="indexterm" name="id2552938"></a> 119 119 This daemon handles all name registration and resolution requests. It is the primary vehicle involved 120 120 in network browsing. It handles all UDP-based protocols. The <code class="literal">nmbd</code> daemon should 121 121 be the first command started as part of the Samba startup process. 122 122 </p></dd><dt><span class="term">smbd</span></dt><dd><p> 123 <a class="indexterm" name="id255 9050"></a>124 <a class="indexterm" name="id255 9056"></a>123 <a class="indexterm" name="id2552965"></a> 124 <a class="indexterm" name="id2552972"></a> 125 125 This daemon handles all TCP/IP-based connection services for file- and print-based operations. It also 126 126 manages local authentication. It should be started immediately following the startup of <code class="literal">nmbd</code>. 127 127 </p></dd><dt><span class="term">winbindd</span></dt><dd><p> 128 <a class="indexterm" name="id255 9083"></a>129 <a class="indexterm" name="id255 9089"></a>128 <a class="indexterm" name="id2552998"></a> 129 <a class="indexterm" name="id2553005"></a> 130 130 This daemon should be started when Samba is a member of a Windows NT4 or ADS domain. It is also needed when 131 131 Samba has trust relationships with another domain. The <code class="literal">winbindd</code> daemon will check the … … 135 135 will start but it will not be able to allocate UIDs or GIDs. 136 136 </p></dd></dl></div><p> 137 <a class="indexterm" name="id255 9142"></a>137 <a class="indexterm" name="id2553057"></a> 138 138 When Samba has been packaged by an operating system vendor, the startup process is typically a custom feature of its 139 139 integration into the platform as a whole. Please refer to your operating system platform administration manuals for 140 140 specific information pertaining to correct management of Samba startup. 141 </p></div><div class="sect2" title="Example Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="id2559157"></a>Example Configuration</h3></div></div></div><p>142 <a class="indexterm" name="id255 9165"></a>143 <a class="indexterm" name="id255 9171"></a>144 <a class="indexterm" name="id255 9177"></a>145 <a class="indexterm" name="id255 9184"></a>146 <a class="indexterm" name="id255 9190"></a>141 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553073"></a>Example Configuration</h3></div></div></div><p> 142 <a class="indexterm" name="id2553080"></a> 143 <a class="indexterm" name="id2553087"></a> 144 <a class="indexterm" name="id2553093"></a> 145 <a class="indexterm" name="id2553099"></a> 146 <a class="indexterm" name="id2553106"></a> 147 147 There are sample configuration files in the examples subdirectory in the source code distribution tarball 148 148 package. It is suggested you read them carefully so you can see how the options go together in practice. See … … 150 150 <code class="filename">smb.conf.default</code> configuration file and adapt it to your needs. It contains plenty of comments. 151 151 </p><p> 152 <a class="indexterm" name="id255 9211"></a>152 <a class="indexterm" name="id2553127"></a> 153 153 The simplest useful configuration file would contain something like that shown in 154 154 <a class="link" href="install.html#simple-example" title="Example 1.2. Another simple smb.conf File">Another simple smb.conf File</a>. 155 <a class="indexterm" name="id255 9227"></a>156 </p><div class="example"><a name="simple-example"></a><p class="title"><b>Example 1.2. Another simple smb.conf File</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2559256"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[homes]</code></em></td></tr><tr><td><a class="indexterm" name="id2559275"></a><em class="parameter"><code>guest ok = no</code></em></td></tr><tr><td><a class="indexterm" name="id2559285"></a><em class="parameter"><code>read only = no</code></em></td></tr></table></div></div><br class="example-break"><p>157 <a class="indexterm" name="id255 9299"></a>158 <a class="indexterm" name="id255 9305"></a>159 <a class="indexterm" name="id255 9311"></a>160 <a class="indexterm" name="id255 9318"></a>155 <a class="indexterm" name="id2553143"></a> 156 </p><div class="example"><a name="simple-example"></a><p class="title"><b>Example 1.2. Another simple smb.conf File</b></p><div class="example-contents"><table class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2553172"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[homes]</code></em></td></tr><tr><td><a class="indexterm" name="id2553190"></a><em class="parameter"><code>guest ok = no</code></em></td></tr><tr><td><a class="indexterm" name="id2553201"></a><em class="parameter"><code>read only = no</code></em></td></tr></table></div></div><br class="example-break"><p> 157 <a class="indexterm" name="id2553214"></a> 158 <a class="indexterm" name="id2553221"></a> 159 <a class="indexterm" name="id2553227"></a> 160 <a class="indexterm" name="id2553233"></a> 161 161 This will allow connections by anyone with an account on the server, using either 162 162 their login name or <em class="parameter"><code>homes</code></em> as the service name. … … 164 164 workgroup name is WORKGROUP.) 165 165 </p><p> 166 <a class="indexterm" name="id255 9337"></a>166 <a class="indexterm" name="id2553252"></a> 167 167 Make sure you put the <code class="filename">smb.conf</code> file in the correct place. Note, the correct location of this file 168 168 depends on how the binary files were built. You can discover the correct location by executing from … … 172 172 </pre><p> 173 173 </p><p> 174 <a class="indexterm" name="id255 9370"></a>174 <a class="indexterm" name="id2553286"></a> 175 175 For more information about security settings for the <em class="parameter"><code>[homes]</code></em> share, please refer to 176 176 <a class="link" href="securing-samba.html" title="Chapter 18. Securing Samba">Securing Samba</a>. 177 </p><div class="sect3" title="Test Your Config File with testparm"><div class="titlepage"><div><div><h4 class="title"><a name="id2559391"></a>Test Your Config File with <code class="literal">testparm</code></h4></div></div></div><p>178 <a class="indexterm" name="id255 9403"></a>179 <a class="indexterm" name="id255 9409"></a>180 <a class="indexterm" name="id255 9415"></a>177 </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2553307"></a>Test Your Config File with <code class="literal">testparm</code></h4></div></div></div><p> 178 <a class="indexterm" name="id2553318"></a> 179 <a class="indexterm" name="id2553325"></a> 180 <a class="indexterm" name="id2553331"></a> 181 181 It's important to validate the contents of the <code class="filename">smb.conf</code> file using the <span class="application">testparm</span> program. 182 182 If testparm runs correctly, it will list the loaded services. If not, it will give an error message. … … 190 190 Always run testparm again whenever the <code class="filename">smb.conf</code> file is changed! 191 191 </p><p> 192 <a class="indexterm" name="id255 9464"></a>193 <a class="indexterm" name="id255 9470"></a>194 <a class="indexterm" name="id255 9476"></a>195 <a class="indexterm" name="id255 9482"></a>192 <a class="indexterm" name="id2553379"></a> 193 <a class="indexterm" name="id2553386"></a> 194 <a class="indexterm" name="id2553392"></a> 195 <a class="indexterm" name="id2553398"></a> 196 196 The <code class="filename">smb.conf</code> file is constantly checked by the Samba daemons <code class="literal">smbd</code> and every instance of 197 197 itself that it spawns, <code class="literal">nmbd</code> and <code class="literal">winbindd</code>. It is good practice to … … 206 206 This administrative method makes it possible to maintain detailed configuration change records while at 207 207 the same time keeping the working <code class="filename">smb.conf</code> file size to the minimum necessary. 208 </p></div></div><div class="sect2" title="SWAT"><div class="titlepage"><div><div><h3 class="title"><a name="id2559561"></a>SWAT</h3></div></div></div><p>209 <a class="indexterm" name="id255 9568"></a>208 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553476"></a>SWAT</h3></div></div></div><p> 209 <a class="indexterm" name="id2553484"></a> 210 210 SWAT is a Web-based interface that can be used to facilitate the configuration of Samba. SWAT might not 211 211 be available in the Samba package that shipped with your platform, but in a separate package. If you need to build SWAT please read the SWAT man page regarding compilation, installation, and … … 223 223 remove all comments! 224 224 More information about SWAT can be found in <a class="link" href="SWAT.html" title="Chapter 37. SWAT: The Samba Web Administration Tool">The Samba Web Administration Tool</a>. 225 </p></div></div><div class="sect1" title="List Shares Available on the Server"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2559619"></a>List Shares Available on the Server</h2></div></div></div><p>225 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2553534"></a>List Shares Available on the Server</h2></div></div></div><p> 226 226 To list shares that are available from the configured Samba server, execute the 227 227 following command: … … 237 237 You can force it to list the shares without a password by adding the option 238 238 <code class="option">-N</code> to the command line. 239 </p></div><div class="sect1" title="Connect with a UNIX Client"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2559671"></a>Connect with a UNIX Client</h2></div></div></div><p>239 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2553587"></a>Connect with a UNIX Client</h2></div></div></div><p> 240 240 Enter the following command: 241 241 </p><pre class="screen"> … … 246 246 is <em class="replaceable"><code>fred</code></em>, you would type:</p><pre class="screen"> 247 247 <code class="prompt">$ </code><strong class="userinput"><code>smbclient //<em class="replaceable"><code>bambi</code></em>/<em class="replaceable"><code>fred</code></em></code></strong> 248 </pre></div><div class="sect1" title="Connect from a Remote SMB Client"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2559762"></a>Connect from a Remote SMB Client</h2></div></div></div><p>248 </pre></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2553678"></a>Connect from a Remote SMB Client</h2></div></div></div><p> 249 249 Now that Samba is working correctly locally, you can try to access it from other clients. Within a few 250 250 minutes, the Samba host should be listed in the Network Neighborhood on all Windows clients of its subnet. … … 267 267 </p><p> 268 268 </p><pre class="screen"><code class="prompt">C:\> </code><strong class="userinput"><code>print filename</code></strong> 269 </pre><div class="sect2" title="What If Things Don't Work?"><div class="titlepage"><div><div><h3 class="title"><a name="id2559843"></a>What If Things Don't Work?</h3></div></div></div><p>269 </pre><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553759"></a>What If Things Don't Work?</h3></div></div></div><p> 270 270 You might want to read <a class="link" href="diagnosis.html" title="Chapter 38. The Samba Checklist">The Samba Checklist</a>. If you are still 271 271 stuck, refer to <a class="link" href="problems.html" title="Chapter 39. Analyzing and Solving Samba Problems">Analyzing and Solving Samba Problems</a>. Samba has … … 275 275 </p><p> 276 276 If you are new to Samba, and particularly if you are new to Windows networking, or to UNIX/Linux, 277 the book <span class="quote">“<span class="quote">Samba-3 by Example</span>”</span>will help you to create a validated network environment.277 the book “<span class="quote">Samba-3 by Example</span>” will help you to create a validated network environment. 278 278 Simply choose from the first five chapters the network design that most closely matches site needs, 279 279 then follow the simple step-by-step procedure to deploy it. Later, when you have a working network 280 280 you may well want to refer back to this book for further insight into opportunities for improvement. 281 </p></div><div class="sect2" title="Still Stuck?"><div class="titlepage"><div><div><h3 class="title"><a name="id2559884"></a>Still Stuck?</h3></div></div></div><p>281 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553800"></a>Still Stuck?</h3></div></div></div><p> 282 282 The best advice under the stress of abject frustration is to cool down! That may be challenging 283 283 of itself, but while you are angry or annoyed your ability to seek out a solution is somewhat … … 288 288 Now that you have cooled down a bit, please refer to <a class="link" href="diagnosis.html" title="Chapter 38. The Samba Checklist">the Samba Checklist</a> 289 289 for a process that can be followed to identify the cause of your problem. 290 </p></div></div><div class="sect1" title="Common Errors"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2559917"></a>Common Errors</h2></div></div></div><p>290 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2553832"></a>Common Errors</h2></div></div></div><p> 291 291 The following questions and issues are raised repeatedly on the Samba mailing list. 292 </p><div class="sect2" title="Large Number of smbd Processes"><div class="titlepage"><div><div><h3 class="title"><a name="id2559927"></a>Large Number of smbd Processes</h3></div></div></div><p>292 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553842"></a>Large Number of smbd Processes</h3></div></div></div><p> 293 293 Samba consists of three core programs: <span class="application">nmbd</span>, <span class="application">smbd</span>, and <span class="application">winbindd</span>. <span class="application">nmbd</span> is the name server message daemon, 294 294 <span class="application">smbd</span> is the server message daemon, and <span class="application">winbindd</span> is the daemon that handles communication with domain controllers. … … 303 303 <span class="application">winbindd</span> will run as one or two daemons, depending on whether or not it is being 304 304 run in <span class="emphasis"><em>split mode</em></span> (in which case there will be two instances). 305 </p></div><div class="sect2" title="Error Message: open_oplock_ipc"><div class="titlepage"><div><div><h3 class="title"><a name="id2560014"></a>Error Message: open_oplock_ipc</h3></div></div></div><p>306 An error message is observed in the log files when <span class="application">smbd</span> is started: <span class="quote">“<span class="quote">open_oplock_ipc: Failed to307 get local UDP socket for address 100007f. Error was Cannot assign requested.</span>” </span>305 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553930"></a>Error Message: open_oplock_ipc</h3></div></div></div><p> 306 An error message is observed in the log files when <span class="application">smbd</span> is started: “<span class="quote">open_oplock_ipc: Failed to 307 get local UDP socket for address 100007f. Error was Cannot assign requested.</span>” 308 308 </p><p> 309 309 Your loopback device isn't working correctly. Make sure it is configured correctly. The loopback 310 310 device is an internal (virtual) network device with the IP address <span class="emphasis"><em>127.0.0.1</em></span>. 311 311 Read your OS documentation for details on how to configure the loopback on your system. 312 </p></div><div class="sect2" title="“The network name cannot be found”"><div class="titlepage"><div><div><h3 class="title"><a name="id2560047"></a><span class="quote">“<span class="quote"><span class="errorname">The network name cannot be found</span></span>”</span></h3></div></div></div><p>312 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553962"></a>“<span class="quote"><span class="errorname">The network name cannot be found</span></span>”</h3></div></div></div><p> 313 313 This error can be caused by one of these misconfigurations: 314 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>You specified a nonexisting path315 for the share in <code class="filename">smb.conf</code>.</p></li><li class="listitem"><p>The user you are trying to access the share with does not314 </p><div class="itemizedlist"><ul type="disc"><li><p>You specified a nonexisting path 315 for the share in <code class="filename">smb.conf</code>.</p></li><li><p>The user you are trying to access the share with does not 316 316 have sufficient permissions to access the path for 317 the share. Both read (r) and access (x) should be possible.</p></li><li class="listitem"><p>The share you are trying to access does not exist.</p></li></ul></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="introduction.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="introduction.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="FastStart.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part I. General Installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Fast Start: Cure for Impatience</td></tr></table></div></body></html>317 the share. Both read (r) and access (x) should be possible.</p></li><li><p>The share you are trying to access does not exist.</p></li></ul></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="introduction.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="introduction.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="FastStart.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part I. General Installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Fast Start: Cure for Impatience</td></tr></table></div></body></html>
Note:
See TracChangeset
for help on using the changeset viewer.
