From 2e2a5d50eb0fcbfdab14e56d6150a1bd35d57f28 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Wed, 13 Nov 2002 15:34:49 +0000 Subject: Some more doc updates: - make - update status of docs document - move security_level to 'type of installation' part (This used to be commit 11ad39398e077c3901e63f31bcc6efb223854357) --- docs/htmldocs/ads.html | 42 +- docs/htmldocs/appendixes.html | 391 ++++++++++++ docs/htmldocs/browsing-quick.html | 16 +- docs/htmldocs/bugreport.html | 30 +- docs/htmldocs/cvs-access.html | 22 +- docs/htmldocs/diagnosis.html | 66 +-- docs/htmldocs/domain-security.html | 24 +- docs/htmldocs/groupmapping.html | 6 +- docs/htmldocs/improved-browsing.html | 28 +- docs/htmldocs/install.html | 46 +- docs/htmldocs/integrate-ms-networks.html | 92 +-- docs/htmldocs/introduction.html | 438 ++++++++++++++ docs/htmldocs/msdfs.html | 14 +- docs/htmldocs/oplocks.html | 6 +- docs/htmldocs/optional.html | 955 ++++++++++++++++++++++++++++++ docs/htmldocs/other-clients.html | 58 +- docs/htmldocs/pam.html | 18 +- docs/htmldocs/pdb-mysql.html | 18 +- docs/htmldocs/pdb-xml.html | 18 +- docs/htmldocs/portability.html | 28 +- docs/htmldocs/printing.html | 104 ++-- docs/htmldocs/pwencrypt.html | 20 +- docs/htmldocs/samba-bdc.html | 38 +- docs/htmldocs/samba-howto-collection.html | 561 +++++++++--------- docs/htmldocs/samba-ldap-howto.html | 64 +- docs/htmldocs/samba-pdc.html | 100 ++-- docs/htmldocs/securitylevels.html | 92 +-- docs/htmldocs/speed.html | 92 +-- docs/htmldocs/type.html | 392 ++++++++++++ docs/htmldocs/unix-permissions.html | 42 +- docs/htmldocs/vfs.html | 403 +++++++++++++ docs/htmldocs/winbind.html | 70 +-- 32 files changed, 3420 insertions(+), 874 deletions(-) create mode 100644 docs/htmldocs/appendixes.html create mode 100644 docs/htmldocs/introduction.html create mode 100644 docs/htmldocs/optional.html create mode 100644 docs/htmldocs/type.html create mode 100644 docs/htmldocs/vfs.html (limited to 'docs/htmldocs') diff --git a/docs/htmldocs/ads.html b/docs/htmldocs/ads.html index fc6b78b32c..49345be2c0 100644 --- a/docs/htmldocs/ads.html +++ b/docs/htmldocs/ads.html @@ -11,7 +11,7 @@ TITLE="SAMBA Project Documentation" HREF="samba-howto-collection.html">Chapter 8. Samba as a ADS domain memberChapter 9. Samba as a ADS domain member

This is a VERY ROUGH guide to setting up the current (November 2001) pre-alpha version of Samba 3.0 with kerberos authentication against a @@ -113,9 +113,9 @@ CLASS="SECT1" >

8.1. Installing the required packages for Debian

9.1. Installing the required packages for Debian

On Debian you need to install the following packages:

8.2. Installing the required packages for RedHat

9.2. Installing the required packages for RedHat

On RedHat this means you should have at least:

8.3. Compile Samba

9.3. Compile Samba

If your kerberos libraries are in a non-standard location then remember to add the configure option --with-krb5=DIR.

8.4. Setup your /etc/krb5.conf

9.4. Setup your /etc/krb5.conf

The minimal configuration for krb5.conf is:

8.5. Create the computer account

9.5. Create the computer account

Do a "kinit" as a user that has authority to change arbitrary passwords on the KDC ("Administrator" is a good choice). Then as a @@ -281,9 +281,9 @@ CLASS="SECT2" >

8.5.1. Possible errors

9.5.1. Possible errors

8.6. Test your server setup

9.6. Test your server setup

On a Windows 2000 client try

8.7. Testing with smbclient

9.7. Testing with smbclient

On your Samba server try to login to a Win2000 server or your Samba server using smbclient and kerberos. Use smbclient as usual, but @@ -345,9 +345,9 @@ CLASS="SECT1" >

