4 >The Samba 2.2 PDC FAQ</TITLE
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
26 >The Samba 2.2 PDC FAQ</A
38 >La Trobe University<BR></SPAN
47 >Comments, corrections and additions to <TT
50 HREF="mailto:D.Bannon@latrobe.edu.au"
51 >D.Bannon@latrobe.edu.au</A
55 >This is the FAQ for Samba 2.2 as an NTDomain controller.
56 This document is derived from the origional FAQ that was built and
57 maintained by Gerald Carter
58 from the early days of Samba NTDomain development up until recently.
59 It is now being updated as significent changes are made to 2.2.0.</P
61 >Please note it does not apply to Samba2.2alpha0, Samba2.2alpha1, Samba 2.0.7, TNG nor HEAD branch.
64 >I'll repeat, it does not apply to the current snapshot [ftp mirror]:/pub/samba/alpha/samba-2.2.0-alpha1.tar.gz, only to the to the current cvs.</P
66 > Also available is a Samba 2.2 PDC <A
67 HREF="samba-pdc-howto.html"
70 > that takes you, step
71 by step, over the process of setting up a very basic Samba 2.2 Primary Domain Controller
80 >Please read the Introduction for the current <A
115 >General Information</A
129 >What can Samba Primary Domain Controller (PDC) do ?</A
134 >Can I have a Windows 2000 client logon to a Samba controlled domain?</A
139 >What's the status of print spool (spoolss) support in the NTDOM code?</A
153 >What are the different Samba branches available in CVS ?</A
158 >What are the CVS commands ?</A
167 >Establishing Connections</A
181 >How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A
186 >What is a 'machine account' ?</A
191 >"The machine account for this computer either does not exist or is not accessable."</A
196 >How do I create machine accounts manually ?</A
201 >I cannot include a '$' in a machine name.</A
206 >I get told "You already have a connection to the Domain...." when creating a
212 >I get told "Cannot join domain, the credentials supplied conflict
213 with an existing set.."</A
218 >"The system can not log you on (C000019B)...."</A
227 >User Account Management</A
241 >How do I configure an account as a domain administrator?</A
255 >Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A
260 >Why are all the users listed in the "domain admin users" using the same profile?</A
265 >The roaming profiles do not seem to be updating on the server.</A
279 >What are 'Policies' ?.</A
284 >I can't get system policies to work.</A
289 >What about Windows NT Policy Editor ?</A
294 >Can Win95 do Policies ?</A
308 >What is password sync and should I use it ?</A
313 >How do I get remote password (unix and SMB) changing working ?</A
336 >How do I get 'User Manager' and 'Server Manager'</A
341 >The time setting from a Samba server does not work.</A
346 >"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A
351 >How do I get my samba server to become a member ( not PDC ) of an NT domain?</A
360 >Troubleshooting and Bug Reporting</A
374 >What are some diagnostics tools I can use to debug the domain logon process and where can I
380 >How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A
387 >What other help can I get ?</A
399 >How do I get help from the mailing lists ?</A
404 >How do I get off the mailing lists ?</A
417 >Chapter 1. Introduction</A
430 >It should be noted that 2.2.0 in its pre-release form still has a few problems,
431 I'll try and keep this section current while things are still dynamic.
432 At the time of this update (November 13, 2000) the current state of play is :</I
435 >Comments here about W2K joining the domain apply only to Samba 2.2 from the CVS after November 27th. The
436 'snapshot' release Samba2.2alpha1 does not work !!! See below on how to get a CVS tree.</P
438 >Client Side creation of Machine accounts does work but is not complete.
442 > runs as the user who's
443 name was entered, not as root. Secondly, the machine name passed to the script (%U)
444 has an underscore at the end, not a '$'. One alternative is to use %m and add the $.
445 This method is documented in the <A
446 HREF="samba-pdc-howto.html"
450 And thirdly, it does not work with NT4ws.
453 >A W2K machine can join the domain. See the <A
454 HREF="samba-pdc-howto.html"
458 which explains the process. The methods
459 described are 'work arounds' and should be regarded as temporary. Although I (drb)
460 have tested these procedures a number of people have had difficulty so there
461 may be other issues at work. JFM is aware of these
462 problems and will attend to them when he can.</P
464 >A Domain Admin account is required and at present it appears that only root
465 is a suitable candidate.</P
467 >Much of the related code does work. For example, if an NT is removed from the
468 domain and then rejoins, the <TT
470 >Create a Computer Account in the Domain</TT
472 will let you reset the smbpasswd. That is you don't need to do it from
473 the unix box. However, at the present, you do need to have root as an
474 administrator and use the root user name and password.</P
479 not sure that last paragraph is correct ....</I
485 > do work on a W2K machine. MS says that recent builds of
486 W2K dont observe an NT policy but it appears it does in 'legacy' mode.</P
497 >This FAQ was origionally compiled by Jerry Carter (gc) chiefly dealing with the 'old head'
498 version of Samba and its NTDomain facilities. It is being rewritten by David Bannon (drb)
499 so that it addresses more accurately the Samba 2.2 planned for release late 2000. </P
501 >This document probably still contains some material that does not apply to
502 Samba 2.2 but most (all?) of the really misleading stuff has been removed. Some
503 issues are not dealt with or are dealt with badly. Please send corrections and additions to
504 David Bannon at D.Bannon@latrobe.edu.au</P
506 >Hopefully, as we all become familiar with the Samba 2.2 as a PDC this document will
507 become much more usefull.</P
515 >Chapter 2. General Information</A
531 >What can Samba Primary Domain Controller (PDC) do ?</A
534 >If you wish to have Samba act as a PDC for Windows NT 3.51.and 4.0 or W2000 client, then you
535 will need to obtain the 2.2.0 version, currently in pre-release. Release of a stable,
536 full featured Samba PDC is currently slated for version 3.0. </P
538 >The following is a list of included features currently in Samba 2.2:</P
544 >The ability to act as a limited PDC for Windows NT and W2000 clients.
545 This includes adding NT and W2K machines to the domain and authenticating users logging
550 >Domain account can be viewed using the User Manager for
555 >Viewing resources on the Samba PDC via the Server Manager for Domains
556 from the NT client. ??</P
560 >Windows 95 clients will allow user level security to be set
561 but will not currently allow browsing of accounts.</P
565 >Machine account password updates.</P
569 >Changing of user passwords from an NT client.</P
573 >Partial support for Windows NT group and username mapping.</P
577 >Support for a LDAP password database backend.</P
588 >These things are note expected to work in the forseeable future</B
593 >Trust relationships</P
597 >PDC and BDC integration</P
601 >Windows NT ACLs (on the Samba shares)</P
605 >Offer a list of domain users to User Manager for Domains
606 (or the Security Tab etc).</P
616 >Can I have a Windows 2000 client logon to a Samba controlled domain?</A
619 >The 2.2 release branch of Samba supports Windows 2000 domain
620 clients in legacy mode, ie as if the PDC is a NTServer, not a
629 >What's the status of print spool (spoolss) support in the NTDOM code?</A
632 >The implementation of support for SPOOLSS pipe is complete and it will be available
633 in the 2.2.0 release. This means that Samba will support the automatic downloading of printer
634 drivers for Windows NT clients just as it currently does for Windows 9x clients.</P
646 >CVS is a programme (publically available) that the Samba developers use to
647 maintain the central source code. Non developers can get access to the source in
648 a read only capacity. Many flavours of unix now arrive with cvs installed.</P
655 >What are the different Samba branches available in CVS ?</A
658 >You can find out more about obtaining Samba's via
661 HREF="http://pserver.samba.org/samba/cvs.html"
663 > http://pserver.samba.org/samba/cvs.html"</A
671 >There are basically four branches to watch at the moment :</B
678 >Samba 3.0 ? This code boasts all the main development
679 work in Samba. Two things that most people are not aware of
680 which live in the HEAD branch code are winbind NSS module and
681 Tim Potter's VFS implementation. Due to its developmental
682 nature, its not really suitable for production work.
689 >This branch contains the current stable release release.
690 At the moment it contains 2.0.7, a version that will do some
691 limited PDC stuff. If you are really going to do PDC things then
692 I (drb) suggest that you consider 2.2 instead.
699 >The next stable release, currently in a 'alpha' form.
700 It provides the Samba developers, testers and interested
701 people with an approximation of what is to come. This document
702 addresses only SAMBA_2_2.
709 >This branch is no longer maintained from the Samba sites.
711 HREF="http://www.samba-tng.org/"
713 > http://www.samba-tng.org/</A
714 >. It has been requested
715 that questions about TNG are not posted to the regular Samba mailing
716 lists including samba-ntdom and samba-technical.
728 >What are the CVS commands ?</A
732 HREF="http://pserver.samba.org/samba/cvs.html"
734 > http://pserver.samba.org/samba/cvs.html</A
740 >To get the Samba 2.2 version, tag SAMBA_2_2 you would do :</B
747 >cd /usr/local/src/</B
754 >cvs -d :pserver:cvs@pserver.samba.org:/cvsroot
760 > When prompted enter a password of <B
769 >cvs -d :pserver:cvs@pserver.samba.org:/cvsroot
770 co -r SAMBA_2_2 samba</B
778 >Then to update that directory at some later time,</B
785 >cd /usr/local/src/samba</B
792 >cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login</B
797 > When prompted enter a password of 'cvs'.</P
815 >Chapter 3. Establishing Connections</A
831 >How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A
834 >There is a comprehensive Samba PDC <A
835 HREF="samba-pdc-howto.html"
839 accessable from the samba web site
840 under 'Documentation'. Its currently located at <A
841 HREF="http://bioserve.latrobe.edu.au/samba"
843 > http://bioserve.latrobe.edu.au/samba</A
852 >What is a 'machine account' ?</A
855 >Every NT, W2K or Samba machine that joins a Samba controlled domain must be known to
856 the Samba PDC. There are two entries required, one in (typically) <TT
860 and the other in (typically) <TT
862 >/usr/local/samba/private/smbpasswd</TT
864 some circumstances these entries are made <A
869 HREF="samba-pdc-howto.html"
872 > discusses ways of creating them automatically.</P
880 >"The machine account for this computer either does not exist or is not accessable."</A
883 >When I try to join the domain I get the message "The machine account for this computer
884 either does not exist or is not accessable". Whats wrong ?</P
886 >This problem is caused by the PDC not having a suitable machine account.
887 If you are using the <B
889 >add user script =</B
890 > method to create accounts
891 then this would indicate that it has not worked. Ensure the domain admin user
892 system is working.</P
894 >Alternatively if you are creating account entries manually then they have not been created
895 correctly. Make sure that you have the entry correct for the machine account in smbpasswd
896 file on the Samba PDC. If you added the account using an editor rather than using the smbpasswd utility,
897 make sure that the account name is the machine netbios name with a '$' appended to it
898 ( ie. computer_name$ ). There must be an entry in both /etc/passwd and
899 the smbpasswd file. Some people have reported that
900 inconsistent subnet masks between the Samba server and the NT client have caused this problem.
901 Make sure that these are consistent for both client and server.</P
909 >How do I create machine accounts manually ?</A
912 >This was the only option until recently, now in version 2.2 better means are available.
913 You might still need to do it manually for a couple of reasons. A machine account
914 consists of two entries (assuming a standard install and /etc/passwd use),
915 one in /etc/passwd and the other in /usr/local/samba/private/smbpasswd. The /etc/passwd
916 entry will list the machine name with a $ appended, won't have a passwd, will have a null
917 shell and no home directory. For example a machine called 'doppy' would have an /etc/passwd
922 >doppy$:x:505:501:NTMachine:/dev/null:/bin/false</B
925 >On a linux system for example, you would typically add it like this :</P
929 >adduser -g machines -c NTMachine -d /dev/null -s /bin/false -n
933 >Then you need to add that entry to smbpasswd, assuming you have a suitable
937 > programme, do this :</P
941 >smbpasswd -a -m doppy$</B
944 >The entry will be created with a well known password, so any machine that
945 says its doppy could join the domain as long as it gets in first. So don't create
946 the accounts any earlier than you need them.</P
954 >I cannot include a '$' in a machine name.</A
957 >A 'machine name' in (typically) <TT
961 of the machine name with a '$' appended. FreeBSD (and other BSD systems ?)
962 won't create a user with a '$' in their name.</P
964 >The problem is only in the program used to make the entry, once made, it works
965 perfectly. So create a user without the '$' and use <B
969 the entry, adding the '$'. Or create the whole entry with vipw if you like,
970 make sure you use a unique uid !</P
978 >I get told "You already have a connection to the Domain...." when creating a
982 >This happens if you try to create a machine account from the machine itself
983 and use a user name that does not work (for whatever reason) and then try
984 another (possibly valid) user name.
985 Exit out of the network applet to close the initial connection and try again.</P
987 >Further, if the machine is a already a 'member of a workgroup' that is the
988 same name as the domain you are joining (bad idea) you will get this message.
989 Change the workgroup name to something else, it does not matter what, reboot,
998 >I get told "Cannot join domain, the credentials supplied conflict
999 with an existing set.."</A
1002 >This is the same basic problem as mentioned above, <A
1004 > "You already have a connection..."</A
1013 >"The system can not log you on (C000019B)...."</A
1016 >I joined the domain successfully but after upgrading to a newer version of the
1017 Samba code I get the message, "The system can not log you on (C000019B), Please try a
1018 gain or consult your system administrator" when attempting to logon.</P
1020 >This occurs when the domain SID stored in private/WORKGROUP.SID is changed.
1021 For example, you remove the file and smbd automatically creates a new one.
1022 Or you are swapping back and forth between versions 2.0.7, TNG and the HEAD branch
1023 code (not recommended). The only way to correct the problem is to restore the
1024 original domain SID or remove the domain client from the domain and rejoin.</P
1033 >Chapter 4. User Account Management</A
1049 >How do I configure an account as a domain administrator?</A
1053 HREF="samba-pdc-howto.html"
1073 >Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A
1076 >Sometimes Windows clients will maintain a connection to the \\homes\ ( or [%U] ) share
1077 even after the user has logged out. Consider the following scenario.</P
1083 > user1 logs into the Windows NT machine. Therefore the
1084 [homes] share is set to \\server\user1.</P
1088 > user1 works for a while and then logs out. </P
1092 > user2 logs into the same Windows NT machine.</P
1096 >However, since the NT box has maintained a connection to [homes] which was
1097 previously set to \\server\user1, when the operating system attempts to
1098 get the profile and if it can read users1's profile, will get it otherwise it
1099 will return an error. You get the picture.</P
1101 >A better solution is to use a separate [profiles] share and set the
1102 "logon path = \\%N\profiles\%U" </P
1110 >Is this still a problem ????</P
1120 >Why are all the users listed in the "domain admin users" using the same profile?</A
1123 >You are using a very very old development version of Samba. Upgrade.</P
1131 >The roaming profiles do not seem to be updating on the server.</A
1134 >There can be several reasons for this.</P
1136 >Make sure that the time on the client and the PDC are synchronized. You can accomplish
1137 this by executing a <B
1139 >net time \\server /set /yes</B
1140 > replacing server with the
1141 name of your PDC (or another synchronized SMB server). See <A
1143 > about Setting Time</A
1147 logon path is writeable by the user and make sure that the connection to the logon
1148 path location is by the current user. Sometimes Windows client do not drop the
1149 connection immediately upon logoff.</P
1151 >Some people have reported that the logon path location should also be browseable.
1152 I (GC) have yet to emperically verify this, but you can try.</P
1169 >What are 'Policies' ?.</A
1172 >When a user logs onto the domain via a client machine, the PDC sends
1173 the client machine a list of things contained in the 'policy' (if it exists).
1174 This list may do things like suppress a splach screen, format the dates the way you
1175 like them or perhaps remove locally stored profiles.</P
1177 >On a samba PDC this list is obtained from a file called <B
1181 and located in the <B
1184 >share. The file is created with a policy editor
1185 and must be readable by anyone and writeable by only root. See <A
1188 > for how to get a suitable editor.</P
1196 >I can't get system policies to work.</A
1199 >There are two possible reasons for system policies not functioning correctly.
1200 Make sure that you have the following parameters set in smb.conf </P
1202 CLASS="PROGRAMLISTING"
1211 >A policy file must be in the <B
1215 readable by everyone and writeable by only root. The file must be created
1221 >Last time I (drb) looked in the source, it was
1225 > first then several other combinations of upper
1226 and lower case. People have reported success using <TT
1236 >. These are the case
1237 settings that I (GC) use with the
1243 CLASS="PROGRAMLISTING"
1244 > case sensitive = no
1255 >What about Windows NT Policy Editor ?</A
1258 >To create or edit <B
1261 > you must use the NT Server
1265 > which is included with NT Server
1268 >not NT Workstation</I
1269 >. There is a Policy Editor on a NTws
1270 but it is not suitable for creating <I
1274 Further, although the Windows 95
1275 Policy Editor can be installed on an NT Workstation/Server, it will not
1276 work with NT policies because the registry key that are set by the policy templates.
1277 However, the files from the NT Server will run happily enough on an NTws.
1280 >poledit.exe, common.adm</TT
1285 to put the two *.adm files in <TT
1289 the binary will look for them unless told otherwise. Note also that that
1290 directory is 'hidden'.</P
1292 >The Windows NT policy editor is also included with the
1293 Service Pack 3 (and later) for Windows NT 4.0. Extract the files using
1296 >servicepackname /x</B
1301 for service pack 6a.
1302 The policy editor, <B
1305 > and the associated template files (*.adm) should
1306 be extracted as well. It is also possible to downloaded the policy template
1307 files for Office97 and get a copy of the policy editor. Another possible
1308 location is with the Zero Administration Kit available for download from Microsoft.
1317 >Can Win95 do Policies ?</A
1320 >Install the group policy handler for Win9x to pick up group policies.
1321 Look on the Win98 CD in <TT
1323 > \tools\reskit\netadmin\poledit</TT
1324 >. Install group policies on a Win9x client by double-clicking
1328 >. Log off and on again a couple of times and see if
1329 Win98 picks up group policies.
1330 Unfortunately this needs to be done on every Win9x machine that uses group policies....</P
1332 >If group policies don't work one reports suggests getting the updated (read: working)
1333 grouppol.dll for Windows 9x. The group list is grabbed from /etc/group.</P
1350 >What is password sync and should I use it ?</A
1353 >NTws users can change their domain password by pressing Ctrl-Alt-Del and
1354 choosing 'Change Password'. By default however, this does not change the unix password
1357 >/etc/passwd or /etc/shadow</TT
1358 >). In lots of situations
1359 thats OK, for example :</P
1365 >The server is only accessible to the user via samba.</P
1369 >Pam_smb or similar is installed so other applications
1370 still refer to the samba password.</P
1374 >But sometimes you really do need to maintain two seperate password databases and
1375 there are good reasons to keep then in sync. Trying to explain to users
1376 that they need to change their passwords in two seperate places or use
1377 two seperate passwords is not fun.</P
1379 >However do understand that setting up password sync is not without problems either.
1380 The chief difficulty is the interface between Samba and the <B
1384 it can be a fiddle to set up and if the password the user has entered fails,
1385 the resulting errors are ambiguously reported
1386 and the user is confused. Further, you need to take steps to ensure that users
1387 only ever change their passwords via samba (or use <B
1391 otherwise they will only be changing the unix password.</P
1399 >How do I get remote password (unix and SMB) changing working ?</A
1402 >Have a practice changing a user's password (as root) to see what
1403 discussion takes place and change the text in the 'passwd chat' line below as necessary. The
1404 line as shown works for recent RH Linux but most other systems seem to like to do something
1405 different. The '*' is a wild card and will match anything (or nothing).
1408 >Add these lines to smb.conf under [Global]</P
1410 CLASS="PROGRAMLISTING"
1413 unix password sync = true
1414 passwd program = /usr/bin/passwd %u
1415 passwd chat = *password* %n\n *password* %n\n *successful*
1418 >As mentioned above, the change to the unix password
1419 happens as root, not as the user, as is indicated in ~/smbd/chgpasswd.c If
1420 you are using NIS, the Samba server must be running on the NIS master machine.</P
1429 >Chapter 5. Miscellaneous</A
1445 >How do I get 'User Manager' and 'Server Manager'</A
1448 >Since I don't need to buy an NT Server CD now, how do I get the 'User Manager for
1449 Domains', the 'Server Manager' ?</P
1454 >Microsoft distributes a version of these tools called nexus
1455 for installation on Windows 95 systems. The tools set includes</B
1464 >User Manager for Domains</P
1472 >Click here to download the archived file
1474 HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE"
1476 > ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE</A
1479 >The Windows NT 4.0 version of the 'User Manager for Domains'
1480 and 'Server Manager' are available from Microsoft via ftp from
1482 HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE"
1484 > ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE</A
1493 >The time setting from a Samba server does not work.</A
1496 >If it works OK when you log on as Domain Admin then the problem is that ordinary users
1497 don't have permission to change the time. (The system is running with their permission
1498 at logon time.) This is not a Samba problem, you will have the same problem where ever
1499 you connect. You can give 'everyone' permission to change the time from the User Manager.
1502 >Anyone know what the registry settings are so this could be done with a Policy ?</P
1510 >"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A
1513 >I keep getting the message "trust account xxx should be in DOMAIN_GROUP_RID_USERS."
1514 in the logs. What do I need to do?</P
1516 >You are using one of the old development versions. Upgrade.
1517 (The message is unimportant, was a reminder to a developer)</P
1525 >How do I get my samba server to become a member ( not PDC ) of an NT domain?</A
1528 >In a domain that has a number of servers you only need one password database.
1529 The machines that don't have their own ask the PDC to check for them.
1530 This will work fine for a domain controlled by either a Samba or NT machine.
1531 The following lines in smb.conf are typical, 'password server' points to the
1532 samba machine (or an NT) that has the password list : </P
1534 CLASS="PROGRAMLISTING"
1540 workgroup = { Put your domain name here }
1541 password server = { Put the ip of the PDC here }
1542 encrypt passwords = yes
1546 >The samba server in question will have to 'join the domain', that requires
1547 the domain controller to have a machine account for it. This is no different
1548 to the machine account requirements to allow a NTws to join the domain. For
1549 example, if we want a unix box called <I
1552 > to ask the PDC called <I
1556 to do its authentication then <I
1559 > will need an entry in its smbpasswd
1560 (assuming it's also samba) that starts with <I
1563 >. It would have to be
1569 >If the domain is controlled by an NTServer then the "Server Manager for Domains"
1570 tool must be used to add 'sleepy' to the domain list.</P
1572 >In either case we then join the domain. If the domain is called <I
1576 then on sleepy we would join the domain by typing :</P
1580 >smbpasswd -j forest</B
1583 >Note that the directory where the smbpasswd file would be
1584 located should exist as this is where smbd will generate the MACHINE.SID file. This
1587 >/usr/local/samba/private/FOREST.SLEEPY.SID</TT
1589 it contains the trust account password for the domain member. The permissions are
1590 (and should remain) "rw-------</P
1592 >Note the Samba Servers without the password list will most likely still need an account
1593 for each user, this means a line in its <TT
1596 >. Because authentication
1597 is being handled at the domain level the
1601 > line does not need a password.
1602 If the shares being offered are not user specific, ie a common (read only ?)
1603 area or perhaps just printing then the user's
1607 > does not need a home directory. A typical
1611 > for a server that allows domain users to
1612 connect to the samba shares but does not offer a home share ('cos that's on the PDC)
1613 and does not allow logon to the unix prompt would be like this :</P
1615 CLASS="PROGRAMLISTING"
1616 >jblow:x:542:100:Joe Blow:/dev/null:/bin/false</PRE
1626 >When removing those 'dummy' users, watch the 'remove user' scripts,
1627 some OS think they should remove a users directory even when its not owned by the user !
1634 >username map = </TT
1635 > parameter might help you to avoid having
1636 all those accounts created.</P
1640 >You should investigate the smb.conf parameter
1643 >'add user script'</TT
1644 >, it will be used to create accounts on
1645 secondary servers when that account already exists on the PDC. Very nice.
1648 CLASS="PROGRAMLISTING"
1651 add user script = /usr/sbin/adduser -n -g users -c User -d /dev/null -s /bin/false %U
1666 >Chapter 6. Troubleshooting and Bug Reporting</A
1674 >Diagnostic tools</A
1682 >What are some diagnostics tools I can use to debug the domain logon process and where can I
1686 >One of the best diagnostic tools for debugging problems is Samba itself. You can use the -d
1687 option for both smbd and nmbd to specifiy what 'debug level' at which to run. See the man
1688 pages on smbd, nmbd and smb.conf for more information on debugging options. The debug
1689 level can range from 1 (the default) to around 100 but a debug level of about 20 will
1690 normally help you find any errors that samba is encountering. Another helpful method
1691 of debugging is to compile samba using the gcc -g flag. This will include debug
1692 information in the binaries and allow you to attch gdb to the running smbd / nmbd
1693 process. In order to attach gdb to an smbd process for an NT workstation, first
1694 get the workstation to make the connection. Pressing ctrl-alt-delete and going down
1695 to the domain box is sufficient (at least, on the first time you join the domain) to
1696 generate a 'LsaEnumTrustedDomains'. Thereafter, the workstation maintains an open
1697 connection, and therefore there will be an smbd process running (assuming that you
1698 haven't set a really short smbd idle timeout) So, in between pressing ctrl alt
1699 delete, and actually typing in your password, you can gdb attach and continue.</P
1701 >An SMB enabled version of tcpdump is available from
1703 HREF="ftp://samba.org/pub/samba/tcpdump-smb/"
1705 >ftp://samba.org/pub/samba/tcpdump-smb/
1709 >Capconvert is a small C program for translating output from tcpdump-smb to CAP format
1710 that can be read by netmon. You will need to use the raw output from tcp dump
1713 >tcpdump -w output.dump</B
1714 > ). Good news! Now you can convert
1715 Solaris' snoop output as well. The C source code for snoop2cap is available for download.
1718 >For tracing things on the Microsoft Windows NT, Network Monitor (aka. netmon) is available
1719 on the Microsoft Developer Network CD's, the Windows NT Server install CD and the SMS CD's.
1720 The version of netmon that ships with SMS allows for dumping packets between any two
1721 computers (ie. placing the network interface in promiscuous mode). The version
1722 on the NT Server install CD will only allow monitoring of network traffic directed to the
1723 local NT box and broadcasts on the local subnet.</P
1731 >How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A
1734 >Installing netmon on an NT workstation requires a couple of steps. The following
1735 are for installing Netmon V4.00.349, which comes with Microsoft Windows NT Server
1736 4.0, on Microsoft Windows NT Workstation 4.0. The process should be similar
1737 for other version of Windows NT / Netmon. You will need both the Microsoft Windows
1738 NT Server 4.0 Install CD and the Workstation 4.0 Install CD.</P
1740 >Initially you will need to install 'Network Monitor Tools and Agent' on the
1741 NT Server. To do this </P
1747 >Goto Start - Settings - Control Panel - Network - Services - Add </P
1751 >Select the 'Network Monitor Tools and Agent' and click on 'OK'.</P
1755 >Click 'OK' on the Network Control Panel.</P
1759 >Insert the Windows NT Server 4.0 install CD when prompted.</P
1763 >At this point the Netmon files should exist in <TT
1765 >%SYSTEMROOT%\System32\netmon\*.*</TT
1767 Two subdirectories exist as well, <TT
1770 > which contains the necessary DLL's
1771 for parsing the netmon packet dump, and <TT
1776 >In order to install the Netmon tools on an NT Workstation, you will first need to
1777 install the 'Network Monitor Agent' from the Workstation install CD.</P
1783 >Goto Start - Settings - Control Panel - Network - Services - Add</P
1787 >Select the 'Network Monitor Agent' and click on 'OK'.</P
1791 >Click 'OK' on the Network Control Panel.</P
1795 >Insert the Windows NT Workstation 4.0 install CD when prompted.</P
1799 >Now copy the files from the NT Server in %SYSTEMROOT%\System32\netmon\*.* to
1800 %SYSTEMROOT%\System32\netmon\*.* on the Workstation and set permissions as
1801 you deem appropriate for your site. You will need administrative rights on the
1802 NT box to run netmon.</P
1804 >To install Netmon on a Windows 9x box install the network monitor agent from
1805 the Windows 9x CD (\admin\nettools\netmon).
1806 There is a readme file located with the netmon driver files on the CD if you need
1807 information on how to do this. Copy the files from a working Netmon installation.</P
1816 >What other help can I get ?</A
1819 >There are many sources of information available in the form of mailing lists, RFC's
1820 and documentation. The docs that come with the samba distribution contain very
1821 good explanations of general SMB topics such as browsing.</P
1828 >URLs and similar</A
1835 >Home of Samba site <A
1836 HREF="http://samba.org"
1838 > http://samba.org</A
1839 >. We have a mirror near you !</P
1847 on the Samba mirrors might mention your problem. If so,
1848 it might mean that the developers are working on it.</P
1852 > Ignacio Coupeau has a very comprehesive look at LDAP with Samba at
1854 HREF="http://www.unav.es/cti/ldap-smb-howto.html"
1856 > http://www.unav.es/cti/ldap-smb-howto.html</A
1858 Be a little carefull however, I suspect that it does not specificly
1859 address samba 2.2.x. The HEAD pre-2.1 may possibly be the best
1860 stream to look at.</P
1864 > Lars Kneschke's site covers <A
1865 HREF="http://www.samba-tng.org"
1870 HREF="http://www.kneschke.de/projekte/samba_tng"
1872 > http://www.kneschke.de/projekte/samba_tng</A
1874 lot of it does not apply to the main stream Samba.</P
1878 >Although 2.0.7 has almost had its day as a PDC, I (drb) will
1879 keep the 2.0.7 PDC pages at <A
1880 HREF="http://bioserve.latrobe.edu.au/samba"
1882 > http://bioserve.latrobe.edu.au/samba</A
1883 > going for a while yet.</P
1887 >Misc links to CIFS information
1889 HREF="http://samba.org/cifs/"
1891 >http://samba.org/cifs/</A
1896 >NT Domains for Unix <A
1897 HREF="http://mailhost.cb1.com/~lkcl/ntdom/"
1899 > http://mailhost.cb1.com/~lkcl/ntdom/</A
1904 >FTP site for older SMB specs:
1906 HREF="ftp://ftp.microsoft.com/developr/drg/CIFS/"
1908 > ftp://ftp.microsoft.com/developr/drg/CIFS/</A
1916 >There are a number of documents that no longer appear to live at their
1917 origional home. Any one know where the following may be found ?</B
1922 >CIFS/E Browser Protocol draft-leach-cifs-browser-spec-00.txt</P
1926 >CIFS Remote Administration Protocol draft-leach-cifs-rap-spec-00.txt</P
1930 >CIFS Logon and Pass Through Authentication draft-leach-cifs-logon-spec-00.txt</P
1934 >A Common Internet File System (CIFS/1.0) Protocol draft-leach-cifs-v1-spec-01.txt</P
1938 >CIFS Printing Specification draft-leach-cifs-print-spec-00.txt</P
1942 >RFC1001 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Concepts and methods.
1943 http://ds.internic.net/rfc/rfc1001.txt </P
1947 >RFC1002 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Detailed specifications.
1948 http://ds.internic.net/rfc/rfc1002.txt </P
1952 >Microsoft's main CIFS page: http://www.microsoft.com/workshop/networking/cifs/</P
1962 >How do I get help from the mailing lists ?</A
1965 > There are a number of Samba related mailing lists. Go to <A
1966 HREF="http://samba.org"
1968 >http://samba.org</A
1969 >, click on your nearest mirror
1970 and then click on <B
1973 > and then click on <B
1975 > Samba related mailing lists</B
1978 >For questions relating to Samba TNG go to
1980 HREF="http://www.samba-tng.org/"
1982 >http://www.samba-tng.org/</A
1984 It has been requested that you don't post questions about Samba-TNG to the
1985 main stream Samba lists.</P
1990 >If you post a message to one of the lists please
1991 observe the following guide lines :</B
1996 > Always remember that the developers are volunteers, they are
1997 not paid and they never guarantee to produce a particular feature at
1998 a particular time. Any time lines are 'best guess' and nothing more.
2003 > Always mention what version of samba you are using and what
2004 operating system its running under. You should probably list the
2005 relevant sections of your smb.conf file, at least the options
2006 in [global] that affect PDC support.</P
2010 >In addition to the version, if you obtained Samba via
2011 CVS mention the date when you last checked it out.</P
2015 > Try and make your question clear and brief, lots of long,
2016 convoluted questions get deleted before they are completely read !
2017 Don't post html encoded messages (if you can select colour or font
2022 > If you run one of those niffy 'I'm on holidays' things when
2023 you are away, make sure its configured to not answer mailing lists.
2028 > Don't cross post. Work out which is the best list to post to
2029 and see what happens, ie don't post to both samba-ntdom and samba-technical.
2030 Many people active on the lists subscribe to more
2031 than one list and get annoyed to see the same message two or more times.
2032 Often someone will see a message and thinking it would be better dealt
2033 with on another, will forward it on for you.</P
2037 >You might include <I
2041 log files written at a debug level set to as much as 20.
2042 Please don't send the entire log but enough to give the context of the
2047 >(Possibly) If you have a complete netmon trace ( from the opening of
2048 the pipe to the error ) you can send the *.CAP file as well.</P
2052 >Please think carefully before attaching a document to an email.
2053 Consider pasting the relevant parts into the body of the message. The samba
2054 mailing lists go to a huge number of people, do they all need a copy of your
2055 smb.conf in their attach directory ?</P
2065 >How do I get off the mailing lists ?</A
2068 >To have your name removed from a samba mailing list, go to the
2069 same place you went to to get on it. Go to <A
2070 HREF="http://samba.org"
2072 >http://samba.org</A
2073 >, click on your nearest mirror
2074 and then click on <B
2077 > and then click on <B
2079 > Samba related mailing lists</B
2082 HREF="http://lists.samba.org/mailman/roster/samba-ntdom"
2087 >Please don't post messages to the list asking to be removed, you will just
2088 be refered to the above address (unless that process failed in some way...)