Updated sgml and html FAQ.
[samba.git] / docs / faq / sambafaq.sgml
1 <!doctype linuxdoc system> <!-- -*- SGML -*- -->
2 <!--
3  v 0.5 18 Oct 1996 Dan Shearer Dan.Shearer@unisa.edu.au
4         First linuxdoc-sgml version, outline only
5  v 0.6 25 Oct 1996 Dan
6         Filled in from current text faq
7  v 0.7 1 June 1997 Paul
8         Replicated changes in txt faq to sgml faq
9 -->
10
11 <article>
12
13 <title> Samba FAQ
14
15 <author>Paul Blackman, <tt>ictinus@lake.canberra.edu.au</tt>
16
17 <date>, v 0.7
18
19 <abstract> This is the Frequently Asked Questions (FAQ) document for
20 Samba, the free and very popular SMB server product. An SMB server
21 allows file and printer connections from clients such as Windows,
22 OS/2, Linux and others. Current to version 1.9.17. Please send any
23 corrections to the author.
24 </abstract>
25
26 <toc>
27
28 <sect> General Information<p> <label id="general_info">
29
30 All about Samba - what it is, how to get it, related sources of
31 information, how to understand the version numbering scheme, pizza
32 details
33
34 <sect1> What is Samba? <p> <label id="introduction">
35
36 Samba is a suite of programs which work together to allow clients to
37 access to a server's filespace and printers via the SMB (Server
38 Message Block) protocol. Initially written for Unix, Samba now also
39 runs on Netware, OS/2 and VMS.
40
41 In practice, this means that you can redirect disks and printers to
42 Unix disks and printers from Lan Manager clients, Windows for
43 Workgroups 3.11 clients, Windows NT clients, Linux clients and OS/2
44 clients. There is also a generic Unix client program supplied as part
45 of the suite which allows Unix users to use an ftp-like interface to
46 access filespace and printers on any other SMB servers. This gives the
47 capability for these operating systems to behave much like a LAN
48 Server or Windows NT Server machine, only with added functionality and
49 flexibility designed to make life easier for administrators.
50
51 The components of the suite are (in summary):
52
53 <itemize>
54
55 <item> smbd, the SMB server. This handles actual connections from
56 clients, doing all the file, permission and username work
57 <item>nmbd, the Netbios name server, which helps clients locate
58 servers, doing the browsing work and managing domains as this
59 capability is being built into Samba
60 <item>smbclient, the Unix-hosted client program
61 <item>smbrun, a little 'glue' program to help the server run external
62 programs
63 <item>testprns, a program to test server access to printers
64 <item>testparms, a program to test the Samba configuration file for
65 correctness
66 <item>smb.conf, the Samba configuration file
67 <item> smbprint, a sample script to allow a Unix host to use smbclient
68 to print to an SMB server
69 <item> documentation! DON'T neglect to read it - you will save a great
70 deal of time!
71 </itemize>
72
73 The suite is supplied with full source (of course!) and is GPLed.
74
75 The primary creator of the Samba suite is Andrew Tridgell. Later
76 versions incorporate much effort by many net.helpers. The man pages
77 and this FAQ were originally written by Karl Auer.
78
79 <sect1> What is the current version of Samba? <p> <label id="current_version">
80
81 At time of writing, the current version was 1.9.16. If you want to be
82 sure check the bottom of the change-log file. <url
83 url="ftp://samba.anu.edu.au/pub/samba/alpha/change-log">
84
85 For more information see <ref id="version_nums" name="What do the
86 version numbers mean?">
87
88 <sect1> Where can I get it? <p> <label id="where">
89
90 The Samba suite is available via anonymous ftp from
91 samba.anu.edu.au. The latest and greatest versions of the suite are in
92 the directory:
93
94 /pub/samba/
95
96 Development (read "alpha") versions, which are NOT necessarily stable
97 and which do NOT necessarily have accurate documentation, are
98 available in the directory:
99
100 /pub/samba/alpha
101
102 Note that binaries are NOT included in any of the above. Samba is
103 distributed ONLY in source form, though binaries may be available from
104 other sites. Recent versions of some Linux distributions, for example,
105 do contain Samba binaries for that platform.
106
107 <sect1> What do the version numbers mean? <p> <label id="version_nums">
108
109 It is not recommended that you run a version of Samba with the word
110 "alpha" in its name unless you know what you are doing and are willing
111 to do some debugging. Many, many people just get the latest
112 recommended stable release version and are happy. If you are brave, by
113 all means take the plunge and help with the testing and development -
114 but don't install it on your departmental server. Samba is typically
115 very stable and safe, and this is mostly due to the policy of many
116 public releases.
117
118 How the scheme works:
119 <enum>
120 <item>when major changes are made the version number is increased. For
121 example, the transition from 1.9.15 to 1.9.16. However, this version
122 number will not appear immediately and people should continue to use
123 1.9.15 for production systems (see next point.)
124
125 <item>just after major changes are made the software is considered
126 unstable, and a series of alpha releases are distributed, for example
127 1.9.16alpha1. These are for testing by those who know what they are
128 doing.  The "alpha" in the filename will hopefully scare off those who
129 are just looking for the latest version to install.
130
131 <item>when Andrew thinks that the alphas have stabilised to the point
132 where he would recommend new users install it, he renames it to the
133 same version number without the alpha, for example 1.9.16.
134
135 <item>inevitably bugs are found in the "stable" releases and minor patch
136 levels are released which give us the pXX series, for example 1.9.16p2.
137 </enum>
138 So the progression goes:
139 <verb>
140                         1.9.15p7        (production)
141                         1.9.15p8        (production)
142                         1.9.16alpha1    (test sites only)
143                           :
144                         1.9.16alpha20   (test sites only)
145                         1.9.16          (production)
146                         1.9.16p1        (production)
147 </verb>
148 The above system means that whenever someone looks at the samba ftp
149 site they will be able to grab the highest numbered release without an
150 alpha in the name and be sure of getting the current recommended
151 version.
152
153 <sect1> What platforms are supported? <p> <label id="platforms">
154
155 Many different platforms have run Samba successfully. The platforms
156 most widely used and thus best tested are Linux and SunOS.
157
158 At time of writing, the Makefile claimed support for:
159 <itemize>
160 <item> SunOS
161 <item> Linux with shadow passwords
162 <item> Linux without shadow passwords
163 <item> SOLARIS
164 <item> SOLARIS 2.2 and above (aka SunOS 5)
165 <item> SVR4
166 <item> ULTRIX
167 <item> OSF1 (alpha only)
168 <item> OSF1 with NIS and Fast Crypt (alpha only)
169 <item> OSF1 V2.0 Enhanced Security (alpha only)
170 <item> AIX
171 <item> BSDI
172 <item> NetBSD
173 <item> NetBSD 1.0
174 <item> SEQUENT
175 <item> HP-UX
176 <item> SGI
177 <item> SGI IRIX 4.x.x
178 <item> SGI IRIX 5.x.x
179 <item> FreeBSD
180 <item> NeXT 3.2 and above
181 <item> NeXT OS 2.x
182 <item> NeXT OS 3.0
183 <item> ISC SVR3V4 (POSIX mode)
184 <item> ISC SVR3V4 (iBCS2 mode)
185 <item> A/UX 3.0
186 <item> SCO with shadow passwords.
187 <item> SCO with shadow passwords, without YP.
188 <item> SCO with TCB passwords
189 <item> SCO 3.2v2 (ODT 1.1) with TCP passwords
190 <item> intergraph
191 <item> DGUX
192 <item> Apollo Domain/OS sr10.3 (BSD4.3)
193 </itemize>
194
195 <sect1> How can I find out more about Samba? <p> <label id="more">
196
197 There are two mailing lists devoted to discussion of Samba-related
198 matters.  There is also the newsgroup, comp.protocols.smb, which has a
199 great deal of discussion on Samba. There is also a WWW site 'SAMBA Web
200 Pages' at <url url="http://samba.canberra.edu.au/pub/samba/samba.html">, under
201 which there is a comprehensive survey of Samba users. Another useful
202 resource is the hypertext archive of the Samba mailing list.
203
204 Send email to <htmlurl url="mailto:listproc@samba.anu.edu.au" name="listproc@samba.anu.edu.au">. Make sure the subject line is
205 blank, and include the following two lines in the body of the message:
206
207 <tscreen><verb>
208 subscribe samba Firstname Lastname
209 subscribe samba-announce Firstname Lastname
210 </verb></tscreen>
211
212 Obviously you should substitute YOUR first name for "Firstname" and
213 YOUR last name for "Lastname"! Try not to send any signature stuff, it
214 sometimes confuses the list processor.
215
216 The samba list is a digest list - every eight hours or so it
217 regurgitates a single message containing all the messages that have
218 been received by the list since the last time and sends a copy of this
219 message to all subscribers.
220
221 If you stop being interested in Samba, please send another email to
222 <htmlurl url="mailto:listproc@samba.anu.edu.au" name="listproc@samba.anu.edu.au">. Make sure the subject line is blank, and
223 include the following two lines in the body of the message:
224
225 <tscreen><verb>
226 unsubscribe samba
227 unsubscribe samba-announce
228 </verb></tscreen>
229
230 The <bf>From:</bf> line in your message <em>MUST</em> be the same address you used when
231 you subscribed.
232
233 <sect1> Something's gone wrong - what should I do? <p> <label id="wrong">
234
235 <bf>[#] *** IMPORTANT! *** [#]</bf>
236 <p>DO NOT post messages on mailing lists or in newsgroups until you have
237 carried out the first three steps given here!
238
239 Firstly, see if there are any likely looking entries in this FAQ! If
240 you have just installed Samba, have you run through the checklist in
241 <url url="ftp://samba.anu.edu.au/pub/samba/DIAGNOSIS.txt" name="DIAGNOSIS.txt">? It can save you a lot of time and effort.
242
243 Secondly, read the man pages for smbd, nmbd and smb.conf, looking for
244 topics that relate to what you are trying to do.
245
246 Thirdly, if there is no obvious solution to hand, try to get a look at
247 the log files for smbd and/or nmbd for the period during which you
248 were having problems. You may need to reconfigure the servers to
249 provide more extensive debugging information - usually level 2 or
250 level 3 provide ample debugging info. Inspect these logs closely,
251 looking particularly for the string "Error:".
252
253 Fourthly, if you still haven't got anywhere, ask the mailing list or
254 newsgroup.  In general nobody minds answering questions provided you
255 have followed the preceding steps. It might be a good idea to scan the
256 archives of the mailing list, which are available through the Samba
257 web site described in the previous
258 section.
259
260 If you successfully solve a problem, please mail the FAQ maintainer a
261 succinct description of the symptom, the problem and the solution, so
262 I can incorporate it in the next version.
263
264 If you make changes to the source code, _please_ submit these patches
265 so that everyone else gets the benefit of your work. This is one of
266 the most important aspects to the maintainence of Samba. Send all
267 patches to <htmlurl url="mailto:samba-bugs@samba.anu.edu.au" name="samba-bugs@samba.anu.edu.au">, not Andrew Tridgell or any
268 other individual and not the samba team mailing list.
269
270 <sect1> Pizza supply details <p> <label id="pizza">
271
272 Those who have registered in the Samba survey as "Pizza Factory" will
273 already know this, but the rest may need some help. Andrew doesn't ask
274 for payment, but he does appreciate it when people give him
275 pizza. This calls for a little organisation when the pizza donor is
276 twenty thousand kilometres away, but it has been done.
277
278 Method 1: Ring up your local branch of an international pizza chain
279 and see if they honour their vouchers internationally. Pizza Hut do,
280 which is how the entire Canberra Linux Users Group got to eat pizza
281 one night, courtesy of someone in the US
282
283 Method 2: Ring up a local pizza shop in Canberra and quote a credit
284 card number for a certain amount, and tell them that Andrew will be
285 collecting it (don't forget to tell him.) One kind soul from Germany
286 did this.
287
288 Method 3: Purchase a pizza voucher from your local pizza shop that has
289 no international affiliations and send it to Andrew. It is completely
290 useless but he can hang it on the wall next to the one he already has
291 from Germany :-)
292
293 Method 4: Air freight him a pizza with your favourite regional
294 flavours. It will probably get stuck in customs or torn apart by
295 hungry sniffer dogs but it will have been a noble gesture.
296
297 <sect>Compiling and installing Samba on a Unix host<p> 
298 <label id="unix_install">
299
300 <sect1>I can't see the Samba server in any browse lists!<p>
301 <label id="no_browse">
302
303  See <url url="ftp://samba.anu.edu.au/pub/samba/BROWSING.txt" name="BROWSING.txt">
304  for more information on browsing.  Browsing.txt can also be found
305  in the docs directory of the Samba source.
306
307 If your GUI client does not permit you to select non-browsable
308 servers, you may need to do so on the command line. For example, under
309 Lan Manager you might connect to the above service as disk drive M:
310 thusly:
311
312    net use M: \\mary\fred
313
314 The details of how to do this and the specific syntax varies from
315 client to client - check your client's documentation.
316
317 <sect1>Some files that I KNOW are on the server doesn't show up when I view the files from my client! <p> <label id="missing_files">
318
319 <sect1>Some files on the server show up with really wierd filenames when I view the files from my client! <p> <label id="strange_filenames">
320
321 If you check what files are not showing up, you will note that they
322 are files which contain upper case letters or which are otherwise not
323 DOS-compatible (ie, they are not legal DOS filenames for some reason).
324
325 The Samba server can be configured either to ignore such files
326 completely, or to present them to the client in "mangled" form. If you
327 are not seeing the files at all, the Samba server has most likely been
328 configured to ignore them.  Consult the man page smb.conf(5) for
329 details of how to change this - the parameter you need to set is
330 "mangled names = yes".
331
332 <sect1>My client reports "cannot locate specified computer" or similar<p> 
333 <label id="cant_see_server">
334
335 This indicates one of three things: You supplied an incorrect server
336 name, the underlying TCP/IP layer is not working correctly, or the
337 name you specified cannot be resolved.
338
339 After carefully checking that the name you typed is the name you
340 should have typed, try doing things like pinging a host or telnetting
341 to somewhere on your network to see if TCP/IP is functioning OK. If it
342 is, the problem is most likely name resolution.
343
344 If your client has a facility to do so, hardcode a mapping between the
345 hosts IP and the name you want to use. For example, with Man Manager
346 or Windows for Workgroups you would put a suitable entry in the file
347 LMHOSTS. If this works, the problem is in the communication between
348 your client and the netbios name server. If it does not work, then
349 there is something fundamental wrong with your naming and the solution
350 is beyond the scope of this document.
351
352 If you do not have any server on your subnet supplying netbios name
353 resolution, hardcoded mappings are your only option. If you DO have a
354 netbios name server running (such as the Samba suite's nmbd program),
355 the problem probably lies in the way it is set up. Refer to Section
356 Two of this FAQ for more ideas.
357
358 By the way, remember to REMOVE the hardcoded mapping before further
359 tests :-)     
360
361 <sect1>My client reports "cannot locate specified share name" or similar<p> <label id="cant_see_share">
362
363 This message indicates that your client CAN locate the specified
364 server, which is a good start, but that it cannot find a service of
365 the name you gave.
366
367 The first step is to check the exact name of the service you are
368 trying to connect to (consult your system administrator). Assuming it
369 exists and you specified it correctly (read your client's doco on how
370 to specify a service name correctly), read on:
371
372 <itemize>
373 <item> Many clients cannot accept or use service names longer than eight characters.
374 <item> Many clients cannot accept or use service names containing spaces.
375 <item> Some servers (not Samba though) are case sensitive with service names.
376 <item> Some clients force service names into upper case.
377 </itemize>
378
379 <sect1>My client reports "cannot find domain controller", "cannot log
380 on to the network" or similar <p> <label id="cant_see_net">
381
382 Nothing is wrong - Samba does not implement the primary domain name
383 controller stuff for several reasons, including the fact that the
384 whole concept of a primary domain controller and "logging in to a
385 network" doesn't fit well with clients possibly running on multiuser
386 machines (such as users of smbclient under Unix). Having said that,
387 several developers are working hard on building it in to the next
388 major version of Samba. If you can contribute, send a message to
389 samba-bugs!
390
391 Seeing this message should not affect your ability to mount redirected
392 disks and printers, which is really what all this is about.
393
394 For many clients (including Windows for Workgroups and Lan Manager),
395 setting the domain to STANDALONE at least gets rid of the message.
396
397 <sect1>Printing doesn't work :-(<p> <label id="no_printing">
398
399 Make sure that the specified print command for the service you are
400 connecting to is correct and that it has a fully-qualified path (eg.,
401 use "/usr/bin/lpr" rather than just "lpr").
402
403 Make sure that the spool directory specified for the service is
404 writable by the user connected to the service. In particular the user
405 "nobody" often has problems with printing, even if it worked with an
406 earlier version of Samba. Try creating another guest user other than
407 "nobody".
408
409 Make sure that the user specified in the service is permitted to use
410 the printer.
411
412 Check the debug log produced by smbd. Search for the printer name and
413 see if the log turns up any clues. Note that error messages to do with
414 a service ipc$ are meaningless - they relate to the way the client
415 attempts to retrieve status information when using the LANMAN1
416 protocol.
417
418 If using WfWg then you need to set the default protocol to TCP/IP, not
419 Netbeui. This is a WfWg bug.
420
421 If using the Lanman1 protocol (the default) then try switching to
422 coreplus.  Also not that print status error messages don't mean
423 printing won't work. The print status is received by a different
424 mechanism.
425
426 <sect1>My programs install on the server OK, but refuse to work properly<p>
427 <label id="programs_wont_run">
428
429 There are numerous possible reasons for this, but one MAJOR
430 possibility is that your software uses locking. Make sure you are
431 using Samba 1.6.11 or later. It may also be possible to work around
432 the problem by setting "locking=no" in the Samba configuration file
433 for the service the software is installed on. This should be regarded
434 as a strictly temporary solution.
435
436 In earlier Samba versions there were some difficulties with the very
437 latest Microsoft products, particularly Excel 5 and Word for Windows
438 6. These should have all been solved. If not then please let Andrew
439 Tridgell know via email at <htmlurl url="mailto:samba-bugs@anu.edu.au" name="samba-bugs@anu.edu.au">.
440
441 <sect1>My "server string" doesn't seem to be recognised<p>
442 <label id="bad_server_string">
443
444 my client reports the default setting, eg. "Samba 1.9.15p4", instead
445 of what I have changed it to in the smb.conf file.
446
447 You need to use the -C option in nmbd. The "server string" affects
448 what smbd puts out and -C affects what nmbd puts out. 
449 Current versions of Samba (1.9.16p11 +) have combined these options into
450 the "server string" field of smb.conf, -C for nmbd is now obsolete.
451
452 <sect1>My client reports "This server is not configured to list shared
453 resources" <p> <label id="cant_list_shares">
454
455 Your guest account is probably invalid for some reason. Samba uses the
456 guest account for browsing in smbd.  Check that your guest account is
457 valid.
458
459 See also 'guest account' in smb.conf man page.
460
461 <sect1>Log message "you appear to have a trapdoor uid system" <p>
462 <label id="trapdoor_uid">
463
464 This can have several causes. It might be because you are using a uid
465 or gid of 65535 or -1. This is a VERY bad idea, and is a big security
466 hole. Check carefully in your /etc/passwd file and make sure that no
467 user has uid 65535 or -1. Especially check the "nobody" user, as many
468 broken systems are shipped with nobody setup with a uid of 65535.
469
470 It might also mean that your OS has a trapdoor uid/gid system :-)
471
472 This means that once a process changes effective uid from root to
473 another user it can't go back to root. Unfortunately Samba relies on
474 being able to change effective uid from root to non-root and back
475 again to implement its security policy. If your OS has a trapdoor uid
476 system this won't work, and several things in Samba may break. Less
477 things will break if you use user or server level security instead of
478 the default share level security, but you may still strike
479 problems.
480
481 The problems don't give rise to any security holes, so don't panic,
482 but it does mean some of Samba's capabilities will be unavailable.
483 In particular you will not be able to connect to the Samba server as
484 two different uids at once. This may happen if you try to print as a
485 "guest" while accessing a share as a normal user. It may also affect
486 your ability to list the available shares as this is normally done as
487 the guest user.
488
489 Complain to your OS vendor and ask them to fix their system.
490
491 Note: the reason why 65535 is a VERY bad choice of uid and gid is that
492 it casts to -1 as a uid, and the setreuid() system call ignores (with
493 no error) uid changes to -1. This means any daemon attempting to run
494 as uid 65535 will actually run as root. This is not good!
495
496 <sect>Common client questions<p> <label id="client_questions">
497
498 <sect1>Are any Macintosh clients for Samba<p> <label id="mac_clients">
499
500 lkcl - update 09mar97 - the answer is "Yes!".  Thursby now have a
501 CIFS Client / Server - see <url url="http://www.thursby.com/">.  They test it against
502 Windows 95, Windows NT and samba for compatibility issues.  At
503 present, DAVE is at version 1.0.0.  DAVE version 1.0.1 is in beta,
504 and will be released in April 97 (the speed of finder copies has
505 been greatly enhanced, and there are bug-fixes included).
506
507 Alternatives - There are two free implementations of AppleTalk for
508 several kinds of UNIX machnes, and several more commercial ones.
509 These products allow you to run file services and print services
510 natively to Macintosh users, with no additional support required on
511 the Macintosh.  The two free omplementations are Netatalk,
512 <url url="http://www.umich.edu/~rsug/netatalk/">, and CAP, 
513 <url url="http://www.cs.mu.oz.au/appletalk/atalk.html">.  What Samba offers 
514 MS Windows users, these packages offer to Macs.  For more info on
515 these packages, Samba, and Linux (and other UNIX-based systems)
516 see <url url="http://www.eats.com/linux_mac_win.html">
517
518 <sect1>"Session request failed (131,130)" error<p> <label id="sess_req_fail">
519
520 The following answer is provided by John E. Miller:
521
522 I'll assume that you're able to ping back and forth between the
523 machines by IP address and name, and that you're using some security
524 model where you're confident that you've got user IDs and passwords
525 right.  The logging options (-d3 or greater) can help a lot with that.
526 DNS and WINS configuration can also impact connectivity as well.
527
528 Now, on to 'scope id's.  Somewhere in your Win95 TCP/IP network
529 configuration (I'm too much of an NT bigot to know where it's located
530 in the Win95 setup, but I'll have to learn someday since I teach for a
531 Microsoft Solution Provider Authorized Tech Education Center - what an
532 acronym...) [Note: It's under Control Panel | Network | TCP/IP | WINS
533 Configuration] there's a little text entry field called something like
534 'Scope ID'.
535
536 This field essentially creates 'invisible' sub-workgroups on the same
537 wire.  Boxes can only see other boxes whose Scope IDs are set to the
538 exact same value - it's sometimes used by OEMs to configure their
539 boxes to browse only other boxes from the same vendor and, in most
540 environments, this field should be left blank.  If you, in fact, have
541 something in this box that EXACT value (case-sensitive!) needs to be
542 provided to smbclient and nmbd as the -i (lowercase) parameter. So, if
543 your Scope ID is configured as the string 'SomeStr' in Win95 then
544 you'd have to use smbclient -iSomeStr [otherparms] in connecting to
545 it.
546
547 <sect1>How do I synchronise my PC's clock with my Samba server? <p>
548 <label id="synchronise_clock">
549
550 To syncronize your PC's clock with your Samba server:
551
552 <itemize>
553 <item> Copy timesync.pif to your windows directory
554  <item> timesync.pif can be found at:
555     <url url="http://samba.canberra.edu.au/pub/samba/binaries/miscellaneous/timesync.pif">
556 <item> Add timesync.pif to your 'Start Up' group/folder
557 <item> Open the properties dialog box for the program/icon
558 <item> Make sure the 'Run Minimized' option is set in program 'Properties'
559 <iteM> Change the command line section that reads \\sambahost to reflect the name of your server.
560 <item> Close the properties dialog box by choosing 'OK'
561 </itemize>
562
563 Each time you start your computer (or login for Win95) your PC will
564 synchronize it's clock with your Samba server.
565
566 Alternativley, if you clients support Domain Logons, you can setup Domain Logons with Samba
567  - see: <url url="ftp://samba.anu.edu.au/pub/samba/docs/BROWSING.txt" name="BROWSING.txt"> *** for more information.
568 <p>Then add 
569 <tscreen><verb>
570 NET TIME \\%L /SET /YES
571 </verb></tscreen>
572 as one of the lines in the logon script.
573 <sect1>Problems with WinDD, NTrigue, WinCenterPro etc<p>
574 <label id="multiple_session_clients">
575
576 All of the above programs are applications that sit on an NT box and
577 allow multiple users to access the NT GUI applications from remote
578 workstations (often over X).
579
580 What has this got to do with Samba? The problem comes when these users
581 use filemanager to mount shares from a Samba server. The most common
582 symptom is that the first user to connect get correct file permissions
583 and has a nice day, but subsequent connections get logged in as the
584 same user as the first person to login. They find that they cannot
585 access files in their own home directory, but that they can access
586 files in the first users home directory (maybe not such a nice day
587 after all?)
588
589 Why does this happen? The above products all share a common heritage
590 (and code base I believe). They all open just a single TCP based SMB
591 connection to the Samba server, and requests from all users are piped
592 over this connection. This is unfortunate, but not fatal.
593
594 It means that if you run your Samba server in share level security
595 (the default) then things will definately break as described
596 above. The share level SMB security model has no provision for
597 multiple user IDs on the one SMB connection. See security_level.txt in
598 the docs for more info on share/user/server level security.
599
600 If you run in user or server level security then you have a chance,
601 but only if you have a recent version of Samba (at least 1.9.15p6). In
602 older versions bugs in Samba meant you still would have had problems.
603
604 If you have a trapdoor uid system in your OS then it will never work
605 properly. Samba needs to be able to switch uids on the connection and
606 it can't if your OS has a trapdoor uid system. You'll know this
607 because Samba will note it in your logs.
608
609 Also note that you should not use the magic "homes" share name with
610 products like these, as otherwise all users will end up with the same
611 home directory. Use \\server\username instead.
612
613 <sect1>Problem with printers under NT<p> <label id="nt_printers">
614
615 This info from Stefan Hergeth
616 hergeth@f7axp1.informatik.fh-muenchen.de may be useful:
617
618  A network-printer (with ethernetcard) is connected to the NT-Clients
619 via our UNIX-Fileserver (SAMBA-Server), like the configuration told by
620  Matthew Harrell harrell@leech.nrl.navy.mil (see WinNT.txt)
621 <enum>
622 <item>If a user has choosen this printer as the default printer in his
623      NT-Session and this printer is not connected to the network
624      (e.g. switched off) than this user has a problem with the SAMBA-
625      connection of his filesystems. It's very slow.
626
627 <item>If the printer is connected to the network everything works fine.
628
629 <item>When the smbd ist started with debug level 3, you can see that the
630      NT spooling system try to connect to the printer many times. If the
631      printer ist not connected to the network this request fails and the
632      NT spooler is wasting a lot of time to connect to the printer service.
633      This seems to be the reason for the slow network connection.
634
635 <item>Maybe it's possible to change this behaviour by setting different 
636      printer properties in the Print-Manager-Menu of NT, but i didn't try it yet.
637 </enum>
638
639 <sect1>Why are my file's timestamps off by an hour, or by a few hours?<p>
640 <label id="dst_bugs">
641
642 This is from Paul Eggert eggert@twinsun.com.
643
644 Most likely it's a problem with your time zone settings.
645
646 Internally, Samba maintains time in traditional Unix format,
647 namely, the number of seconds since 1970-01-01 00:00:00 Universal Time
648 (or ``GMT''), not counting leap seconds.
649
650 On the server side, Samba uses the Unix TZ variable to convert
651 internal timestamps to and from local time.  So on the server side, there are
652 two things to get right.
653 <enum>
654 <item>The Unix system clock must have the correct Universal time.
655         Use the shell command "sh -c 'TZ=UTC0 date'" to check this.
656
657 <item>The TZ environment variable must be set on the server
658         before Samba is invoked.  The details of this depend on the
659         server OS, but typically you must edit a file whose name is
660         /etc/TIMEZONE or /etc/default/init, or run the command `zic -l'.
661
662 <item>TZ must have the correct value.
663 <enum>
664       <item>If possible, use geographical time zone settings
665                 (e.g. TZ='America/Los_Angeles' or perhaps
666                 TZ=':US/Pacific').  These are supported by most
667                 popular Unix OSes, are easier to get right, and are
668                 more accurate for historical timestamps.  If your
669                 operating system has out-of-date tables, you should be
670                 able to update them from the public domain time zone
671                 tables at <url url="ftp://elsie.nci.nih.gov/pub/">.
672
673       <item>If your system does not support geographical timezone
674                 settings, you must use a Posix-style TZ strings, e.g.
675                 TZ='PST8PDT,M4.1.0/2,M10.5.0/2' for US Pacific time.
676                 Posix TZ strings can take the following form (with optional
677                 items in brackets):
678 <verb>
679                         StdOffset[Dst[Offset],Date/Time,Date/Time]
680 </verb>
681                 where:
682 <itemize>
683 <item>                        `Std' is the standard time designation (e.g. `PST').
684
685 <item>                        `Offset' is the number of hours behind UTC (e.g. `8').
686                         Prepend a `-' if you are ahead of UTC, and
687                         append `:30' if you are at a half-hour offset.
688                         Omit all the remaining items if you do not use
689                         daylight-saving time.
690
691 <item>                        `Dst' is the daylight-saving time designation
692                         (e.g. `PDT').
693
694                         The optional second `Offset' is the number of
695                         hours that daylight-saving time is behind UTC.
696                         The default is 1 hour ahead of standard time.
697
698 <item>                        `Date/Time,Date/Time' specify when daylight-saving
699                         time starts and ends.  The format for a date is
700                         `Mm.n.d', which specifies the dth day (0 is Sunday)
701                         of the nth week of the mth month, where week 5 means
702                         the last such day in the month.  The format for a
703                         time is [h]h[:mm[:ss]], using a 24-hour clock.
704 </itemize>
705                 Other Posix string formats are allowed but you don't want
706                 to know about them.
707 </enum>
708 </enum>
709 On the client side, you must make sure that your client's clock and
710 time zone is also set appropriately.  [[I don't know how to do this.]]
711 Samba traditionally has had many problems dealing with time zones, due
712 to the bizarre ways that Microsoft network protocols handle time
713 zones.  A common symptom is for file timestamps to be off by an hour.
714 To work around the problem, try disconnecting from your Samba server
715 and then reconnecting to it; or upgrade your Samba server to
716 1.9.16alpha10 or later.
717
718 <sect1> How do I set the printer driver name correctly? <p>
719 <label id="printer_driver_name">
720
721 Question:
722  On NT, I opened "Printer Manager" and "Connect to Printer".
723  Enter "\\ptdi270\ps1" in the box of printer. I got the
724  following error message:
725 <tscreen><verb>
726      You do not have sufficient access to your machine
727      to connect to the selected printer, since a driver
728      needs to be installed locally.
729 </verb></tscreen>
730 Answer:
731
732 In the more recent versions of Samba you can now set the "printer
733 driver" in smb.conf. This tells the client what driver to use. For
734 example, I have:
735 <tscreen><verb>
736      printer driver = HP LaserJet 4L
737 </verb></tscreen>
738 and NT knows to use the right driver. You have to get this string
739 exactly right.
740
741 To find the exact string to use, you need to get to the dialog box in
742 your client where you select which printer driver to install. The
743 correct strings for all the different printers are shown in a listbox
744 in that dialog box.
745
746 You could also try setting the driver to NULL like this:
747 <tscreen><verb>
748      printer driver = NULL
749 </verb></tscreen>
750 this is effectively what older versions of Samba did, so if that
751 worked for you then give it a go. If this does work then let me know
752 and I'll make it the default. Currently the default is a 0 length
753 string.
754
755 <sect>Specific client application problems<p> <label id="client_problems">
756
757 <sect1>MS Office Setup reports "Cannot change properties of "\MSOFFICE\SETUP.INI"<p> 
758 <label id="cant_change_properties">
759
760 When installing MS Office on a Samba drive for which you have admin
761 user permissions, ie. admin users = username, you will find the
762 setup program unable to complete the installation.
763
764 To get around this problem, do the installation without admin user
765 permissions The problem is that MS Office Setup checks that a file is
766 rdonly by trying to open it for writing.
767
768 Admin users can always open a file for writing, as they run as root.
769 You just have to install as a non-admin user and then use "chown -R"
770 to fix the owner.
771
772 <sect>Miscellaneous<p> <label id="miscellaneous">
773
774
775 </article>