diff options
-rw-r--r-- | docs/htmldocs/samba-pdc-faq.html | 2157 | ||||
-rw-r--r-- | docs/htmldocs/samba-pdc-howto.html | 2096 | ||||
-rw-r--r-- | docs/textdocs/samba-pdc-faq.txt | 923 | ||||
-rw-r--r-- | docs/textdocs/samba-pdc-howto.txt | 703 |
4 files changed, 5879 insertions, 0 deletions
diff --git a/docs/htmldocs/samba-pdc-faq.html b/docs/htmldocs/samba-pdc-faq.html new file mode 100644 index 0000000000..08301f8a40 --- /dev/null +++ b/docs/htmldocs/samba-pdc-faq.html @@ -0,0 +1,2157 @@ +<HTML +><HEAD +><TITLE +>The Samba 2.2 PDC FAQ</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD +><BODY +CLASS="BOOK" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="BOOK" +><A +NAME="SAMBA-PDC-FAQ" +></A +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="SAMBA-PDC-FAQ" +>The Samba 2.2 PDC FAQ</A +></H1 +><H3 +CLASS="AUTHOR" +><A +NAME="AEN4" +>David Bannon</A +></H3 +><DIV +CLASS="AFFILIATION" +><SPAN +CLASS="ORGNAME" +>La Trobe University<BR></SPAN +></DIV +><HR></DIV +><HR><H1 +><A +NAME="AEN12" +></A +></H1 +><P +>Comments, corrections and additions to <TT +CLASS="EMAIL" +><<A +HREF="mailto:D.Bannon@latrobe.edu.au" +>D.Bannon@latrobe.edu.au</A +>></TT +></P +><P +>This is the FAQ for Samba 2.2 as an NTDomain controller. + This document is derived from the origional FAQ that was built and + maintained by Gerald Carter + from the early days of Samba NTDomain development up until recently. + It is now being updated as significent changes are made to 2.2.0.</P +><P +>Please note it does not apply to Samba2.2alpha0, Samba2.2alpha1, Samba 2.0.7, TNG nor HEAD branch. + </P +><P +>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 +><P +> Also available is a Samba 2.2 PDC <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> that takes you, step + by step, over the process of setting up a very basic Samba 2.2 Primary Domain Controller + </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +>Please read the Introduction for the current <A +HREF="#AEN27" +> state of play</A +>.</P +></BLOCKQUOTE +></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>1. <A +HREF="#AEN25" +>Introduction</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN27" +>State of Play</A +></DT +><DT +><A +HREF="#AEN44" +>Introduction</A +></DT +></DL +></DD +><DT +>2. <A +HREF="#AEN49" +>General Information</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN51" +>What can we do ?</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN53" +>What can Samba Primary Domain Controller (PDC) do ?</A +></DT +><DT +><A +HREF="#AEN86" +>Can I have a Windows 2000 client logon to a Samba controlled domain?</A +></DT +><DT +><A +HREF="#AEN89" +>What's the status of print spool (spoolss) support in the NTDOM code?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN92" +>CVS</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN95" +>What are the different Samba branches available in CVS ?</A +></DT +><DT +><A +HREF="#AEN118" +>What are the CVS commands ?</A +></DT +></DL +></DD +></DL +></DD +><DT +>3. <A +HREF="#AEN149" +>Establishing Connections</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN151" +></A +></DT +><DD +><DL +><DT +><A +HREF="#AEN153" +>How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A +></DT +><DT +><A +HREF="#AEN158" +>What is a 'machine account' ?</A +></DT +><DT +><A +HREF="#AEN165" +>"The machine account for this computer either does not exist or is not accessable."</A +></DT +><DT +><A +HREF="#AEN171" +>How do I create machine accounts manually ?</A +></DT +><DT +><A +HREF="#AEN184" +>I cannot include a '$' in a machine name.</A +></DT +><DT +><A +HREF="#AEN190" +>I get told "You already have a connection to the Domain...." when creating a + machine account.</A +></DT +><DT +><A +HREF="#AEN194" +>I get told "Cannot join domain, the credentials supplied conflict + with an existing set.."</A +></DT +><DT +><A +HREF="#AEN198" +>"The system can not log you on (C000019B)...."</A +></DT +></DL +></DD +></DL +></DD +><DT +>4. <A +HREF="#AEN202" +>User Account Management</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN204" +>Domain Admins</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN206" +>How do I configure an account as a domain administrator?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN210" +>Profiles</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN212" +>Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A +></DT +><DT +><A +HREF="#AEN226" +>Why are all the users listed in the "domain admin users" using the same profile?</A +></DT +><DT +><A +HREF="#AEN229" +>The roaming profiles do not seem to be updating on the server.</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN237" +>Policies</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN239" +>What are 'Policies' ?.</A +></DT +><DT +><A +HREF="#AEN246" +>I can't get system policies to work.</A +></DT +><DT +><A +HREF="#AEN260" +>What about Windows NT Policy Editor ?</A +></DT +><DT +><A +HREF="#AEN274" +>Can Win95 do Policies ?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN280" +>Passwords</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN282" +>What is password sync and should I use it ?</A +></DT +><DT +><A +HREF="#AEN295" +>How do I get remote password (unix and SMB) changing working ?</A +></DT +></DL +></DD +></DL +></DD +><DT +>5. <A +HREF="#AEN301" +>Miscellaneous</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN303" +></A +></DT +><DD +><DL +><DT +><A +HREF="#AEN305" +>What editor can I use in DOS/Windows that won't mess with my unix EOF</A +></DT +><DT +><A +HREF="#AEN318" +>How do I get 'User Manager' and 'Server Manager'</A +></DT +><DT +><A +HREF="#AEN333" +>The time setting from a Samba server does not work.</A +></DT +><DT +><A +HREF="#AEN337" +>"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A +></DT +><DT +><A +HREF="#AEN341" +>How do I get my samba server to become a member ( not PDC ) of an NT domain?</A +></DT +></DL +></DD +></DL +></DD +><DT +>6. <A +HREF="#AEN376" +>Troubleshooting and Bug Reporting</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN378" +>Diagnostic tools</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN380" +>What are some diagnostics tools I can use to debug the domain logon process and where can I + find them?</A +></DT +><DT +><A +HREF="#AEN394" +>How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN423" +>What other help can I get ?</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN426" +>URLs and similar</A +></DT +><DT +><A +HREF="#AEN472" +>How do I get help from the mailing lists ?</A +></DT +><DT +><A +HREF="#AEN501" +>How do I get off the mailing lists ?</A +></DT +></DL +></DD +></DL +></DD +></DL +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN25" +>Chapter 1. Introduction</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN27" +>State of Play</A +></H1 +><P +><I +CLASS="EMPHASIS" +>It should be noted that 2.2.0 in its pre-release form still has a few problems, + I'll try and keep this section current while things are still dynamic. + At the time of this update (November 13, 2000) the current state of play is :</I +></P +><P +>Comments here about W2K joining the domain apply only to Samba 2.2 from the CVS after November 27th. The + 'snapshot' release Samba2.2alpha1 does not work !!! See below on how to get a CVS tree.</P +><P +>Client Side creation of Machine accounts does work but is not complete. + Firstly, the <TT +CLASS="FILENAME" +>add user script</TT +> runs as the user who's + name was entered, not as root. Secondly, the machine name passed to the script (%U) + has an underscore at the end, not a '$'. One alternative is to use %m and add the $. + This method is documented in the <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +>. + And thirdly, it does not work with NT4ws. + </P +><P +>A W2K machine can join the domain. See the <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> + which explains the process. The methods + described are 'work arounds' and should be regarded as temporary. Although I (drb) + have tested these procedures a number of people have had difficulty so there + may be other issues at work. JFM is aware of these + problems and will attend to them when he can.</P +><P +>A Domain Admin account is required and at present it appears that only root + is a suitable candidate.</P +><P +>Much of the related code does work. For example, if an NT is removed from the + domain and then rejoins, the <TT +CLASS="FILENAME" +>Create a Computer Account in the Domain</TT +> dialog + will let you reset the smbpasswd. That is you don't need to do it from + the unix box. However, at the present, you do need to have root as an + administrator and use the root user name and password.</P +><P +><I +CLASS="EMPHASIS" +>Actually I'm + not sure that last paragraph is correct ....</I +></P +><P +><B +CLASS="COMMAND" +>Policies</B +> do work on a W2K machine. MS says that recent builds of + W2K dont observe an NT policy but it appears it does in 'legacy' mode.</P +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN44" +>Introduction</A +></H1 +><P +>This FAQ was origionally compiled by Jerry Carter (gc) chiefly dealing with the 'old head' + version of Samba and its NTDomain facilities. It is being rewritten by David Bannon (drb) + so that it addresses more accurately the Samba 2.2 planned for release late 2000. </P +><P +>This document probably still contains some material that does not apply to + Samba 2.2 but most (all?) of the really misleading stuff has been removed. Some + issues are not dealt with or are dealt with badly. Please send corrections and additions to + David Bannon at D.Bannon@latrobe.edu.au</P +><P +>Hopefully, as we all become familiar with the Samba 2.2 as a PDC this document will + become much more usefull.</P +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN49" +>Chapter 2. General Information</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN51" +>What can we do ?</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN53" +>What can Samba Primary Domain Controller (PDC) do ?</A +></H2 +><P +>If you wish to have Samba act as a PDC for Windows NT 3.51.and 4.0 or W2000 client, then you + will need to obtain the 2.2.0 version, currently in pre-release. Release of a stable, + full featured Samba PDC is currently slated for version 3.0. </P +><P +>The following is a list of included features currently in Samba 2.2:</P +><P +></P +><UL +><LI +><P +>The ability to act as a limited PDC for Windows NT and W2000 clients. + This includes adding NT and W2K machines to the domain and authenticating users logging + into the domain.</P +></LI +><LI +><P +>Domain account can be viewed using the User Manager for + Domains ????</P +></LI +><LI +><P +>Viewing resources on the Samba PDC via the Server Manager for Domains + from the NT client. ??</P +></LI +><LI +><P +>Windows 95 clients will allow user level security to be set + but will not currently allow browsing of accounts.</P +></LI +><LI +><P +>Machine account password updates.</P +></LI +><LI +><P +>Changing of user passwords from an NT client.</P +></LI +><LI +><P +>Partial support for Windows NT group and username mapping.</P +></LI +><LI +><P +>Support for a LDAP password database backend.</P +></LI +><LI +><P +>Printing.</P +></LI +></UL +><P +></P +><P +><B +>These things are note expected to work in the forseeable future</B +></P +><UL +><LI +><P +>Trust relationships</P +></LI +><LI +><P +>PDC and BDC integration</P +></LI +><LI +><P +>Windows NT ACLs (on the Samba shares)</P +></LI +><LI +><P +>Offer a list of domain users to User Manager for Domains + (or the Security Tab etc).</P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN86" +>Can I have a Windows 2000 client logon to a Samba controlled domain?</A +></H2 +><P +>The 2.2 release branch of Samba supports Windows 2000 domain + clients in legacy mode, ie as if the PDC is a NTServer, not a + W2K server.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN89" +>What's the status of print spool (spoolss) support in the NTDOM code?</A +></H2 +><P +>The implementation of support for SPOOLSS pipe is complete and it will be available + in the 2.2.0 release. This means that Samba will support the automatic downloading of printer + drivers for Windows NT clients just as it currently does for Windows 9x clients.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN92" +>CVS</A +></H1 +><P +>CVS is a programme (publically available) that the Samba developers use to + maintain the central source code. Non developers can get access to the source in + a read only capacity. Many flavours of unix now arrive with cvs installed.</P +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN95" +>What are the different Samba branches available in CVS ?</A +></H2 +><P +>You can find out more about obtaining Samba's via + anonymous CVS from + <A +HREF="http://pserver.samba.org/samba/cvs.html" +TARGET="_top" +> http://pserver.samba.org/samba/cvs.html"</A +>. </P +><P +></P +><DIV +CLASS="VARIABLELIST" +><P +><B +>There are basically four branches to watch at the moment :</B +></P +><DL +><DT +>HEAD</DT +><DD +><P +>Samba 3.0 ? This code boasts all the main development + work in Samba. Two things that most people are not aware of + which live in the HEAD branch code are winbind NSS module and + Tim Potter's VFS implementation. Due to its developmental + nature, its not really suitable for production work. + </P +></DD +><DT +>SAMBA_2_0</DT +><DD +><P +>This branch contains the current stable release release. + At the moment it contains 2.0.7, a version that will do some + limited PDC stuff. If you are really going to do PDC things then + I (drb) suggest that you consider 2.2 instead. + </P +></DD +><DT +>SAMBA_2_2</DT +><DD +><P +>The next stable release, currently in a 'alpha' form. + It provides the Samba developers, testers and interested + people with an approximation of what is to come. This document + addresses only SAMBA_2_2. + </P +></DD +><DT +>SAMBA_TNG</DT +><DD +><P +>This branch is no longer maintained from the Samba sites. + Please see <A +HREF="http://www.samba-tng.org/" +TARGET="_top" +> http://www.samba-tng.org/</A +>. It has been requested + that questions about TNG are not posted to the regular Samba mailing + lists including samba-ntdom and samba-technical. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN118" +>What are the CVS commands ?</A +></H2 +><P +>See <A +HREF="http://pserver.samba.org/samba/cvs.html" +TARGET="_top" +> http://pserver.samba.org/samba/cvs.html</A +></P +><P +></P +><P +><B +>To get the Samba 2.2 version, tag SAMBA_2_2 you would do :</B +></P +><UL +><LI +><P +> For example : <B +CLASS="COMMAND" +>cd /usr/local/src/</B +></P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs -d :pserver:cvs@pserver.samba.org:/cvsroot + login</B +></P +></LI +><LI +><P +> When prompted enter a password of <B +CLASS="COMMAND" +>cvs</B +></P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs -d :pserver:cvs@pserver.samba.org:/cvsroot + co -r SAMBA_2_2 samba</B +></P +></LI +></UL +><P +></P +><P +><B +>Then to update that directory at some later time,</B +></P +><UL +><LI +><P +> <B +CLASS="COMMAND" +>cd /usr/local/src/samba</B +></P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login</B +></P +></LI +><LI +><P +> When prompted enter a password of 'cvs'.</P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs update -d -P</B +></P +></LI +></UL +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN149" +>Chapter 3. Establishing Connections</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN151" +></A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN153" +>How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A +></H2 +><P +>There is a comprehensive Samba PDC <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> + accessable from the samba web site + under 'Documentation'. Its currently located at <A +HREF="http://bioserve.latrobe.edu.au/samba" +TARGET="_top" +> http://bioserve.latrobe.edu.au/samba</A +>. Read it.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN158" +>What is a 'machine account' ?</A +></H2 +><P +>Every NT, W2K or Samba machine that joins a Samba controlled domain must be known to + the Samba PDC. There are two entries required, one in (typically) <TT +CLASS="FILENAME" +>/etc/passwd</TT +> + and the other in (typically) <TT +CLASS="FILENAME" +>/usr/local/samba/private/smbpasswd</TT +>. Under + some circumstances these entries are made <A +HREF="#AEN171" +>manually</A +>, the + <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> discusses ways of creating them automatically.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN165" +>"The machine account for this computer either does not exist or is not accessable."</A +></H2 +><P +>When I try to join the domain I get the message "The machine account for this computer + either does not exist or is not accessable". Whats wrong ?</P +><P +>This problem is caused by the PDC not having a suitable machine account. + If you are using the <B +CLASS="COMMAND" +>add user script =</B +> method to create accounts + then this would indicate that it has not worked. Ensure the domain admin user + system is working.</P +><P +>Alternatively if you are creating account entries manually then they have not been created + correctly. Make sure that you have the entry correct for the machine account in smbpasswd + file on the Samba PDC. If you added the account using an editor rather than using the smbpasswd utility, + make sure that the account name is the machine netbios name with a '$' appended to it + ( ie. computer_name$ ). There must be an entry in both /etc/passwd and + the smbpasswd file. Some people have reported that + inconsistent subnet masks between the Samba server and the NT client have caused this problem. + Make sure that these are consistent for both client and server.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN171" +>How do I create machine accounts manually ?</A +></H2 +><P +>This was the only option until recently, now in version 2.2 better means are available. + You might still need to do it manually for a couple of reasons. A machine account + consists of two entries (assuming a standard install and /etc/passwd use), + one in /etc/passwd and the other in /usr/local/samba/private/smbpasswd. The /etc/passwd + entry will list the machine name with a $ appended, won't have a passwd, will have a null + shell and no home directory. For example a machine called 'doppy' would have an /etc/passwd + entry like this :</P +><P +><B +CLASS="COMMAND" +>doppy$:x:505:501:NTMachine:/dev/null:/bin/false</B +></P +><P +>On a linux system for example, you would typically add it like this :</P +><P +><B +CLASS="COMMAND" +>adduser -g machines -c NTMachine -d /dev/null -s /bin/false -n + doppy$</B +></P +><P +>Then you need to add that entry to smbpasswd, assuming you have a suitable + path to the <B +CLASS="COMMAND" +>smbpasswd</B +> programme, do this :</P +><P +><B +CLASS="COMMAND" +>smbpasswd -a -m doppy$</B +></P +><P +>The entry will be created with a well known password, so any machine that + says its doppy could join the domain as long as it gets in first. So don't create + the accounts any earlier than you need them.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN184" +>I cannot include a '$' in a machine name.</A +></H2 +><P +>A 'machine name' in (typically) <TT +CLASS="FILENAME" +>/etc/passwd</TT +> consists + of the machine name with a '$' appended. FreeBSD (and other BSD systems ?) + won't create a user with a '$' in their name.</P +><P +>The problem is only in the program used to make the entry, once made, it works + perfectly. So create a user without the '$' and use <B +CLASS="COMMAND" +>vipw</B +> to edit + the entry, adding the '$'. Or create the whole entry with vipw if you like, + make sure you use a unique uid !</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN190" +>I get told "You already have a connection to the Domain...." when creating a + machine account.</A +></H2 +><P +>This happens if you try to create a machine account from the machine itself + and use a user name that does not work (for whatever reason) and then try + another (possibly valid) user name. + Exit out of the network applet to close the initial connection and try again.</P +><P +>Further, if the machine is a already a 'member of a workgroup' that is the + same name as the domain you are joining (bad idea) you will get this message. + Change the workgroup name to something else, it does not matter what, reboot, + and try again.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN194" +>I get told "Cannot join domain, the credentials supplied conflict + with an existing set.."</A +></H2 +><P +>This is the same basic problem as mentioned above, <A +HREF="#AEN190" +> "You already have a connection..."</A +></P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN198" +>"The system can not log you on (C000019B)...."</A +></H2 +><P +>I joined the domain successfully but after upgrading to a newer version of the + Samba code I get the message, "The system can not log you on (C000019B), Please try a + gain or consult your system administrator" when attempting to logon.</P +><P +>This occurs when the domain SID stored in private/WORKGROUP.SID is changed. + For example, you remove the file and smbd automatically creates a new one. + Or you are swapping back and forth between versions 2.0.7, TNG and the HEAD branch + code (not recommended). The only way to correct the problem is to restore the + original domain SID or remove the domain client from the domain and rejoin.</P +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN202" +>Chapter 4. User Account Management</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN204" +>Domain Admins</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN206" +>How do I configure an account as a domain administrator?</A +></H2 +><P +>See the NTDom <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +>.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN210" +>Profiles</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN212" +>Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A +></H2 +><P +>Sometimes Windows clients will maintain a connection to the \\homes\ ( or [%U] ) share + even after the user has logged out. Consider the following scenario.</P +><P +></P +><UL +><LI +><P +> user1 logs into the Windows NT machine. Therefore the + [homes] share is set to \\server\user1.</P +></LI +><LI +><P +> user1 works for a while and then logs out. </P +></LI +><LI +><P +> user2 logs into the same Windows NT machine.</P +></LI +></UL +><P +>However, since the NT box has maintained a connection to [homes] which was + previously set to \\server\user1, when the operating system attempts to + get the profile and if it can read users1's profile, will get it otherwise it + will return an error. You get the picture.</P +><P +>A better solution is to use a separate [profiles] share and set the + "logon path = \\%N\profiles\%U" </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +>Is this still a problem ????</P +></BLOCKQUOTE +></DIV +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN226" +>Why are all the users listed in the "domain admin users" using the same profile?</A +></H2 +><P +>You are using a very very old development version of Samba. Upgrade.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN229" +>The roaming profiles do not seem to be updating on the server.</A +></H2 +><P +>There can be several reasons for this.</P +><P +>Make sure that the time on the client and the PDC are synchronized. You can accomplish + this by executing a <B +CLASS="COMMAND" +>net time \\server /set /yes</B +> replacing server with the + name of your PDC (or another synchronized SMB server). See <A +HREF="#AEN333" +> about Setting Time</A +></P +><P +>Make sure that the + logon path is writeable by the user and make sure that the connection to the logon + path location is by the current user. Sometimes Windows client do not drop the + connection immediately upon logoff.</P +><P +>Some people have reported that the logon path location should also be browseable. + I (GC) have yet to emperically verify this, but you can try.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN237" +>Policies</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN239" +>What are 'Policies' ?.</A +></H2 +><P +>When a user logs onto the domain via a client machine, the PDC sends + the client machine a list of things contained in the 'policy' (if it exists). + This list may do things like suppress a splach screen, format the dates the way you + like them or perhaps remove locally stored profiles.</P +><P +>On a samba PDC this list is obtained from a file called <B +CLASS="COMMAND" +>ntconfig.pol</B +> + and located in the <B +CLASS="COMMAND" +>[netlogon]</B +>share. The file is created with a policy editor + and must be readable by anyone and writeable by only root. See <A +HREF="#AEN260" +> below</A +> for how to get a suitable editor.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN246" +>I can't get system policies to work.</A +></H2 +><P +>There are two possible reasons for system policies not functioning correctly. + Make sure that you have the following parameters set in smb.conf </P +><PRE +CLASS="PROGRAMLISTING" +> [netlogon] + .... + locking = no + public = no + browseable = yes + .... + </PRE +><P +>A policy file must be in the <B +CLASS="COMMAND" +>[netlogon]</B +> share and must be + readable by everyone and writeable by only root. The file must be created + by an NTServer <A +HREF="#AEN260" +>Policy Editor</A +>.</P +><P +>Last time I (drb) looked in the source, it was + looking for <TT +CLASS="FILENAME" +>ntconfig.pol</TT +> first then several other combinations of upper + and lower case. People have reported success using <TT +CLASS="FILENAME" +>NTconfig.pol</TT +>, + <TT +CLASS="FILENAME" +>NTconfig.POL</TT +> and <TT +CLASS="FILENAME" +>ntconfig.pol</TT +>. These are the case + settings that I (GC) use with the + filename <TT +CLASS="FILENAME" +>ntconfig.pol</TT +></P +><PRE +CLASS="PROGRAMLISTING" +> case sensitive = no + case preserve = yes + default case = yes + </PRE +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN260" +>What about Windows NT Policy Editor ?</A +></H2 +><P +>To create or edit <B +CLASS="COMMAND" +>ntconfig.pol</B +> you must use the NT Server + Policy Editor, <B +CLASS="COMMAND" +>poledit.exe</B +> which is included with NT Server + but <I +CLASS="EMPHASIS" +>not NT Workstation</I +>. There is a Policy Editor on a NTws + but it is not suitable for creating <I +CLASS="EMPHASIS" +>Domain Policies</I +>. + Further, although the Windows 95 + Policy Editor can be installed on an NT Workstation/Server, it will not + work with NT policies because the registry key that are set by the policy templates. + However, the files from the NT Server will run happily enough on an NTws. + You need <TT +CLASS="FILENAME" +>poledit.exe, common.adm</TT +> and <TT +CLASS="FILENAME" +>winnt.adm</TT +>. It is convenient + to put the two *.adm files in <TT +CLASS="FILENAME" +>c:\winnt\inf</TT +> which is where + the binary will look for them unless told otherwise. Note also that that + directory is 'hidden'.</P +><P +>The Windows NT policy editor is also included with the + Service Pack 3 (and later) for Windows NT 4.0. Extract the files using + <B +CLASS="COMMAND" +>servicepackname /x</B +>, ie thats <B +CLASS="COMMAND" +>Nt4sp6ai.exe /x</B +> + for service pack 6a. + The policy editor, <B +CLASS="COMMAND" +>poledt.exe</B +> and the associated template files (*.adm) should + be extracted as well. It is also possible to downloaded the policy template + files for Office97 and get a copy of the policy editor. Another possible + location is with the Zero Administration Kit available for download from Microsoft. + </P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN274" +>Can Win95 do Policies ?</A +></H2 +><P +>Install the group policy handler for Win9x to pick up group policies. + Look on the Win98 CD in <TT +CLASS="FILENAME" +> \tools\reskit\netadmin\poledit</TT +>. Install group policies on a Win9x client by double-clicking + <TT +CLASS="FILENAME" +>grouppol.inf</TT +>. Log off and on again a couple of times and see if + Win98 picks up group policies. + Unfortunately this needs to be done on every Win9x machine that uses group policies....</P +><P +>If group policies don't work one reports suggests getting the updated (read: working) + grouppol.dll for Windows 9x. The group list is grabbed from /etc/group.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN280" +>Passwords</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN282" +>What is password sync and should I use it ?</A +></H2 +><P +>NTws users can change their domain password by pressing Ctrl-Alt-Del and + choosing 'Change Password'. By default however, this does not change the unix password + (typically in <TT +CLASS="FILENAME" +>/etc/passwd or /etc/shadow</TT +>). In lots of situations + thats OK, for example :</P +><P +></P +><UL +><LI +><P +>The server is only accessible to the user via samba.</P +></LI +><LI +><P +>Pam_smb or similar is installed so other applications + still refer to the samba password.</P +></LI +></UL +><P +>But sometimes you really do need to maintain two seperate password databases and + there are good reasons to keep then in sync. Trying to explain to users + that they need to change their passwords in two seperate places or use + two seperate passwords is not fun.</P +><P +>However do understand that setting up password sync is not without problems either. + The chief difficulty is the interface between Samba and the <B +CLASS="COMMAND" +>passwd</B +> command, + it can be a fiddle to set up and if the password the user has entered fails, + the resulting errors are ambiguously reported + and the user is confused. Further, you need to take steps to ensure that users + only ever change their passwords via samba (or use <B +CLASS="COMMAND" +>smbpasswd</B +>), + otherwise they will only be changing the unix password.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN295" +>How do I get remote password (unix and SMB) changing working ?</A +></H2 +><P +>Have a practice changing a user's password (as root) to see what + discussion takes place and change the text in the 'passwd chat' line below as necessary. The + line as shown works for recent RH Linux but most other systems seem to like to do something + different. The '*' is a wild card and will match anything (or nothing). + </P +><P +>Add these lines to smb.conf under [Global]</P +><PRE +CLASS="PROGRAMLISTING" +> + + unix password sync = true + passwd program = /usr/bin/passwd %u + passwd chat = *password* %n\n *password* %n\n *successful* + </PRE +><P +>As mentioned above, the change to the unix password + happens as root, not as the user, as is indicated in ~/smbd/chgpasswd.c If + you are using NIS, the Samba server must be running on the NIS master machine.</P +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN301" +>Chapter 5. Miscellaneous</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN303" +></A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN305" +>What editor can I use in DOS/Windows that won't mess with my unix EOF</A +></H2 +><P +>There are a number of Windows or DOS based editors that will understand, and + leave intact, the unix eof (as opposed to a DOS CL/LF). List members suggested :</P +><P +></P +><UL +><LI +><P +>UltraEdit at <A +HREF="http://www.ultraedit.com" +TARGET="_top" +>www.ultraedit.com</A +></P +></LI +><LI +><P +>VI for windows at <A +HREF="http://home.snafu.de/ramo/WinViEn.htm" +TARGET="_top" +> home.snafu.de/ramo/WinViEn.htm</A +></P +></LI +><LI +><P +>The author prefers PFE at <A +HREF="http://www.lancs.ac.uk/people/cpaap/pfe/" +TARGET="_top" +> www.lancs.ac.uk/people/cpaap/pfe/</A +> but its no longer being developed...</P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN318" +>How do I get 'User Manager' and 'Server Manager'</A +></H2 +><P +>Since I don't need to buy an NT Server CD now, how do I get the 'User Manager for + Domains', the 'Server Manager' ?</P +><P +></P +><P +><B +>Microsoft distributes a version of these tools called nexus + for installation on Windows 95 systems. The tools set includes</B +></P +><UL +><LI +><P +>Server Manager</P +></LI +><LI +><P +>User Manager for Domains</P +></LI +><LI +><P +>Event Viewer</P +></LI +></UL +><P +>Click here to download the archived file + <A +HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE" +TARGET="_top" +> ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE</A +></P +><P +>The Windows NT 4.0 version of the 'User Manager for Domains' + and 'Server Manager' are available from Microsoft via ftp from + <A +HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE" +TARGET="_top" +> ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE</A +></P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN333" +>The time setting from a Samba server does not work.</A +></H2 +><P +>If it works OK when you log on as Domain Admin then the problem is that ordinary users + don't have permission to change the time. (The system is running with their permission + at logon time.) This is not a Samba problem, you will have the same problem where ever + you connect. You can give 'everyone' permission to change the time from the User Manager. + </P +><P +>Anyone know what the registry settings are so this could be done with a Policy ?</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN337" +>"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A +></H2 +><P +>I keep getting the message "trust account xxx should be in DOMAIN_GROUP_RID_USERS." + in the logs. What do I need to do?</P +><P +>You are using one of the old development versions. Upgrade. + (The message is unimportant, was a reminder to a developer)</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN341" +>How do I get my samba server to become a member ( not PDC ) of an NT domain?</A +></H2 +><P +>In a domain that has a number of servers you only need one password database. + The machines that don't have their own ask the PDC to check for them. + This will work fine for a domain controlled by either a Samba or NT machine. + The following lines in smb.conf are typical, 'password server' points to the + samba machine (or an NT) that has the password list : </P +><PRE +CLASS="PROGRAMLISTING" +> + + [global] + ... + security = domain + workgroup = { Put your domain name here } + password server = { Put the ip of the PDC here } + encrypt passwords = yes + ... + </PRE +><P +>The samba server in question will have to 'join the domain', that requires + the domain controller to have a machine account for it. This is no different + to the machine account requirements to allow a NTws to join the domain. For + example, if we want a unix box called <I +CLASS="EMPHASIS" +>sleepy</I +> to ask the PDC called <I +CLASS="EMPHASIS" +>grumpy</I +> + to do its authentication then <I +CLASS="EMPHASIS" +>grumpy</I +> will need an entry in its smbpasswd + (assuming it's also samba) that starts with <I +CLASS="EMPHASIS" +>sleepy$</I +>. It would have to be + created <A +HREF="#AEN171" +>manually</A +>. </P +><P +>If the domain is controlled by an NTServer then the "Server Manager for Domains" + tool must be used to add 'sleepy' to the domain list.</P +><P +>In either case we then join the domain. If the domain is called <I +CLASS="EMPHASIS" +>forest</I +> + then on sleepy we would join the domain by typing :</P +><P +><B +CLASS="COMMAND" +>smbpasswd -j forest</B +></P +><P +>Note that the directory where the smbpasswd file would be + located should exist as this is where smbd will generate the MACHINE.SID file. This + might be <TT +CLASS="FILENAME" +>/usr/local/samba/private/FOREST.SLEEPY.SID</TT +> and + it contains the trust account password for the domain member. The permissions are + (and should remain) "rw-------</P +><P +>Note the Samba Servers without the password list will most likely still need an account + for each user, this means a line in its <TT +CLASS="FILENAME" +>/etc/passwd</TT +>. Because authentication + is being handled at the domain level the + <TT +CLASS="FILENAME" +>/etc/passwd</TT +> line does not need a password. + If the shares being offered are not user specific, ie a common (read only ?) + area or perhaps just printing then the user's + <TT +CLASS="FILENAME" +>/etc/passwd</TT +> does not need a home directory. A typical + line in <TT +CLASS="FILENAME" +>/etc/passwd</TT +> for a server that allows domain users to + connect to the samba shares but does not offer a home share ('cos that's on the PDC) + and does not allow logon to the unix prompt would be like this :</P +><PRE +CLASS="PROGRAMLISTING" +>jblow:x:542:100:Joe Blow:/dev/null:/bin/false</PRE +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +></P +><UL +><LI +><P +>When removing those 'dummy' users, watch the 'remove user' scripts, + some OS think they should remove a users directory even when its not owned by the user ! + </P +></LI +><LI +><P +>The <TT +CLASS="FILENAME" +>username map = </TT +> parameter might help you to avoid having + all those accounts created.</P +></LI +><LI +><P +>You should investigate the smb.conf parameter + <TT +CLASS="FILENAME" +>'add user script'</TT +>, it will be used to create accounts on + secondary servers when that account already exists on the PDC. Very nice. + Something like :</P +><PRE +CLASS="PROGRAMLISTING" +> [Global] + .... + add user script = /usr/sbin/adduser -n -g users -c User -d /dev/null -s /bin/false %U + .... + </PRE +></LI +></UL +></BLOCKQUOTE +></DIV +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN376" +>Chapter 6. Troubleshooting and Bug Reporting</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN378" +>Diagnostic tools</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN380" +>What are some diagnostics tools I can use to debug the domain logon process and where can I + find them?</A +></H2 +><P +>One of the best diagnostic tools for debugging problems is Samba itself. You can use the -d + option for both smbd and nmbd to specifiy what 'debug level' at which to run. See the man + pages on smbd, nmbd and smb.conf for more information on debugging options. The debug + level can range from 1 (the default) to around 100 but a debug level of about 20 will + normally help you find any errors that samba is encountering. Another helpful method + of debugging is to compile samba using the gcc -g flag. This will include debug + information in the binaries and allow you to attch gdb to the running smbd / nmbd + process. In order to attach gdb to an smbd process for an NT workstation, first + get the workstation to make the connection. Pressing ctrl-alt-delete and going down + to the domain box is sufficient (at least, on the first time you join the domain) to + generate a 'LsaEnumTrustedDomains'. Thereafter, the workstation maintains an open + connection, and therefore there will be an smbd process running (assuming that you + haven't set a really short smbd idle timeout) So, in between pressing ctrl alt + delete, and actually typing in your password, you can gdb attach and continue.</P +><P +></P +><P +><B +>Some usefull samba commands worth investigating:</B +></P +><UL +><LI +><P +>testparam | more</P +></LI +><LI +><P +>smbclient -L //{netbios name of server}</P +></LI +></UL +><P +>An SMB enabled version of tcpdump is available from + <A +HREF="ftp://samba.org/pub/samba/tcpdump-smb/" +TARGET="_top" +>ftp://samba.org/pub/samba/tcpdump-smb/ + </A +></P +><P +>Capconvert is a small C program for translating output from tcpdump-smb to CAP format + that can be read by netmon. You will need to use the raw output from tcp dump + ( ie. <B +CLASS="COMMAND" +>tcpdump -w output.dump</B +> ). Good news! Now you can convert + Solaris' snoop output as well. The C source code for snoop2cap is available for download. + </P +><P +>For tracing things on the Microsoft Windows NT, Network Monitor (aka. netmon) is available + on the Microsoft Developer Network CD's, the Windows NT Server install CD and the SMS CD's. + The version of netmon that ships with SMS allows for dumping packets between any two + computers (ie. placing the network interface in promiscuous mode). The version + on the NT Server install CD will only allow monitoring of network traffic directed to the + local NT box and broadcasts on the local subnet.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN394" +>How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A +></H2 +><P +>Installing netmon on an NT workstation requires a couple of steps. The following + are for installing Netmon V4.00.349, which comes with Microsoft Windows NT Server + 4.0, on Microsoft Windows NT Workstation 4.0. The process should be similar + for other version of Windows NT / Netmon. You will need both the Microsoft Windows + NT Server 4.0 Install CD and the Workstation 4.0 Install CD.</P +><P +>Initially you will need to install 'Network Monitor Tools and Agent' on the + NT Server. To do this </P +><P +></P +><UL +><LI +><P +>Goto Start - Settings - Control Panel - Network - Services - Add </P +></LI +><LI +><P +>Select the 'Network Monitor Tools and Agent' and click on 'OK'.</P +></LI +><LI +><P +>Click 'OK' on the Network Control Panel.</P +></LI +><LI +><P +>Insert the Windows NT Server 4.0 install CD when prompted.</P +></LI +></UL +><P +>At this point the Netmon files should exist in <TT +CLASS="FILENAME" +>%SYSTEMROOT%\System32\netmon\*.*</TT +>. + Two subdirectories exist as well, <TT +CLASS="FILENAME" +>parsers\</TT +> which contains the necessary DLL's + for parsing the netmon packet dump, and <TT +CLASS="FILENAME" +>captures\</TT +>.</P +><P +>In order to install the Netmon tools on an NT Workstation, you will first need to + install the 'Network Monitor Agent' from the Workstation install CD.</P +><P +></P +><UL +><LI +><P +>Goto Start - Settings - Control Panel - Network - Services - Add</P +></LI +><LI +><P +>Select the 'Network Monitor Agent' and click on 'OK'.</P +></LI +><LI +><P +>Click 'OK' on the Network Control Panel.</P +></LI +><LI +><P +>Insert the Windows NT Workstation 4.0 install CD when prompted.</P +></LI +></UL +><P +>Now copy the files from the NT Server in %SYSTEMROOT%\System32\netmon\*.* to + %SYSTEMROOT%\System32\netmon\*.* on the Workstation and set permissions as + you deem appropriate for your site. You will need administrative rights on the + NT box to run netmon.</P +><P +>To install Netmon on a Windows 9x box install the network monitor agent from + the Windows 9x CD (\admin\nettools\netmon). + There is a readme file located with the netmon driver files on the CD if you need + information on how to do this. Copy the files from a working Netmon installation.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN423" +>What other help can I get ?</A +></H1 +><P +>There are many sources of information available in the form of mailing lists, RFC's + and documentation. The docs that come with the samba distribution contain very + good explanations of general SMB topics such as browsing.</P +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN426" +>URLs and similar</A +></H2 +><P +></P +><UL +><LI +><P +>Home of Samba site <A +HREF="http://samba.org" +TARGET="_top" +> http://samba.org</A +>. We have a mirror near you !</P +></LI +><LI +><P +> The <I +CLASS="EMPHASIS" +>Development</I +> document + on the Samba mirrors might mention your problem. If so, + it might mean that the developers are working on it.</P +></LI +><LI +><P +> Ignacio Coupeau has a very comprehesive look at LDAP with Samba at + <A +HREF="http://www.unav.es/cti/ldap-smb-howto.html" +TARGET="_top" +> http://www.unav.es/cti/ldap-smb-howto.html</A +> + Be a little carefull however, I suspect that it does not specificly + address samba 2.2.x. The HEAD pre-2.1 may possibly be the best + stream to look at.</P +></LI +><LI +><P +> Lars Kneschke's site covers <A +HREF="http://www.samba-tng.org" +TARGET="_top" +> Samba-TNG</A +> at + <A +HREF="http://www.kneschke.de/projekte/samba_tng" +TARGET="_top" +> http://www.kneschke.de/projekte/samba_tng</A +>, but again, a + lot of it does not apply to the main stream Samba.</P +></LI +><LI +><P +>Although 2.0.7 has almost had its day as a PDC, I (drb) will + keep the 2.0.7 PDC pages at <A +HREF="http://bioserve.latrobe.edu.au/samba" +TARGET="_top" +> http://bioserve.latrobe.edu.au/samba</A +> going for a while yet.</P +></LI +><LI +><P +>Misc links to CIFS information + <A +HREF="http://samba.org/cifs/" +TARGET="_top" +>http://samba.org/cifs/</A +></P +></LI +><LI +><P +>NT Domains for Unix <A +HREF="http://mailhost.cb1.com/~lkcl/ntdom/" +TARGET="_top" +> http://mailhost.cb1.com/~lkcl/ntdom/</A +></P +></LI +><LI +><P +>FTP site for older SMB specs: + <A +HREF="ftp://ftp.microsoft.com/developr/drg/CIFS/" +TARGET="_top" +> ftp://ftp.microsoft.com/developr/drg/CIFS/</A +></P +></LI +></UL +><P +></P +><P +><B +>There are a number of documents that no longer appear to live at their + origional home. Any one know where the following may be found ?</B +></P +><UL +><LI +><P +>CIFS/E Browser Protocol draft-leach-cifs-browser-spec-00.txt</P +></LI +><LI +><P +>CIFS Remote Administration Protocol draft-leach-cifs-rap-spec-00.txt</P +></LI +><LI +><P +>CIFS Logon and Pass Through Authentication draft-leach-cifs-logon-spec-00.txt</P +></LI +><LI +><P +>A Common Internet File System (CIFS/1.0) Protocol draft-leach-cifs-v1-spec-01.txt</P +></LI +><LI +><P +>CIFS Printing Specification draft-leach-cifs-print-spec-00.txt</P +></LI +><LI +><P +>RFC1001 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Concepts and methods. + http://ds.internic.net/rfc/rfc1001.txt </P +></LI +><LI +><P +>RFC1002 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Detailed specifications. + http://ds.internic.net/rfc/rfc1002.txt </P +></LI +><LI +><P +>Microsoft's main CIFS page: http://www.microsoft.com/workshop/networking/cifs/</P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN472" +>How do I get help from the mailing lists ?</A +></H2 +><P +> There are a number of Samba related mailing lists. Go to <A +HREF="http://samba.org" +TARGET="_top" +>http://samba.org</A +>, click on your nearest mirror + and then click on <B +CLASS="COMMAND" +>Support</B +> and then click on <B +CLASS="COMMAND" +> Samba related mailing lists</B +>.</P +><P +>For questions relating to Samba TNG go to + <A +HREF="http://www.samba-tng.org/" +TARGET="_top" +>http://www.samba-tng.org/</A +> + It has been requested that you don't post questions about Samba-TNG to the + main stream Samba lists.</P +><P +></P +><P +><B +>If you post a message to one of the lists please + observe the following guide lines :</B +></P +><UL +><LI +><P +> Always remember that the developers are volunteers, they are + not paid and they never guarantee to produce a particular feature at + a particular time. Any time lines are 'best guess' and nothing more. + </P +></LI +><LI +><P +> Always mention what version of samba you are using and what + operating system its running under. You should probably list the + relevant sections of your smb.conf file, at least the options + in [global] that affect PDC support.</P +></LI +><LI +><P +>In addition to the version, if you obtained Samba via + CVS mention the date when you last checked it out.</P +></LI +><LI +><P +> Try and make your question clear and brief, lots of long, + convoluted questions get deleted before they are completely read ! + Don't post html encoded messages (if you can select colour or font + size its html).</P +></LI +><LI +><P +> If you run one of those niffy 'I'm on holidays' things when + you are away, make sure its configured to not answer mailing lists. + </P +></LI +><LI +><P +> Don't cross post. Work out which is the best list to post to + and see what happens, ie don't post to both samba-ntdom and samba-technical. + Many people active on the lists subscribe to more + than one list and get annoyed to see the same message two or more times. + Often someone will see a message and thinking it would be better dealt + with on another, will forward it on for you.</P +></LI +><LI +><P +>You might include <I +CLASS="EMPHASIS" +>partial</I +> + log files written at a debug level set to as much as 20. + Please don't send the entire log but enough to give the context of the + error messages.</P +></LI +><LI +><P +>(Possibly) If you have a complete netmon trace ( from the opening of + the pipe to the error ) you can send the *.CAP file as well.</P +></LI +><LI +><P +>Please think carefully before attaching a document to an email. + Consider pasting the relevant parts into the body of the message. The samba + mailing lists go to a huge number of people, do they all need a copy of your + smb.conf in their attach directory ?</P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN501" +>How do I get off the mailing lists ?</A +></H2 +><P +>To have your name removed from a samba mailing list, go to the + same place you went to to get on it. Go to <A +HREF="http://samba.org" +TARGET="_top" +>http://samba.org</A +>, click on your nearest mirror + and then click on <B +CLASS="COMMAND" +>Support</B +> and then click on <B +CLASS="COMMAND" +> Samba related mailing lists</B +>. Or perhaps see + <A +HREF="http://lists.samba.org/mailman/roster/samba-ntdom" +TARGET="_top" +>here</A +></P +><P +>Please don't post messages to the list asking to be removed, you will just + be refered to the above address (unless that process failed in some way...) + </P +></DIV +></DIV +></DIV +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/docs/htmldocs/samba-pdc-howto.html b/docs/htmldocs/samba-pdc-howto.html new file mode 100644 index 0000000000..760e2e73b8 --- /dev/null +++ b/docs/htmldocs/samba-pdc-howto.html @@ -0,0 +1,2096 @@ +<HTML +><HEAD +><TITLE +>The Samba 2.2 PDC FAQ</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD +><BODY +CLASS="BOOK" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="BOOK" +><A +NAME="SAMBA-PDC-FAQ" +></A +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="SAMBA-PDC-FAQ" +>The Samba 2.2 PDC FAQ</A +></H1 +><H3 +CLASS="AUTHOR" +><A +NAME="AEN4" +>David Bannon</A +></H3 +><DIV +CLASS="AFFILIATION" +><SPAN +CLASS="ORGNAME" +>La Trobe University<BR></SPAN +></DIV +><HR></DIV +><HR><H1 +><A +NAME="AEN12" +></A +></H1 +><P +>Comments, corrections and additions to <TT +CLASS="EMAIL" +><<A +HREF="mailto:D.Bannon@latrobe.edu.au" +>D.Bannon@latrobe.edu.au</A +>></TT +></P +><P +>This is the FAQ for Samba 2.2 as an NTDomain controller. + This document is derived from the origional FAQ that was built and + maintained by Gerald Carter + from the early days of Samba NTDomain development up until recently. + It is now being updated as significent changes are made to 2.2.0.</P +><P +>Please note it does not apply to Samba2.2alpha0, Samba2.2alpha1, Samba 2.0.7, TNG nor HEAD branch. + </P +><P +>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 +><P +> Also available is a Samba 2.2 PDC <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> that takes you, step + by step, over the process of setting up a very basic Samba 2.2 Primary Domain Controller + </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +>Please read the Introduction for the current <A +HREF="#AEN27" +> state of play</A +>.</P +></BLOCKQUOTE +></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>1. <A +HREF="#AEN25" +>Introduction</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN27" +>State of Play</A +></DT +><DT +><A +HREF="#AEN44" +>Introduction</A +></DT +></DL +></DD +><DT +>2. <A +HREF="#AEN49" +>General Information</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN51" +>What can we do ?</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN53" +>What can Samba Primary Domain Controller (PDC) do ?</A +></DT +><DT +><A +HREF="#AEN86" +>Can I have a Windows 2000 client logon to a Samba controlled domain?</A +></DT +><DT +><A +HREF="#AEN89" +>What's the status of print spool (spoolss) support in the NTDOM code?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN92" +>CVS</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN95" +>What are the different Samba branches available in CVS ?</A +></DT +><DT +><A +HREF="#AEN118" +>What are the CVS commands ?</A +></DT +></DL +></DD +></DL +></DD +><DT +>3. <A +HREF="#AEN149" +>Establishing Connections</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN151" +></A +></DT +><DD +><DL +><DT +><A +HREF="#AEN153" +>How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A +></DT +><DT +><A +HREF="#AEN158" +>What is a 'machine account' ?</A +></DT +><DT +><A +HREF="#AEN165" +>"The machine account for this computer either does not exist or is not accessable."</A +></DT +><DT +><A +HREF="#AEN171" +>How do I create machine accounts manually ?</A +></DT +><DT +><A +HREF="#AEN184" +>I cannot include a '$' in a machine name.</A +></DT +><DT +><A +HREF="#AEN190" +>I get told "You already have a connection to the Domain...." when creating a + machine account.</A +></DT +><DT +><A +HREF="#AEN194" +>I get told "Cannot join domain, the credentials supplied conflict + with an existing set.."</A +></DT +><DT +><A +HREF="#AEN198" +>"The system can not log you on (C000019B)...."</A +></DT +></DL +></DD +></DL +></DD +><DT +>4. <A +HREF="#AEN202" +>User Account Management</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN204" +>Domain Admins</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN206" +>How do I configure an account as a domain administrator?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN210" +>Profiles</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN212" +>Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A +></DT +><DT +><A +HREF="#AEN226" +>Why are all the users listed in the "domain admin users" using the same profile?</A +></DT +><DT +><A +HREF="#AEN229" +>The roaming profiles do not seem to be updating on the server.</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN237" +>Policies</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN239" +>What are 'Policies' ?.</A +></DT +><DT +><A +HREF="#AEN246" +>I can't get system policies to work.</A +></DT +><DT +><A +HREF="#AEN260" +>What about Windows NT Policy Editor ?</A +></DT +><DT +><A +HREF="#AEN274" +>Can Win95 do Policies ?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN280" +>Passwords</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN282" +>What is password sync and should I use it ?</A +></DT +><DT +><A +HREF="#AEN295" +>How do I get remote password (unix and SMB) changing working ?</A +></DT +></DL +></DD +></DL +></DD +><DT +>5. <A +HREF="#AEN301" +>Miscellaneous</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN303" +></A +></DT +><DD +><DL +><DT +><A +HREF="#AEN305" +>How do I get 'User Manager' and 'Server Manager'</A +></DT +><DT +><A +HREF="#AEN320" +>The time setting from a Samba server does not work.</A +></DT +><DT +><A +HREF="#AEN324" +>"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A +></DT +><DT +><A +HREF="#AEN328" +>How do I get my samba server to become a member ( not PDC ) of an NT domain?</A +></DT +></DL +></DD +></DL +></DD +><DT +>6. <A +HREF="#AEN363" +>Troubleshooting and Bug Reporting</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN365" +>Diagnostic tools</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN367" +>What are some diagnostics tools I can use to debug the domain logon process and where can I + find them?</A +></DT +><DT +><A +HREF="#AEN375" +>How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A +></DT +></DL +></DD +><DT +><A +HREF="#AEN404" +>What other help can I get ?</A +></DT +><DD +><DL +><DT +><A +HREF="#AEN407" +>URLs and similar</A +></DT +><DT +><A +HREF="#AEN453" +>How do I get help from the mailing lists ?</A +></DT +><DT +><A +HREF="#AEN482" +>How do I get off the mailing lists ?</A +></DT +></DL +></DD +></DL +></DD +></DL +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN25" +>Chapter 1. Introduction</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN27" +>State of Play</A +></H1 +><P +><I +CLASS="EMPHASIS" +>It should be noted that 2.2.0 in its pre-release form still has a few problems, + I'll try and keep this section current while things are still dynamic. + At the time of this update (November 13, 2000) the current state of play is :</I +></P +><P +>Comments here about W2K joining the domain apply only to Samba 2.2 from the CVS after November 27th. The + 'snapshot' release Samba2.2alpha1 does not work !!! See below on how to get a CVS tree.</P +><P +>Client Side creation of Machine accounts does work but is not complete. + Firstly, the <TT +CLASS="FILENAME" +>add user script</TT +> runs as the user who's + name was entered, not as root. Secondly, the machine name passed to the script (%U) + has an underscore at the end, not a '$'. One alternative is to use %m and add the $. + This method is documented in the <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +>. + And thirdly, it does not work with NT4ws. + </P +><P +>A W2K machine can join the domain. See the <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> + which explains the process. The methods + described are 'work arounds' and should be regarded as temporary. Although I (drb) + have tested these procedures a number of people have had difficulty so there + may be other issues at work. JFM is aware of these + problems and will attend to them when he can.</P +><P +>A Domain Admin account is required and at present it appears that only root + is a suitable candidate.</P +><P +>Much of the related code does work. For example, if an NT is removed from the + domain and then rejoins, the <TT +CLASS="FILENAME" +>Create a Computer Account in the Domain</TT +> dialog + will let you reset the smbpasswd. That is you don't need to do it from + the unix box. However, at the present, you do need to have root as an + administrator and use the root user name and password.</P +><P +><I +CLASS="EMPHASIS" +>Actually I'm + not sure that last paragraph is correct ....</I +></P +><P +><B +CLASS="COMMAND" +>Policies</B +> do work on a W2K machine. MS says that recent builds of + W2K dont observe an NT policy but it appears it does in 'legacy' mode.</P +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN44" +>Introduction</A +></H1 +><P +>This FAQ was origionally compiled by Jerry Carter (gc) chiefly dealing with the 'old head' + version of Samba and its NTDomain facilities. It is being rewritten by David Bannon (drb) + so that it addresses more accurately the Samba 2.2 planned for release late 2000. </P +><P +>This document probably still contains some material that does not apply to + Samba 2.2 but most (all?) of the really misleading stuff has been removed. Some + issues are not dealt with or are dealt with badly. Please send corrections and additions to + David Bannon at D.Bannon@latrobe.edu.au</P +><P +>Hopefully, as we all become familiar with the Samba 2.2 as a PDC this document will + become much more usefull.</P +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN49" +>Chapter 2. General Information</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN51" +>What can we do ?</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN53" +>What can Samba Primary Domain Controller (PDC) do ?</A +></H2 +><P +>If you wish to have Samba act as a PDC for Windows NT 3.51.and 4.0 or W2000 client, then you + will need to obtain the 2.2.0 version, currently in pre-release. Release of a stable, + full featured Samba PDC is currently slated for version 3.0. </P +><P +>The following is a list of included features currently in Samba 2.2:</P +><P +></P +><UL +><LI +><P +>The ability to act as a limited PDC for Windows NT and W2000 clients. + This includes adding NT and W2K machines to the domain and authenticating users logging + into the domain.</P +></LI +><LI +><P +>Domain account can be viewed using the User Manager for + Domains ????</P +></LI +><LI +><P +>Viewing resources on the Samba PDC via the Server Manager for Domains + from the NT client. ??</P +></LI +><LI +><P +>Windows 95 clients will allow user level security to be set + but will not currently allow browsing of accounts.</P +></LI +><LI +><P +>Machine account password updates.</P +></LI +><LI +><P +>Changing of user passwords from an NT client.</P +></LI +><LI +><P +>Partial support for Windows NT group and username mapping.</P +></LI +><LI +><P +>Support for a LDAP password database backend.</P +></LI +><LI +><P +>Printing.</P +></LI +></UL +><P +></P +><P +><B +>These things are note expected to work in the forseeable future</B +></P +><UL +><LI +><P +>Trust relationships</P +></LI +><LI +><P +>PDC and BDC integration</P +></LI +><LI +><P +>Windows NT ACLs (on the Samba shares)</P +></LI +><LI +><P +>Offer a list of domain users to User Manager for Domains + (or the Security Tab etc).</P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN86" +>Can I have a Windows 2000 client logon to a Samba controlled domain?</A +></H2 +><P +>The 2.2 release branch of Samba supports Windows 2000 domain + clients in legacy mode, ie as if the PDC is a NTServer, not a + W2K server.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN89" +>What's the status of print spool (spoolss) support in the NTDOM code?</A +></H2 +><P +>The implementation of support for SPOOLSS pipe is complete and it will be available + in the 2.2.0 release. This means that Samba will support the automatic downloading of printer + drivers for Windows NT clients just as it currently does for Windows 9x clients.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN92" +>CVS</A +></H1 +><P +>CVS is a programme (publically available) that the Samba developers use to + maintain the central source code. Non developers can get access to the source in + a read only capacity. Many flavours of unix now arrive with cvs installed.</P +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN95" +>What are the different Samba branches available in CVS ?</A +></H2 +><P +>You can find out more about obtaining Samba's via + anonymous CVS from + <A +HREF="http://pserver.samba.org/samba/cvs.html" +TARGET="_top" +> http://pserver.samba.org/samba/cvs.html"</A +>. </P +><P +></P +><DIV +CLASS="VARIABLELIST" +><P +><B +>There are basically four branches to watch at the moment :</B +></P +><DL +><DT +>HEAD</DT +><DD +><P +>Samba 3.0 ? This code boasts all the main development + work in Samba. Two things that most people are not aware of + which live in the HEAD branch code are winbind NSS module and + Tim Potter's VFS implementation. Due to its developmental + nature, its not really suitable for production work. + </P +></DD +><DT +>SAMBA_2_0</DT +><DD +><P +>This branch contains the current stable release release. + At the moment it contains 2.0.7, a version that will do some + limited PDC stuff. If you are really going to do PDC things then + I (drb) suggest that you consider 2.2 instead. + </P +></DD +><DT +>SAMBA_2_2</DT +><DD +><P +>The next stable release, currently in a 'alpha' form. + It provides the Samba developers, testers and interested + people with an approximation of what is to come. This document + addresses only SAMBA_2_2. + </P +></DD +><DT +>SAMBA_TNG</DT +><DD +><P +>This branch is no longer maintained from the Samba sites. + Please see <A +HREF="http://www.samba-tng.org/" +TARGET="_top" +> http://www.samba-tng.org/</A +>. It has been requested + that questions about TNG are not posted to the regular Samba mailing + lists including samba-ntdom and samba-technical. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN118" +>What are the CVS commands ?</A +></H2 +><P +>See <A +HREF="http://pserver.samba.org/samba/cvs.html" +TARGET="_top" +> http://pserver.samba.org/samba/cvs.html</A +></P +><P +></P +><P +><B +>To get the Samba 2.2 version, tag SAMBA_2_2 you would do :</B +></P +><UL +><LI +><P +> For example : <B +CLASS="COMMAND" +>cd /usr/local/src/</B +></P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs -d :pserver:cvs@pserver.samba.org:/cvsroot + login</B +></P +></LI +><LI +><P +> When prompted enter a password of <B +CLASS="COMMAND" +>cvs</B +></P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs -d :pserver:cvs@pserver.samba.org:/cvsroot + co -r SAMBA_2_2 samba</B +></P +></LI +></UL +><P +></P +><P +><B +>Then to update that directory at some later time,</B +></P +><UL +><LI +><P +> <B +CLASS="COMMAND" +>cd /usr/local/src/samba</B +></P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login</B +></P +></LI +><LI +><P +> When prompted enter a password of 'cvs'.</P +></LI +><LI +><P +> <B +CLASS="COMMAND" +>cvs update -d -P</B +></P +></LI +></UL +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN149" +>Chapter 3. Establishing Connections</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN151" +></A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN153" +>How do I get my NT4 or W2000 Workstation to login to the Samba controlled Domain?</A +></H2 +><P +>There is a comprehensive Samba PDC <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> + accessable from the samba web site + under 'Documentation'. Its currently located at <A +HREF="http://bioserve.latrobe.edu.au/samba" +TARGET="_top" +> http://bioserve.latrobe.edu.au/samba</A +>. Read it.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN158" +>What is a 'machine account' ?</A +></H2 +><P +>Every NT, W2K or Samba machine that joins a Samba controlled domain must be known to + the Samba PDC. There are two entries required, one in (typically) <TT +CLASS="FILENAME" +>/etc/passwd</TT +> + and the other in (typically) <TT +CLASS="FILENAME" +>/usr/local/samba/private/smbpasswd</TT +>. Under + some circumstances these entries are made <A +HREF="#AEN171" +>manually</A +>, the + <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +> discusses ways of creating them automatically.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN165" +>"The machine account for this computer either does not exist or is not accessable."</A +></H2 +><P +>When I try to join the domain I get the message "The machine account for this computer + either does not exist or is not accessable". Whats wrong ?</P +><P +>This problem is caused by the PDC not having a suitable machine account. + If you are using the <B +CLASS="COMMAND" +>add user script =</B +> method to create accounts + then this would indicate that it has not worked. Ensure the domain admin user + system is working.</P +><P +>Alternatively if you are creating account entries manually then they have not been created + correctly. Make sure that you have the entry correct for the machine account in smbpasswd + file on the Samba PDC. If you added the account using an editor rather than using the smbpasswd utility, + make sure that the account name is the machine netbios name with a '$' appended to it + ( ie. computer_name$ ). There must be an entry in both /etc/passwd and + the smbpasswd file. Some people have reported that + inconsistent subnet masks between the Samba server and the NT client have caused this problem. + Make sure that these are consistent for both client and server.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN171" +>How do I create machine accounts manually ?</A +></H2 +><P +>This was the only option until recently, now in version 2.2 better means are available. + You might still need to do it manually for a couple of reasons. A machine account + consists of two entries (assuming a standard install and /etc/passwd use), + one in /etc/passwd and the other in /usr/local/samba/private/smbpasswd. The /etc/passwd + entry will list the machine name with a $ appended, won't have a passwd, will have a null + shell and no home directory. For example a machine called 'doppy' would have an /etc/passwd + entry like this :</P +><P +><B +CLASS="COMMAND" +>doppy$:x:505:501:NTMachine:/dev/null:/bin/false</B +></P +><P +>On a linux system for example, you would typically add it like this :</P +><P +><B +CLASS="COMMAND" +>adduser -g machines -c NTMachine -d /dev/null -s /bin/false -n + doppy$</B +></P +><P +>Then you need to add that entry to smbpasswd, assuming you have a suitable + path to the <B +CLASS="COMMAND" +>smbpasswd</B +> programme, do this :</P +><P +><B +CLASS="COMMAND" +>smbpasswd -a -m doppy$</B +></P +><P +>The entry will be created with a well known password, so any machine that + says its doppy could join the domain as long as it gets in first. So don't create + the accounts any earlier than you need them.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN184" +>I cannot include a '$' in a machine name.</A +></H2 +><P +>A 'machine name' in (typically) <TT +CLASS="FILENAME" +>/etc/passwd</TT +> consists + of the machine name with a '$' appended. FreeBSD (and other BSD systems ?) + won't create a user with a '$' in their name.</P +><P +>The problem is only in the program used to make the entry, once made, it works + perfectly. So create a user without the '$' and use <B +CLASS="COMMAND" +>vipw</B +> to edit + the entry, adding the '$'. Or create the whole entry with vipw if you like, + make sure you use a unique uid !</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN190" +>I get told "You already have a connection to the Domain...." when creating a + machine account.</A +></H2 +><P +>This happens if you try to create a machine account from the machine itself + and use a user name that does not work (for whatever reason) and then try + another (possibly valid) user name. + Exit out of the network applet to close the initial connection and try again.</P +><P +>Further, if the machine is a already a 'member of a workgroup' that is the + same name as the domain you are joining (bad idea) you will get this message. + Change the workgroup name to something else, it does not matter what, reboot, + and try again.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN194" +>I get told "Cannot join domain, the credentials supplied conflict + with an existing set.."</A +></H2 +><P +>This is the same basic problem as mentioned above, <A +HREF="#AEN190" +> "You already have a connection..."</A +></P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN198" +>"The system can not log you on (C000019B)...."</A +></H2 +><P +>I joined the domain successfully but after upgrading to a newer version of the + Samba code I get the message, "The system can not log you on (C000019B), Please try a + gain or consult your system administrator" when attempting to logon.</P +><P +>This occurs when the domain SID stored in private/WORKGROUP.SID is changed. + For example, you remove the file and smbd automatically creates a new one. + Or you are swapping back and forth between versions 2.0.7, TNG and the HEAD branch + code (not recommended). The only way to correct the problem is to restore the + original domain SID or remove the domain client from the domain and rejoin.</P +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN202" +>Chapter 4. User Account Management</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN204" +>Domain Admins</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN206" +>How do I configure an account as a domain administrator?</A +></H2 +><P +>See the NTDom <A +HREF="samba-pdc-howto.html" +TARGET="_top" +>HowTo</A +>.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN210" +>Profiles</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN212" +>Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ?</A +></H2 +><P +>Sometimes Windows clients will maintain a connection to the \\homes\ ( or [%U] ) share + even after the user has logged out. Consider the following scenario.</P +><P +></P +><UL +><LI +><P +> user1 logs into the Windows NT machine. Therefore the + [homes] share is set to \\server\user1.</P +></LI +><LI +><P +> user1 works for a while and then logs out. </P +></LI +><LI +><P +> user2 logs into the same Windows NT machine.</P +></LI +></UL +><P +>However, since the NT box has maintained a connection to [homes] which was + previously set to \\server\user1, when the operating system attempts to + get the profile and if it can read users1's profile, will get it otherwise it + will return an error. You get the picture.</P +><P +>A better solution is to use a separate [profiles] share and set the + "logon path = \\%N\profiles\%U" </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +>Is this still a problem ????</P +></BLOCKQUOTE +></DIV +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN226" +>Why are all the users listed in the "domain admin users" using the same profile?</A +></H2 +><P +>You are using a very very old development version of Samba. Upgrade.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN229" +>The roaming profiles do not seem to be updating on the server.</A +></H2 +><P +>There can be several reasons for this.</P +><P +>Make sure that the time on the client and the PDC are synchronized. You can accomplish + this by executing a <B +CLASS="COMMAND" +>net time \\server /set /yes</B +> replacing server with the + name of your PDC (or another synchronized SMB server). See <A +HREF="#AEN320" +> about Setting Time</A +></P +><P +>Make sure that the + logon path is writeable by the user and make sure that the connection to the logon + path location is by the current user. Sometimes Windows client do not drop the + connection immediately upon logoff.</P +><P +>Some people have reported that the logon path location should also be browseable. + I (GC) have yet to emperically verify this, but you can try.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN237" +>Policies</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN239" +>What are 'Policies' ?.</A +></H2 +><P +>When a user logs onto the domain via a client machine, the PDC sends + the client machine a list of things contained in the 'policy' (if it exists). + This list may do things like suppress a splach screen, format the dates the way you + like them or perhaps remove locally stored profiles.</P +><P +>On a samba PDC this list is obtained from a file called <B +CLASS="COMMAND" +>ntconfig.pol</B +> + and located in the <B +CLASS="COMMAND" +>[netlogon]</B +>share. The file is created with a policy editor + and must be readable by anyone and writeable by only root. See <A +HREF="#AEN260" +> below</A +> for how to get a suitable editor.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN246" +>I can't get system policies to work.</A +></H2 +><P +>There are two possible reasons for system policies not functioning correctly. + Make sure that you have the following parameters set in smb.conf </P +><PRE +CLASS="PROGRAMLISTING" +> [netlogon] + .... + locking = no + public = no + browseable = yes + .... + </PRE +><P +>A policy file must be in the <B +CLASS="COMMAND" +>[netlogon]</B +> share and must be + readable by everyone and writeable by only root. The file must be created + by an NTServer <A +HREF="#AEN260" +>Policy Editor</A +>.</P +><P +>Last time I (drb) looked in the source, it was + looking for <TT +CLASS="FILENAME" +>ntconfig.pol</TT +> first then several other combinations of upper + and lower case. People have reported success using <TT +CLASS="FILENAME" +>NTconfig.pol</TT +>, + <TT +CLASS="FILENAME" +>NTconfig.POL</TT +> and <TT +CLASS="FILENAME" +>ntconfig.pol</TT +>. These are the case + settings that I (GC) use with the + filename <TT +CLASS="FILENAME" +>ntconfig.pol</TT +></P +><PRE +CLASS="PROGRAMLISTING" +> case sensitive = no + case preserve = yes + default case = yes + </PRE +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN260" +>What about Windows NT Policy Editor ?</A +></H2 +><P +>To create or edit <B +CLASS="COMMAND" +>ntconfig.pol</B +> you must use the NT Server + Policy Editor, <B +CLASS="COMMAND" +>poledit.exe</B +> which is included with NT Server + but <I +CLASS="EMPHASIS" +>not NT Workstation</I +>. There is a Policy Editor on a NTws + but it is not suitable for creating <I +CLASS="EMPHASIS" +>Domain Policies</I +>. + Further, although the Windows 95 + Policy Editor can be installed on an NT Workstation/Server, it will not + work with NT policies because the registry key that are set by the policy templates. + However, the files from the NT Server will run happily enough on an NTws. + You need <TT +CLASS="FILENAME" +>poledit.exe, common.adm</TT +> and <TT +CLASS="FILENAME" +>winnt.adm</TT +>. It is convenient + to put the two *.adm files in <TT +CLASS="FILENAME" +>c:\winnt\inf</TT +> which is where + the binary will look for them unless told otherwise. Note also that that + directory is 'hidden'.</P +><P +>The Windows NT policy editor is also included with the + Service Pack 3 (and later) for Windows NT 4.0. Extract the files using + <B +CLASS="COMMAND" +>servicepackname /x</B +>, ie thats <B +CLASS="COMMAND" +>Nt4sp6ai.exe /x</B +> + for service pack 6a. + The policy editor, <B +CLASS="COMMAND" +>poledt.exe</B +> and the associated template files (*.adm) should + be extracted as well. It is also possible to downloaded the policy template + files for Office97 and get a copy of the policy editor. Another possible + location is with the Zero Administration Kit available for download from Microsoft. + </P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN274" +>Can Win95 do Policies ?</A +></H2 +><P +>Install the group policy handler for Win9x to pick up group policies. + Look on the Win98 CD in <TT +CLASS="FILENAME" +> \tools\reskit\netadmin\poledit</TT +>. Install group policies on a Win9x client by double-clicking + <TT +CLASS="FILENAME" +>grouppol.inf</TT +>. Log off and on again a couple of times and see if + Win98 picks up group policies. + Unfortunately this needs to be done on every Win9x machine that uses group policies....</P +><P +>If group policies don't work one reports suggests getting the updated (read: working) + grouppol.dll for Windows 9x. The group list is grabbed from /etc/group.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN280" +>Passwords</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN282" +>What is password sync and should I use it ?</A +></H2 +><P +>NTws users can change their domain password by pressing Ctrl-Alt-Del and + choosing 'Change Password'. By default however, this does not change the unix password + (typically in <TT +CLASS="FILENAME" +>/etc/passwd or /etc/shadow</TT +>). In lots of situations + thats OK, for example :</P +><P +></P +><UL +><LI +><P +>The server is only accessible to the user via samba.</P +></LI +><LI +><P +>Pam_smb or similar is installed so other applications + still refer to the samba password.</P +></LI +></UL +><P +>But sometimes you really do need to maintain two seperate password databases and + there are good reasons to keep then in sync. Trying to explain to users + that they need to change their passwords in two seperate places or use + two seperate passwords is not fun.</P +><P +>However do understand that setting up password sync is not without problems either. + The chief difficulty is the interface between Samba and the <B +CLASS="COMMAND" +>passwd</B +> command, + it can be a fiddle to set up and if the password the user has entered fails, + the resulting errors are ambiguously reported + and the user is confused. Further, you need to take steps to ensure that users + only ever change their passwords via samba (or use <B +CLASS="COMMAND" +>smbpasswd</B +>), + otherwise they will only be changing the unix password.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN295" +>How do I get remote password (unix and SMB) changing working ?</A +></H2 +><P +>Have a practice changing a user's password (as root) to see what + discussion takes place and change the text in the 'passwd chat' line below as necessary. The + line as shown works for recent RH Linux but most other systems seem to like to do something + different. The '*' is a wild card and will match anything (or nothing). + </P +><P +>Add these lines to smb.conf under [Global]</P +><PRE +CLASS="PROGRAMLISTING" +> + + unix password sync = true + passwd program = /usr/bin/passwd %u + passwd chat = *password* %n\n *password* %n\n *successful* + </PRE +><P +>As mentioned above, the change to the unix password + happens as root, not as the user, as is indicated in ~/smbd/chgpasswd.c If + you are using NIS, the Samba server must be running on the NIS master machine.</P +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN301" +>Chapter 5. Miscellaneous</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN303" +></A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN305" +>How do I get 'User Manager' and 'Server Manager'</A +></H2 +><P +>Since I don't need to buy an NT Server CD now, how do I get the 'User Manager for + Domains', the 'Server Manager' ?</P +><P +></P +><P +><B +>Microsoft distributes a version of these tools called nexus + for installation on Windows 95 systems. The tools set includes</B +></P +><UL +><LI +><P +>Server Manager</P +></LI +><LI +><P +>User Manager for Domains</P +></LI +><LI +><P +>Event Viewer</P +></LI +></UL +><P +>Click here to download the archived file + <A +HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE" +TARGET="_top" +> ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE</A +></P +><P +>The Windows NT 4.0 version of the 'User Manager for Domains' + and 'Server Manager' are available from Microsoft via ftp from + <A +HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE" +TARGET="_top" +> ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE</A +></P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN320" +>The time setting from a Samba server does not work.</A +></H2 +><P +>If it works OK when you log on as Domain Admin then the problem is that ordinary users + don't have permission to change the time. (The system is running with their permission + at logon time.) This is not a Samba problem, you will have the same problem where ever + you connect. You can give 'everyone' permission to change the time from the User Manager. + </P +><P +>Anyone know what the registry settings are so this could be done with a Policy ?</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN324" +>"trust account xxx should be in DOMAIN_GROUP_RID_USERS"</A +></H2 +><P +>I keep getting the message "trust account xxx should be in DOMAIN_GROUP_RID_USERS." + in the logs. What do I need to do?</P +><P +>You are using one of the old development versions. Upgrade. + (The message is unimportant, was a reminder to a developer)</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN328" +>How do I get my samba server to become a member ( not PDC ) of an NT domain?</A +></H2 +><P +>In a domain that has a number of servers you only need one password database. + The machines that don't have their own ask the PDC to check for them. + This will work fine for a domain controlled by either a Samba or NT machine. + The following lines in smb.conf are typical, 'password server' points to the + samba machine (or an NT) that has the password list : </P +><PRE +CLASS="PROGRAMLISTING" +> + + [global] + ... + security = domain + workgroup = { Put your domain name here } + password server = { Put the ip of the PDC here } + encrypt passwords = yes + ... + </PRE +><P +>The samba server in question will have to 'join the domain', that requires + the domain controller to have a machine account for it. This is no different + to the machine account requirements to allow a NTws to join the domain. For + example, if we want a unix box called <I +CLASS="EMPHASIS" +>sleepy</I +> to ask the PDC called <I +CLASS="EMPHASIS" +>grumpy</I +> + to do its authentication then <I +CLASS="EMPHASIS" +>grumpy</I +> will need an entry in its smbpasswd + (assuming it's also samba) that starts with <I +CLASS="EMPHASIS" +>sleepy$</I +>. It would have to be + created <A +HREF="#AEN171" +>manually</A +>. </P +><P +>If the domain is controlled by an NTServer then the "Server Manager for Domains" + tool must be used to add 'sleepy' to the domain list.</P +><P +>In either case we then join the domain. If the domain is called <I +CLASS="EMPHASIS" +>forest</I +> + then on sleepy we would join the domain by typing :</P +><P +><B +CLASS="COMMAND" +>smbpasswd -j forest</B +></P +><P +>Note that the directory where the smbpasswd file would be + located should exist as this is where smbd will generate the MACHINE.SID file. This + might be <TT +CLASS="FILENAME" +>/usr/local/samba/private/FOREST.SLEEPY.SID</TT +> and + it contains the trust account password for the domain member. The permissions are + (and should remain) "rw-------</P +><P +>Note the Samba Servers without the password list will most likely still need an account + for each user, this means a line in its <TT +CLASS="FILENAME" +>/etc/passwd</TT +>. Because authentication + is being handled at the domain level the + <TT +CLASS="FILENAME" +>/etc/passwd</TT +> line does not need a password. + If the shares being offered are not user specific, ie a common (read only ?) + area or perhaps just printing then the user's + <TT +CLASS="FILENAME" +>/etc/passwd</TT +> does not need a home directory. A typical + line in <TT +CLASS="FILENAME" +>/etc/passwd</TT +> for a server that allows domain users to + connect to the samba shares but does not offer a home share ('cos that's on the PDC) + and does not allow logon to the unix prompt would be like this :</P +><PRE +CLASS="PROGRAMLISTING" +>jblow:x:542:100:Joe Blow:/dev/null:/bin/false</PRE +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +></P +><UL +><LI +><P +>When removing those 'dummy' users, watch the 'remove user' scripts, + some OS think they should remove a users directory even when its not owned by the user ! + </P +></LI +><LI +><P +>The <TT +CLASS="FILENAME" +>username map = </TT +> parameter might help you to avoid having + all those accounts created.</P +></LI +><LI +><P +>You should investigate the smb.conf parameter + <TT +CLASS="FILENAME" +>'add user script'</TT +>, it will be used to create accounts on + secondary servers when that account already exists on the PDC. Very nice. + Something like :</P +><PRE +CLASS="PROGRAMLISTING" +> [Global] + .... + add user script = /usr/sbin/adduser -n -g users -c User -d /dev/null -s /bin/false %U + .... + </PRE +></LI +></UL +></BLOCKQUOTE +></DIV +></DIV +></DIV +></DIV +><DIV +CLASS="CHAPTER" +><HR><H1 +><A +NAME="AEN363" +>Chapter 6. Troubleshooting and Bug Reporting</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN365" +>Diagnostic tools</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN367" +>What are some diagnostics tools I can use to debug the domain logon process and where can I + find them?</A +></H2 +><P +>One of the best diagnostic tools for debugging problems is Samba itself. You can use the -d + option for both smbd and nmbd to specifiy what 'debug level' at which to run. See the man + pages on smbd, nmbd and smb.conf for more information on debugging options. The debug + level can range from 1 (the default) to around 100 but a debug level of about 20 will + normally help you find any errors that samba is encountering. Another helpful method + of debugging is to compile samba using the gcc -g flag. This will include debug + information in the binaries and allow you to attch gdb to the running smbd / nmbd + process. In order to attach gdb to an smbd process for an NT workstation, first + get the workstation to make the connection. Pressing ctrl-alt-delete and going down + to the domain box is sufficient (at least, on the first time you join the domain) to + generate a 'LsaEnumTrustedDomains'. Thereafter, the workstation maintains an open + connection, and therefore there will be an smbd process running (assuming that you + haven't set a really short smbd idle timeout) So, in between pressing ctrl alt + delete, and actually typing in your password, you can gdb attach and continue.</P +><P +>An SMB enabled version of tcpdump is available from + <A +HREF="ftp://samba.org/pub/samba/tcpdump-smb/" +TARGET="_top" +>ftp://samba.org/pub/samba/tcpdump-smb/ + </A +></P +><P +>Capconvert is a small C program for translating output from tcpdump-smb to CAP format + that can be read by netmon. You will need to use the raw output from tcp dump + ( ie. <B +CLASS="COMMAND" +>tcpdump -w output.dump</B +> ). Good news! Now you can convert + Solaris' snoop output as well. The C source code for snoop2cap is available for download. + </P +><P +>For tracing things on the Microsoft Windows NT, Network Monitor (aka. netmon) is available + on the Microsoft Developer Network CD's, the Windows NT Server install CD and the SMS CD's. + The version of netmon that ships with SMS allows for dumping packets between any two + computers (ie. placing the network interface in promiscuous mode). The version + on the NT Server install CD will only allow monitoring of network traffic directed to the + local NT box and broadcasts on the local subnet.</P +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN375" +>How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box?</A +></H2 +><P +>Installing netmon on an NT workstation requires a couple of steps. The following + are for installing Netmon V4.00.349, which comes with Microsoft Windows NT Server + 4.0, on Microsoft Windows NT Workstation 4.0. The process should be similar + for other version of Windows NT / Netmon. You will need both the Microsoft Windows + NT Server 4.0 Install CD and the Workstation 4.0 Install CD.</P +><P +>Initially you will need to install 'Network Monitor Tools and Agent' on the + NT Server. To do this </P +><P +></P +><UL +><LI +><P +>Goto Start - Settings - Control Panel - Network - Services - Add </P +></LI +><LI +><P +>Select the 'Network Monitor Tools and Agent' and click on 'OK'.</P +></LI +><LI +><P +>Click 'OK' on the Network Control Panel.</P +></LI +><LI +><P +>Insert the Windows NT Server 4.0 install CD when prompted.</P +></LI +></UL +><P +>At this point the Netmon files should exist in <TT +CLASS="FILENAME" +>%SYSTEMROOT%\System32\netmon\*.*</TT +>. + Two subdirectories exist as well, <TT +CLASS="FILENAME" +>parsers\</TT +> which contains the necessary DLL's + for parsing the netmon packet dump, and <TT +CLASS="FILENAME" +>captures\</TT +>.</P +><P +>In order to install the Netmon tools on an NT Workstation, you will first need to + install the 'Network Monitor Agent' from the Workstation install CD.</P +><P +></P +><UL +><LI +><P +>Goto Start - Settings - Control Panel - Network - Services - Add</P +></LI +><LI +><P +>Select the 'Network Monitor Agent' and click on 'OK'.</P +></LI +><LI +><P +>Click 'OK' on the Network Control Panel.</P +></LI +><LI +><P +>Insert the Windows NT Workstation 4.0 install CD when prompted.</P +></LI +></UL +><P +>Now copy the files from the NT Server in %SYSTEMROOT%\System32\netmon\*.* to + %SYSTEMROOT%\System32\netmon\*.* on the Workstation and set permissions as + you deem appropriate for your site. You will need administrative rights on the + NT box to run netmon.</P +><P +>To install Netmon on a Windows 9x box install the network monitor agent from + the Windows 9x CD (\admin\nettools\netmon). + There is a readme file located with the netmon driver files on the CD if you need + information on how to do this. Copy the files from a working Netmon installation.</P +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H1 +CLASS="SECT1" +><A +NAME="AEN404" +>What other help can I get ?</A +></H1 +><P +>There are many sources of information available in the form of mailing lists, RFC's + and documentation. The docs that come with the samba distribution contain very + good explanations of general SMB topics such as browsing.</P +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN407" +>URLs and similar</A +></H2 +><P +></P +><UL +><LI +><P +>Home of Samba site <A +HREF="http://samba.org" +TARGET="_top" +> http://samba.org</A +>. We have a mirror near you !</P +></LI +><LI +><P +> The <I +CLASS="EMPHASIS" +>Development</I +> document + on the Samba mirrors might mention your problem. If so, + it might mean that the developers are working on it.</P +></LI +><LI +><P +> Ignacio Coupeau has a very comprehesive look at LDAP with Samba at + <A +HREF="http://www.unav.es/cti/ldap-smb-howto.html" +TARGET="_top" +> http://www.unav.es/cti/ldap-smb-howto.html</A +> + Be a little carefull however, I suspect that it does not specificly + address samba 2.2.x. The HEAD pre-2.1 may possibly be the best + stream to look at.</P +></LI +><LI +><P +> Lars Kneschke's site covers <A +HREF="http://www.samba-tng.org" +TARGET="_top" +> Samba-TNG</A +> at + <A +HREF="http://www.kneschke.de/projekte/samba_tng" +TARGET="_top" +> http://www.kneschke.de/projekte/samba_tng</A +>, but again, a + lot of it does not apply to the main stream Samba.</P +></LI +><LI +><P +>Although 2.0.7 has almost had its day as a PDC, I (drb) will + keep the 2.0.7 PDC pages at <A +HREF="http://bioserve.latrobe.edu.au/samba" +TARGET="_top" +> http://bioserve.latrobe.edu.au/samba</A +> going for a while yet.</P +></LI +><LI +><P +>Misc links to CIFS information + <A +HREF="http://samba.org/cifs/" +TARGET="_top" +>http://samba.org/cifs/</A +></P +></LI +><LI +><P +>NT Domains for Unix <A +HREF="http://mailhost.cb1.com/~lkcl/ntdom/" +TARGET="_top" +> http://mailhost.cb1.com/~lkcl/ntdom/</A +></P +></LI +><LI +><P +>FTP site for older SMB specs: + <A +HREF="ftp://ftp.microsoft.com/developr/drg/CIFS/" +TARGET="_top" +> ftp://ftp.microsoft.com/developr/drg/CIFS/</A +></P +></LI +></UL +><P +></P +><P +><B +>There are a number of documents that no longer appear to live at their + origional home. Any one know where the following may be found ?</B +></P +><UL +><LI +><P +>CIFS/E Browser Protocol draft-leach-cifs-browser-spec-00.txt</P +></LI +><LI +><P +>CIFS Remote Administration Protocol draft-leach-cifs-rap-spec-00.txt</P +></LI +><LI +><P +>CIFS Logon and Pass Through Authentication draft-leach-cifs-logon-spec-00.txt</P +></LI +><LI +><P +>A Common Internet File System (CIFS/1.0) Protocol draft-leach-cifs-v1-spec-01.txt</P +></LI +><LI +><P +>CIFS Printing Specification draft-leach-cifs-print-spec-00.txt</P +></LI +><LI +><P +>RFC1001 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Concepts and methods. + http://ds.internic.net/rfc/rfc1001.txt </P +></LI +><LI +><P +>RFC1002 (March '87) Protocol standard for a NetBIOS service on a TCP/UDP transport: Detailed specifications. + http://ds.internic.net/rfc/rfc1002.txt </P +></LI +><LI +><P +>Microsoft's main CIFS page: http://www.microsoft.com/workshop/networking/cifs/</P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN453" +>How do I get help from the mailing lists ?</A +></H2 +><P +> There are a number of Samba related mailing lists. Go to <A +HREF="http://samba.org" +TARGET="_top" +>http://samba.org</A +>, click on your nearest mirror + and then click on <B +CLASS="COMMAND" +>Support</B +> and then click on <B +CLASS="COMMAND" +> Samba related mailing lists</B +>.</P +><P +>For questions relating to Samba TNG go to + <A +HREF="http://www.samba-tng.org/" +TARGET="_top" +>http://www.samba-tng.org/</A +> + It has been requested that you don't post questions about Samba-TNG to the + main stream Samba lists.</P +><P +></P +><P +><B +>If you post a message to one of the lists please + observe the following guide lines :</B +></P +><UL +><LI +><P +> Always remember that the developers are volunteers, they are + not paid and they never guarantee to produce a particular feature at + a particular time. Any time lines are 'best guess' and nothing more. + </P +></LI +><LI +><P +> Always mention what version of samba you are using and what + operating system its running under. You should probably list the + relevant sections of your smb.conf file, at least the options + in [global] that affect PDC support.</P +></LI +><LI +><P +>In addition to the version, if you obtained Samba via + CVS mention the date when you last checked it out.</P +></LI +><LI +><P +> Try and make your question clear and brief, lots of long, + convoluted questions get deleted before they are completely read ! + Don't post html encoded messages (if you can select colour or font + size its html).</P +></LI +><LI +><P +> If you run one of those niffy 'I'm on holidays' things when + you are away, make sure its configured to not answer mailing lists. + </P +></LI +><LI +><P +> Don't cross post. Work out which is the best list to post to + and see what happens, ie don't post to both samba-ntdom and samba-technical. + Many people active on the lists subscribe to more + than one list and get annoyed to see the same message two or more times. + Often someone will see a message and thinking it would be better dealt + with on another, will forward it on for you.</P +></LI +><LI +><P +>You might include <I +CLASS="EMPHASIS" +>partial</I +> + log files written at a debug level set to as much as 20. + Please don't send the entire log but enough to give the context of the + error messages.</P +></LI +><LI +><P +>(Possibly) If you have a complete netmon trace ( from the opening of + the pipe to the error ) you can send the *.CAP file as well.</P +></LI +><LI +><P +>Please think carefully before attaching a document to an email. + Consider pasting the relevant parts into the body of the message. The samba + mailing lists go to a huge number of people, do they all need a copy of your + smb.conf in their attach directory ?</P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H2 +CLASS="SECT2" +><A +NAME="AEN482" +>How do I get off the mailing lists ?</A +></H2 +><P +>To have your name removed from a samba mailing list, go to the + same place you went to to get on it. Go to <A +HREF="http://samba.org" +TARGET="_top" +>http://samba.org</A +>, click on your nearest mirror + and then click on <B +CLASS="COMMAND" +>Support</B +> and then click on <B +CLASS="COMMAND" +> Samba related mailing lists</B +>. Or perhaps see + <A +HREF="http://lists.samba.org/mailman/roster/samba-ntdom" +TARGET="_top" +>here</A +></P +><P +>Please don't post messages to the list asking to be removed, you will just + be refered to the above address (unless that process failed in some way...) + </P +></DIV +></DIV +></DIV +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/docs/textdocs/samba-pdc-faq.txt b/docs/textdocs/samba-pdc-faq.txt new file mode 100644 index 0000000000..4b54c4d3ef --- /dev/null +++ b/docs/textdocs/samba-pdc-faq.txt @@ -0,0 +1,923 @@ + +The Samba 2.2 PDC FAQ + +David Bannon + + La Trobe University + _________________________________________________________________ + _________________________________________________________________ + + Comments, corrections and additions to <D.Bannon@latrobe.edu.au> + + This is the FAQ for Samba 2.2 as an NTDomain controller. This document + is derived from the origional FAQ that was built and maintained by + Gerald Carter from the early days of Samba NTDomain development up + until recently. It is now being updated as significent changes are + made to 2.2.0. + + Please note it does not apply to Samba2.2alpha0, Samba2.2alpha1, Samba + 2.0.7, TNG nor HEAD branch. + + 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. + + Also available is a Samba 2.2 PDC HowTo that takes you, step by step, + over the process of setting up a very basic Samba 2.2 Primary Domain + Controller + + Note: Please read the Introduction for the current state of play. + + Table of Contents + 1. Introduction + + State of Play + Introduction + + 2. General Information + + What can we do ? + + What can Samba Primary Domain Controller (PDC) do ? + Can I have a Windows 2000 client logon to a Samba + controlled domain? + + What's the status of print spool (spoolss) support in the + NTDOM code? + + CVS + + What are the different Samba branches available in CVS ? + What are the CVS commands ? + + 3. Establishing Connections + + How do I get my NT4 or W2000 Workstation to login to the + Samba controlled Domain? + + What is a 'machine account' ? + "The machine account for this computer either does not + exist or is not accessable." + + How do I create machine accounts manually ? + I cannot include a '$' in a machine name. + I get told "You already have a connection to the + Domain...." when creating a machine account. + + I get told "Cannot join domain, the credentials supplied + conflict with an existing set.." + + "The system can not log you on (C000019B)...." + + 4. User Account Management + + Domain Admins + + How do I configure an account as a domain administrator? + + Profiles + + Why is it bad to set "logon path = \\%N\%U\profile" in + smb.conf? ? + + Why are all the users listed in the "domain admin users" + using the same profile? + + The roaming profiles do not seem to be updating on the + server. + + Policies + + What are 'Policies' ?. + I can't get system policies to work. + What about Windows NT Policy Editor ? + Can Win95 do Policies ? + + Passwords + + What is password sync and should I use it ? + How do I get remote password (unix and SMB) changing + working ? + + 5. Miscellaneous + + What editor can I use in DOS/Windows that won't mess with + my unix EOF + + How do I get 'User Manager' and 'Server Manager' + The time setting from a Samba server does not work. + "trust account xxx should be in DOMAIN_GROUP_RID_USERS" + How do I get my samba server to become a member ( not PDC ) + of an NT domain? + + 6. Troubleshooting and Bug Reporting + + Diagnostic tools + + What are some diagnostics tools I can use to debug the + domain logon process and where can I find them? + + How do I install 'Network Monitor' on an NT Workstation or + a Windows 9x box? + + What other help can I get ? + + URLs and similar + How do I get help from the mailing lists ? + How do I get off the mailing lists ? + _________________________________________________________________ + +Chapter 1. Introduction + +State of Play + + It should be noted that 2.2.0 in its pre-release form still has a few + problems, I'll try and keep this section current while things are + still dynamic. At the time of this update (November 13, 2000) the + current state of play is : + + Comments here about W2K joining the domain apply only to Samba 2.2 + from the CVS after November 27th. The 'snapshot' release + Samba2.2alpha1 does not work !!! See below on how to get a CVS tree. + + Client Side creation of Machine accounts does work but is not + complete. Firstly, the add user script runs as the user who's name was + entered, not as root. Secondly, the machine name passed to the script + (%U) has an underscore at the end, not a '$'. One alternative is to + use %m and add the $. This method is documented in the HowTo. And + thirdly, it does not work with NT4ws. + + A W2K machine can join the domain. See the HowTo which explains the + process. The methods described are 'work arounds' and should be + regarded as temporary. Although I (drb) have tested these procedures a + number of people have had difficulty so there may be other issues at + work. JFM is aware of these problems and will attend to them when he + can. + + A Domain Admin account is required and at present it appears that only + root is a suitable candidate. + + Much of the related code does work. For example, if an NT is removed + from the domain and then rejoins, the Create a Computer Account in the + Domain dialog will let you reset the smbpasswd. That is you don't need + to do it from the unix box. However, at the present, you do need to + have root as an administrator and use the root user name and password. + + Actually I'm not sure that last paragraph is correct .... + + Policies do work on a W2K machine. MS says that recent builds of W2K + dont observe an NT policy but it appears it does in 'legacy' mode. + _________________________________________________________________ + +Introduction + + This FAQ was origionally compiled by Jerry Carter (gc) chiefly dealing + with the 'old head' version of Samba and its NTDomain facilities. It + is being rewritten by David Bannon (drb) so that it addresses more + accurately the Samba 2.2 planned for release late 2000. + + This document probably still contains some material that does not + apply to Samba 2.2 but most (all?) of the really misleading stuff has + been removed. Some issues are not dealt with or are dealt with badly. + Please send corrections and additions to David Bannon at + D.Bannon@latrobe.edu.au + + Hopefully, as we all become familiar with the Samba 2.2 as a PDC this + document will become much more usefull. + _________________________________________________________________ + +Chapter 2. General Information + +What can we do ? + +What can Samba Primary Domain Controller (PDC) do ? + + If you wish to have Samba act as a PDC for Windows NT 3.51.and 4.0 or + W2000 client, then you will need to obtain the 2.2.0 version, + currently in pre-release. Release of a stable, full featured Samba PDC + is currently slated for version 3.0. + + The following is a list of included features currently in Samba 2.2: + + * The ability to act as a limited PDC for Windows NT and W2000 + clients. This includes adding NT and W2K machines to the domain + and authenticating users logging into the domain. + * Domain account can be viewed using the User Manager for Domains + ???? + * Viewing resources on the Samba PDC via the Server Manager for + Domains from the NT client. ?? + * Windows 95 clients will allow user level security to be set but + will not currently allow browsing of accounts. + * Machine account password updates. + * Changing of user passwords from an NT client. + * Partial support for Windows NT group and username mapping. + * Support for a LDAP password database backend. + * Printing. + + These things are note expected to work in the forseeable future + * Trust relationships + * PDC and BDC integration + * Windows NT ACLs (on the Samba shares) + * Offer a list of domain users to User Manager for Domains (or the + Security Tab etc). + _________________________________________________________________ + +Can I have a Windows 2000 client logon to a Samba controlled domain? + + The 2.2 release branch of Samba supports Windows 2000 domain clients + in legacy mode, ie as if the PDC is a NTServer, not a W2K server. + _________________________________________________________________ + +What's the status of print spool (spoolss) support in the NTDOM code? + + The implementation of support for SPOOLSS pipe is complete and it will + be available in the 2.2.0 release. This means that Samba will support + the automatic downloading of printer drivers for Windows NT clients + just as it currently does for Windows 9x clients. + _________________________________________________________________ + +CVS + + CVS is a programme (publically available) that the Samba developers + use to maintain the central source code. Non developers can get access + to the source in a read only capacity. Many flavours of unix now + arrive with cvs installed. + _________________________________________________________________ + +What are the different Samba branches available in CVS ? + + You can find out more about obtaining Samba's via anonymous CVS from + http://pserver.samba.org/samba/cvs.html". + + There are basically four branches to watch at the moment : + + HEAD + Samba 3.0 ? This code boasts all the main development work in + Samba. Two things that most people are not aware of which live + in the HEAD branch code are winbind NSS module and Tim Potter's + VFS implementation. Due to its developmental nature, its not + really suitable for production work. + + SAMBA_2_0 + This branch contains the current stable release release. At the + moment it contains 2.0.7, a version that will do some limited + PDC stuff. If you are really going to do PDC things then I + (drb) suggest that you consider 2.2 instead. + + SAMBA_2_2 + The next stable release, currently in a 'alpha' form. It + provides the Samba developers, testers and interested people + with an approximation of what is to come. This document + addresses only SAMBA_2_2. + + SAMBA_TNG + This branch is no longer maintained from the Samba sites. + Please see http://www.samba-tng.org/. It has been requested + that questions about TNG are not posted to the regular Samba + mailing lists including samba-ntdom and samba-technical. + _________________________________________________________________ + +What are the CVS commands ? + + See http://pserver.samba.org/samba/cvs.html + + To get the Samba 2.2 version, tag SAMBA_2_2 you would do : + * For example : cd /usr/local/src/ + * cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login + * When prompted enter a password of cvs + * cvs -d :pserver:cvs@pserver.samba.org:/cvsroot co -r SAMBA_2_2 + samba + + Then to update that directory at some later time, + * cd /usr/local/src/samba + * cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login + * When prompted enter a password of 'cvs'. + * cvs update -d -P + _________________________________________________________________ + +Chapter 3. Establishing Connections + +How do I get my NT4 or W2000 Workstation to login to the Samba controlled +Domain? + + There is a comprehensive Samba PDC HowTo accessable from the samba web + site under 'Documentation'. Its currently located at + http://bioserve.latrobe.edu.au/samba. Read it. + _________________________________________________________________ + +What is a 'machine account' ? + + Every NT, W2K or Samba machine that joins a Samba controlled domain + must be known to the Samba PDC. There are two entries required, one in + (typically) /etc/passwd and the other in (typically) + /usr/local/samba/private/smbpasswd. Under some circumstances these + entries are made manually, the HowTo discusses ways of creating them + automatically. + _________________________________________________________________ + +"The machine account for this computer either does not exist or is not +accessable." + + When I try to join the domain I get the message "The machine account + for this computer either does not exist or is not accessable". Whats + wrong ? + + This problem is caused by the PDC not having a suitable machine + account. If you are using the add user script = method to create + accounts then this would indicate that it has not worked. Ensure the + domain admin user system is working. + + Alternatively if you are creating account entries manually then they + have not been created correctly. Make sure that you have the entry + correct for the machine account in smbpasswd file on the Samba PDC. If + you added the account using an editor rather than using the smbpasswd + utility, make sure that the account name is the machine netbios name + with a '$' appended to it ( ie. computer_name$ ). There must be an + entry in both /etc/passwd and the smbpasswd file. Some people have + reported that inconsistent subnet masks between the Samba server and + the NT client have caused this problem. Make sure that these are + consistent for both client and server. + _________________________________________________________________ + +How do I create machine accounts manually ? + + This was the only option until recently, now in version 2.2 better + means are available. You might still need to do it manually for a + couple of reasons. A machine account consists of two entries (assuming + a standard install and /etc/passwd use), one in /etc/passwd and the + other in /usr/local/samba/private/smbpasswd. The /etc/passwd entry + will list the machine name with a $ appended, won't have a passwd, + will have a null shell and no home directory. For example a machine + called 'doppy' would have an /etc/passwd entry like this : + + doppy$:x:505:501:NTMachine:/dev/null:/bin/false + + On a linux system for example, you would typically add it like this : + + adduser -g machines -c NTMachine -d /dev/null -s /bin/false -n doppy$ + + Then you need to add that entry to smbpasswd, assuming you have a + suitable path to the smbpasswd programme, do this : + + smbpasswd -a -m doppy$ + + The entry will be created with a well known password, so any machine + that says its doppy could join the domain as long as it gets in first. + So don't create the accounts any earlier than you need them. + _________________________________________________________________ + +I cannot include a '$' in a machine name. + + A 'machine name' in (typically) /etc/passwd consists of the machine + name with a '$' appended. FreeBSD (and other BSD systems ?) won't + create a user with a '$' in their name. + + The problem is only in the program used to make the entry, once made, + it works perfectly. So create a user without the '$' and use vipw to + edit the entry, adding the '$'. Or create the whole entry with vipw if + you like, make sure you use a unique uid ! + _________________________________________________________________ + +I get told "You already have a connection to the Domain...." when creating a +machine account. + + This happens if you try to create a machine account from the machine + itself and use a user name that does not work (for whatever reason) + and then try another (possibly valid) user name. Exit out of the + network applet to close the initial connection and try again. + + Further, if the machine is a already a 'member of a workgroup' that is + the same name as the domain you are joining (bad idea) you will get + this message. Change the workgroup name to something else, it does not + matter what, reboot, and try again. + _________________________________________________________________ + +I get told "Cannot join domain, the credentials supplied conflict with an +existing set.." + + This is the same basic problem as mentioned above, "You already have a + connection..." + _________________________________________________________________ + +"The system can not log you on (C000019B)...." + + I joined the domain successfully but after upgrading to a newer + version of the Samba code I get the message, "The system can not log + you on (C000019B), Please try a gain or consult your system + administrator" when attempting to logon. + + This occurs when the domain SID stored in private/WORKGROUP.SID is + changed. For example, you remove the file and smbd automatically + creates a new one. Or you are swapping back and forth between versions + 2.0.7, TNG and the HEAD branch code (not recommended). The only way to + correct the problem is to restore the original domain SID or remove + the domain client from the domain and rejoin. + _________________________________________________________________ + +Chapter 4. User Account Management + +Domain Admins + +How do I configure an account as a domain administrator? + + See the NTDom HowTo. + _________________________________________________________________ + +Profiles + +Why is it bad to set "logon path = \\%N\%U\profile" in smb.conf? ? + + Sometimes Windows clients will maintain a connection to the \\homes\ ( + or [%U] ) share even after the user has logged out. Consider the + following scenario. + + * user1 logs into the Windows NT machine. Therefore the [homes] + share is set to \\server\user1. + * user1 works for a while and then logs out. + * user2 logs into the same Windows NT machine. + + However, since the NT box has maintained a connection to [homes] which + was previously set to \\server\user1, when the operating system + attempts to get the profile and if it can read users1's profile, will + get it otherwise it will return an error. You get the picture. + + A better solution is to use a separate [profiles] share and set the + "logon path = \\%N\profiles\%U" + + Note: Is this still a problem ???? + _________________________________________________________________ + +Why are all the users listed in the "domain admin users" using the same +profile? + + You are using a very very old development version of Samba. Upgrade. + _________________________________________________________________ + +The roaming profiles do not seem to be updating on the server. + + There can be several reasons for this. + + Make sure that the time on the client and the PDC are synchronized. + You can accomplish this by executing a net time \\server /set /yes + replacing server with the name of your PDC (or another synchronized + SMB server). See about Setting Time + + Make sure that the logon path is writeable by the user and make sure + that the connection to the logon path location is by the current user. + Sometimes Windows client do not drop the connection immediately upon + logoff. + + Some people have reported that the logon path location should also be + browseable. I (GC) have yet to emperically verify this, but you can + try. + _________________________________________________________________ + +Policies + +What are 'Policies' ?. + + When a user logs onto the domain via a client machine, the PDC sends + the client machine a list of things contained in the 'policy' (if it + exists). This list may do things like suppress a splach screen, format + the dates the way you like them or perhaps remove locally stored + profiles. + + On a samba PDC this list is obtained from a file called ntconfig.pol + and located in the [netlogon]share. The file is created with a policy + editor and must be readable by anyone and writeable by only root. See + below for how to get a suitable editor. + _________________________________________________________________ + +I can't get system policies to work. + + There are two possible reasons for system policies not functioning + correctly. Make sure that you have the following parameters set in + smb.conf + [netlogon] + .... + locking = no + public = no + browseable = yes + .... + + + A policy file must be in the [netlogon] share and must be readable by + everyone and writeable by only root. The file must be created by an + NTServer Policy Editor. + + Last time I (drb) looked in the source, it was looking for + ntconfig.pol first then several other combinations of upper and lower + case. People have reported success using NTconfig.pol, NTconfig.POL + and ntconfig.pol. These are the case settings that I (GC) use with the + filename ntconfig.pol + case sensitive = no + case preserve = yes + default case = yes + + _________________________________________________________________ + +What about Windows NT Policy Editor ? + + To create or edit ntconfig.pol you must use the NT Server Policy + Editor, poledit.exe which is included with NT Server but not NT + Workstation. There is a Policy Editor on a NTws but it is not suitable + for creating Domain Policies. Further, although the Windows 95 Policy + Editor can be installed on an NT Workstation/Server, it will not work + with NT policies because the registry key that are set by the policy + templates. However, the files from the NT Server will run happily + enough on an NTws. You need poledit.exe, common.adm and winnt.adm. It + is convenient to put the two *.adm files in c:\winnt\inf which is + where the binary will look for them unless told otherwise. Note also + that that directory is 'hidden'. + + The Windows NT policy editor is also included with the Service Pack 3 + (and later) for Windows NT 4.0. Extract the files using + servicepackname /x, ie thats Nt4sp6ai.exe /x for service pack 6a. The + policy editor, poledt.exe and the associated template files (*.adm) + should be extracted as well. It is also possible to downloaded the + policy template files for Office97 and get a copy of the policy + editor. Another possible location is with the Zero Administration Kit + available for download from Microsoft. + _________________________________________________________________ + +Can Win95 do Policies ? + + Install the group policy handler for Win9x to pick up group policies. + Look on the Win98 CD in \tools\reskit\netadmin\poledit. Install group + policies on a Win9x client by double-clicking grouppol.inf. Log off + and on again a couple of times and see if Win98 picks up group + policies. Unfortunately this needs to be done on every Win9x machine + that uses group policies.... + + If group policies don't work one reports suggests getting the updated + (read: working) grouppol.dll for Windows 9x. The group list is grabbed + from /etc/group. + _________________________________________________________________ + +Passwords + +What is password sync and should I use it ? + + NTws users can change their domain password by pressing Ctrl-Alt-Del + and choosing 'Change Password'. By default however, this does not + change the unix password (typically in /etc/passwd or /etc/shadow). In + lots of situations thats OK, for example : + + * The server is only accessible to the user via samba. + * Pam_smb or similar is installed so other applications still refer + to the samba password. + + But sometimes you really do need to maintain two seperate password + databases and there are good reasons to keep then in sync. Trying to + explain to users that they need to change their passwords in two + seperate places or use two seperate passwords is not fun. + + However do understand that setting up password sync is not without + problems either. The chief difficulty is the interface between Samba + and the passwd command, it can be a fiddle to set up and if the + password the user has entered fails, the resulting errors are + ambiguously reported and the user is confused. Further, you need to + take steps to ensure that users only ever change their passwords via + samba (or use smbpasswd), otherwise they will only be changing the + unix password. + _________________________________________________________________ + +How do I get remote password (unix and SMB) changing working ? + + Have a practice changing a user's password (as root) to see what + discussion takes place and change the text in the 'passwd chat' line + below as necessary. The line as shown works for recent RH Linux but + most other systems seem to like to do something different. The '*' is + a wild card and will match anything (or nothing). + + Add these lines to smb.conf under [Global] + + + unix password sync = true + passwd program = /usr/bin/passwd %u + passwd chat = *password* %n\n *password* %n\n *successful* + + As mentioned above, the change to the unix password happens as root, + not as the user, as is indicated in ~/smbd/chgpasswd.c If you are + using NIS, the Samba server must be running on the NIS master machine. + _________________________________________________________________ + +Chapter 5. Miscellaneous + +What editor can I use in DOS/Windows that won't mess with my unix EOF + + There are a number of Windows or DOS based editors that will + understand, and leave intact, the unix eof (as opposed to a DOS + CL/LF). List members suggested : + + * UltraEdit at www.ultraedit.com + * VI for windows at home.snafu.de/ramo/WinViEn.htm + * The author prefers PFE at www.lancs.ac.uk/people/cpaap/pfe/ but + its no longer being developed... + _________________________________________________________________ + +How do I get 'User Manager' and 'Server Manager' + + Since I don't need to buy an NT Server CD now, how do I get the 'User + Manager for Domains', the 'Server Manager' ? + + Microsoft distributes a version of these tools called nexus for + installation on Windows 95 systems. The tools set includes + * Server Manager + * User Manager for Domains + * Event Viewer + + Click here to download the archived file + ftp://ftp.microsoft.com/Softlib/MSLFILES/NEXUS.EXE + + The Windows NT 4.0 version of the 'User Manager for Domains' and + 'Server Manager' are available from Microsoft via ftp from + ftp://ftp.microsoft.com/Softlib/MSLFILES/SRVTOOLS.EXE + _________________________________________________________________ + +The time setting from a Samba server does not work. + + If it works OK when you log on as Domain Admin then the problem is + that ordinary users don't have permission to change the time. (The + system is running with their permission at logon time.) This is not a + Samba problem, you will have the same problem where ever you connect. + You can give 'everyone' permission to change the time from the User + Manager. + + Anyone know what the registry settings are so this could be done with + a Policy ? + _________________________________________________________________ + +"trust account xxx should be in DOMAIN_GROUP_RID_USERS" + + I keep getting the message "trust account xxx should be in + DOMAIN_GROUP_RID_USERS." in the logs. What do I need to do? + + You are using one of the old development versions. Upgrade. (The + message is unimportant, was a reminder to a developer) + _________________________________________________________________ + +How do I get my samba server to become a member ( not PDC ) of an NT domain? + + In a domain that has a number of servers you only need one password + database. The machines that don't have their own ask the PDC to check + for them. This will work fine for a domain controlled by either a + Samba or NT machine. The following lines in smb.conf are typical, + 'password server' points to the samba machine (or an NT) that has the + password list : + + + [global] + ... + security = domain + workgroup = { Put your domain name here } + password server = { Put the ip of the PDC here } + encrypt passwords = yes + ... + + The samba server in question will have to 'join the domain', that + requires the domain controller to have a machine account for it. This + is no different to the machine account requirements to allow a NTws to + join the domain. For example, if we want a unix box called sleepy to + ask the PDC called grumpy to do its authentication then grumpy will + need an entry in its smbpasswd (assuming it's also samba) that starts + with sleepy$. It would have to be created manually. + + If the domain is controlled by an NTServer then the "Server Manager + for Domains" tool must be used to add 'sleepy' to the domain list. + + In either case we then join the domain. If the domain is called forest + then on sleepy we would join the domain by typing : + + smbpasswd -j forest + + Note that the directory where the smbpasswd file would be located + should exist as this is where smbd will generate the MACHINE.SID file. + This might be /usr/local/samba/private/FOREST.SLEEPY.SID and it + contains the trust account password for the domain member. The + permissions are (and should remain) "rw------- + + Note the Samba Servers without the password list will most likely + still need an account for each user, this means a line in its + /etc/passwd. Because authentication is being handled at the domain + level the /etc/passwd line does not need a password. If the shares + being offered are not user specific, ie a common (read only ?) area or + perhaps just printing then the user's /etc/passwd does not need a home + directory. A typical line in /etc/passwd for a server that allows + domain users to connect to the samba shares but does not offer a home + share ('cos that's on the PDC) and does not allow logon to the unix + prompt would be like this : +jblow:x:542:100:Joe Blow:/dev/null:/bin/false + + * When removing those 'dummy' users, watch the 'remove user' + scripts, some OS think they should remove a users directory even + when its not owned by the user ! + * The username map = parameter might help you to avoid having all + those accounts created. + * You should investigate the smb.conf parameter 'add user script', + it will be used to create accounts on secondary servers when that + account already exists on the PDC. Very nice. Something like : + [Global] + .... + add user script = /usr/sbin/adduser -n -g users -c User -d /dev/null -s /bi +n/false %U + .... + _________________________________________________________________ + +Chapter 6. Troubleshooting and Bug Reporting + +Diagnostic tools + +What are some diagnostics tools I can use to debug the domain logon process +and where can I find them? + + One of the best diagnostic tools for debugging problems is Samba + itself. You can use the -d option for both smbd and nmbd to specifiy + what 'debug level' at which to run. See the man pages on smbd, nmbd + and smb.conf for more information on debugging options. The debug + level can range from 1 (the default) to around 100 but a debug level + of about 20 will normally help you find any errors that samba is + encountering. Another helpful method of debugging is to compile samba + using the gcc -g flag. This will include debug information in the + binaries and allow you to attch gdb to the running smbd / nmbd + process. In order to attach gdb to an smbd process for an NT + workstation, first get the workstation to make the connection. + Pressing ctrl-alt-delete and going down to the domain box is + sufficient (at least, on the first time you join the domain) to + generate a 'LsaEnumTrustedDomains'. Thereafter, the workstation + maintains an open connection, and therefore there will be an smbd + process running (assuming that you haven't set a really short smbd + idle timeout) So, in between pressing ctrl alt delete, and actually + typing in your password, you can gdb attach and continue. + + Some usefull samba commands worth investigating: + * testparam | more + * smbclient -L //{netbios name of server} + + An SMB enabled version of tcpdump is available from + ftp://samba.org/pub/samba/tcpdump-smb/ + + Capconvert is a small C program for translating output from + tcpdump-smb to CAP format that can be read by netmon. You will need to + use the raw output from tcp dump ( ie. tcpdump -w output.dump ). Good + news! Now you can convert Solaris' snoop output as well. The C source + code for snoop2cap is available for download. + + For tracing things on the Microsoft Windows NT, Network Monitor (aka. + netmon) is available on the Microsoft Developer Network CD's, the + Windows NT Server install CD and the SMS CD's. The version of netmon + that ships with SMS allows for dumping packets between any two + computers (ie. placing the network interface in promiscuous mode). The + version on the NT Server install CD will only allow monitoring of + network traffic directed to the local NT box and broadcasts on the + local subnet. + _________________________________________________________________ + +How do I install 'Network Monitor' on an NT Workstation or a Windows 9x box? + + Installing netmon on an NT workstation requires a couple of steps. The + following are for installing Netmon V4.00.349, which comes with + Microsoft Windows NT Server 4.0, on Microsoft Windows NT Workstation + 4.0. The process should be similar for other version of Windows NT / + Netmon. You will need both the Microsoft Windows NT Server 4.0 Install + CD and the Workstation 4.0 Install CD. + + Initially you will need to install 'Network Monitor Tools and Agent' + on the NT Server. To do this + + * Goto Start - Settings - Control Panel - Network - Services - Add + * Select the 'Network Monitor Tools and Agent' and click on 'OK'. + * Click 'OK' on the Network Control Panel. + * Insert the Windows NT Server 4.0 install CD when prompted. + + At this point the Netmon files should exist in + %SYSTEMROOT%\System32\netmon\*.*. Two subdirectories exist as well, + parsers\ which contains the necessary DLL's for parsing the netmon + packet dump, and captures\. + + In order to install the Netmon tools on an NT Workstation, you will + first need to install the 'Network Monitor Agent' from the Workstation + install CD. + + * Goto Start - Settings - Control Panel - Network - Services - Add + * Select the 'Network Monitor Agent' and click on 'OK'. + * Click 'OK' on the Network Control Panel. + * Insert the Windows NT Workstation 4.0 install CD when prompted. + + Now copy the files from the NT Server in + %SYSTEMROOT%\System32\netmon\*.* to %SYSTEMROOT%\System32\netmon\*.* + on the Workstation and set permissions as you deem appropriate for + your site. You will need administrative rights on the NT box to run + netmon. + + To install Netmon on a Windows 9x box install the network monitor + agent from the Windows 9x CD (\admin\nettools\netmon). There is a + readme file located with the netmon driver files on the CD if you need + information on how to do this. Copy the files from a working Netmon + installation. + _________________________________________________________________ + +What other help can I get ? + + There are many sources of information available in the form of mailing + lists, RFC's and documentation. The docs that come with the samba + distribution contain very good explanations of general SMB topics such + as browsing. + _________________________________________________________________ + +URLs and similar + + * Home of Samba site http://samba.org. We have a mirror near you ! + * The Development document on the Samba mirrors might mention your + problem. If so, it might mean that the developers are working on + it. + * Ignacio Coupeau has a very comprehesive look at LDAP with Samba at + http://www.unav.es/cti/ldap-smb-howto.html Be a little carefull + however, I suspect that it does not specificly address samba + 2.2.x. The HEAD pre-2.1 may possibly be the best stream to look + at. + * Lars Kneschke's site covers Samba-TNG at + http://www.kneschke.de/projekte/samba_tng, but again, a lot of it + does not apply to the main stream Samba. + * Although 2.0.7 has almost had its day as a PDC, I (drb) will keep + the 2.0.7 PDC pages at http://bioserve.latrobe.edu.au/samba going + for a while yet. + * Misc links to CIFS information http://samba.org/cifs/ + * NT Domains for Unix http://mailhost.cb1.com/~lkcl/ntdom/ + * FTP site for older SMB specs: + ftp://ftp.microsoft.com/developr/drg/CIFS/ + + There are a number of documents that no longer appear to live at their + origional home. Any one know where the following may be found ? + * CIFS/E Browser Protocol draft-leach-cifs-browser-spec-00.txt + * CIFS Remote Administration Protocol + draft-leach-cifs-rap-spec-00.txt + * CIFS Logon and Pass Through Authentication + draft-leach-cifs-logon-spec-00.txt + * A Common Internet File System (CIFS/1.0) Protocol + draft-leach-cifs-v1-spec-01.txt + * CIFS Printing Specification draft-leach-cifs-print-spec-00.txt + * RFC1001 (March '87) Protocol standard for a NetBIOS service on a + TCP/UDP transport: Concepts and methods. + http://ds.internic.net/rfc/rfc1001.txt + * RFC1002 (March '87) Protocol standard for a NetBIOS service on a + TCP/UDP transport: Detailed specifications. + http://ds.internic.net/rfc/rfc1002.txt + * Microsoft's main CIFS page: + http://www.microsoft.com/workshop/networking/cifs/ + _________________________________________________________________ + +How do I get help from the mailing lists ? + + There are a number of Samba related mailing lists. Go to + http://samba.org, click on your nearest mirror and then click on + Support and then click on Samba related mailing lists. + + For questions relating to Samba TNG go to http://www.samba-tng.org/ It + has been requested that you don't post questions about Samba-TNG to + the main stream Samba lists. + + If you post a message to one of the lists please observe the following + guide lines : + * Always remember that the developers are volunteers, they are not + paid and they never guarantee to produce a particular feature at a + particular time. Any time lines are 'best guess' and nothing more. + * Always mention what version of samba you are using and what + operating system its running under. You should probably list the + relevant sections of your smb.conf file, at least the options in + [global] that affect PDC support. + * In addition to the version, if you obtained Samba via CVS mention + the date when you last checked it out. + * Try and make your question clear and brief, lots of long, + convoluted questions get deleted before they are completely read ! + Don't post html encoded messages (if you can select colour or font + size its html). + * If you run one of those niffy 'I'm on holidays' things when you + are away, make sure its configured to not answer mailing lists. + * Don't cross post. Work out which is the best list to post to and + see what happens, ie don't post to both samba-ntdom and + samba-technical. Many people active on the lists subscribe to more + than one list and get annoyed to see the same message two or more + times. Often someone will see a message and thinking it would be + better dealt with on another, will forward it on for you. + * You might include partial log files written at a debug level set + to as much as 20. Please don't send the entire log but enough to + give the context of the error messages. + * (Possibly) If you have a complete netmon trace ( from the opening + of the pipe to the error ) you can send the *.CAP file as well. + * Please think carefully before attaching a document to an email. + Consider pasting the relevant parts into the body of the message. + The samba mailing lists go to a huge number of people, do they all + need a copy of your smb.conf in their attach directory ? + _________________________________________________________________ + +How do I get off the mailing lists ? + + To have your name removed from a samba mailing list, go to the same + place you went to to get on it. Go to http://samba.org, click on your + nearest mirror and then click on Support and then click on Samba + related mailing lists. Or perhaps see here + + Please don't post messages to the list asking to be removed, you will + just be refered to the above address (unless that process failed in + some way...) diff --git a/docs/textdocs/samba-pdc-howto.txt b/docs/textdocs/samba-pdc-howto.txt new file mode 100644 index 0000000000..0073d2947b --- /dev/null +++ b/docs/textdocs/samba-pdc-howto.txt @@ -0,0 +1,703 @@ + +The Samba 2.2 PDC HowTo + +David Bannon + + La Trobe University + _________________________________________________________________ + _________________________________________________________________ + + Comments, corrections and additions to <D.Bannon@latrobe.edu.au> + + This document explains how to setup Samba as a Primary Domain + Controller and applies to version 2.2.0. Before using these functions + make sure you understand what the controller can and cannot do. Please + read the sections below in the Introduction. As 2.2.0 is incrementally + updated this document will change or become out of date very quickly, + make sure you are reading the most current version. + + Please note this document does not apply to Samba2.2alpha0, + Samba2.2alpha1, Samba 2.0.7, TNG nor HEAD branch. + + It does apply to the current (post November 27th) cvs. + + Also available is an updated version of Jerry Carter's NTDom FAQ that + will answer lots of the special 'tuning' questions that are not + covered here. Over the next couple of weeks some of the items here + will be moved to the FAQ. + + Table of Contents + 1. Introduction + + What can we do ? + What can't we do ? + + 2. Installing + + Start Up Script + Config File + + A sample conf file + PDC Config Parameters + + Special directories + + 3. User and Machine Accounts + + Logon Accounts + Machine Accounts + Joining the Domain + User Accounts + Domain Admin Accounts + + 4. Profiles, Policies and Logon Scripts + + Profiles + Policies + Logon Scripts + + 5. Passwords and Authentication + + Syncing Passwords + Using PAM + Authenticating other Samba Servers + + 6. Background + + History + The Future + Getting further help + _________________________________________________________________ + +Chapter 1. Introduction + + This document will show you one way of making Version 2.2.0 of Samba + perform some of the tasks of a NT Primary Domain Controller. The + facilities described are built into Samba as a result of development + work done over a number of years by a large number of people. These + facilities are only just beginning to be officially supported and + although they do appear to work reliably, if you use them then you + take the risks upon your self. This document does not cover the + developmental versions of Samba, particularly Samba-TNG + + Note that Samba 2.0.7 supports significently less of the NT Domain + facilities compared with 2.2.0 + + This document does not replace the text files DOMAIN_CONTROL.txt, + DOMAIN.txt (by John H Terpstra) or NTDOMAIN.txt (by Luke Kenneth + Casson Leighton). Those documents provide more detail and an insight + to the development cycle and should be considered 'further reading'. + _________________________________________________________________ + +What can we do ? + + * Permit 'domain logons' for Win95/98, NT4 and W2K workstations from + one central password database. WRT W2K, please see the section + about adding machine accounts and the Intro in the FAQ. + * Grant Administrator privileges to particular domain users on an NT + or W2K workstation. + * Apply policies from a domain policy file to NT and W2K (?) + workstation. + * Run the appropriate logon script when a user logs on to the domain + . + * Maintain a user's local profile on the server. + * Validate a user using another system via smb (such as smb_pam) and + soon winbind (?). + _________________________________________________________________ + +What can't we do ? + + * Become or work with a Backup Domain Controller (a BDC). + * Participate in any sort of trust relationship (with either Samba + or NT Servers). + * Offer a list of domain users to User Manager for Domains on the + Security Tab etc). + * Be a W2K type of Domain Controller. Samba PDC will behave like an + NT PDC, W2K workstations connect in legacy mode. + _________________________________________________________________ + +Chapter 2. Installing + + Installing consists of the usual download, configure, make and make + install process. These steps are well documented elsewhere. The FAQ + discusses getting pre-release versions via CVS. Then you need to + configure the server. + _________________________________________________________________ + +Start Up Script + + Skip this section if you have a working Samba already. Everyone has + their own favourite startup script. Here is mine, offered with no + warrantee at all ! + + + #!/bin/sh + # Script to control Samba server, David Bannon, 14-6-96 + # + # + PATH=/bin:/usr/sbin:/usr/bin + export PATH + case "$1" in + 'start') + if [ -f /usr/local/samba/bin/smbd ] + then + /usr/local/samba/bin/smbd -D + /usr/local/samba/bin/nmbd -D + echo "Starting Samba Server" + fi + ;; + 'conf') + if [ -f /usr/local/samba/lib/smb.conf ] + then + vi /usr/local/samba/lib/smb.conf + fi + ;; + 'pw') + if [ -f /usr/local/samba/private/smbpasswd ] + then + vi /usr/local/samba/private/smbpasswd + fi + ;; + 'who') + /usr/local/samba/bin/smbstatus -b + ;; + 'restart') + psline=`/bin/ps x | grep smbd | grep -v grep` + + if [ "$psline" != "" ] + then + while [ "$psline" != "" ] + do + psline=`/bin/ps x | fgrep smbd | grep -v grep` + if [ "$psline" ] + then + set -- $psline + pid=$1 + /bin/kill -HUP $pid + echo "Stopped $pid line = $psline" + sleep 2 + fi + done + fi + echo "Stopped Samba servers" + ;; + 'stop') + psline=`/bin/ps x | grep smbd | grep -v grep` + + if [ "$psline" != "" ] + then + while [ "$psline" != "" ] + do + psline=`/bin/ps x | fgrep smbd | grep -v grep` + if [ "$psline" ] + then + set -- $psline + pid=$1 + /bin/kill -9 $pid + echo "Stopped $pid line = $psline" + sleep 2 + fi + done + fi + echo "Stopped Samba servers" + psline=`/bin/ps x | grep nmbd | grep -v grep` + if [ "$psline" ] + then + set -- $psline + pid=$1 + /bin/kill -9 $pid + echo "Stopped Name Server " + fi + echo "Stopped Name Servers" + ;; + *) + echo "usage: samba {start | restart |stop | conf | pw | who}" + ;; + esac + + + Use this script, or some other one, you will need to ensure its used + while the machine is booting. (This typically involves /etc/rc.d, + we'll be assuming that there is a script called samba in + /etc/rc.d/init.d further down in this document.) + _________________________________________________________________ + +Config File + +A sample conf file + + Here is a fairly minimal config file to do PDC. It will also make the + server become the browse master for the specified domain (not + necessary but usually desirable). You will need to change only two + parameters to make this file work, wins server and workgroup, plus you + will need to put your own name (not mine!) in the domain admin users + fields. Some of the parameters are discussed further down this + document. + + Assuming you have used the default install directories, this file + should appear as /usr/local/samba/lib/smb.conf. It should not be + writable by anyone except root. + + Note: The 'add user script' parameter is a work-around, watch for + changes ! + + + + [global] + security = user + status = yes + workgroup = { Your domain name here } + wins server = { ip of a wins server if you have one } + encrypt passwords = yes + domain logons =yes + logon script = scripts\%U.bat + domain admin users = root dbannon andrew + add user script = /usr/sbin/adduser -n -g machines -c Machine -d /dev/n +ull -s /bin/false %m$ + guest account = ftp + share modes=no + os level=65 + [homes] + guest ok = no + read only = no + create mask = 0700 + directory mask = 0700 + oplocks = false + locking = no + [netlogon] + path = /usr/local/samba/netlogon + writeable = no + guest ok = no + + _________________________________________________________________ + +PDC Config Parameters + + There are a huge range of parameters that may appear in a smb.conf + file. Some that may be of interest to a PDC are : + + add user script + This parameter specifies a script (or program) that will be run + to add a user to the system. Here it is being used to add a + machine, not a user. This is probably not very nice and may + change. But it does work ! + + For this example, I have a group called 'machines', entries can + be added to /etc/passwd using a programme called /usr/adduser + and the other parameters are chosen as suitable for a machine + account. Works for RH Linux, your system may require changes. + + domain admin users = user1 users2 + This parameter specifies a unix user who will be granted admin + privileges on a NT workstation when logged onto that + workstation. See the section called Domain Admin Accounts. + + encrypt passwords = yes + This parameter must be 'yes' to allow any of the recent service + pack NTs to logon. There are some reg hacks that turn off + encrypted passwords on the NTws itself but if you are going to + use the smbpasswd system (and you should) you must use + encrypted passwords. + + logon script = scripts\%U.bat + This will make samba look for a logon script named after the + user (eg joeblow.bat). See the section further on called Logon + Scripts + + Note: Note that the slash is like this '\', not like this '/'. NT + is happy with both, win95 is not ! + + logon path + Lets you specify where you would like users profiles kept. The + default, that is in the users home directory, does encourage a + bit of fiddling. + _________________________________________________________________ + +Special directories + + You need to create a couple of special files and directories. Its nice + to have some of the binaries handy too, so I create links to them. + Assuming you have used the default samba location and have not changed + the locations mentioned in the sample config file, do the following : + + + mkdir /usr/local/samba/netlogon + mkdir /usr/local/samba/netlogon/scripts + mkdir /usr/local/samba/private + touch /usr/local/samba/private/smbpasswd + chmod go-rwx /usr/local/samba/private/smbpasswd + cd /usr/local/sbin + ln -s /usr/local/samba/bin/smbpasswd + ln -s /usr/local/samba/bin/smbclient + ln -s /etc/rc.d/init.d/samba + + Make sure permissions are appropriate ! + + OK, if you have used the scripts above and have a path to where the + links are do this to start up the Samba Server : + + samba start + + Instead, you might like to reboot the machine to make sure that you + got the init stuff right. Any way, a quick look in the logs + /usr/local/samba/var/log.smbd and /usr/local/samba/var/log/nmbd will + give you an idea of what's happening. Assuming all is well, lets + create some accounts... + _________________________________________________________________ + +Chapter 3. User and Machine Accounts + +Logon Accounts + + This section is very nearly out of date already ! It appears that + while you are reading it, Jean Francois Micou is making it redundant ! + Jean Francois is adding facilities to add users (via User Manager) and + machines (when joining the domain) and it looks like these facilities + will make it into the official release of 2.2. + + Every user and NTws (and other samba servers) that will be on the + domain must have its own passwd entry in both /etc/passwd and + /usr/local/samba/private/smbpasswd . The /etc/passwd entry is really + only to reserve a user ID. The NT encrypted password is stored in + /usr/local/samba/private/smbpasswd. (Note that win95/98 machines don't + need an account as they don't do any security aware things.) + + Samba 2.2 will now create these entries for us. Carefull set up is + required and there may well be some changes to this system before its + released. + _________________________________________________________________ + +Machine Accounts + + Note: There is an entry in the ntdom FAQ explaining how to create + machine entries manually. + + At present to have the machine accounts created when a machine joins + the domain a number of conditions must be met : + + Only root can do it ! + There must be an entry in /usr/local/samba/private/smbpasswd + for root and root must be mentioned in domain admins. This may + be fixed some time in the future so any 'domain admin' can do + it. If you don't like having root as a windows logon account, + make the machine entries manually (both of them). + + Use the add user script + Again, this looks a bit like a 'work around'. Use a suitable + command line to add a machine account see above, and pass it + %m$, that is %m to get machine name plus the '$'. Now, this + means you cannot use the add user script to really add users + .... + + Only for W2K + This automatic creation of machine accounts does not work for + NT4ws at present. Watch this space. + _________________________________________________________________ + +Joining the Domain + + You must have either added the machine account entries manually (NT4 + ws) or set up the automatic system (W2K), see Machine Accounts before + proceeding. + + Windows NT + + + (this step may not be necessary some time in the near + future). On the samba server that is the PDC, add a machine + account manually as per the instructions in the FAQ Then give + the command smbpasswd -a -m {machine} substituting in the + client machine name. + + Logon to the NTws in question as a local admin, go to the + Control Panel, Network IdentificationTag. + + Press the Change button. + + Enter the Domain name (from the 'Workgroup' parameter, + smb.conf) in the Domain Field. + + Press OK and after a few seconds you will get a 'Welcome to + Whatever Domain'. Allow to reboot. + + Windows 2000 + + + Logon to the W2k machine as Administrator, go to the Control + Panel and double click on Network and Dialup Connections. + + Pull down the Advanced menu and choose Network + Identification. Press Properties . + + Choose Domain and enter the domain name. Press 'OK'. + + Now enter a user name and password for a Domain Admin (Who + must be root until a pre-release bug is fixed) and press + 'OK'. + + Wait for the confirmation, reboot when prompted. + + To remove a W2K machine from the domain, follow the first two + steps then choose Workgroup, enter a work group name (or just + WORKGROUP) and follow the prompts. + _________________________________________________________________ + +User Accounts + + Again, doing it manually (cos' the auto way is not working + pre-release). In our simple case every domain user should have an + account on the PDC. The account may have a null shell if they are not + allowed to log on to the unix prompt. Again they need an entry in both + the /etc/passwd and /usr/local/samba/private/smbpasswd. Again a + password is not necessary in /etc/passwd but the location of the home + directory is honoured. To make an entry for a user called Joe Blow you + would typically do the following : + + adduser -g users -c 'Joe Blow' -s /bin/false -n joeblow + + smbpasswd -a joeblow + + And you will prompted to enter a password for Joe. Ideally he will be + hovering over your shoulder and will, when asked, type in a password + of his choice. There are a number of scripts and systems to ease the + migration of users from somewhere to samba. Better start looking ! + _________________________________________________________________ + +Domain Admin Accounts + + Certain operations demand that the logged on user has Administrator + privileges, typically installing software and doing maintenance tasks. + It is very simple to appoint some users as Domain Admins, most likely + yourself. Make sure you trust the appointee ! + + Samba 2.2 recognizes particular users as being domain admins and tells + the NTws when it thinks that it has got one logged on. In the smb.conf + file we declare that the Domain Admin users = user1 user2. Any user + mentioned here will be treated as a Domain Admin by a NTws when logged + onto the Domain. They will have full Administrator rights including + the rights to change permissions on files and run the system utilities + such as Disk Administrator. + + Further, and this is very new, they will be allowed to create a new + machine account when first connecting a new NT or W2K machine to the + domain. At present, ie pre-release, only a Domain Admin who also + happens to be root can do so. + _________________________________________________________________ + +Chapter 4. Profiles, Policies and Logon Scripts + +Profiles + + NT Profiles should work if you have followed the setup so far. A + user's profile contains a whole lot of their personal settings, the + contents of their desktop, personal 'My Documents' and so on. When + they log off, all of the profile is copied to their directory on the + server and is downloaded again when they logon on again, possibly on + another client machine. + + Sounds great but can be a bit of a bug bear sometimes. Users let their + profiles get too big and then complain about how long it takes to log + on each time. This sample setup only supports NT profiles, rumor has + it that it is also possible to do the same on Win95, my users don't + know and I'm not telling them. + + Note: There is more info about Profiles (including for W95/98) in + the FAQ. + _________________________________________________________________ + +Policies + + Policies are an easy way to make or enforce specific characteristics + across your network. You create a ntconfig.pol file and every time + someone logs on with their NTws, the settings you put in ntconfig.pol + are applied to the NTws. Typical setting are things like making the + date appear the way you want it (none of these 2 figure years here) or + maybe suppressing one of the splash screens. Perhaps you want to set + the NTws so it does not keep users profiles on the local machine. + Cool. The only problem is making the ntconfig.pol file itself. You + cannot use the policy editor that comes with NTws. + + Note: See the FAQ for pointers on how to get a suitable Policy + Editor. + + The Policy Editor (and associated files) will create a ntconfig.pol + file using the parameters Microsoft thought of and parameters you + specify by making your own template file. + + In our example configuration here, Samba will expect to find the + ntconfig.pol file in /usr/local/samba/netlogon. Needless to say (I + hope !), it is vitally important that ordinary users don't have write + permission to the Policy files. + _________________________________________________________________ + +Logon Scripts + + In the sample config file above there is a line logon script = + scripts\%U.bat + + Note: Note that the slash is like this '\' not like this '/'. NT is + happy with both, win95 is not ! + + This allows you to run a dos batch file every time someone logs on. + The batch file is located on the server, in the sample install + mentioned here, its in /usr/local/samba/netlogon/scripts and is named + after the user with .bat appended, eg Joe Blow's script is called + /usr/local/samba/netlogon/scripts/joeblow.bat. + + Note: There is a suggestion that user names longer than 8 + characters may cause problems with some systems being unable to run + logon scripts. This is confirmed in earlier versions when + connecting using W95, comments about other combinations ?? + + You could use a line like this logon script = default.bat and samba + will supply /usr/local/samba/netlogon/default.bat for any client and + every user. Maybe you could use %m and get a client machine dependant + logon script. You get the idea... + + Note that the file is a dos batch file not a Unix script. It runs dos + commands on the client computer with the logon user's permissions. It + must be a dos file with each line ending with the dos cr/lf not a nice + clean newline. Generally, its best to create the initial file on a DOS + system and copy it across. + + There is lots of very clever uses of the Samba replaceable variables + such ( %U = user, %G = primary group, %H = client machine, see the + 'man 5 smb.conf') to give you control over which script runs when a + particular person logs on. (Gee, it would be nice to have a + default.bat run when nothing else is available.) + + Again, it is vitally important that ordinary users don't have write + permission to other peoples, or even probably their own, logon script + files. + + A typical logon script is reproduced below. Note that it runs separate + commands for win95 and NT, that's because NT has slightly different + behaviour when using the net use .. command. Its useful for lots of + other situations too. I don't know what syntax to use for win98, I + don't use it here. + + + rem Default logon script, create links to this file. + + net time \\bioserve /set /yes + @echo off + if %OS%.==Windows_NT. goto WinNT + + :Win95 + net use k: \\trillion\bio_prog + net use p: \\bcfile\homes + goto end + :WinNT + net use k: \\trillion\bio_prog /persistent:no + net use p: \\bcfile\homes /persistent:no + + :end + _________________________________________________________________ + +Chapter 5. Passwords and Authentication + + So far our configuration assumes that ordinary users don't have unix + logon access. A change to the adduser line above would allow unix + logon but it would be with passwords that may be different from the NT + logon. Clearly that won't suit everyone. Trying to explain to users + that they need to change their passwords in two seperate places is not + fun. Further, even if they cannot do a unix logon there are other + processes that might require authentication. We have a nice securely + encrypted password in /usr/local/samba/private/smbpasswd, why not use + it ? + _________________________________________________________________ + +Syncing Passwords + + Yes, its possible and seems the easiest way (initially anyway). The + FAQ details how to do so in the sections What is password sync and + should I use it ? and How do I get remote password (unix and SMB) + changing working ? + _________________________________________________________________ + +Using PAM + + Pam enabled systems have a much better solution available. The Samba + PDC server will offer to authenticate domain users to other processes + (either on this server or on the domain). With a suitable pam stack + such as Pam_smb you can get any pam aware application looking to the + samba password and can leave the password field in /etc/shadow or + /etc/passwd invalid. + _________________________________________________________________ + +Authenticating other Samba Servers + + In a domain that has a number of servers you only need one password + database. The machines that don't have their own ask the PDC to check + for them. This will work fine for a domain controlled by either a + Samba or NT machine. + + To do so the Samba machine must be told to refer to the PDC and where + the PDC is. See the section in the NTDom FAQ called How do I get my + samba server to become a member ( not PDC ) of an NT domain? + _________________________________________________________________ + +Chapter 6. Background + +History + + It might help you understand the limitations of the PDC in Samba if + you read something of its history. Well, the history as I understand + it anyway. + + For many years the Samba team have been developing Samba, some time + ago a number of people, possibly lead by Luke Leighton started + contributing NT PDC stuff. This was added to the 'head' stream (that + would eventually become the next version) and later to a seperate + stream (NTDom). They did so much that eventually this development + stream was so mutated that it could not be merged back into the main + stream and was abandoned towards the end of 1999. And that was very + sad because many users, myself include had become heavily dependant on + the NTController facilities it offered. Oh well... + + The NTDom team continued on with their new found knowledge however and + built the TNG stream. Intended to be carefully controlled so that it + can be merged back into the main stream and benefiting from what they + learnt, it is a very different product to the origional NTDom product. + However, for a number of reasons, the merge did not take place and now + TNG is being developed at http://www.samba-tng.org. + + Now, the NTDom things that the main strean 2.0.x version does is based + more on the old (initial version) abandoned code than on the TNG + ideas. It appears that version 2.2.0 will also include an improved + version of the 2.0.7 domain controller charactistics, not the TNG + ways. The developers have indicated that 2.2.0 will be further + developed incrementally and the ideas from TNG incorporated into it. + + One more little wriggle is worth mentioning. At one stage the NTDom + stream was called Samba 2.1.0-prealpha and similar names. This is most + unfortunate because at least one book published advises people who + want to use NTDom Samba to get version 2.1.0 or later. As main stream + Samba will soon be called 2.2.0 and NOT officially supporting NTDom + Controlling functions, the potential for confusion is certainly there. + _________________________________________________________________ + +The Future + + There is a document on the Samba mirrors called 'Development' . It + offers the 'best guess' of what is planned for future releases of + Samba. + + The future of Samba as a Primary Domain Controller appears rosie, + however be aware that its the future, not the present. The developers + are strongly committed to building a full featured PDC into Samba but + it will take time. If this version does not meet your requirements + then you should consider (in no particular order) : + + * Wait. No, we don't know how long. Repeated asking won't help. + * Investigate the development versions, TNG perhaps or HEAD where + new code is being added all the time. Realise that development + code is often unstable, poorly documented and subject to change. + You will need to use cvs to download development versions. + * Join one of the Samba mailing lists so that you can find out what + is happening on the 'bleeding edge'. + _________________________________________________________________ + +Getting further help + + This document cannot possibly answer all your questions. Please + understand that its very likely that someone has been confrounted by + the same problem that you have. The FAQ discusses a number of possible + paths to take to get further help : + + * Documents on the Samba Sites. + * Other web sites. + * Mailing list. + + There is some discussion about guide lines for using the Mailing Lists + on the accompanying FAQ, please read them before posting. |