Initial import
[samba] / docs / htmldocs / Samba3-HOWTO / diagnosis.html
diff --git a/docs/htmldocs/Samba3-HOWTO/diagnosis.html b/docs/htmldocs/Samba3-HOWTO/diagnosis.html
new file mode 100644 (file)
index 0000000..ca1e907
--- /dev/null
@@ -0,0 +1,352 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 37. The Samba Checklist</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="The Official Samba-3 HOWTO and Reference Guide"><link rel="up" href="troubleshooting.html" title="Part V. Troubleshooting"><link rel="prev" href="troubleshooting.html" title="Part V. Troubleshooting"><link rel="next" href="problems.html" title="Chapter 38. Analyzing and Solving Samba Problems"></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 37. The Samba Checklist</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="troubleshooting.html">Prev</a> </td><th width="60%" align="center">Part V. Troubleshooting</th><td width="20%" align="right"> <a accesskey="n" href="problems.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="diagnosis"></a>Chapter 37. The Samba Checklist</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">&lt;<a href="mailto:tridge@samba.org">tridge@samba.org</a>&gt;</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">&lt;<a href="mailto:jelmer@samba.org">jelmer@samba.org</a>&gt;</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">&lt;<a href="mailto:dan@samba.org">dan@samba.org</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">Wed Jan 15</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="diagnosis.html#id2649141">Introduction</a></span></dt><dt><span class="sect1"><a href="diagnosis.html#id2649180">Assumptions</a></span></dt><dt><span class="sect1"><a href="diagnosis.html#id2649477">The Tests</a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2649141"></a>Introduction</h2></div></div></div><p>
+<a class="indexterm" name="id2649149"></a>
+This file contains a list of tests you can perform to validate your
+Samba server. It also tells you what the likely cause of the problem
+is if it fails any one of these steps. If it passes all these tests,
+then it is probably working fine.
+</p><p>
+You should do all the tests in the order shown. We have tried to
+carefully choose them so later tests only use capabilities verified in
+the earlier tests. However, do not stop at the first error: there
+have been some instances when continuing with the tests has helped
+to solve a problem.
+</p><p>
+If you send one of the Samba mailing lists  an email saying, &#8220;<span class="quote">It does not work,</span>&#8221;
+and you have not followed this test procedure, you should not be surprised
+if your email is ignored.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2649180"></a>Assumptions</h2></div></div></div><p>
+In all of the tests, it is assumed you have a Samba server called 
+BIGSERVER and a PC called ACLIENT, both in workgroup TESTGROUP.
+</p><p>
+The procedure is similar for other types of clients.
+</p><p>
+It is also assumed you know the name of an available share in your
+<code class="filename">smb.conf</code>. I for our examples this share is called <em class="parameter"><code>tmp</code></em>.
+You can add a <em class="parameter"><code>tmp</code></em> share like this by adding the
+lines shown in <a href="diagnosis.html#tmpshare" title="Example 37.1. smb.conf with [tmp] Share">the next example</a>.
+</p><div class="example"><a name="tmpshare"></a><p class="title"><b>Example 37.1. smb.conf with [tmp] Share</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[tmp]</code></em></td></tr><tr><td><a class="indexterm" name="id2649252"></a><em class="parameter"><code>comment = temporary files </code></em></td></tr><tr><td><a class="indexterm" name="id2649264"></a><em class="parameter"><code>path = /tmp</code></em></td></tr><tr><td><a class="indexterm" name="id2649277"></a><em class="parameter"><code>read only = yes</code></em></td></tr></table></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
+These tests assume version 3.0.0 or later of the Samba suite.
+Some commands shown did not exist in earlier versions. 
+</p></div><p>
+<a class="indexterm" name="id2649299"></a>
+<a class="indexterm" name="id2649306"></a>
+<a class="indexterm" name="id2649313"></a>
+Please pay attention to the error messages you receive. If any error message
+reports that your server is being unfriendly, you should first check that your
+IP name resolution is correctly set up. Make sure your <code class="filename">/etc/resolv.conf</code>
+file points to name servers that really do exist.
+</p><p>
+<a class="indexterm" name="id2649334"></a>
+<a class="indexterm" name="id2649341"></a>
+<a class="indexterm" name="id2649348"></a>
+<a class="indexterm" name="id2649354"></a>
+Also, if you do not have DNS server access for name resolution, please check
+that the settings for your <code class="filename">smb.conf</code> file results in <em class="parameter"><code>dns proxy = no</code></em>. The
+best way to check this is with <span><strong class="command">testparm smb.conf</strong></span>.
+</p><p>
+<a class="indexterm" name="id2649385"></a>
+<a class="indexterm" name="id2649392"></a>
+<a class="indexterm" name="id2649399"></a>
+<a class="indexterm" name="id2649406"></a>
+<a class="indexterm" name="id2649413"></a>
+It is helpful to monitor the log files during testing by using the
+<span><strong class="command">tail -F log_file_name</strong></span> in a separate
+terminal console (use ctrl-alt-F1 through F6 or multiple terminals in X). 
+Relevant log files can be found (for default installations) in
+<code class="filename">/usr/local/samba/var</code>. Also, connection logs from
+machines can be found here or possibly in <code class="filename">/var/log/samba</code>,
+depending on how or if you specified logging in your <code class="filename">smb.conf</code> file.
+</p><p>
+If you make changes to your <code class="filename">smb.conf</code> file while going through these test,
+remember to restart <span class="application">smbd</span> and <span class="application">nmbd</span>.
+</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2649477"></a>The Tests</h2></div></div></div><div class="procedure"><a name="id2649482"></a><p class="title"><b>Procedure 37.1. Diagnosing Your Samba Server</b></p><ol type="1"><li><p>
+<a class="indexterm" name="id2649495"></a>
+In the directory in which you store your <code class="filename">smb.conf</code> file, run the command
+<span><strong class="command">testparm smb.conf</strong></span>. If it reports any errors, then your <code class="filename">smb.conf</code>
+configuration file is faulty.
+</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
+<a class="indexterm" name="id2649526"></a>
+<a class="indexterm" name="id2649533"></a>
+Your <code class="filename">smb.conf</code> file may be located in <code class="filename">/etc/samba</code>
+or in <code class="filename">/usr/local/samba/lib</code>.
+</p></div></li><li><p>
+<a class="indexterm" name="id2649567"></a>
+Run the command <span><strong class="command">ping BIGSERVER</strong></span> from the PC and
+<span><strong class="command">ping ACLIENT</strong></span> from the UNIX box. If you do not get a valid response,
+then your TCP/IP software is not correctly installed. 
+</p><p>
+You will need to start a &#8220;<span class="quote">DOS prompt</span>&#8221; window on the PC to run ping.
+</p><p>
+<a class="indexterm" name="id2649599"></a>
+<a class="indexterm" name="id2649606"></a>
+<a class="indexterm" name="id2649613"></a>
+If you get a message saying &#8220;<span class="quote"><span class="errorname">host not found</span></span>&#8221; or a similar message, then
+your DNS software or <code class="filename">/etc/hosts</code> file is not correctly set up.  If using DNS, check that
+the <code class="filename">/etc/resolv.conf</code> has correct, current, entries in it. It is possible to run
+Samba without DNS entries for the server and client, but it is assumed you do have correct entries for the
+remainder of these tests.
+</p><p>
+<a class="indexterm" name="id2649645"></a>
+<a class="indexterm" name="id2649652"></a>
+<a class="indexterm" name="id2649659"></a>
+Another reason why ping might fail is if your host is running firewall 
+software. You will need to relax the rules to let in the workstation
+in question, perhaps by allowing access from another subnet (on Linux
+this is done via the appropriate firewall maintenance commands <span><strong class="command">ipchains</strong></span>
+or <span><strong class="command">iptables</strong></span>).
+</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
+Modern Linux distributions install ipchains/iptables by default. 
+This is a common problem that is often overlooked.
+</p></div><p>
+<a class="indexterm" name="id2649694"></a>
+<a class="indexterm" name="id2649701"></a>
+If you wish to check what firewall rules may be present in a system under test, simply run
+<span><strong class="command">iptables -L -v</strong></span>, or if <em class="parameter"><code>ipchains</code></em>-based firewall rules are in use,
+<span><strong class="command">ipchains -L -v</strong></span>.
+</p><p>
+Here is a sample listing from a system that has an external Ethernet interface (eth1) on which Samba
+is not active and an internal (private network) interface (eth0) on which Samba is active:
+</p><pre class="screen">
+frodo:~ # iptables -L -v
+Chain INPUT (policy DROP 98496 packets, 12M bytes)
+ pkts bytes target     prot opt in     out     source     destination
+ 187K  109M ACCEPT     all  --  lo     any     anywhere   anywhere
+ 892K  125M ACCEPT     all  --  eth0   any     anywhere   anywhere
+1399K 1380M ACCEPT     all  --  eth1   any     anywhere   anywhere  \
+                                       state RELATED,ESTABLISHED
+
+Chain FORWARD (policy DROP 0 packets, 0 bytes)
+ pkts bytes target     prot opt in     out     source     destination
+ 978K 1177M ACCEPT     all  --  eth1   eth0    anywhere   anywhere \
+                                       state RELATED,ESTABLISHED
+ 658K   40M ACCEPT     all  --  eth0   eth1    anywhere   anywhere
+    0     0 LOG        all  --  any    any     anywhere   anywhere \
+                                       LOG level warning
+
+Chain OUTPUT (policy ACCEPT 2875K packets, 1508M bytes)
+ pkts bytes target     prot opt in     out     source     destination
+
+Chain reject_func (0 references)
+ pkts bytes target     prot opt in     out     source     destination
+</pre><p>
+</p></li><li><p>
+Run the command <span><strong class="command">smbclient -L BIGSERVER</strong></span>
+on the UNIX box. You should get back a list of available shares. 
+</p><p>
+<a class="indexterm" name="id2649776"></a>
+<a class="indexterm" name="id2649783"></a>
+<a class="indexterm" name="id2649790"></a>
+<a class="indexterm" name="id2649796"></a>
+<a class="indexterm" name="id2649803"></a>
+<a class="indexterm" name="id2649810"></a>
+If you get an error message containing the string &#8220;<span class="quote">bad password</span>&#8221;, then
+you probably have either an incorrect <em class="parameter"><code>hosts allow</code></em>, 
+<em class="parameter"><code>hosts deny</code></em>, or <em class="parameter"><code>valid users</code></em> line in your 
+<code class="filename">smb.conf</code>, or your guest account is not valid. Check what your guest account is using <span class="application">testparm</span> and
+temporarily remove any <em class="parameter"><code>hosts allow</code></em>, <em class="parameter"><code>hosts deny</code></em>,
+<em class="parameter"><code>valid users</code></em>, or <em class="parameter"><code>invalid users</code></em> lines.
+</p><p>
+<a class="indexterm" name="id2649881"></a>
+If you get a message <code class="literal">connection refused</code> response, then the <span><strong class="command">smbd</strong></span> server may
+not be running. If you installed it in <code class="filename">inetd.conf</code>, then you probably edited
+that file incorrectly. If you installed it as a daemon, then check that
+it is running and check that the netbios-ssn port is in a LISTEN
+state using <span><strong class="command">netstat -a</strong></span>.
+</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
+<a class="indexterm" name="id2649920"></a>
+<a class="indexterm" name="id2649927"></a>
+Some UNIX/Linux systems use <span><strong class="command">xinetd</strong></span> in place of
+<span><strong class="command">inetd</strong></span>. Check your system documentation for the location
+of the control files for your particular system implementation of
+the network super daemon.
+</p></div><p>
+If you get a message saying <code class="literal">session request failed,</code> the server refused the
+connection. If it says &#8220;<span class="quote">Your server software is being unfriendly,</span>&#8221; then
+it's probably because you have invalid command line parameters to <span class="application">smbd</span>,
+or a similar fatal problem with the initial startup of <span class="application">smbd</span>. Also
+check your config file (<code class="filename">smb.conf</code>) for syntax errors with <span class="application">testparm</span>
+and that the various directories where Samba keeps its log and lock
+files exist.
+</p><p>
+There are a number of reasons for which smbd may refuse or decline
+a session request. The most common of these involve one or more of
+the <code class="filename">smb.conf</code> file entries as shown in <a href="diagnosis.html#modif1" title="Example 37.2. Configuration for Allowing Connections Only from a Certain Subnet">the next example</a>.
+</p><div class="example"><a name="modif1"></a><p class="title"><b>Example 37.2. Configuration for Allowing Connections Only from a Certain Subnet</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[globals]</code></em></td></tr><tr><td><a class="indexterm" name="id2650040"></a><em class="parameter"><code>hosts deny = ALL</code></em></td></tr><tr><td><a class="indexterm" name="id2650052"></a><em class="parameter"><code>hosts allow = xxx.xxx.xxx.xxx/yy</code></em></td></tr><tr><td><a class="indexterm" name="id2650065"></a><em class="parameter"><code>interfaces = eth0</code></em></td></tr><tr><td><a class="indexterm" name="id2650078"></a><em class="parameter"><code>bind interfaces only = Yes</code></em></td></tr></table></div><p>
+<a class="indexterm" name="id2650094"></a>
+In <a href="diagnosis.html#modif1" title="Example 37.2. Configuration for Allowing Connections Only from a Certain Subnet">Configuration for Allowing Connections Only from a Certain Subnet</a>, no
+allowance has been made for any session requests that will automatically translate to the loopback adapter
+address 127.0.0.1.  To solve this problem, change these lines as shown in <a href="diagnosis.html#modif2" title="Example 37.3. Configuration for Allowing Connections from a Certain Subnet and localhost">the following
+example</a>.
+</p><div class="example"><a name="modif2"></a><p class="title"><b>Example 37.3. Configuration for Allowing Connections from a Certain Subnet and localhost</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[globals]</code></em></td></tr><tr><td><a class="indexterm" name="id2650146"></a><em class="parameter"><code>hosts deny = ALL</code></em></td></tr><tr><td><a class="indexterm" name="id2650158"></a><em class="parameter"><code>hosts allow = xxx.xxx.xxx.xxx/yy 127.</code></em></td></tr><tr><td><a class="indexterm" name="id2650172"></a><em class="parameter"><code>interfaces = eth0 lo</code></em></td></tr></table></div><p>
+<a class="indexterm" name="id2650188"></a>
+<a class="indexterm" name="id2650194"></a>
+Another common cause of these two errors is having something already running on port <code class="constant">139</code>,
+such as Samba (<span class="application">smbd</span> is running from <span class="application">inetd</span> already) or Digital's Pathworks. Check
+your <code class="filename">inetd.conf</code> file before trying to start <span class="application">smbd</span> as a daemon  it can avoid a
+lot of frustration!
+</p><p>
+<a class="indexterm" name="id2650239"></a>
+<a class="indexterm" name="id2650245"></a>
+<a class="indexterm" name="id2650252"></a>
+<a class="indexterm" name="id2650259"></a>
+<a class="indexterm" name="id2650266"></a>
+And yet another possible cause for failure of this test is when the subnet mask and/or broadcast address
+settings are incorrect. Please check that the network interface IP address/broadcast address/subnet mask
+settings are correct and that Samba has correctly noted these in the <code class="filename">log.nmbd</code> file.
+</p></li><li><p>
+<a class="indexterm" name="id2650292"></a>
+Run the command <span><strong class="command">nmblookup -B BIGSERVER __SAMBA__</strong></span>.
+You should get back the IP address of your Samba server.
+</p><p>
+<a class="indexterm" name="id2650310"></a>
+<a class="indexterm" name="id2650316"></a>
+<a class="indexterm" name="id2650323"></a>
+If you do not, then <span class="application">nmbd</span> is incorrectly installed. Check your <code class="filename">inetd.conf</code>
+if you run it from there, or that the daemon is running and listening to UDP port 137.
+</p><p>
+One common problem is that many inetd implementations can't take many
+parameters on the command line. If this is the case, then create a
+one-line script that contains the right parameters and run that from
+inetd.
+</p></li><li><p>
+<a class="indexterm" name="id2650360"></a>
+Run the command <span><strong class="command">nmblookup -B ACLIENT `*'</strong></span>.
+</p><p>
+You should get the PC's IP address back. If you do not, then the client
+software on the PC isn't installed correctly, or isn't started, or you
+got the name of the PC wrong. 
+</p><p>
+If ACLIENT does not resolve via DNS, then use the IP address of the
+client in the above test.
+</p></li><li><p>
+Run the command <span><strong class="command">nmblookup -d 2 `*'</strong></span>.
+</p><p>
+This time we are trying the same as the previous test but are trying
+it via a broadcast to the default broadcast address. A number of
+NetBIOS/TCP/IP hosts on the network should respond, although Samba may
+not catch all of the responses in the short time it listens. You
+should see the <code class="literal">got a positive name query response</code>
+messages from several hosts.
+</p><p>
+<a class="indexterm" name="id2650417"></a>
+If this does not give a result similar to the previous test, then nmblookup isn't correctly getting your
+broadcast address through its automatic mechanism. In this case you should experiment with the <a class="indexterm" name="id2650428"></a>interfaces option in <code class="filename">smb.conf</code> to manually configure your IP address, broadcast, and netmask.
+</p><p>
+If your PC and server aren't on the same subnet, then you will need to use the
+<code class="option">-B</code> option to set the broadcast address to that of the PC's subnet.
+</p><p>
+This test will probably fail if your subnet mask and broadcast address are
+not correct. (Refer to test 3 notes above).
+</p></li><li><p>
+<a class="indexterm" name="id2650465"></a>
+Run the command <span><strong class="command">smbclient //BIGSERVER/TMP</strong></span>. You should 
+then be prompted for a password. You should use the password of the account
+with which you are logged into the UNIX box. If you want to test with
+another account, then add the <code class="option">-U accountname</code> option to the end of
+the command line  for example, <span><strong class="command">smbclient //bigserver/tmp -Ujohndoe</strong></span>.
+</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
+It is possible to specify the password along with the username as follows:
+<span><strong class="command">smbclient //bigserver/tmp -Ujohndoe%secret</strong></span>.
+</p></div><p>
+Once you enter the password, you should get the <code class="prompt">smb&gt;</code> prompt. If you
+do not, then look at the error message. If it says &#8220;<span class="quote"><span class="errorname">invalid network
+name,</span></span>&#8221; then the service <em class="parameter"><code>tmp</code></em> is not correctly set up in your <code class="filename">smb.conf</code>.
+</p><p>
+If it says &#8220;<span class="quote"><span class="errorname">bad password,</span></span>&#8221; then the likely causes are:
+</p><div class="orderedlist"><ol type="1"><li><p>
+       You have shadow passwords (or some other password system) but didn't
+       compile in support for them in <span class="application">smbd</span>.
+       </p></li><li><p>
+       Your <a class="indexterm" name="id2650570"></a>valid users configuration is incorrect.
+       </p></li><li><p>
+       You have a mixed-case password and you haven't enabled the <a class="indexterm" name="id2650585"></a>password level option at a high enough level.
+       </p></li><li><p>
+       The <a class="indexterm" name="id2650600"></a>path line in <code class="filename">smb.conf</code> is incorrect. Check it with <span class="application">testparm</span>.
+       </p></li><li><p>
+       You enabled password encryption but didn't map UNIX to Samba users. Run
+       <span><strong class="command">smbpasswd -a username</strong></span>
+       </p></li></ol></div><p>
+<a class="indexterm" name="id2650638"></a>
+<a class="indexterm" name="id2650645"></a>
+<a class="indexterm" name="id2650652"></a>
+<a class="indexterm" name="id2650658"></a>
+Once connected, you should be able to use the commands <span><strong class="command">dir</strong></span>, <span><strong class="command">get</strong></span>,
+<span><strong class="command">put</strong></span>, and so on. Type <span><strong class="command">help command</strong></span> for instructions. You should
+especially check that the amount of free disk space shown is correct when you type <span><strong class="command">dir</strong></span>.
+</p></li><li><p>
+<a class="indexterm" name="id2650705"></a>
+On the PC, type the command <span><strong class="command">net view \\BIGSERVER</strong></span>. You will 
+need to do this from within a DOS prompt window. You should get back a 
+list of shares available on the server.
+</p><p>
+<a class="indexterm" name="id2650724"></a>
+If you get a message <code class="literal">network name not found</code> or similar error, then NetBIOS
+name resolution is not working. This is usually caused by a problem in <span><strong class="command">nmbd</strong></span>.
+To overcome it, you could do one of the following (you only need to choose one of them):
+</p><div class="orderedlist"><ol type="1"><li><p>
+       Fix the <span class="application">nmbd</span> installation.
+</p></li><li><p>
+       Add the IP address of BIGSERVER to the <span><strong class="command">wins server</strong></span> box in the
+       advanced TCP/IP setup on the PC.
+</p></li><li><p>
+       Enable Windows name resolution via DNS in the advanced section of the TCP/IP setup.
+</p></li><li><p>
+       Add BIGSERVER to your lmhosts file on the PC.
+</p></li></ol></div><p>
+If you get a message &#8220;<span class="quote"><span class="errorname">invalid network name</span></span>&#8221; or 
+&#8220;<span class="quote"><span class="errorname">bad password error,</span></span>&#8221; then apply the
+same fixes as for the <span><strong class="command">smbclient -L</strong></span> test. In
+particular, make sure your <span><strong class="command">hosts allow</strong></span> line is correct (see the man pages).
+</p><p>
+Also, do not overlook that fact that when the workstation requests the
+connection to the Samba server, it will attempt to connect using the 
+name with which you logged onto your Windows machine. You need to make
+sure that an account exists on your Samba server with that exact same
+name and password.
+</p><p>
+If you get a message &#8220;<span class="quote"><span class="errorname">specified computer is not receiving requests</span></span>&#8221; or similar error,
+it probably means that the host is not contactable via TCP services.
+Check to see if the host is running TCP wrappers, and if so, add an entry in
+the <code class="filename">hosts.allow</code> file for your client (or subnet, and so on.)
+</p></li><li><p>
+Run the command <span><strong class="command">net use x: \\BIGSERVER\TMP</strong></span>. You should 
+be prompted for a password, then you should get a <code class="computeroutput">command completed 
+successfully</code> message. If not, then your PC software is incorrectly 
+installed or your <code class="filename">smb.conf</code> is incorrect. Make sure your <em class="parameter"><code>hosts allow</code></em>
+and other config lines in <code class="filename">smb.conf</code> are correct.
+</p><p>
+It's also possible that the server can't work out what username to connect you as.
+To see if this is the problem, add the line
+<a class="indexterm" name="id2650890"></a>user = username to the
+<em class="parameter"><code>[tmp]</code></em> section of 
+<code class="filename">smb.conf</code> where <em class="parameter"><code>username</code></em> is the
+username corresponding to the password you typed. If you find this
+fixes things, you may need the username mapping option. 
+</p><p>
+It might also be the case that your client only sends encrypted passwords 
+and you have <a class="indexterm" name="id2650923"></a>encrypt passwords = no in <code class="filename">smb.conf</code>.
+Change this setting to `yes' to fix this.
+</p></li><li><p>
+Run the command <span><strong class="command">nmblookup -M <em class="parameter"><code>testgroup</code></em></strong></span> where 
+<em class="parameter"><code>testgroup</code></em> is the name of the workgroup that your Samba server and 
+Windows PCs belong to. You should get back the IP address of the 
+master browser for that workgroup.
+</p><p>
+If you do not, then the election process has failed. Wait a minute to
+see if it is just being slow, then try again. If it still fails after
+that, then look at the browsing options you have set in <code class="filename">smb.conf</code>. Make
+sure you have <a class="indexterm" name="id2650978"></a>preferred master = yes to ensure that 
+an election is held at startup.
+</p></li><li><p>
+From file manager, try to browse the server. Your Samba server should
+appear in the browse list of your local workgroup (or the one you
+specified in <code class="filename">smb.conf</code>). You should be able to double-click on the name
+of the server and get a list of shares. If you get the error message &#8220;<span class="quote">invalid password,</span>&#8221;
+ you are probably running Windows NT and it
+is refusing to browse a server that has no encrypted password
+capability and is in user-level security mode. In this case, either set
+<a class="indexterm" name="id2651012"></a>security = server and 
+<a class="indexterm" name="id2651020"></a>password server = Windows_NT_Machine in your
+<code class="filename">smb.conf</code> file or make sure <a class="indexterm" name="id2651034"></a>encrypt passwords is
+set to &#8220;<span class="quote">yes</span>&#8221;.
+</p></li></ol></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="troubleshooting.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="troubleshooting.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="problems.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part V. Troubleshooting </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 38. Analyzing and Solving Samba Problems</td></tr></table></div></body></html>