corrected it's (it is) documentation errors, when "its" should be
[samba.git] / docs / textdocs / GOTCHAS.txt
1 This file lists Gotchas to watch out for:
2 =========================================================================
3 Item Number:    1.0
4 Description:    Problem Detecting Interfaces
5 Symptom:        Workstations do NOT see Samba server in Browse List
6 OS:             RedHat - Rembrandt Beta 2
7 Platform:       Intel
8 Date:           August 16, 1996
9 Submitted By:   John H Terpstra 
10 Details:
11         By default RedHat Rembrandt-II during installation adds an
12         entry to /etc/hosts as follows:-
13                 127.0.0.1 loopback "hostname"."domainname"
14
15         This causes Samba to loop back onto the loopback interface.
16         The result is that Samba fails to communicate correctly with
17         the world and therefor may fail to correctly negotiate who
18         is the master browse list holder and who is the master browser.
19
20 Corrective Action:      Delete the entry after the word loopback
21         in the line starting 127.0.0.1
22 =========================================================================
23 Item Number:    2.0
24 Description:    Problems with MS Windows NT Server network logon service
25 Symptom:        Loss of Domain Logon Services and failed Windows NT / 95
26                 logon attempts.
27 OS:             All Unix systems with Windows NT Domain Control environments.
28 Platform:       All
29 Date:           February 1, 1997
30 Submitted By:   John H Terpstra 
31 Details:
32         Samba is configured for Domain logon control in a network
33         where a Windows NT Domain Primary Controller is running.
34
35         Case 1:
36                 The Windows NT Server is shut down, then restarted. Then
37                 the Samba server is reconfigured so that it NO LONGER offers
38                 Domain logon services. Windows NT and 95 workstations can no
39                 longer log onto the domain. Ouch!!!
40
41         Case 2:
42                 The Windows NT Server which is running the Network logon
43                 Service is shut down and restarted while Samba is a domain
44                 controller offering the Domain LogOn service. Windows NT
45                 Workstation and Server can no longer log onto the network.
46
47         Cause:
48                 Windows NT checks at start up to see if any domain logon
49                 controllers are already running within the domain. It finds
50                 Samba claiming to offer the service and therefore does NOT
51                 start its Network Logon Service.
52
53                 Windows NT needs the Windows NT network logon service to gain
54                 from its Domain controller's SAM database the security
55                 identifier for the user loging on.
56
57 Work-around:    Stop the Samba nmbd and smbd processes, then on the Windows
58                 NT Primary Domain Controller start the Network Logon Service.
59                 Now restart the Samba nmbd and smbd services.
60
61                 Better still: DO NOT CONFIGURE SAMBA AS THE NETWORK LOGON
62                 SERVER, DO NOT SET SAMBA TO BE THE DOMAIN MASTER, DO NOT
63                 SET SAMBA TO OS LEVEL GREATER THAN 0.
64
65                 ie: Let Windows NT Server be the Domain Logon server, the
66                 domain master browser and do NOT interfere with any aspect
67                 of Microsoft Windows NT Domain Control.
68 =========================================================================