8.8. Notes

9.8. Notes

You must change administrator password at least once after DC install, to create the right encoding types

Up +Appendixes
SAMBA Project Documentation
PrevNext

IV. Appendixes

Table of Contents
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.2.1. How can I configure OS/2 Warp Connect or + OS/2 Warp 4 as a client for Samba?
25.2.2. How can I configure OS/2 Warp 3 (not Connect), + OS/2 1.2, 1.3 or 2.x for Samba?
25.2.3. Are there any other issues when OS/2 (any version) + is used as a client?
25.2.4. How do I get printer driver download working + for OS/2 clients?
25.3. Windows for Workgroups
25.3.1. Use latest TCP/IP stack from Microsoft
25.3.2. Delete .pwl files after password change
25.3.3. Configure WfW password handling
25.3.4. Case handling of passwords
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.3.1. Test 1
27.3.2. Test 2
27.3.3. Test 3
27.3.4. Test 4
27.3.5. Test 5
27.3.6. Test 6
27.3.7. Test 7
27.3.8. Test 8
27.3.9. Test 9
27.3.10. Test 10
27.3.11. Test 11
27.4. Still having troubles?

PrevHomeNext
Samba performance issues Portability
\ No newline at end of file diff --git a/docs/htmldocs/browsing-quick.html b/docs/htmldocs/browsing-quick.html index d2546f74b2..cc703d217f 100644 --- a/docs/htmldocs/browsing-quick.html +++ b/docs/htmldocs/browsing-quick.html @@ -11,7 +11,7 @@ TITLE="SAMBA Project Documentation" HREF="samba-howto-collection.html">

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

UpChapter 25. Reporting BugsChapter 26. Reporting Bugs

25.1. Introduction

26.1. Introduction

The email address for bug reports for stable releases is

25.2. General info

26.2. General info

Before submitting a bug report check your config for silly errors. Look in your log files for obvious messages that tell you that @@ -150,9 +150,9 @@ CLASS="SECT1" >

25.3. Debug levels

26.3. Debug levels

If the bug has anything to do with Samba behaving incorrectly as a server (like refusing to open a file) then the log files will probably @@ -220,9 +220,9 @@ CLASS="SECT1" >

25.4. Internal errors

26.4. Internal errors

If you get a "INTERNAL ERROR" message in your log files it means that Samba got an unexpected signal while running. It is probably a @@ -264,9 +264,9 @@ CLASS="SECT1" >

25.5. Attaching to a running process

26.5. Attaching to a running process

