SAMBA Project Documentation

SAMBA Team


Abstract

Last Update : $Date: 2003/01/15 22:29:23 $

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. Improved browsing in samba
2.1. Overview of browsing
2.2. Browsing support in samba
2.3. Problem resolution
2.4. Browsing across subnets
2.5. Setting up a WINS server
2.6. Setting up Browsing in a WORKGROUP
2.7. Setting up Browsing in a DOMAIN
2.8. Forcing samba to be the master
2.9. Making samba the domain master
2.10. Note about broadcast addresses
2.11. Multiple interfaces
3. Oplocks
3.1. What are oplocks?
4. Quick Cross Subnet Browsing / Cross Workgroup Browsing guide
4.1. Discussion
4.2. Use of the "Remote Announce" parameter
4.3. Use of the "Remote Browse Sync" parameter
4.4. Use of WINS
4.5. Do NOT use more than one (1) protocol on MS Windows machines
4.6. Name Resolution Order
5. LanMan and NT Password Encryption in Samba
5.1. Introduction
5.2. Important Notes About Security
5.3. The smbpasswd Command
II. Type of installation
6. User and Share security level (for servers not in a domain)
7. How to Configure Samba as a NT4 Primary Domain Controller
7.1. Prerequisite Reading
7.2. Background
7.3. Configuring the Samba Domain Controller
7.4. Creating Machine Trust Accounts and Joining Clients to the Domain
7.5. Common Problems and Errors
7.6. System Policies and Profiles
7.7. What other help can I get?
7.8. Domain Control for Windows 9x/ME
7.9. DOMAIN_CONTROL.txt : Windows NT Domain Control & Samba
8. How to Act as a Backup Domain Controller in a Purely Samba Controlled Domain
8.1. Prerequisite Reading
8.2. Background
8.3. What qualifies a Domain Controller on the network?
8.4. Can Samba be a Backup Domain Controller?
8.5. How do I set up a Samba BDC?
9. Samba as a ADS domain member
9.1. Installing the required packages for Debian
9.2. Installing the required packages for RedHat
9.3. Compile Samba
9.4. Setup your /etc/krb5.conf
9.5. Create the computer account
9.6. Test your server setup
9.7. Testing with smbclient
9.8. Notes
10. Samba as a NT4 domain member
10.1. Joining an NT Domain with Samba 2.2
10.2. Samba and Windows 2000 Domains
10.3. Why is this better than security = server?
III. Optional configuration
11. Integrating MS Windows networks with Samba
11.1. Agenda
11.2. Name Resolution in a pure Unix/Linux world
11.3. Name resolution as used within MS Windows networking
11.4. How browsing functions and how to deploy stable and dependable browsing using Samba
11.5. MS Windows security options and how to configure Samba for seemless integration
11.6. Conclusions
12. UNIX Permission Bits and Windows NT Access Control Lists
12.1. Viewing and changing UNIX permissions using the NT security dialogs
12.2. How to view file security on a Samba share
12.3. Viewing file ownership
12.4. Viewing file or directory permissions
12.5. Modifying file or directory permissions
12.6. Interaction with the standard Samba create mask parameters
12.7. Interaction with the standard Samba file attribute mapping
13. Configuring PAM for distributed but centrally managed authentication
13.1. Samba and PAM
13.2. Distributed Authentication
13.3. PAM Configuration in smb.conf
14. Hosting a Microsoft Distributed File System tree on Samba
14.1. Instructions
15. Printing Support
15.1. Introduction
15.2. Configuration
15.3. The Imprints Toolset
15.4. Diagnosis
16. Unified Logons between Windows NT and UNIX using Winbind
16.1. Abstract
16.2. Introduction
16.3. What Winbind Provides
16.4. How Winbind Works
16.5. Installation and Configuration
16.6. Limitations
16.7. Conclusion
17. Passdb MySQL plugin
17.1. Building
17.2. Configuring
17.3. Using plaintext passwords or encrypted password
17.4. Getting non-column data from the table
18. Passdb XML plugin
18.1. Building
18.2. Usage
19. Stackable VFS modules
19.1. Introduction and configuration
19.2. Included modules
19.3. VFS modules available elsewhere
20. Storing Samba's User/Machine Account information in an LDAP Directory
20.1. Purpose
20.2. Introduction
20.3. Supported LDAP Servers
20.4. Schema and Relationship to the RFC 2307 posixAccount
20.5. Configuring Samba with LDAP
20.6. Accounts and Groups management
20.7. Security and sambaAccount
20.8. LDAP specials attributes for sambaAccounts
20.9. Example LDIF Entries for a sambaAccount
20.10. Comments
21. HOWTO Access Samba source code via CVS
21.1. Introduction
21.2. CVS Access to samba.org
22. Group mapping HOWTO
23. Samba performance issues
23.1. Comparisons
23.2. Oplocks
23.3. Socket options
23.4. Read size
23.5. Max xmit
23.6. Locking
23.7. Share modes
23.8. Log level
23.9. Wide lines
23.10. Read raw
23.11. Write raw
23.12. Read prediction
23.13. Memory mapping
23.14. Slow Clients
23.15. Slow Logins
23.16. Client tuning
23.17. My Results
IV. Appendixes
24. Portability
24.1. HPUX
24.2. SCO Unix
24.3. DNIX
24.4. RedHat Linux Rembrandt-II
25. Samba and other CIFS clients
25.1. Macintosh clients?
25.2. OS2 Client
25.3. Windows for Workgroups
25.4. Windows '95/'98
25.5. Windows 2000 Service Pack 2
26. Reporting Bugs
26.1. Introduction
26.2. General info
26.3. Debug levels
26.4. Internal errors
26.5. Attaching to a running process
26.6. Patches
27. Diagnosing your samba server
27.1. Introduction
27.2. Assumptions
27.3. Tests
27.4. Still having troubles?