b9f4cf3a938eb5eedf34fd292d3ab8c68026f1c9
[samba.git] / docs / docbook / projdoc / Other-Clients.xml
1 <chapter id="Other-Clients">
2 <chapterinfo>
3         &author.jmcd;
4         &author.jelmer;
5         
6         <pubdate>5 Mar 2001</pubdate>
7 </chapterinfo>
8
9 <title>Samba and other CIFS clients</title>
10
11 <para>This chapter contains client-specific information.</para>
12
13 <sect1>
14 <title>Macintosh clients?</title>
15
16 <para>
17 Yes. <ulink url="http://www.thursby.com/">Thursby</ulink> now have a CIFS Client / Server called <ulink url="http://www.thursby.com/products/dave.html">DAVE</ulink>
18 </para>
19
20 <para>
21 They test it against Windows 95, Windows NT and samba for
22 compatibility issues.  At the time of writing, DAVE was at version
23 1.0.1. The 1.0.0 to 1.0.1 update is available as a free download from
24 the Thursby web site (the speed of finder copies has been greatly
25 enhanced, and there are bug-fixes included).
26 </para>
27
28 <para> 
29 Alternatives - There are two free implementations of AppleTalk for
30 several kinds of UNIX machnes, and several more commercial ones.
31 These products allow you to run file services and print services
32 natively to Macintosh users, with no additional support required on
33 the Macintosh.  The two free omplementations are 
34 <ulink url="http://www.umich.edu/~rsug/netatalk/">Netatalk</ulink>, and 
35 <ulink url="http://www.cs.mu.oz.au/appletalk/atalk.html">CAP</ulink>.  
36 What Samba offers MS
37 Windows users, these packages offer to Macs.  For more info on these
38 packages, Samba, and Linux (and other UNIX-based systems) see
39 <ulink url="http://www.eats.com/linux_mac_win.html">http://www.eats.com/linux_mac_win.html</ulink>
40 </para>
41
42 </sect1>
43
44 <sect1>
45 <title>OS2 Client</title>
46
47         <sect2>
48                 <title>How can I configure OS/2 Warp Connect or 
49                 OS/2 Warp 4 as a client for Samba?</title>
50
51                 <para>A more complete answer to this question can be 
52                 found on <ulink url="http://carol.wins.uva.nl/~leeuw/samba/warp.html">
53                 http://carol.wins.uva.nl/~leeuw/samba/warp.html</ulink>.</para>
54                 
55                 <para>Basically, you need three components:</para>
56                 
57                 <itemizedlist>
58                         <listitem><para>The File and Print Client ('IBM Peer')
59                         </para></listitem>
60                         <listitem><para>TCP/IP ('Internet support') 
61                         </para></listitem>
62                         <listitem><para>The "NetBIOS over TCP/IP" driver ('TCPBEUI')
63                         </para></listitem>
64                 </itemizedlist>
65                 
66                 <para>Installing the first two together with the base operating 
67                 system on a blank system is explained in the Warp manual. If Warp 
68                 has already been installed, but you now want to install the 
69                 networking support, use the "Selective Install for Networking" 
70                 object in the "System Setup" folder.</para>
71
72                 <para>Adding the "NetBIOS over TCP/IP" driver is not described 
73                 in the manual and just barely in the online documentation. Start 
74                 MPTS.EXE, click on OK, click on "Configure LAPS" and click 
75                 on "IBM OS/2 NETBIOS OVER TCP/IP" in  'Protocols'.  This line 
76                 is then moved to 'Current Configuration'. Select that line, 
77                 click on "Change number" and increase it from 0 to 1. Save this
78                 configuration.</para>
79
80                 <para>If the Samba server(s) is not on your local subnet, you 
81                 can optionally add IP names and addresses of these servers 
82                 to the "Names List", or specify a  WINS server ('NetBIOS 
83                 Nameserver' in IBM and RFC terminology). For Warp Connect you 
84                 may need to download an update for 'IBM Peer' to bring it on 
85                 the same level as Warp 4. See the webpage mentioned above.</para>
86         </sect2>
87         
88         <sect2>
89                 <title>How can I configure OS/2 Warp 3 (not Connect), 
90                 OS/2 1.2, 1.3 or 2.x for Samba?</title>
91                 
92                 <para>You can use the free Microsoft LAN Manager 2.2c Client 
93                 for OS/2 from 
94                 <ulink url="ftp://ftp.microsoft.com/BusSys/Clients/LANMAN.OS2/">
95                 ftp://ftp.microsoft.com/BusSys/Clients/LANMAN.OS2/</ulink>.
96         See <ulink url="http://carol.wins.uva.nl/~leeuw/lanman.html">
97                 http://carol.wins.uva.nl/~leeuw/lanman.html</ulink> for 
98                 more information on how to install and use this client. In 
99                 a nutshell, edit the file \OS2VER in the root directory of 
100                 the OS/2 boot partition and add the lines:</para>
101                 
102                 <para><programlisting>
103                 20=setup.exe
104                 20=netwksta.sys
105                 20=netvdd.sys
106                 </programlisting></para>
107                 
108                 <para>before you install the client. Also, don't use the 
109                 included NE2000 driver because it is buggy. Try the NE2000 
110                 or NS2000 driver from 
111                 <ulink url="ftp://ftp.cdrom.com/pub/os2/network/ndis/">
112                 ftp://ftp.cdrom.com/pub/os2/network/ndis/</ulink> instead.
113                 </para>
114         </sect2>
115         
116         <sect2>
117                 <title>Are there any other issues when OS/2 (any version) 
118                 is used as a client?</title>
119                 
120                 <para>When you do a NET VIEW or use the "File and Print 
121                 Client Resource Browser", no Samba servers show up. This can 
122                 be fixed by a patch from <ulink
123                 url="http://carol.wins.uva.nl/~leeuw/samba/fix.html">
124                 http://carol.wins.uva.nl/~leeuw/samba/fix.html</ulink>.
125                 The patch will be included in a later version of Samba. It also 
126                 fixes a couple of other problems, such as preserving long 
127                 filenames when objects are dragged from the Workplace Shell 
128                 to the Samba server. </para>
129         </sect2>
130         
131         <sect2>
132                 <title>How do I get printer driver download working 
133                 for OS/2 clients?</title>
134
135                 <para>First, create a share called [PRINTDRV] that is 
136                 world-readable.  Copy your OS/2 driver files there.  Note 
137                 that the .EA_ files must still be separate, so you will need 
138                 to use the original install files, and not copy an installed 
139                 driver from an OS/2 system.</para>
140                 
141                 <para>Install the NT driver first for that printer.  Then, 
142                 add to your smb.conf a parameter, os2 driver map = 
143                 <replaceable>filename</replaceable>".  Then, in the file 
144                 specified by <replaceable>filename</replaceable>, map the 
145                 name of the NT driver name to the OS/2 driver name as 
146                 follows:</para>
147                 
148                 <para><command>nt driver name = os2 "driver 
149                 name"."device name"</command>, e.g.:
150                 HP LaserJet 5L = LASERJET.HP LaserJet 5L</para>
151
152                 <para>You can have multiple drivers mapped in this file.</para>
153         
154                 <para>If you only specify the OS/2 driver name, and not the 
155                 device name, the first attempt to download the driver will 
156                 actually download the files, but the OS/2 client will tell 
157                 you the driver is not available.  On the second attempt, it 
158                 will work.  This is fixed simply by adding the device name
159                  to the mapping, after which it will work on the first attempt.
160                 </para>
161         </sect2>
162 </sect1>
163
164 <sect1>
165 <title>Windows for Workgroups</title>
166
167 <sect2>
168 <title>Use latest TCP/IP stack from Microsoft</title>
169
170 <para>Use the latest TCP/IP stack from microsoft if you use Windows
171 for workgroups. 
172 </para>
173
174 <para>The early TCP/IP stacks had lots of bugs.</para>
175
176 <para> 
177 Microsoft has released an incremental upgrade to their TCP/IP 32-Bit
178 VxD drivers.  The latest release can be found on their ftp site at
179 ftp.microsoft.com, located in /peropsys/windows/public/tcpip/wfwt32.exe.
180 There is an update.txt file there that describes the problems that were
181 fixed.  New files include WINSOCK.DLL, TELNET.EXE, WSOCK.386, VNBT.386,
182 WSTCP.386, TRACERT.EXE, NETSTAT.EXE, and NBTSTAT.EXE.
183 </para>
184
185 </sect2>
186
187 <sect2>
188 <title>Delete .pwl files after password change</title>
189
190 <para>
191 WfWg does a lousy job with passwords. I find that if I change my
192 password on either the unix box or the PC the safest thing to do is to
193 delete the .pwl files in the windows directory. The PC will complain about not finding the files, but will soon get over it, allowing you to enter the new password.
194 </para>
195
196 <para> 
197 If you don't do this you may find that WfWg remembers and uses the old
198 password, even if you told it a new one.
199 </para>
200
201 <para> 
202 Often WfWg will totally ignore a password you give it in a dialog box.
203 </para>
204
205 </sect2>
206
207 <sect2>
208 <title>Configure WfW password handling</title>
209
210 <para>
211 There is a program call admincfg.exe
212 on the last disk (disk 8) of the WFW 3.11 disk set.  To install it
213 type EXPAND A:\ADMINCFG.EX_ C:\WINDOWS\ADMINCFG.EXE Then add an icon
214 for it via the "Progam Manager" "New" Menu.  This program allows you
215 to control how WFW handles passwords.  ie disable Password Caching etc
216 for use with <command>security = user</command>
217 </para>
218
219 </sect2>
220
221 <sect2>
222 <title>Case handling of passwords</title>
223
224 <para>Windows for Workgroups uppercases the password before sending it to the server. Unix passwords can be case-sensitive though. Check the <ulink url="smb.conf.5.html">smb.conf(5)</ulink> information on <command>password level</command> to specify what characters samba should try to uppercase when checking.</para>
225
226 </sect2>
227
228 <sect2>
229 <title>Use TCP/IP as default protocol</title>
230
231 <para>To support print queue reporting you may find
232 that you have to use TCP/IP as the default protocol under
233 WfWg. For some reason if you leave Netbeui as the default
234 it may break the print queue reporting on some systems.
235 It is presumably a WfWg bug.</para>
236
237 </sect2>
238
239 <sect2>
240 <title>Speed improvement</title>
241
242 <para>
243 Note that some people have found that setting DefaultRcvWindow in
244 the [MSTCP] section of the SYSTEM.INI file under WfWg to 3072 gives a
245 big improvement. I don't know why.
246 </para>
247
248 <para>
249 My own experience wth DefaultRcvWindow is that I get much better
250 performance with a large value (16384 or larger). Other people have
251 reported that anything over 3072 slows things down enourmously. One
252 person even reported a speed drop of a factor of 30 when he went from
253 3072 to 8192. I don't know why.
254 </para>
255 </sect2>
256 </sect1>
257
258 <sect1>
259 <title>Windows '95/'98</title>
260
261 <para>
262 When using Windows 95 OEM SR2 the following updates are recommended where Samba
263 is being used. Please NOTE that the above change will affect you once these
264 updates  have been installed.
265 </para>
266
267 <para> 
268 There are more updates than the ones mentioned here. You are referred to the
269 Microsoft Web site for all currently available updates to your specific version
270 of Windows 95.
271 </para>
272
273 <orderedlist>
274 <listitem><para>Kernel Update: KRNLUPD.EXE</para></listitem>
275 <listitem><para>Ping Fix: PINGUPD.EXE</para></listitem>
276 <listitem><para>RPC Update: RPCRTUPD.EXE</para></listitem>
277 <listitem><para>TCP/IP Update: VIPUPD.EXE</para></listitem>
278 <listitem><para>Redirector Update: VRDRUPD.EXE</para></listitem>
279 </orderedlist>
280
281 <para>
282 Also, if using MS OutLook it is desirable to install the OLEUPD.EXE fix. This
283 fix may stop your machine from hanging for an extended period when exiting
284 OutLook and you may also notice a significant speedup when accessing network
285 neighborhood services.
286 </para>
287
288 <sect2>
289 <title>Speed improvement</title>
290
291 <para>
292 Configure the win95 TCPIP registry settings to give better
293 performance. I use a program called MTUSPEED.exe which I got off the
294 net. There are various other utilities of this type freely available.
295 </para>
296
297 </sect2>
298
299 </sect1>
300
301 <sect1>
302 <title>Windows 2000 Service Pack 2</title>
303
304 <para> 
305 There are several annoyances with Windows 2000 SP2. One of which
306 only appears when using a Samba server to host user profiles
307 to Windows 2000 SP2 clients in a Windows domain.  This assumes
308 that Samba is a member of the domain, but the problem will
309 likely occur if it is not.
310 </para>
311
312 <para> 
313 In order to serve profiles successfully to Windows 2000 SP2 
314 clients (when not operating as a PDC), Samba must have 
315 <command>nt acl support = no</command>
316 added to the file share which houses the roaming profiles.
317 If this is not done, then the Windows 2000 SP2 client will
318 complain about not being able to access the profile (Access 
319 Denied) and create multiple copies of it on disk (DOMAIN.user.001,
320 DOMAIN.user.002, etc...).  See the 
321 <ulink url="smb.conf.5.html">smb.conf(5)</ulink> man page
322 for more details on this option.  Also note that the 
323 <command>nt acl support</command> parameter was formally a global parameter in
324 releases prior to Samba 2.2.2.
325 </para>
326
327 <para> 
328 The following is a minimal profile share:
329 </para>
330
331 <para><programlisting>
332         [profile]
333                 path = /export/profile
334                 create mask = 0600
335                 directory mask = 0700
336                 nt acl support = no
337                 read only = no
338 </programlisting></para>
339
340 <para>
341 The reason for this bug is that the Win2k SP2 client copies
342 the security descriptor for the profile which contains
343 the Samba server's SID, and not the domain SID.  The client
344 compares the SID for SAMBA\user and realizes it is
345 different that the one assigned to DOMAIN\user.  Hence the reason
346 for the "access denied" message.
347 </para>
348
349 <para>
350 By disabling the <command>nt acl support</command> parameter, Samba will send
351 the Win2k client a response to the QuerySecurityDescriptor
352 trans2 call which causes the client to set a default ACL
353 for the profile. This default ACL includes 
354 </para>
355
356 <para><command>DOMAIN\user      "Full Control"</command></para>
357
358 <note><para>This bug does not occur when using winbind to
359 create accounts on the Samba host for Domain users.</para></note>
360
361 </sect1>
362
363 <sect1>
364 <title>Windows NT 3.1</title>
365
366 <para>If you have problems communicating across routers with Windows 
367 NT 3.1 workstations, read <ulink url="http://support.microsoft.com/default.aspx?scid=kb;[LN];Q103765">this Microsoft Knowledge Base article</ulink>.
368
369 </para>
370
371 </sect1>
372
373 </chapter>