SAMBA Project Documentation

SAMBA Team

Abstract

Last Update : Wed Jan 15

This book is a collection of HOWTOs added to Samba documentation over the years. I try to ensure that all are current, but sometimes the is a larger job than one person can maintain. The most recent version of this document can be found at http://www.samba.org/ on the "Documentation" page. Please send updates to jerry@samba.org or jelmer@samba.org.

This documentation is distributed under the GNU General Public License (GPL) version 2. A copy of the license is included with the Samba source distribution. A copy can be found on-line at http://www.fsf.org/licenses/gpl.txt

Cheers, jerry

Table of Contents
I. General installation
1. How to Install and Test SAMBA
1.1. Read the man pages
1.2. Building the Binaries
1.3. The all important step
1.4. Create the smb configuration file.
1.5. Test your config file with testparm
1.6. Starting the smbd and nmbd
1.7. Try listing the shares available on your server
1.8. Try connecting with the unix client
1.9. Try connecting from a DOS, WfWg, Win9x, WinNT, Win2k, OS/2, etc... client
1.10. What If Things Don't Work?
2. Quick Cross Subnet Browsing / Cross Workgroup Browsing guide
2.1. Discussion
2.2. Use of the "Remote Announce" parameter
2.3. Use of the "Remote Browse Sync" parameter
2.4. Use of WINS
2.5. Do NOT use more than one (1) protocol on MS Windows machines
2.6. Name Resolution Order
3. User information database
3.1. Introduction
3.2. Important Notes About Security
3.3. The smbpasswd Command
3.4. Plain text
3.5. TDB
3.6. LDAP
3.7. MySQL
3.8. Passdb XML plugin
II. Type of installation
4. User and Share security level (for servers not in a domain)
5. Samba as a NT4 or Win2k Primary Domain Controller
5.1. Prerequisite Reading
5.2. Background
5.3. Configuring the Samba Domain Controller
5.4. Creating Machine Trust Accounts and Joining Clients to the Domain
5.5. Common Problems and Errors
5.6. System Policies and Profiles
5.7. What other help can I get?
5.8. Domain Control for Windows 9x/ME
5.9. DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba
6. How to Act as a Backup Domain Controller in a Purely Samba Controlled Domain
6.1. Prerequisite Reading
6.2. Background
6.3. What qualifies a Domain Controller on the network?
6.4. Can Samba be a Backup Domain Controller to an NT PDC?
6.5. How do I set up a Samba BDC?
7. Samba as a ADS domain member
7.1. Installing the required packages for Debian
7.2. Installing the required packages for RedHat
7.3. Compile Samba
7.4. Setup your /etc/krb5.conf
7.5. Create the computer account
7.6. Test your server setup
7.7. Testing with smbclient
7.8. Notes
8. Samba as a NT4 or Win2k domain member
8.1. Joining an NT Domain with Samba 3.0
8.2. Samba and Windows 2000 Domains
8.3. Why is this better than security = server?
III. Optional configuration
9. Integrating MS Windows networks with Samba
9.1. Agenda
9.2. Name Resolution in a pure Unix/Linux world
9.3. Name resolution as used within MS Windows networking
9.4. How browsing functions and how to deploy stable and dependable browsing using Samba
9.5. MS Windows security options and how to configure Samba for seemless integration
9.6. Conclusions
10. UNIX Permission Bits and Windows NT Access Control Lists
10.1. Viewing and changing UNIX permissions using the NT security dialogs
10.2. How to view file security on a Samba share
10.3. Viewing file ownership
10.4. Viewing file or directory permissions
10.5. Modifying file or directory permissions
10.6. Interaction with the standard Samba create mask parameters
10.7. Interaction with the standard Samba file attribute mapping
11. Configuring PAM for distributed but centrally managed authentication
11.1. Samba and PAM
11.2. Distributed Authentication
11.3. PAM Configuration in smb.conf
12. Hosting a Microsoft Distributed File System tree on Samba
12.1. Instructions
13. Printing Support
13.1. Introduction
13.2. Configuration
13.3. The Imprints Toolset
13.4. Diagnosis
14. Unified Logons between Windows NT and UNIX using Winbind
14.1. Abstract
14.2. Introduction
14.3. What Winbind Provides
14.4. How Winbind Works
14.5. Installation and Configuration
14.6. Limitations
14.7. Conclusion
15. Improved browsing in samba
15.1. Overview of browsing
15.2. Browsing support in samba
15.3. Problem resolution
15.4. Browsing across subnets
15.5. Setting up a WINS server
15.6. Setting up Browsing in a WORKGROUP
15.7. Setting up Browsing in a DOMAIN
15.8. Forcing samba to be the master
15.9. Making samba the domain master
15.10. Note about broadcast addresses
15.11. Multiple interfaces
16. Stackable VFS modules
16.1. Introduction and configuration
16.2. Included modules
16.3. VFS modules available elsewhere
17. Access Samba source code via CVS
17.1. Introduction
17.2. CVS Access to samba.org
18. Group mapping HOWTO
19. Samba performance issues
19.1. Comparisons
19.2. Socket options
19.3. Read size
19.4. Max xmit
19.5. Log level
19.6. Read raw
19.7. Write raw
19.8. Slow Clients
19.9. Slow Logins
19.10. Client tuning
20. Creating Group Profiles
20.1. Windows '9x
20.2. Windows NT 4
20.3. Windows 2000/XP
IV. Appendixes
21. Portability
21.1. HPUX
21.2. SCO Unix
21.3. DNIX
21.4. RedHat Linux Rembrandt-II
22. Samba and other CIFS clients
22.1. Macintosh clients?
22.2. OS2 Client
22.3. Windows for Workgroups
22.4. Windows '95/'98
22.5. Windows 2000 Service Pack 2
23. Reporting Bugs
23.1. Introduction
23.2. General info
23.3. Debug levels
23.4. Internal errors
23.5. Attaching to a running process
23.6. Patches
24. Diagnosing your samba server
24.1. Introduction
24.2. Assumptions
24.3. Tests
24.4. Still having troubles?
  Next
  General installation