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