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.4.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#id2551936">Obtaining and Installing Samba</a></span></dt><dt><span class="sect1"><a href="install.html#id2551976">Configuring Samba (smb.conf)</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2552018">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#id2552921">Starting Samba</a></span></dt><dt><span class="sect2"><a href="install.html#id2553100">Example Configuration</a></span></dt><dt><span class="sect2"><a href="install.html#id2553503">SWAT</a></span></dt></dl></dd><dt><span class="sect1"><a href="install.html#id2553562">List Shares Available on the Server</a></span></dt><dt><span class="sect1"><a href="install.html#id2553614">Connect with a UNIX Client</a></span></dt><dt><span class="sect1"><a href="install.html#id2553705">Connect from a Remote SMB Client</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2553786">What If Things Don't Work?</a></span></dt><dt><span class="sect2"><a href="install.html#id2553827">Still Stuck?</a></span></dt></dl></dd><dt><span class="sect1"><a href="install.html#id2553859">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2553870">Large Number of smbd Processes</a></span></dt><dt><span class="sect2"><a href="install.html#id2553957">Error Message: open_oplock_ipc</a></span></dt><dt><span class="sect2"><a href="install.html#id2553989">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="id2551936"></a>Obtaining and Installing Samba</h2></div></div></div><p>
2
<a class="indexterm" name="id2551944"></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.75.2"><link rel="home" href="index.html" title="The Official Samba 3.4.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="id2558001"></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.
7
<a class="indexterm" name="id2551962"></a>
7
<a class="indexterm" name="id2558019"></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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2551976"></a>Configuring Samba (smb.conf)</h2></div></div></div><p>
10
<a class="indexterm" name="id2551984"></a>
11
<a class="indexterm" name="id2551990"></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="id2558041"></a>
11
<a class="indexterm" name="id2558047"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552018"></a>Configuration File Syntax</h3></div></div></div><p>
17
<a class="indexterm" name="id2552026"></a>
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="id2558083"></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
20
20
(<code class="literal">[]</code>) on a new line. Each contains zero or more key/value pairs separated by an equality
21
21
sign (<code class="literal">=</code>). The file is just a plaintext file, so you can open and edit it with your favorite
24
<a class="indexterm" name="id2552063"></a>
25
<a class="indexterm" name="id2552069"></a>
26
<a class="indexterm" name="id2552077"></a>
27
<a class="indexterm" name="id2552084"></a>
28
<a class="indexterm" name="id2552090"></a>
29
<a class="indexterm" name="id2552098"></a>
24
<a class="indexterm" name="id2558120"></a>
25
<a class="indexterm" name="id2558126"></a>
26
<a class="indexterm" name="id2558134"></a>
27
<a class="indexterm" name="id2558141"></a>
28
<a class="indexterm" name="id2558147"></a>
29
<a class="indexterm" name="id2558155"></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
32
32
server. Samba supports a number of meta-services, each of which serves its own purpose. For example, the
35
35
and that specifies the location of the intermediate spool directory into which print jobs are received
36
36
from Windows clients prior to being dispatched to the UNIX/Linux print spooler.
38
<a class="indexterm" name="id2552141"></a>
39
<a class="indexterm" name="id2552148"></a>
40
<a class="indexterm" name="id2552154"></a>
41
<a class="indexterm" name="id2552160"></a>
42
<a class="indexterm" name="id2552166"></a>
43
<a class="indexterm" name="id2552173"></a>
38
<a class="indexterm" name="id2558198"></a>
39
<a class="indexterm" name="id2558205"></a>
40
<a class="indexterm" name="id2558211"></a>
41
<a class="indexterm" name="id2558217"></a>
42
<a class="indexterm" name="id2558224"></a>
43
<a class="indexterm" name="id2558230"></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
46
46
published as a shared print queue. The <code class="literal">printers</code> stanza in the <code class="filename">smb.conf</code> file can
49
49
available as Windows print queues. If a <code class="literal">comment</code> parameter is specified, the value
50
50
of it will be displayed as part of the printer name in Windows Explorer browse lists.
52
<a class="indexterm" name="id2552222"></a>
52
<a class="indexterm" name="id2558280"></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
55
55
<code class="filename">smb.conf</code> file. Configuration parameters are documented in the <code class="filename">smb.conf</code> man page. Some parameters
56
56
can be used only in the <code class="literal">global</code> stanza, some only in share or meta-service stanzas,
57
57
and some can be used globally or just within a share or meta-service stanza.
59
<a class="indexterm" name="id2552265"></a>
59
<a class="indexterm" name="id2558322"></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="id2552284"></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="id2552312"></a><em class="parameter"><code>workgroup = WKG</code></em></td></tr><tr><td><a class="indexterm" name="id2552323"></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="id2552341"></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="id2552360"></a><em class="parameter"><code>path = /my_shared_folder</code></em></td></tr><tr><td><a class="indexterm" name="id2552371"></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>
61
<a class="indexterm" name="id2558341"></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>
63
63
This section contains brief descriptions of the databases that are used by Samba-3.
65
<a class="indexterm" name="id2552398"></a>
65
<a class="indexterm" name="id2558455"></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
80
80
Therefore the remaining control files will, in the example shown, be stored in the
81
81
<code class="filename">/var/lib/samba</code> directory.
83
<a class="indexterm" name="id2552450"></a>
83
<a class="indexterm" name="id2558507"></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
86
86
<code class="literal">tdbbackup</code> utility to backup the tdb files. All persistent tdb files must be
106
106
information so that clients that have temporarily disconnected can reconnect without
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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552921"></a>Starting Samba</h3></div></div></div><p>
110
<a class="indexterm" name="id2552928"></a>
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="id2558984"></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
113
113
are three daemons, two of which are needed as a minimum.
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="id2552960"></a>
118
<a class="indexterm" name="id2552966"></a>
117
<a class="indexterm" name="id2559016"></a>
118
<a class="indexterm" name="id2559022"></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="id2552994"></a>
124
<a class="indexterm" name="id2553000"></a>
123
<a class="indexterm" name="id2559050"></a>
124
<a class="indexterm" name="id2559056"></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="id2553027"></a>
129
<a class="indexterm" name="id2553033"></a>
128
<a class="indexterm" name="id2559083"></a>
129
<a class="indexterm" name="id2559089"></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
132
132
<code class="filename">smb.conf</code> file for the presence of the <em class="parameter"><code>idmap uid</code></em> and <em class="parameter"><code>idmap gid</code></em>
134
134
for UID and GID allocation. If these parameters are not specified, <code class="literal">winbindd</code>
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="id2553084"></a>
137
<a class="indexterm" name="id2559142"></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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553100"></a>Example Configuration</h3></div></div></div><p>
142
<a class="indexterm" name="id2553108"></a>
143
<a class="indexterm" name="id2553114"></a>
144
<a class="indexterm" name="id2553120"></a>
145
<a class="indexterm" name="id2553126"></a>
146
<a class="indexterm" name="id2553133"></a>
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="id2559165"></a>
143
<a class="indexterm" name="id2559171"></a>
144
<a class="indexterm" name="id2559177"></a>
145
<a class="indexterm" name="id2559184"></a>
146
<a class="indexterm" name="id2559190"></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
149
149
the man page for all the options. It might be worthwhile to start out with the
150
150
<code class="filename">smb.conf.default</code> configuration file and adapt it to your needs. It contains plenty of comments.
152
<a class="indexterm" name="id2553154"></a>
152
<a class="indexterm" name="id2559211"></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="id2553170"></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="id2553199"></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="id2553218"></a><em class="parameter"><code>guest ok = no</code></em></td></tr><tr><td><a class="indexterm" name="id2553228"></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="id2553242"></a>
158
<a class="indexterm" name="id2553248"></a>
159
<a class="indexterm" name="id2553254"></a>
160
<a class="indexterm" name="id2553260"></a>
155
<a class="indexterm" name="id2559227"></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="id2559299"></a>
158
<a class="indexterm" name="id2559305"></a>
159
<a class="indexterm" name="id2559311"></a>
160
<a class="indexterm" name="id2559318"></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.
163
163
(Note: The workgroup that Samba should appear in must also be set. The default
164
164
workgroup name is WORKGROUP.)
166
<a class="indexterm" name="id2553279"></a>
166
<a class="indexterm" name="id2559337"></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
169
169
the directory that contains the <code class="literal">smbd</code> command file:
171
171
<code class="prompt">root# </code> smbd -b | grep smb.conf
174
<a class="indexterm" name="id2553313"></a>
174
<a class="indexterm" name="id2559370"></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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2553334"></a>Test Your Config File with <code class="literal">testparm</code></h4></div></div></div><p>
178
<a class="indexterm" name="id2553346"></a>
179
<a class="indexterm" name="id2553352"></a>
180
<a class="indexterm" name="id2553358"></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="id2559403"></a>
179
<a class="indexterm" name="id2559409"></a>
180
<a class="indexterm" name="id2559415"></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.
183
183
Make sure it runs correctly and that the services look reasonable before proceeding. Enter the command:
190
190
Always run testparm again whenever the <code class="filename">smb.conf</code> file is changed!
192
<a class="indexterm" name="id2553406"></a>
193
<a class="indexterm" name="id2553413"></a>
194
<a class="indexterm" name="id2553419"></a>
195
<a class="indexterm" name="id2553425"></a>
192
<a class="indexterm" name="id2559464"></a>
193
<a class="indexterm" name="id2559470"></a>
194
<a class="indexterm" name="id2559476"></a>
195
<a class="indexterm" name="id2559482"></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
198
198
keep this file as small as possible. Many administrators prefer to document Samba configuration settings
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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553503"></a>SWAT</h3></div></div></div><p>
209
<a class="indexterm" name="id2553511"></a>
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="id2559568"></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
212
212
configuration of SWAT from the source code.
236
236
before it will list the shares. See the <code class="literal">smbclient</code> man page for details.
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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2553614"></a>Connect with a UNIX Client</h2></div></div></div><p>
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>
240
240
Enter the following command:
241
241
</p><pre class="screen">
242
242
<code class="prompt">$ </code><strong class="userinput"><code>smbclient <em class="replaceable"><code> //yourhostname/aservice</code></em></code></strong>
245
245
file. Try your username if you just have a <em class="parameter"><code>[homes]</code></em> section in the <code class="filename">smb.conf</code> file.</p><p>Example: If the UNIX host is called <em class="replaceable"><code>bambi</code></em> and a valid login name
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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2553705"></a>Connect from a Remote SMB Client</h2></div></div></div><p>
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>
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.
251
251
Try browsing the server from another client or "mounting" it.
266
266
be sent to the printer that owns the spoolservice that has been specified.
268
268
</p><pre class="screen"><code class="prompt">C:\> </code><strong class="userinput"><code>print filename</code></strong>
269
</pre><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553786"></a>What If Things Don't Work?</h3></div></div></div><p>
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>
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
272
272
been successfully installed at thousands of sites worldwide. It is unlikely that your particular problem is
274
274
problem and has found a way to overcome it.
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">Samba-3 by Example</span>” will help you to create a validated network environment.
277
the book <span class="quote">“<span class="quote">Samba-3 by Example</span>”</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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553827"></a>Still Stuck?</h3></div></div></div><p>
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>
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
284
284
undermined. A cool head clears the way to finding the answer you are looking for. Just remember,
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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2553859"></a>Common Errors</h2></div></div></div><p>
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>
291
291
The following questions and issues are raised repeatedly on the Samba mailing list.
292
</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553870"></a>Large Number of smbd Processes</h3></div></div></div><p>
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>
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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553957"></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>”
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 to
307
get local UDP socket for address 100007f. Error was Cannot assign requested.</span>”</span>
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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553989"></a>“<span class="quote"><span class="errorname">The network name cannot be found</span></span>”</h3></div></div></div><p>
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>
313
313
This error can be caused by one of these misconfigurations:
314
</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
314
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>You specified a nonexisting path
315
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 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><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 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>