Unfortunately some unixes (in particular some recent linux kernels) refuse to dump a core file if the task has changed uid (which smbd @@ -281,9 +281,9 @@ CLASS="SECT1" >

25.6. Patches

26.6. Patches

The best sort of bug report is one that includes a fix! If you send us patches please use UpChapter 20. HOWTO Access Samba source code via CVSChapter 21. HOWTO Access Samba source code via CVS

20.1. Introduction

21.1. Introduction

Samba is developed in an open environment. Developers use CVS (Concurrent Versioning System) to "checkin" (also known as @@ -102,9 +102,9 @@ CLASS="SECT1" >

20.2. CVS Access to samba.org

21.2. CVS Access to samba.org

The machine samba.org runs a publicly accessible CVS repository for access to the source code of several packages, @@ -115,9 +115,9 @@ CLASS="SECT2" >

20.2.1. Access via CVSweb

21.2.1. Access via CVSweb

You can access the source code via your favourite WWW browser. This allows you to access the contents of @@ -136,9 +136,9 @@ CLASS="SECT2" >

20.2.2. Access via cvs

21.2.2. Access via cvs

You can also access the source code via a normal cvs client. This gives you much more control over you can @@ -290,7 +290,7 @@ WIDTH="34%" ALIGN="center" VALIGN="top" >UpChapter 26. Diagnosing your samba serverChapter 27. Diagnosing your samba server

26.1. Introduction

27.1. Introduction

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 @@ -95,9 +95,9 @@ CLASS="SECT1" >

26.2. Assumptions

27.2. Assumptions

In all of the tests it is assumed you have a Samba server called BIGSERVER and a PC called ACLIENT both in workgroup TESTGROUP.

26.3. Tests

27.3. Tests

26.3.1. Test 1

27.3.1. Test 1

In the directory in which you store your smb.conf file, run the command "testparm smb.conf". If it reports any errors then your smb.conf @@ -163,9 +163,9 @@ CLASS="SECT2" >

26.3.2. Test 2

27.3.2. Test 2

Run the command "ping BIGSERVER" from the PC and "ping ACLIENT" from the unix box. If you don't get a valid response then your TCP/IP @@ -189,9 +189,9 @@ CLASS="SECT2" >

26.3.3. Test 3

27.3.3. Test 3

Run the command "smbclient -L BIGSERVER" on the unix box. You should get a list of available shares back.

26.3.4. Test 4

27.3.4. Test 4

Run the command "nmblookup -B BIGSERVER __SAMBA__". You should get the IP address of your Samba server back.

26.3.5. Test 5

27.3.5. Test 5

run the command

26.3.6. Test 6

27.3.6. Test 6

Run the command

26.3.7. Test 7

27.3.7. Test 7

Run the command

26.3.8. Test 8

27.3.8. Test 8

On the PC type the command

26.3.9. Test 9

27.3.9. Test 9

Run the command

26.3.10. Test 10

27.3.10. Test 10

Run the command

26.3.11. Test 11

27.3.11. Test 11

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 @@ -573,9 +573,9 @@ CLASS="SECT1" >

26.4. Still having troubles?

27.4. Still having troubles?

Try the mailing list or newsgroup, or use the ethereal utility to sniff the problem. The official samba mailing list can be reached at @@ -641,7 +641,7 @@ WIDTH="34%" ALIGN="center" VALIGN="top" >UpNextChapter 9. Samba as a NT4 domain memberChapter 10. Samba as a NT4 domain member

9.1. Joining an NT Domain with Samba 2.2

10.1. Joining an NT Domain with Samba 2.2

Assume you have a Samba 2.x server with a NetBIOS name of

9.2. Samba and Windows 2000 Domains

10.2. Samba and Windows 2000 Domains

Many people have asked regarding the state of Samba's ability to participate in a Windows 2000 Domain. Samba 3.0 is able to act as a member server of a Windows @@ -336,9 +336,9 @@ CLASS="SECT1" >

9.3. Why is this better than security = server?

10.3. Why is this better than security = server?

Currently, domain security in Samba doesn't free you from having to create local Unix users to represent the users attaching @@ -456,7 +456,7 @@ WIDTH="33%" ALIGN="right" VALIGN="top" >NextUpChapter 21. Group mapping HOWTOChapter 22. Group mapping HOWTO

Starting with Samba 3.0 alpha 2, a new group mapping function is available. The @@ -219,7 +219,7 @@ WIDTH="34%" ALIGN="center" VALIGN="top" >Up

2.1. Overview of browsing

2.2. Browsing support in samba

2.3. Problem resolution

2.4. Browsing across subnets

2.4.1. How does cross subnet browsing work ?

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

UpPrev

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

1.6. Starting the smbd and nmbd

1.6.1. Starting from inetd.conf

1.6.2. Alternative: starting it as a daemon

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?

1.10.1. Diagnosing Problems

1.10.2. Scope IDs

1.10.3. Choosing the Protocol Level

1.10.4. Printing from UNIX to a Client PC

1.10.5. Locking

1.10.6. Mapping Usernames

PrevUpPrevChapter 10. Integrating MS Windows networks with Samba

Chapter 11. Integrating MS Windows networks with Samba

10.1. Agenda

11.1. Agenda

To identify the key functional mechanisms of MS Windows networking to enable the deployment of Samba as a means of extending and/or @@ -147,9 +147,9 @@ CLASS="SECT1" >

10.2. Name Resolution in a pure Unix/Linux world

11.2. Name Resolution in a pure Unix/Linux world

The key configuration files covered in this section are:

10.2.1. 11.2.1. /etc/hosts

10.2.2. 11.2.2. /etc/resolv.conf

10.2.3. 11.2.3. /etc/host.conf

10.2.4. 11.2.4. /etc/nsswitch.conf

10.3. Name resolution as used within MS Windows networking

11.3. Name resolution as used within MS Windows networking

MS Windows networking is predicated about the name each machine is given. This name is known variously (and inconsistently) as @@ -491,9 +491,9 @@ CLASS="SECT2" >

10.3.1. The NetBIOS Name Cache

11.3.1. The NetBIOS Name Cache

All MS Windows machines employ an in memory buffer in which is stored the NetBIOS names and IP addresses for all external @@ -518,9 +518,9 @@ CLASS="SECT2" >

10.3.2. The LMHOSTS file

11.3.2. The LMHOSTS file

This file is usually located in MS Windows NT 4.0 or 2000 in

10.3.3. HOSTS file

11.3.3. HOSTS file

This file is usually located in MS Windows NT 4.0 or 2000 in

10.3.4. DNS Lookup

11.3.4. DNS Lookup

This capability is configured in the TCP/IP setup area in the network configuration facility. If enabled an elaborate name resolution sequence @@ -663,9 +663,9 @@ CLASS="SECT2" >

10.3.5. WINS Lookup

11.3.5. WINS Lookup

A WINS (Windows Internet Name Server) service is the equivaent of the rfc1001/1002 specified NBNS (NetBIOS Name Server). A WINS server stores @@ -706,9 +706,9 @@ CLASS="SECT1" >

10.4. How browsing functions and how to deploy stable and +>11.4. How browsing functions and how to deploy stable and dependable browsing using Samba

As stated above, MS Windows machines register their NetBIOS names @@ -773,9 +773,9 @@ CLASS="SECT1" >

10.5. MS Windows security options and how to configure +>11.5. MS Windows security options and how to configure Samba for seemless integration

MS Windows clients may use encrypted passwords as part of a @@ -910,9 +910,9 @@ CLASS="SECT2" >

10.5.1. Use MS Windows NT as an authentication server

11.5.1. Use MS Windows NT as an authentication server

This method involves the additions of the following parameters in the smb.conf file:

10.5.2. Make Samba a member of an MS Windows NT security domain

11.5.2. Make Samba a member of an MS Windows NT security domain

This method involves additon of the following paramters in the smb.conf file:

10.5.3. Configure Samba as an authentication server

11.5.3. Configure Samba as an authentication server

This mode of authentication demands that there be on the Unix/Linux system both a Unix style account as well as an @@ -1046,9 +1046,9 @@ CLASS="SECT3" >

10.5.3.1. Users

11.5.3.1. Users

A user account that may provide a home directory should be created. The following Linux system commands are typical of @@ -1069,9 +1069,9 @@ CLASS="SECT3" >

10.5.3.2. MS Windows NT Machine Accounts

11.5.3.2. MS Windows NT Machine Accounts

These are required only when Samba is used as a domain controller. Refer to the Samba-PDC-HOWTO for more details.

10.6. Conclusions

11.6. Conclusions

Samba provides a flexible means to operate as...

PrevUp +General installation

SAMBA Project Documentation
PrevNext

I. General installation

Introduction

This part contains general info on how to install samba +and how to configure the parts of samba you will most likely need. +PLEASE read this.

Table of Contents
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.6.1. Starting from inetd.conf
1.6.2. Alternative: starting it as a daemon
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?
1.10.1. Diagnosing Problems
1.10.2. Scope IDs
1.10.3. Choosing the Protocol Level
1.10.4. Printing from UNIX to a Client PC
1.10.5. Locking
1.10.6. Mapping Usernames
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.4.1. How does cross subnet browsing work ?
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.2.1. Advantages of SMB Encryption
5.2.2. Advantages of non-encrypted passwords
5.3. The smbpasswd Command

PrevHomeNext
SAMBA Project Documentation How to Install and Test SAMBA
\ No newline at end of file diff --git a/docs/htmldocs/msdfs.html b/docs/htmldocs/msdfs.html index 95902f7217..832187d19f 100644 --- a/docs/htmldocs/msdfs.html +++ b/docs/htmldocs/msdfs.html @@ -11,7 +11,7 @@ TITLE="SAMBA Project Documentation" HREF="samba-howto-collection.html">Chapter 13. Hosting a Microsoft Distributed File System tree on SambaChapter 14. Hosting a Microsoft Distributed File System tree on Samba

13.1. Instructions

14.1. Instructions

The Distributed File System (or Dfs) provides a means of separating the logical view of files and directories that users @@ -229,9 +229,9 @@ CLASS="SECT2" >

13.1.1. Notes

14.1.1. Notes