- Timestamp:
- Jun 17, 2009, 2:19:52 PM (16 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.3.x/docs/htmldocs/Samba3-HOWTO/install.html
r218 r274 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. 2.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#id2553560">List Shares Available on the Server</a></span></dt><dt><span class="sect1"><a href="install.html#id2553613">Connect with a UNIX Client</a></span></dt><dt><span class="sect1"><a href="install.html#id2553704">Connect from a Remote SMB Client</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2553785">What If Things Don't Work?</a></span></dt><dt><span class="sect2"><a href="install.html#id2553826">Still Stuck?</a></span></dt></dl></dd><dt><span class="sect1"><a href="install.html#id2553858">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="install.html#id2553868">Large Number of smbd Processes</a></span></dt><dt><span class="sect2"><a href="install.html#id2553955">Error Message: open_oplock_ipc</a></span></dt><dt><span class="sect2"><a href="install.html#id2553988">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>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#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 2 <a class="indexterm" name="id2551944"></a> 3 3 Binary packages of Samba are included in almost any Linux or UNIX distribution. There are also some … … 200 200 be adopted is to do all documentation and configuration in a file that has another name, such as 201 201 <code class="filename">smb.conf.master</code>. The <code class="literal">testparm</code> utility can be used to generate a 202 fully optimized <code class="filename">smb.conf</code> file from this master configuration and docum tenation file as shown here:202 fully optimized <code class="filename">smb.conf</code> file from this master configuration and documentation file as shown here: 203 203 </p><pre class="screen"> 204 204 <code class="prompt">root# </code> testparm -s smb.conf.master > smb.conf … … 209 209 <a class="indexterm" name="id2553511"></a> 210 210 SWAT is a Web-based interface that can be used to facilitate the configuration of Samba. SWAT might not 211 be available in the Samba package that shipped with your platform, but in a separate package. If it is 212 necesaary to built SWAT please read the SWAT man page regarding compilation, installation, and 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 213 212 configuration of SWAT from the source code. 214 213 </p><p> … … 219 218 </p><p> 220 219 SWAT can be used from a browser on any IP-connected machine, but be aware that connecting from a remote 221 machine leaves your connection open to password sniffing because passwords will be sent over the wire in the clear. 222 </p><p> 220 machine leaves your connection open to password sniffing because passwords will be sent over the wire in the clear. 221 </p><p> 222 Please note that re-writing the configuration file using SWAT will 223 remove all comments! 223 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>. 224 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id255356 0"></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="id2553562"></a>List Shares Available on the Server</h2></div></div></div><p> 225 226 To list shares that are available from the configured Samba server, execute the 226 227 following command: … … 236 237 You can force it to list the shares without a password by adding the option 237 238 <code class="option">-N</code> to the command line. 238 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id255361 3"></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="id2553614"></a>Connect with a UNIX Client</h2></div></div></div><p> 239 240 Enter the following command: 240 241 </p><pre class="screen"> … … 245 246 is <em class="replaceable"><code>fred</code></em>, you would type:</p><pre class="screen"> 246 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> 247 </pre></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id255370 4"></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="id2553705"></a>Connect from a Remote SMB Client</h2></div></div></div><p> 248 249 Now that Samba is working correctly locally, you can try to access it from other clients. Within a few 249 250 minutes, the Samba host should be listed in the Network Neighborhood on all Windows clients of its subnet. … … 266 267 </p><p> 267 268 </p><pre class="screen"><code class="prompt">C:\> </code><strong class="userinput"><code>print filename</code></strong> 268 </pre><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id255378 5"></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="id2553786"></a>What If Things Don't Work?</h3></div></div></div><p> 269 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 270 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 … … 278 279 then follow the simple step-by-step procedure to deploy it. Later, when you have a working network 279 280 you may well want to refer back to this book for further insight into opportunities for improvement. 280 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id255382 6"></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="id2553827"></a>Still Stuck?</h3></div></div></div><p> 281 282 The best advice under the stress of abject frustration is to cool down! That may be challenging 282 283 of itself, but while you are angry or annoyed your ability to seek out a solution is somewhat … … 287 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> 288 289 for a process that can be followed to identify the cause of your problem. 289 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id255385 8"></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="id2553859"></a>Common Errors</h2></div></div></div><p> 290 291 The following questions and issues are raised repeatedly on the Samba mailing list. 291 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id25538 68"></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="id2553870"></a>Large Number of smbd Processes</h3></div></div></div><p> 292 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, 293 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. … … 302 303 <span class="application">winbindd</span> will run as one or two daemons, depending on whether or not it is being 303 304 run in <span class="emphasis"><em>split mode</em></span> (in which case there will be two instances). 304 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id255395 5"></a>Error Message: open_oplock_ipc</h3></div></div></div><p>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> 305 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 306 307 get local UDP socket for address 100007f. Error was Cannot assign requested.</span>” … … 309 310 device is an internal (virtual) network device with the IP address <span class="emphasis"><em>127.0.0.1</em></span>. 310 311 Read your OS documentation for details on how to configure the loopback on your system. 311 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id255398 8"></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" 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 313 This error can be caused by one of these misconfigurations: 313 314 </p><div class="itemizedlist"><ul type="disc"><li><p>You specified a nonexisting path
Note:
See TracChangeset
for help on using the changeset viewer.
