DebuggingSamba

Revision 1 as of 2009-02-19 18:28:24

Clear message

Debugging Central

This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages.

Introduction

Bugs relating to samba typically fall into the following categories:

  1. User cannot connect to a remote share from his Ubuntu system. This falls under the category of samba as a client.

  2. Other systems cannot connect to an Ubuntu system providing samba shares. This may be an issue with samba as a server.

  3. Install/upgrade failures of the samba packages.

How to file

First figure out if the bug falls under one of the generic categories:

  1. samba as a client
  2. samba as a server
  3. install/upgrade failure

Samba as a client

How is the remote share accessed from the Ubuntu system?

  1. nautilus
  2. smbclient (from the command line)
  3. cifs mount

If nautilus is used to access the remote share, can the share can be accessed with the '''smbclient''' command line utility ?

To test:

  1. install the samba-client package
  2. try to connect to the remote system from the command line:

smbclient //remote_system/share_name

What is the remote server version?

Include the output of the following smbclient command:

smbclient -L //remote_srv

If a cifs mount is used also include:

  • the content of the file /etc/fstab
  • the command line used to mount the remote share if the share is manually mounted.
  • the content of the file /proc/fs/cifs/DebugData

Samba as a server

Which clients are failing to connect?

Include the name (Windows, Ubuntu) and version (XP, Vista, 8.04) of the client systems failing to connect to the share.

What is the error message produced on the client?

Information to include

  • the content of the smb.conf file
  • log files found in /var/log/samba/
  • the output of the smbclient -L //server/

  • the output of testparm -s

Install/upgrade failure

Information to include

  • apt and dpkg log files: /var/log/dpkg.log and /var/log/apt/term.log.
  • /etc/samba/smb.conf

==== In the case of an upgrade whether was there a prompt for a modified configuration file? ====

If so which steps have been taken.

How to Triage

Samba as a client

If nautilus fails to connect but smbclient can successfully connect, the bug is related to nautilus. Mark the samba task Invalid and open a new task for nautilus.

If both nautilus and smbclient can not connect, the bug is related to samba. If cifs can not connect the bug is also related to samba.

Stock Reply

Samba as a client

Thank you for taking the time to report this bug and helping to make Ubuntu better. Unfortunately we can't fix it without more information. 

Please include the information requested at https://wiki.ubuntu.com/DebuggingSamba#samba-client.

Samba as a server

Thank you for taking the time to report this bug and helping to make Ubuntu better. Unfortunately we can't fix it without more information. 

Please include the information requested at https://wiki.ubuntu.com/DebuggingSamba#samba-server.

Install/upgrade failure

Thank you for taking the time to report this bug and helping to make Ubuntu better. Unfortunately we can't fix it without more information. 

Please include the information requested at https://wiki.ubuntu.com/DebuggingSamba#samba-pkg-fail.


CategoryBugSquad CategoryDebugging