760e2e73b8088c5c344c20c58cefc34a89affefd
[ira/wip.git] / docs / htmldocs / samba-pdc-howto.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >The Samba 2.2 PDC FAQ</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
8 ><BODY
9 CLASS="BOOK"
10 BGCOLOR="#FFFFFF"
11 TEXT="#000000"
12 LINK="#0000FF"
13 VLINK="#840084"
14 ALINK="#0000FF"
15 ><DIV
16 CLASS="BOOK"
17 ><A
18 NAME="SAMBA-PDC-FAQ"
19 ></A
20 ><DIV
21 CLASS="TITLEPAGE"
22 ><H1
23 CLASS="TITLE"
24 ><A
25 NAME="SAMBA-PDC-FAQ"
26 >The Samba 2.2 PDC FAQ</A
27 ></H1
28 ><H3
29 CLASS="AUTHOR"
30 ><A
31 NAME="AEN4"
32 >David Bannon</A
33 ></H3
34 ><DIV
35 CLASS="AFFILIATION"
36 ><SPAN
37 CLASS="ORGNAME"
38 >La Trobe University<BR></SPAN
39 ></DIV
40 ><HR></DIV
41 ><HR><H1
42 ><A
43 NAME="AEN12"
44 ></A
45 ></H1
46 ><P
47 >Comments, corrections and additions to <TT
48 CLASS="EMAIL"
49 >&#60;<A
50 HREF="mailto:D.Bannon@latrobe.edu.au"
51 >D.Bannon@latrobe.edu.au</A
52 >&#62;</TT
53 ></P
54 ><P
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
60 ><P
61 >Please note it does not apply to Samba2.2alpha0, Samba2.2alpha1, Samba 2.0.7, TNG nor HEAD branch.
62     </P
63 ><P
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
65 ><P
66 >       Also available is a Samba 2.2 PDC <A
67 HREF="samba-pdc-howto.html"
68 TARGET="_top"
69 >HowTo</A
70 > that takes you, step
71     by step, over the process of setting up a very basic Samba 2.2 Primary Domain Controller
72     </P
73 ><DIV
74 CLASS="NOTE"
75 ><BLOCKQUOTE
76 CLASS="NOTE"
77 ><P
78 ><B
79 >Note: </B
80 >Please read the Introduction for the current <A
81 HREF="#AEN27"
82 > state of play</A
83 >.</P
84 ></BLOCKQUOTE
85 ></DIV
86 ><DIV
87 CLASS="TOC"
88 ><DL
89 ><DT
90 ><B
91 >Table of Contents</B
92 ></DT
93 ><DT
94 >1. <A
95 HREF="#AEN25"
96 >Introduction</A
97 ></DT
98 ><DD
99 ><DL
100 ><DT
101 ><A
102 HREF="#AEN27"
103 >State of Play</A
104 ></DT
105 ><DT
106 ><A
107 HREF="#AEN44"
108 >Introduction</A
109 ></DT
110 ></DL
111 ></DD
112 ><DT
113 >2. <A
114 HREF="#AEN49"
115 >General Information</A
116 ></DT
117 ><DD
118 ><DL
119 ><DT
120 ><A
121 HREF="#AEN51"
122 >What can we do ?</A
123 ></DT
124 ><DD
125 ><DL
126 ><DT
127 ><A
128 HREF="#AEN53"
129 >What can Samba Primary Domain Controller (PDC) do ?</A
130 ></DT
131 ><DT
132 ><A
133 HREF="#AEN86"
134 >Can I have a Windows 2000 client logon to a Samba controlled domain?</A
135 ></DT
136 ><DT
137 ><A
138 HREF="#AEN89"
139 >What's the status of print spool (spoolss) support in the NTDOM code?</A
140 ></DT
141 ></DL
142 ></DD
143 ><DT
144 ><A
145 HREF="#AEN92"
146 >CVS</A
147 ></DT
148 ><DD
149 ><DL
150 ><DT
151 ><A
152 HREF="#AEN95"
153 >What are the different Samba branches available in CVS ?</A
154 ></DT
155 ><DT
156 ><A
157 HREF="#AEN118"
158 >What are the CVS commands ?</A
159 ></DT
160 ></DL
161 ></DD
162 ></DL
163 ></DD
164 ><DT
165 >3. <A
166 HREF="#AEN149"
167 >Establishing Connections</A
168 ></DT
169 ><DD
170 ><DL
171 ><DT
172 ><A
173 HREF="#AEN151"
174 ></A
175 ></DT
176 ><DD
177 ><DL
178 ><DT
179 ><A
180 HREF="#AEN153"
181 >How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A
182 ></DT
183 ><DT
184 ><A
185 HREF="#AEN158"
186 >What is a 'machine account' ?</A
187 ></DT
188 ><DT
189 ><A
190 HREF="#AEN165"
191 >"The machine account for this computer either does not exist or is not accessable."</A
192 ></DT
193 ><DT
194 ><A
195 HREF="#AEN171"
196 >How do I create machine accounts manually ?</A
197 ></DT
198 ><DT
199 ><A
200 HREF="#AEN184"
201 >I cannot include a '$' in a machine name.</A
202 ></DT
203 ><DT
204 ><A
205 HREF="#AEN190"
206 >I get told "You already have a connection to the Domain...." when creating a
207          machine account.</A
208 ></DT
209 ><DT
210 ><A
211 HREF="#AEN194"
212 >I get told "Cannot join domain, the credentials supplied conflict
213                 with an existing set.."</A
214 ></DT
215 ><DT
216 ><A
217 HREF="#AEN198"
218 >"The system can not log you on (C000019B)...."</A
219 ></DT
220 ></DL
221 ></DD
222 ></DL
223 ></DD
224 ><DT
225 >4. <A
226 HREF="#AEN202"
227 >User Account Management</A
228 ></DT
229 ><DD
230 ><DL
231 ><DT
232 ><A
233 HREF="#AEN204"
234 >Domain Admins</A
235 ></DT
236 ><DD
237 ><DL
238 ><DT
239 ><A
240 HREF="#AEN206"
241 >How do I configure an account as a domain administrator?</A
242 ></DT
243 ></DL
244 ></DD
245 ><DT
246 ><A
247 HREF="#AEN210"
248 >Profiles</A
249 ></DT
250 ><DD
251 ><DL
252 ><DT
253 ><A
254 HREF="#AEN212"
255 >Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A
256 ></DT
257 ><DT
258 ><A
259 HREF="#AEN226"
260 >Why are all the users listed in the "domain admin users" using the same profile?</A
261 ></DT
262 ><DT
263 ><A
264 HREF="#AEN229"
265 >The roaming profiles do not seem to be updating on the server.</A
266 ></DT
267 ></DL
268 ></DD
269 ><DT
270 ><A
271 HREF="#AEN237"
272 >Policies</A
273 ></DT
274 ><DD
275 ><DL
276 ><DT
277 ><A
278 HREF="#AEN239"
279 >What are 'Policies' ?.</A
280 ></DT
281 ><DT
282 ><A
283 HREF="#AEN246"
284 >I can't get system policies to work.</A
285 ></DT
286 ><DT
287 ><A
288 HREF="#AEN260"
289 >What about Windows NT Policy Editor ?</A
290 ></DT
291 ><DT
292 ><A
293 HREF="#AEN274"
294 >Can Win95 do Policies ?</A
295 ></DT
296 ></DL
297 ></DD
298 ><DT
299 ><A
300 HREF="#AEN280"
301 >Passwords</A
302 ></DT
303 ><DD
304 ><DL
305 ><DT
306 ><A
307 HREF="#AEN282"
308 >What is password sync and should I use it ?</A
309 ></DT
310 ><DT
311 ><A
312 HREF="#AEN295"
313 >How do I get remote password (unix and SMB) changing working ?</A
314 ></DT
315 ></DL
316 ></DD
317 ></DL
318 ></DD
319 ><DT
320 >5. <A
321 HREF="#AEN301"
322 >Miscellaneous</A
323 ></DT
324 ><DD
325 ><DL
326 ><DT
327 ><A
328 HREF="#AEN303"
329 ></A
330 ></DT
331 ><DD
332 ><DL
333 ><DT
334 ><A
335 HREF="#AEN305"
336 >How do I get 'User Manager' and 'Server Manager'</A
337 ></DT
338 ><DT
339 ><A
340 HREF="#AEN320"
341 >The time setting from a Samba server does not work.</A
342 ></DT
343 ><DT
344 ><A
345 HREF="#AEN324"
346 >"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A
347 ></DT
348 ><DT
349 ><A
350 HREF="#AEN328"
351 >How do I get my samba server to become a member ( not PDC ) of an NT domain?</A
352 ></DT
353 ></DL
354 ></DD
355 ></DL
356 ></DD
357 ><DT
358 >6. <A
359 HREF="#AEN363"
360 >Troubleshooting and Bug Reporting</A
361 ></DT
362 ><DD
363 ><DL
364 ><DT
365 ><A
366 HREF="#AEN365"
367 >Diagnostic tools</A
368 ></DT
369 ><DD
370 ><DL
371 ><DT
372 ><A
373 HREF="#AEN367"
374 >What are some diagnostics tools I can use to debug the domain logon process and where can I
375         find them?</A
376 ></DT
377 ><DT
378 ><A
379 HREF="#AEN375"
380 >How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A
381 ></DT
382 ></DL
383 ></DD
384 ><DT
385 ><A
386 HREF="#AEN404"
387 >What other help can I get ?</A
388 ></DT
389 ><DD
390 ><DL
391 ><DT
392 ><A
393 HREF="#AEN407"
394 >URLs and similar</A
395 ></DT
396 ><DT
397 ><A
398 HREF="#AEN453"
399 >How do I get help from the mailing lists ?</A
400 ></DT
401 ><DT
402 ><A
403 HREF="#AEN482"
404 >How do I get off the mailing lists ?</A
405 ></DT
406 ></DL
407 ></DD
408 ></DL
409 ></DD
410 ></DL
411 ></DIV
412 ><DIV
413 CLASS="CHAPTER"
414 ><HR><H1
415 ><A
416 NAME="AEN25"
417 >Chapter 1. Introduction</A
418 ></H1
419 ><DIV
420 CLASS="SECT1"
421 ><H1
422 CLASS="SECT1"
423 ><A
424 NAME="AEN27"
425 >State of Play</A
426 ></H1
427 ><P
428 ><I
429 CLASS="EMPHASIS"
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
433 ></P
434 ><P
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
437 ><P
438 >Client Side creation of Machine accounts does work but is not complete. 
439     Firstly, the <TT
440 CLASS="FILENAME"
441 >add user script</TT
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"
447 TARGET="_top"
448 >HowTo</A
449 >.  
450     And thirdly, it does not work with NT4ws. 
451     </P
452 ><P
453 >A W2K machine can join the domain. See the <A
454 HREF="samba-pdc-howto.html"
455 TARGET="_top"
456 >HowTo</A
457 >
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
463 ><P
464 >A Domain Admin account is required and at present it appears that only root
465         is a suitable candidate.</P
466 ><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
469 CLASS="FILENAME"
470 >Create a Computer Account in the Domain</TT
471 > dialog
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
475 ><P
476 ><I
477 CLASS="EMPHASIS"
478 >Actually I'm 
479     not sure that last paragraph is correct ....</I
480 ></P
481 ><P
482 ><B
483 CLASS="COMMAND"
484 >Policies</B
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
487 ></DIV
488 ><DIV
489 CLASS="SECT1"
490 ><HR><H1
491 CLASS="SECT1"
492 ><A
493 NAME="AEN44"
494 >Introduction</A
495 ></H1
496 ><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
500 ><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
505 ><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
508 ></DIV
509 ></DIV
510 ><DIV
511 CLASS="CHAPTER"
512 ><HR><H1
513 ><A
514 NAME="AEN49"
515 >Chapter 2. General Information</A
516 ></H1
517 ><DIV
518 CLASS="SECT1"
519 ><H1
520 CLASS="SECT1"
521 ><A
522 NAME="AEN51"
523 >What can we do ?</A
524 ></H1
525 ><DIV
526 CLASS="SECT2"
527 ><H2
528 CLASS="SECT2"
529 ><A
530 NAME="AEN53"
531 >What can Samba Primary Domain Controller (PDC) do ?</A
532 ></H2
533 ><P
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
537 ><P
538 >The following is a list of included  features currently in Samba 2.2:</P
539 ><P
540 ></P
541 ><UL
542 ><LI
543 ><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 
546         into the domain.</P
547 ></LI
548 ><LI
549 ><P
550 >Domain account can be viewed using the User Manager for 
551         Domains  ????</P
552 ></LI
553 ><LI
554 ><P
555 >Viewing resources on the Samba PDC via the Server Manager for Domains 
556         from the NT client. ??</P
557 ></LI
558 ><LI
559 ><P
560 >Windows 95 clients will allow user level security to be set 
561         but will not currently allow browsing of accounts.</P
562 ></LI
563 ><LI
564 ><P
565 >Machine account password updates.</P
566 ></LI
567 ><LI
568 ><P
569 >Changing of user passwords from an NT client.</P
570 ></LI
571 ><LI
572 ><P
573 >Partial support for Windows NT group and username mapping.</P
574 ></LI
575 ><LI
576 ><P
577 >Support for a LDAP password database backend.</P
578 ></LI
579 ><LI
580 ><P
581 >Printing.</P
582 ></LI
583 ></UL
584 ><P
585 ></P
586 ><P
587 ><B
588 >These things are note expected to work in the forseeable future</B
589 ></P
590 ><UL
591 ><LI
592 ><P
593 >Trust relationships</P
594 ></LI
595 ><LI
596 ><P
597 >PDC and BDC integration</P
598 ></LI
599 ><LI
600 ><P
601 >Windows NT ACLs (on the Samba shares)</P
602 ></LI
603 ><LI
604 ><P
605 >Offer a list of domain users to User Manager for Domains 
606         (or the Security Tab etc).</P
607 ></LI
608 ></UL
609 ></DIV
610 ><DIV
611 CLASS="SECT2"
612 ><HR><H2
613 CLASS="SECT2"
614 ><A
615 NAME="AEN86"
616 >Can I have a Windows 2000 client logon to a Samba controlled domain?</A
617 ></H2
618 ><P
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
621         W2K server.</P
622 ></DIV
623 ><DIV
624 CLASS="SECT2"
625 ><HR><H2
626 CLASS="SECT2"
627 ><A
628 NAME="AEN89"
629 >What's the status of print spool (spoolss) support in the NTDOM code?</A
630 ></H2
631 ><P
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
635 ></DIV
636 ></DIV
637 ><DIV
638 CLASS="SECT1"
639 ><HR><H1
640 CLASS="SECT1"
641 ><A
642 NAME="AEN92"
643 >CVS</A
644 ></H1
645 ><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
649 ><DIV
650 CLASS="SECT2"
651 ><HR><H2
652 CLASS="SECT2"
653 ><A
654 NAME="AEN95"
655 >What are the different Samba branches available in CVS ?</A
656 ></H2
657 ><P
658 >You can find out more about obtaining Samba's  via 
659         anonymous CVS from 
660         <A
661 HREF="http://pserver.samba.org/samba/cvs.html"
662 TARGET="_top"
663 >       http://pserver.samba.org/samba/cvs.html"</A
664 >. </P
665 ><P
666 ></P
667 ><DIV
668 CLASS="VARIABLELIST"
669 ><P
670 ><B
671 >There are basically four branches to watch at the moment :</B
672 ></P
673 ><DL
674 ><DT
675 >HEAD</DT
676 ><DD
677 ><P
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.
683         </P
684 ></DD
685 ><DT
686 >SAMBA_2_0</DT
687 ><DD
688 ><P
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.
693         </P
694 ></DD
695 ><DT
696 >SAMBA_2_2</DT
697 ><DD
698 ><P
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.
703         </P
704 ></DD
705 ><DT
706 >SAMBA_TNG</DT
707 ><DD
708 ><P
709 >This branch is no longer maintained from the Samba sites. 
710                 Please see <A
711 HREF="http://www.samba-tng.org/"
712 TARGET="_top"
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.
717         </P
718 ></DD
719 ></DL
720 ></DIV
721 ></DIV
722 ><DIV
723 CLASS="SECT2"
724 ><HR><H2
725 CLASS="SECT2"
726 ><A
727 NAME="AEN118"
728 >What are the CVS commands ?</A
729 ></H2
730 ><P
731 >See <A
732 HREF="http://pserver.samba.org/samba/cvs.html"
733 TARGET="_top"
734 >       http://pserver.samba.org/samba/cvs.html</A
735 ></P
736 ><P
737 ></P
738 ><P
739 ><B
740 >To get the Samba 2.2 version, tag SAMBA_2_2 you would do :</B
741 ></P
742 ><UL
743 ><LI
744 ><P
745 > For example : <B
746 CLASS="COMMAND"
747 >cd /usr/local/src/</B
748 ></P
749 ></LI
750 ><LI
751 ><P
752 > <B
753 CLASS="COMMAND"
754 >cvs -d :pserver:cvs@pserver.samba.org:/cvsroot 
755                         login</B
756 ></P
757 ></LI
758 ><LI
759 ><P
760 > When prompted enter a password of <B
761 CLASS="COMMAND"
762 >cvs</B
763 ></P
764 ></LI
765 ><LI
766 ><P
767 > <B
768 CLASS="COMMAND"
769 >cvs -d :pserver:cvs@pserver.samba.org:/cvsroot 
770                         co -r SAMBA_2_2 samba</B
771 ></P
772 ></LI
773 ></UL
774 ><P
775 ></P
776 ><P
777 ><B
778 >Then to update that directory at some later time,</B
779 ></P
780 ><UL
781 ><LI
782 ><P
783 > <B
784 CLASS="COMMAND"
785 >cd /usr/local/src/samba</B
786 ></P
787 ></LI
788 ><LI
789 ><P
790 > <B
791 CLASS="COMMAND"
792 >cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login</B
793 ></P
794 ></LI
795 ><LI
796 ><P
797 > When prompted enter a password of 'cvs'.</P
798 ></LI
799 ><LI
800 ><P
801 > <B
802 CLASS="COMMAND"
803 >cvs update -d -P</B
804 ></P
805 ></LI
806 ></UL
807 ></DIV
808 ></DIV
809 ></DIV
810 ><DIV
811 CLASS="CHAPTER"
812 ><HR><H1
813 ><A
814 NAME="AEN149"
815 >Chapter 3. Establishing Connections</A
816 ></H1
817 ><DIV
818 CLASS="SECT1"
819 ><H1
820 CLASS="SECT1"
821 ><A
822 NAME="AEN151"
823 ></A
824 ></H1
825 ><DIV
826 CLASS="SECT2"
827 ><H2
828 CLASS="SECT2"
829 ><A
830 NAME="AEN153"
831 >How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A
832 ></H2
833 ><P
834 >There is a comprehensive Samba PDC <A
835 HREF="samba-pdc-howto.html"
836 TARGET="_top"
837 >HowTo</A
838 >
839      accessable from the samba web site 
840         under 'Documentation'. Its currently located at <A
841 HREF="http://bioserve.latrobe.edu.au/samba"
842 TARGET="_top"
843 >       http://bioserve.latrobe.edu.au/samba</A
844 >. Read it.</P
845 ></DIV
846 ><DIV
847 CLASS="SECT2"
848 ><HR><H2
849 CLASS="SECT2"
850 ><A
851 NAME="AEN158"
852 >What is a 'machine account' ?</A
853 ></H2
854 ><P
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
857 CLASS="FILENAME"
858 >/etc/passwd</TT
859 >
860     and the other in (typically) <TT
861 CLASS="FILENAME"
862 >/usr/local/samba/private/smbpasswd</TT
863 >. Under 
864     some circumstances these entries are made <A
865 HREF="#AEN171"
866 >manually</A
867 >, the 
868     <A
869 HREF="samba-pdc-howto.html"
870 TARGET="_top"
871 >HowTo</A
872 > discusses ways of creating them automatically.</P
873 ></DIV
874 ><DIV
875 CLASS="SECT2"
876 ><HR><H2
877 CLASS="SECT2"
878 ><A
879 NAME="AEN165"
880 >"The machine account for this computer either does not exist or is not accessable."</A
881 ></H2
882 ><P
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
885 ><P
886 >This problem is caused by the PDC not having a suitable machine account. 
887         If you are using the <B
888 CLASS="COMMAND"
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
893 ><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
902 ></DIV
903 ><DIV
904 CLASS="SECT2"
905 ><HR><H2
906 CLASS="SECT2"
907 ><A
908 NAME="AEN171"
909 >How do I create machine accounts manually ?</A
910 ></H2
911 ><P
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 
918         entry like this :</P
919 ><P
920 ><B
921 CLASS="COMMAND"
922 >doppy$:x:505:501:NTMachine:/dev/null:/bin/false</B
923 ></P
924 ><P
925 >On a linux system for example, you would typically add it like this :</P
926 ><P
927 ><B
928 CLASS="COMMAND"
929 >adduser -g machines -c NTMachine -d /dev/null -s /bin/false -n 
930                 doppy$</B
931 ></P
932 ><P
933 >Then you need to add that entry to smbpasswd, assuming you have a suitable
934         path to the <B
935 CLASS="COMMAND"
936 >smbpasswd</B
937 > programme, do this :</P
938 ><P
939 ><B
940 CLASS="COMMAND"
941 >smbpasswd -a -m doppy$</B
942 ></P
943 ><P
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
947 ></DIV
948 ><DIV
949 CLASS="SECT2"
950 ><HR><H2
951 CLASS="SECT2"
952 ><A
953 NAME="AEN184"
954 >I cannot include a '$' in a machine name.</A
955 ></H2
956 ><P
957 >A 'machine name' in (typically) <TT
958 CLASS="FILENAME"
959 >/etc/passwd</TT
960 > consists 
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
963 ><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
966 CLASS="COMMAND"
967 >vipw</B
968 > to edit
969     the entry, adding the '$'. Or create the whole entry with vipw if you like,
970     make sure you use a unique uid !</P
971 ></DIV
972 ><DIV
973 CLASS="SECT2"
974 ><HR><H2
975 CLASS="SECT2"
976 ><A
977 NAME="AEN190"
978 >I get told "You already have a connection to the Domain...." when creating a
979          machine account.</A
980 ></H2
981 ><P
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
986 ><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,
990         and try again.</P
991 ></DIV
992 ><DIV
993 CLASS="SECT2"
994 ><HR><H2
995 CLASS="SECT2"
996 ><A
997 NAME="AEN194"
998 >I get told "Cannot join domain, the credentials supplied conflict
999                 with an existing set.."</A
1000 ></H2
1001 ><P
1002 >This is the same basic problem as mentioned above, <A
1003 HREF="#AEN190"
1004 >        "You already have a connection..."</A
1005 ></P
1006 ></DIV
1007 ><DIV
1008 CLASS="SECT2"
1009 ><HR><H2
1010 CLASS="SECT2"
1011 ><A
1012 NAME="AEN198"
1013 >"The system can not log you on (C000019B)...."</A
1014 ></H2
1015 ><P
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
1019 ><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
1025 ></DIV
1026 ></DIV
1027 ></DIV
1028 ><DIV
1029 CLASS="CHAPTER"
1030 ><HR><H1
1031 ><A
1032 NAME="AEN202"
1033 >Chapter 4. User Account Management</A
1034 ></H1
1035 ><DIV
1036 CLASS="SECT1"
1037 ><H1
1038 CLASS="SECT1"
1039 ><A
1040 NAME="AEN204"
1041 >Domain Admins</A
1042 ></H1
1043 ><DIV
1044 CLASS="SECT2"
1045 ><H2
1046 CLASS="SECT2"
1047 ><A
1048 NAME="AEN206"
1049 >How do I configure an account as a domain administrator?</A
1050 ></H2
1051 ><P
1052 >See the NTDom <A
1053 HREF="samba-pdc-howto.html"
1054 TARGET="_top"
1055 >HowTo</A
1056 >.</P
1057 ></DIV
1058 ></DIV
1059 ><DIV
1060 CLASS="SECT1"
1061 ><HR><H1
1062 CLASS="SECT1"
1063 ><A
1064 NAME="AEN210"
1065 >Profiles</A
1066 ></H1
1067 ><DIV
1068 CLASS="SECT2"
1069 ><H2
1070 CLASS="SECT2"
1071 ><A
1072 NAME="AEN212"
1073 >Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A
1074 ></H2
1075 ><P
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
1078 ><P
1079 ></P
1080 ><UL
1081 ><LI
1082 ><P
1083 > user1 logs into the Windows NT machine.  Therefore the 
1084                 [homes] share is set to \\server\user1.</P
1085 ></LI
1086 ><LI
1087 ><P
1088 > user1 works for a while and then logs out. </P
1089 ></LI
1090 ><LI
1091 ><P
1092 > user2 logs into the same Windows NT  machine.</P
1093 ></LI
1094 ></UL
1095 ><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
1100 ><P
1101 >A better solution is to use a separate [profiles] share and set the 
1102         "logon path = \\%N\profiles\%U" </P
1103 ><DIV
1104 CLASS="NOTE"
1105 ><BLOCKQUOTE
1106 CLASS="NOTE"
1107 ><P
1108 ><B
1109 >Note: </B
1110 >Is this still a problem ????</P
1111 ></BLOCKQUOTE
1112 ></DIV
1113 ></DIV
1114 ><DIV
1115 CLASS="SECT2"
1116 ><HR><H2
1117 CLASS="SECT2"
1118 ><A
1119 NAME="AEN226"
1120 >Why are all the users listed in the "domain admin users" using the same profile?</A
1121 ></H2
1122 ><P
1123 >You are using a very very old development version of Samba. Upgrade.</P
1124 ></DIV
1125 ><DIV
1126 CLASS="SECT2"
1127 ><HR><H2
1128 CLASS="SECT2"
1129 ><A
1130 NAME="AEN229"
1131 >The roaming profiles do not seem to be updating on the server.</A
1132 ></H2
1133 ><P
1134 >There can be several reasons for this.</P
1135 ><P
1136 >Make sure that the time on the client and the PDC are synchronized.  You can accomplish 
1137         this by executing a <B
1138 CLASS="COMMAND"
1139 >net time  \\server /set /yes</B
1140 > replacing server with the 
1141         name of your PDC (or another synchronized SMB server). See <A
1142 HREF="#AEN320"
1143 >    about Setting Time</A
1144 ></P
1145 ><P
1146 >Make sure that the 
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
1150 ><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
1153 ></DIV
1154 ></DIV
1155 ><DIV
1156 CLASS="SECT1"
1157 ><HR><H1
1158 CLASS="SECT1"
1159 ><A
1160 NAME="AEN237"
1161 >Policies</A
1162 ></H1
1163 ><DIV
1164 CLASS="SECT2"
1165 ><H2
1166 CLASS="SECT2"
1167 ><A
1168 NAME="AEN239"
1169 >What are 'Policies' ?.</A
1170 ></H2
1171 ><P
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
1176 ><P
1177 >On a samba PDC this list is obtained from a file called <B
1178 CLASS="COMMAND"
1179 >ntconfig.pol</B
1180 >
1181     and located in the <B
1182 CLASS="COMMAND"
1183 >[netlogon]</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
1186 HREF="#AEN260"
1187 >    below</A
1188 > for how  to get a suitable editor.</P
1189 ></DIV
1190 ><DIV
1191 CLASS="SECT2"
1192 ><HR><H2
1193 CLASS="SECT2"
1194 ><A
1195 NAME="AEN246"
1196 >I can't get system policies to work.</A
1197 ></H2
1198 ><P
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
1201 ><PRE
1202 CLASS="PROGRAMLISTING"
1203 >       [netlogon]
1204         ....
1205         locking = no
1206         public = no
1207         browseable = yes
1208         ....   
1209     </PRE
1210 ><P
1211 >A policy file must be in the <B
1212 CLASS="COMMAND"
1213 >[netlogon]</B
1214 > share and must be 
1215     readable by everyone and writeable by only root. The file must be created
1216     by an NTServer <A
1217 HREF="#AEN260"
1218 >Policy Editor</A
1219 >.</P
1220 ><P
1221 >Last time I (drb) looked in the source, it was
1222         looking for <TT
1223 CLASS="FILENAME"
1224 >ntconfig.pol</TT
1225 > first then several other combinations of upper
1226         and lower case. People have reported success using <TT
1227 CLASS="FILENAME"
1228 >NTconfig.pol</TT
1229 >, 
1230         <TT
1231 CLASS="FILENAME"
1232 >NTconfig.POL</TT
1233 > and <TT
1234 CLASS="FILENAME"
1235 >ntconfig.pol</TT
1236 >.   These are the case 
1237     settings that I (GC) use with the
1238         filename <TT
1239 CLASS="FILENAME"
1240 >ntconfig.pol</TT
1241 ></P
1242 ><PRE
1243 CLASS="PROGRAMLISTING"
1244 >        case sensitive = no
1245         case preserve = yes
1246         default case = yes
1247     </PRE
1248 ></DIV
1249 ><DIV
1250 CLASS="SECT2"
1251 ><HR><H2
1252 CLASS="SECT2"
1253 ><A
1254 NAME="AEN260"
1255 >What about Windows NT Policy Editor ?</A
1256 ></H2
1257 ><P
1258 >To create or edit <B
1259 CLASS="COMMAND"
1260 >ntconfig.pol</B
1261 > you must use the NT Server 
1262     Policy Editor, <B
1263 CLASS="COMMAND"
1264 >poledit.exe</B
1265 >       which is included with NT Server 
1266     but <I
1267 CLASS="EMPHASIS"
1268 >not NT Workstation</I
1269 >. There is a Policy Editor on a NTws 
1270     but it is not suitable for creating <I
1271 CLASS="EMPHASIS"
1272 >Domain Policies</I
1273 >. 
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. 
1278         You need <TT
1279 CLASS="FILENAME"
1280 >poledit.exe, common.adm</TT
1281 > and <TT
1282 CLASS="FILENAME"
1283 >winnt.adm</TT
1284 >. It is convenient
1285     to put the two *.adm files in <TT
1286 CLASS="FILENAME"
1287 >c:\winnt\inf</TT
1288 > which is where
1289     the binary will look for them unless told otherwise. Note also that that 
1290     directory is 'hidden'.</P
1291 ><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 
1294     <B
1295 CLASS="COMMAND"
1296 >servicepackname /x</B
1297 >, ie thats <B
1298 CLASS="COMMAND"
1299 >Nt4sp6ai.exe /x</B
1300 >
1301     for service pack 6a.  
1302         The policy editor, <B
1303 CLASS="COMMAND"
1304 >poledt.exe</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.
1309     </P
1310 ></DIV
1311 ><DIV
1312 CLASS="SECT2"
1313 ><HR><H2
1314 CLASS="SECT2"
1315 ><A
1316 NAME="AEN274"
1317 >Can Win95 do Policies ?</A
1318 ></H2
1319 ><P
1320 >Install the group policy handler for Win9x to pick up group policies. 
1321     Look on the Win98 CD in <TT
1322 CLASS="FILENAME"
1323 >       \tools\reskit\netadmin\poledit</TT
1324 >. Install group policies on a Win9x client by double-clicking 
1325         <TT
1326 CLASS="FILENAME"
1327 >grouppol.inf</TT
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
1331 ><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
1334 ></DIV
1335 ></DIV
1336 ><DIV
1337 CLASS="SECT1"
1338 ><HR><H1
1339 CLASS="SECT1"
1340 ><A
1341 NAME="AEN280"
1342 >Passwords</A
1343 ></H1
1344 ><DIV
1345 CLASS="SECT2"
1346 ><H2
1347 CLASS="SECT2"
1348 ><A
1349 NAME="AEN282"
1350 >What is password sync and should I use it ?</A
1351 ></H2
1352 ><P
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 
1355     (typically in <TT
1356 CLASS="FILENAME"
1357 >/etc/passwd or /etc/shadow</TT
1358 >). In lots of situations
1359     thats OK, for example :</P
1360 ><P
1361 ></P
1362 ><UL
1363 ><LI
1364 ><P
1365 >The server is only accessible to the user via samba.</P
1366 ></LI
1367 ><LI
1368 ><P
1369 >Pam_smb or similar is installed so other applications 
1370         still refer to the samba password.</P
1371 ></LI
1372 ></UL
1373 ><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
1378 ><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
1381 CLASS="COMMAND"
1382 >passwd</B
1383 > command, 
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
1388 CLASS="COMMAND"
1389 >smbpasswd</B
1390 >),
1391     otherwise they will only be changing the unix password.</P
1392 ></DIV
1393 ><DIV
1394 CLASS="SECT2"
1395 ><HR><H2
1396 CLASS="SECT2"
1397 ><A
1398 NAME="AEN295"
1399 >How do I get remote password (unix and SMB) changing working ?</A
1400 ></H2
1401 ><P
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).
1406         </P
1407 ><P
1408 >Add these lines to smb.conf under [Global]</P
1409 ><PRE
1410 CLASS="PROGRAMLISTING"
1411
1412
1413                 unix password sync = true
1414                 passwd program = /usr/bin/passwd %u
1415                 passwd chat = *password* %n\n *password* %n\n *successful*
1416         </PRE
1417 ><P
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
1421 ></DIV
1422 ></DIV
1423 ></DIV
1424 ><DIV
1425 CLASS="CHAPTER"
1426 ><HR><H1
1427 ><A
1428 NAME="AEN301"
1429 >Chapter 5. Miscellaneous</A
1430 ></H1
1431 ><DIV
1432 CLASS="SECT1"
1433 ><H1
1434 CLASS="SECT1"
1435 ><A
1436 NAME="AEN303"
1437 ></A
1438 ></H1
1439 ><DIV
1440 CLASS="SECT2"
1441 ><H2
1442 CLASS="SECT2"
1443 ><A
1444 NAME="AEN305"
1445 >How do I get 'User Manager' and 'Server Manager'</A
1446 ></H2
1447 ><P
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
1450 ><P
1451 ></P
1452 ><P
1453 ><B
1454 >Microsoft distributes a version of these tools called nexus 
1455     for installation on Windows 95 systems.  The tools set includes</B
1456 ></P
1457 ><UL
1458 ><LI
1459 ><P
1460 >Server Manager</P
1461 ></LI
1462 ><LI
1463 ><P
1464 >User Manager for Domains</P
1465 ></LI
1466 ><LI
1467 ><P
1468 >Event Viewer</P
1469 ></LI
1470 ></UL
1471 ><P
1472 >Click here to download the archived file 
1473         <A
1474 HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE"
1475 TARGET="_top"
1476 >        ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE</A
1477 ></P
1478 ><P
1479 >The Windows NT 4.0 version of the 'User Manager for Domains' 
1480         and 'Server Manager' are available from Microsoft via ftp from 
1481         <A
1482 HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE"
1483 TARGET="_top"
1484 >        ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE</A
1485 ></P
1486 ></DIV
1487 ><DIV
1488 CLASS="SECT2"
1489 ><HR><H2
1490 CLASS="SECT2"
1491 ><A
1492 NAME="AEN320"
1493 >The time setting from a Samba server does not work.</A
1494 ></H2
1495 ><P
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.
1500         </P
1501 ><P
1502 >Anyone know what the registry settings are so this could be done with a Policy ?</P
1503 ></DIV
1504 ><DIV
1505 CLASS="SECT2"
1506 ><HR><H2
1507 CLASS="SECT2"
1508 ><A
1509 NAME="AEN324"
1510 >"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A
1511 ></H2
1512 ><P
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
1515 ><P
1516 >You are using one of the old development versions. Upgrade. 
1517         (The message is unimportant, was a reminder to a developer)</P
1518 ></DIV
1519 ><DIV
1520 CLASS="SECT2"
1521 ><HR><H2
1522 CLASS="SECT2"
1523 ><A
1524 NAME="AEN328"
1525 >How do I get my samba server to become a member ( not PDC ) of an NT domain?</A
1526 ></H2
1527 ><P
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
1533 ><PRE
1534 CLASS="PROGRAMLISTING"
1535
1536
1537                 [global]
1538                 ...
1539                 security = domain
1540                 workgroup = { Put your domain name here }
1541                 password server = { Put the ip of the PDC here }
1542                 encrypt passwords = yes
1543                 ...     
1544         </PRE
1545 ><P
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
1550 CLASS="EMPHASIS"
1551 >sleepy</I
1552 > to ask the PDC called <I
1553 CLASS="EMPHASIS"
1554 >grumpy</I
1555
1556         to do its authentication then <I
1557 CLASS="EMPHASIS"
1558 >grumpy</I
1559 > will need an entry in its smbpasswd 
1560         (assuming it's also samba) that starts with <I
1561 CLASS="EMPHASIS"
1562 >sleepy$</I
1563 >. It would have to be
1564     created <A
1565 HREF="#AEN171"
1566 >manually</A
1567 >. </P
1568 ><P
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
1571 ><P
1572 >In either case we then join the domain. If the domain is called <I
1573 CLASS="EMPHASIS"
1574 >forest</I
1575 >
1576         then on sleepy we would join the domain by typing :</P
1577 ><P
1578 ><B
1579 CLASS="COMMAND"
1580 >smbpasswd -j forest</B
1581 ></P
1582 ><P
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
1585     might be <TT
1586 CLASS="FILENAME"
1587 >/usr/local/samba/private/FOREST.SLEEPY.SID</TT
1588 > and
1589     it contains the trust account password for the domain member. The permissions are
1590     (and should remain) "rw-------</P
1591 ><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
1594 CLASS="FILENAME"
1595 >/etc/passwd</TT
1596 >. Because authentication
1597     is being handled at the domain level the 
1598         <TT
1599 CLASS="FILENAME"
1600 >/etc/passwd</TT
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
1604         <TT
1605 CLASS="FILENAME"
1606 >/etc/passwd</TT
1607 > does not need a home directory. A typical 
1608         line in <TT
1609 CLASS="FILENAME"
1610 >/etc/passwd</TT
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
1614 ><PRE
1615 CLASS="PROGRAMLISTING"
1616 >jblow:x:542:100:Joe Blow:/dev/null:/bin/false</PRE
1617 ><DIV
1618 CLASS="NOTE"
1619 ><BLOCKQUOTE
1620 CLASS="NOTE"
1621 ><P
1622 ></P
1623 ><UL
1624 ><LI
1625 ><P
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 !
1628         </P
1629 ></LI
1630 ><LI
1631 ><P
1632 >The <TT
1633 CLASS="FILENAME"
1634 >username map = </TT
1635 > parameter might help you to avoid having 
1636     all those accounts created.</P
1637 ></LI
1638 ><LI
1639 ><P
1640 >You should investigate the smb.conf parameter 
1641             <TT
1642 CLASS="FILENAME"
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.
1646         Something like :</P
1647 ><PRE
1648 CLASS="PROGRAMLISTING"
1649 >    [Global]
1650     ....
1651     add user script = /usr/sbin/adduser -n -g users -c User -d /dev/null -s /bin/false %U       
1652     ....
1653         </PRE
1654 ></LI
1655 ></UL
1656 ></BLOCKQUOTE
1657 ></DIV
1658 ></DIV
1659 ></DIV
1660 ></DIV
1661 ><DIV
1662 CLASS="CHAPTER"
1663 ><HR><H1
1664 ><A
1665 NAME="AEN363"
1666 >Chapter 6. Troubleshooting and Bug Reporting</A
1667 ></H1
1668 ><DIV
1669 CLASS="SECT1"
1670 ><H1
1671 CLASS="SECT1"
1672 ><A
1673 NAME="AEN365"
1674 >Diagnostic tools</A
1675 ></H1
1676 ><DIV
1677 CLASS="SECT2"
1678 ><H2
1679 CLASS="SECT2"
1680 ><A
1681 NAME="AEN367"
1682 >What are some diagnostics tools I can use to debug the domain logon process and where can I
1683         find them?</A
1684 ></H2
1685 ><P
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
1700 ><P
1701 >An SMB enabled version of tcpdump is available from 
1702     <A
1703 HREF="ftp://samba.org/pub/samba/tcpdump-smb/"
1704 TARGET="_top"
1705 >ftp://samba.org/pub/samba/tcpdump-smb/
1706     </A
1707 ></P
1708 ><P
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 
1711         ( ie. <B
1712 CLASS="COMMAND"
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.
1716     </P
1717 ><P
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
1724 ></DIV
1725 ><DIV
1726 CLASS="SECT2"
1727 ><HR><H2
1728 CLASS="SECT2"
1729 ><A
1730 NAME="AEN375"
1731 >How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A
1732 ></H2
1733 ><P
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
1739 ><P
1740 >Initially you will need to install 'Network Monitor Tools and Agent' on the 
1741     NT Server.  To do this </P
1742 ><P
1743 ></P
1744 ><UL
1745 ><LI
1746 ><P
1747 >Goto Start - Settings - Control Panel - Network - Services - Add </P
1748 ></LI
1749 ><LI
1750 ><P
1751 >Select the 'Network Monitor Tools and Agent' and click on 'OK'.</P
1752 ></LI
1753 ><LI
1754 ><P
1755 >Click 'OK' on the Network Control Panel.</P
1756 ></LI
1757 ><LI
1758 ><P
1759 >Insert the Windows NT Server 4.0 install CD when prompted.</P
1760 ></LI
1761 ></UL
1762 ><P
1763 >At this point the Netmon files should exist in <TT
1764 CLASS="FILENAME"
1765 >%SYSTEMROOT%\System32\netmon\*.*</TT
1766 >.    
1767         Two subdirectories exist as well, <TT
1768 CLASS="FILENAME"
1769 >parsers\</TT
1770 > which contains the necessary DLL's 
1771         for parsing the netmon packet dump, and <TT
1772 CLASS="FILENAME"
1773 >captures\</TT
1774 >.</P
1775 ><P
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
1778 ><P
1779 ></P
1780 ><UL
1781 ><LI
1782 ><P
1783 >Goto Start - Settings - Control Panel - Network - Services - Add</P
1784 ></LI
1785 ><LI
1786 ><P
1787 >Select the 'Network Monitor Agent' and click on 'OK'.</P
1788 ></LI
1789 ><LI
1790 ><P
1791 >Click 'OK' on the Network Control Panel.</P
1792 ></LI
1793 ><LI
1794 ><P
1795 >Insert the Windows NT Workstation 4.0 install CD when prompted.</P
1796 ></LI
1797 ></UL
1798 ><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
1803 ><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
1808 ></DIV
1809 ></DIV
1810 ><DIV
1811 CLASS="SECT1"
1812 ><HR><H1
1813 CLASS="SECT1"
1814 ><A
1815 NAME="AEN404"
1816 >What other help can I get ?</A
1817 ></H1
1818 ><P
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
1822 ><DIV
1823 CLASS="SECT2"
1824 ><HR><H2
1825 CLASS="SECT2"
1826 ><A
1827 NAME="AEN407"
1828 >URLs and similar</A
1829 ></H2
1830 ><P
1831 ></P
1832 ><UL
1833 ><LI
1834 ><P
1835 >Home of Samba site <A
1836 HREF="http://samba.org"
1837 TARGET="_top"
1838 >        http://samba.org</A
1839 >. We have a mirror near you !</P
1840 ></LI
1841 ><LI
1842 ><P
1843 > The <I
1844 CLASS="EMPHASIS"
1845 >Development</I
1846 > document 
1847                 on the Samba mirrors might mention your problem. If so,
1848                 it might mean that the developers are working on it.</P
1849 ></LI
1850 ><LI
1851 ><P
1852 > Ignacio Coupeau has a very comprehesive look at LDAP with Samba at 
1853                 <A
1854 HREF="http://www.unav.es/cti/ldap-smb-howto.html"
1855 TARGET="_top"
1856 >               http://www.unav.es/cti/ldap-smb-howto.html</A
1857
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
1861 ></LI
1862 ><LI
1863 ><P
1864 >  Lars Kneschke's site covers <A
1865 HREF="http://www.samba-tng.org"
1866 TARGET="_top"
1867 >        Samba-TNG</A
1868 > at 
1869                 <A
1870 HREF="http://www.kneschke.de/projekte/samba_tng"
1871 TARGET="_top"
1872 >               http://www.kneschke.de/projekte/samba_tng</A
1873 >, but again, a 
1874                 lot of it does not apply to the main stream Samba.</P
1875 ></LI
1876 ><LI
1877 ><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"
1881 TARGET="_top"
1882 >        http://bioserve.latrobe.edu.au/samba</A
1883 > going for a while yet.</P
1884 ></LI
1885 ><LI
1886 ><P
1887 >Misc links to CIFS information 
1888         <A
1889 HREF="http://samba.org/cifs/"
1890 TARGET="_top"
1891 >http://samba.org/cifs/</A
1892 ></P
1893 ></LI
1894 ><LI
1895 ><P
1896 >NT Domains for Unix <A
1897 HREF="http://mailhost.cb1.com/~lkcl/ntdom/"
1898 TARGET="_top"
1899 >        http://mailhost.cb1.com/~lkcl/ntdom/</A
1900 ></P
1901 ></LI
1902 ><LI
1903 ><P
1904 >FTP site for older SMB specs: 
1905         <A
1906 HREF="ftp://ftp.microsoft.com/developr/drg/CIFS/"
1907 TARGET="_top"
1908 >        ftp://ftp.microsoft.com/developr/drg/CIFS/</A
1909 ></P
1910 ></LI
1911 ></UL
1912 ><P
1913 ></P
1914 ><P
1915 ><B
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
1918 ></P
1919 ><UL
1920 ><LI
1921 ><P
1922 >CIFS/E Browser Protocol draft-leach-cifs-browser-spec-00.txt</P
1923 ></LI
1924 ><LI
1925 ><P
1926 >CIFS Remote Administration Protocol draft-leach-cifs-rap-spec-00.txt</P
1927 ></LI
1928 ><LI
1929 ><P
1930 >CIFS Logon and Pass Through Authentication draft-leach-cifs-logon-spec-00.txt</P
1931 ></LI
1932 ><LI
1933 ><P
1934 >A Common Internet File System (CIFS/1.0) Protocol draft-leach-cifs-v1-spec-01.txt</P
1935 ></LI
1936 ><LI
1937 ><P
1938 >CIFS Printing Specification draft-leach-cifs-print-spec-00.txt</P
1939 ></LI
1940 ><LI
1941 ><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
1944 ></LI
1945 ><LI
1946 ><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
1949 ></LI
1950 ><LI
1951 ><P
1952 >Microsoft's main CIFS page: http://www.microsoft.com/workshop/networking/cifs/</P
1953 ></LI
1954 ></UL
1955 ></DIV
1956 ><DIV
1957 CLASS="SECT2"
1958 ><HR><H2
1959 CLASS="SECT2"
1960 ><A
1961 NAME="AEN453"
1962 >How do I get help from the mailing lists ?</A
1963 ></H2
1964 ><P
1965 > There are a number of Samba related mailing lists. Go to <A
1966 HREF="http://samba.org"
1967 TARGET="_top"
1968 >http://samba.org</A
1969 >, click on your nearest mirror
1970         and then click on <B
1971 CLASS="COMMAND"
1972 >Support</B
1973 > and then click on <B
1974 CLASS="COMMAND"
1975 >        Samba related mailing lists</B
1976 >.</P
1977 ><P
1978 >For questions relating to Samba TNG go to
1979         <A
1980 HREF="http://www.samba-tng.org/"
1981 TARGET="_top"
1982 >http://www.samba-tng.org/</A
1983
1984             It has been requested that you don't post questions about Samba-TNG to the
1985         main stream Samba lists.</P
1986 ><P
1987 ></P
1988 ><P
1989 ><B
1990 >If you post a message to one of the lists please
1991          observe the following guide lines :</B
1992 ></P
1993 ><UL
1994 ><LI
1995 ><P
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.
1999                 </P
2000 ></LI
2001 ><LI
2002 ><P
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
2007 ></LI
2008 ><LI
2009 ><P
2010 >In addition to the version, if you obtained Samba via
2011         CVS mention the date when you last checked it out.</P
2012 ></LI
2013 ><LI
2014 ><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 
2018                 size its html).</P
2019 ></LI
2020 ><LI
2021 ><P
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.
2024                 </P
2025 ></LI
2026 ><LI
2027 ><P
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
2034 ></LI
2035 ><LI
2036 ><P
2037 >You might include <I
2038 CLASS="EMPHASIS"
2039 >partial</I
2040 >
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 
2043         error messages.</P
2044 ></LI
2045 ><LI
2046 ><P
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
2049 ></LI
2050 ><LI
2051 ><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
2056 ></LI
2057 ></UL
2058 ></DIV
2059 ><DIV
2060 CLASS="SECT2"
2061 ><HR><H2
2062 CLASS="SECT2"
2063 ><A
2064 NAME="AEN482"
2065 >How do I get off the mailing lists ?</A
2066 ></H2
2067 ><P
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"
2071 TARGET="_top"
2072 >http://samba.org</A
2073 >, click on your nearest mirror
2074         and then click on <B
2075 CLASS="COMMAND"
2076 >Support</B
2077 > and then click on <B
2078 CLASS="COMMAND"
2079 >        Samba related mailing lists</B
2080 >. Or perhaps see 
2081         <A
2082 HREF="http://lists.samba.org/mailman/roster/samba-ntdom"
2083 TARGET="_top"
2084 >here</A
2085 ></P
2086 ><P
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...)
2089     </P
2090 ></DIV
2091 ></DIV
2092 ></DIV
2093 ></DIV
2094 ></BODY
2095 ></HTML
2096 >