another merge from 2.2
[Samba/gbeck.git] / docs / docbook / projdoc / OS2-Client-HOWTO.sgml
blob5db80cda3d7b6e16be1de8b6249ee7d731ef3cbf
1 <chapter>
4 <chapterinfo>
5 <author>
6 <firstname>Jim</firstname><surname>McDonough</surname>
7 <affiliation>
8 <orgname>IBM</orgname>
9 <address>
10 <email>jerry@samba.org</email>
11 </address>
12 </affiliation>
13 </author>
16 <pubdate>5 Mar 2001</pubdate>
17 </chapterinfo>
19 <title>OS2 Client HOWTO</title>
21 <sect1>
22 <title>FAQs</title>
24 <sect2>
25 <title>How can I configure OS/2 Warp Connect or
26 OS/2 Warp 4 as a client for Samba?</title>
28 <para>A more complete answer to this question can be
29 found on <ulink url="http://carol.wins.uva.nl/~leeuw/samba/warp.html">
30 http://carol.wins.uva.nl/~leeuw/samba/warp.html</ulink>.</para>
32 <para>Basically, you need three components:</para>
34 <itemizedlist>
35 <listitem><para>The File and Print Client ('IBM Peer')
36 </para></listitem>
37 <listitem><para>TCP/IP ('Internet support')
38 </para></listitem>
39 <listitem><para>The "NetBIOS over TCP/IP" driver ('TCPBEUI')
40 </para></listitem>
41 </itemizedlist>
43 <para>Installing the first two together with the base operating
44 system on a blank system is explained in the Warp manual. If Warp
45 has already been installed, but you now want to install the
46 networking support, use the "Selective Install for Networking"
47 object in the "System Setup" folder.</para>
49 <para>Adding the "NetBIOS over TCP/IP" driver is not described
50 in the manual and just barely in the online documentation. Start
51 MPTS.EXE, click on OK, click on "Configure LAPS" and click
52 on "IBM OS/2 NETBIOS OVER TCP/IP" in 'Protocols'. This line
53 is then moved to 'Current Configuration'. Select that line,
54 click on "Change number" and increase it from 0 to 1. Save this
55 configuration.</para>
57 <para>If the Samba server(s) is not on your local subnet, you
58 can optionally add IP names and addresses of these servers
59 to the "Names List", or specify a WINS server ('NetBIOS
60 Nameserver' in IBM and RFC terminology). For Warp Connect you
61 may need to download an update for 'IBM Peer' to bring it on
62 the same level as Warp 4. See the webpage mentioned above.</para>
63 </sect2>
65 <sect2>
66 <title>How can I configure OS/2 Warp 3 (not Connect),
67 OS/2 1.2, 1.3 or 2.x for Samba?</title>
69 <para>You can use the free Microsoft LAN Manager 2.2c Client
70 for OS/2 from
71 <ulink url="ftp://ftp.microsoft.com/BusSys/Clients/LANMAN.OS2/">
72 ftp://ftp.microsoft.com/BusSys/Clients/LANMAN.OS2/</ulink>.
73 See <ulink url="http://carol.wins.uva.nl/~leeuw/lanman.html">
74 http://carol.wins.uva.nl/~leeuw/lanman.html</ulink> for
75 more information on how to install and use this client. In
76 a nutshell, edit the file \OS2VER in the root directory of
77 the OS/2 boot partition and add the lines:</para>
79 <para><programlisting>
80 20=setup.exe
81 20=netwksta.sys
82 20=netvdd.sys
83 </programlisting></para>
85 <para>before you install the client. Also, don't use the
86 included NE2000 driver because it is buggy. Try the NE2000
87 or NS2000 driver from
88 <ulink url="ftp://ftp.cdrom.com/pub/os2/network/ndis/">
89 ftp://ftp.cdrom.com/pub/os2/network/ndis/</ulink> instead.
90 </para>
91 </sect2>
93 <sect2>
94 <title>Are there any other issues when OS/2 (any version)
95 is used as a client?</title>
97 <para>When you do a NET VIEW or use the "File and Print
98 Client Resource Browser", no Samba servers show up. This can
99 be fixed by a patch from <ulink
100 url="http://carol.wins.uva.nl/~leeuw/samba/fix.html">
101 http://carol.wins.uva.nl/~leeuw/samba/fix.html</ulink>.
102 The patch will be included in a later version of Samba. It also
103 fixes a couple of other problems, such as preserving long
104 filenames when objects are dragged from the Workplace Shell
105 to the Samba server. </para>
106 </sect2>
108 <sect2>
109 <title>How do I get printer driver download working
110 for OS/2 clients?</title>
112 <para>First, create a share called [PRINTDRV] that is
113 world-readable. Copy your OS/2 driver files there. Note
114 that the .EA_ files must still be separate, so you will need
115 to use the original install files, and not copy an installed
116 driver from an OS/2 system.</para>
118 <para>Install the NT driver first for that printer. Then,
119 add to your smb.conf a paramater, "os2 driver map =
120 <replaceable>filename</replaceable>". Then, in the file
121 specified by <replaceable>filename</replaceable>, map the
122 name of the NT driver name to the OS/2 driver name as
123 follows:</para>
125 <para>&lt;nt driver name&gt; = &lt;os2 driver
126 name&gt;.&lt;device name&gt;, e.g.:
127 HP LaserJet 5L = LASERJET.HP LaserJet 5L</para>
129 <para>You can have multiple drivers mapped in this file.</para>
131 <para>If you only specify the OS/2 driver name, and not the
132 device name, the first attempt to download the driver will
133 actually download the files, but the OS/2 client will tell
134 you the driver is not available. On the second attempt, it
135 will work. This is fixed simply by adding the device name
136 to the mapping, after which it will work on the first attempt.
137 </para>
138 </sect2>
139 </sect1>
141 </chapter>