Remove questions that have been moved to 'Common Errors' in the HOWTO Collection.
[sfrench/samba-autobuild/.git] / docs / docbook / faq / features.xml
1 <chapter id="FAQ-features">
2
3 <title>Features</title>
4
5 <sect1>
6 <title>How can I use samba as a fax server?</title>
7
8 <para>Contributor: <ulink url="mailto:zuber@berlin.snafu.de">Gerhard Zuber</ulink></para>
9
10 <para>Requirements:
11 <simplelist>
12 <member>UNIX box (Linux preferred) with SAMBA and a faxmodem</member>
13 <member>ghostscript package</member>
14 <member>mgetty+sendfax package</member>
15 <member>pbm package (portable bitmap tools)</member>
16 </simplelist>
17 </para>
18
19 <para>First, install and configure the required packages. Be sure to read the mgetty+sendfax 
20 manual carefully.</para>
21
22 <sect2>
23 <title>Tools for printing faxes</title>
24
25 <para>Your incomed faxes are in:
26 <filename>/var/spool/fax/incoming</filename>. Print it with:</para>
27
28 <para><programlisting>
29 for i in *
30 do
31 g3cat $i | g3tolj | lpr -P hp
32 done
33 </programlisting>
34 </para>
35
36 <para>
37 g3cat is in the tools-section, g3tolj is in the contrib-section
38 for printing to HP lasers.
39 </para>
40
41 <para>
42 If you want to produce files for displaying and printing with Windows, use
43 some tools from the pbm-package like the following command: <command>g3cat $i | g3topbm - |  ppmtopcx - >$i.pcx</command>
44 and view it with your favourite Windows tool (maybe paintbrush)
45 </para>
46
47 </sect2>
48
49 <sect2>
50 <title>Making the fax-server</title>
51
52 <para>fetch the file <filename>mgetty+sendfax/frontends/winword/faxfilter</filename> and place it in <filename>/usr/local/etc/mgetty+sendfax/</filename>(replace /usr/local/ with whatever place you installed mgetty+sendfax)</para>
53
54 <para>prepare your faxspool file as mentioned in this file
55 edit fax/faxspool.in and reinstall or change the final
56 /usr/local/bin/faxspool too.
57 </para>
58
59 <para><programlisting>
60 if [ "$user" = "root" -o "$user" = "fax" -o \
61      "$user" = "lp" -o "$user" = "daemon" -o "$user" = "bin" ]
62 </programlisting></para>
63
64 <para>find the first line and change it to the second.</para>
65
66 <para>
67 make sure you have pbmtext (from the pbm-package). This is
68 needed for creating the small header line on each page.
69 </para>
70
71 <para>Prepare your faxheader <filename>/usr/local/etc/mgetty+sendfax/faxheader</filename></para>
72
73 <para>
74 Edit your /etc/printcap file:
75 <programlisting>
76 # FAX 
77 lp3|fax:\
78         :lp=/dev/null:\
79         :sd=/usr/spool/lp3:\
80         :if=/usr/local/etc/mgetty+sendfax/faxfilter:sh:sf:mx#0:\
81         :lf=/usr/spool/lp3/fax-log:
82 </programlisting></para>
83
84 <para>Now, edit your <filename>smb.conf</filename> so you have a smb based printer named "fax"</para>
85
86 </sect2>
87
88 <sect2>
89 <title>Installing the client drivers</title>
90
91 <para>
92 Now you have a printer called "fax" which can be used via
93 TCP/IP-printing (lpd-system) or via SAMBA (windows printing).
94 </para>
95
96 <para>
97 On every system you are able to produce postscript-files you
98 are ready to fax.
99 </para>
100
101 <para>
102 On Windows 3.1 95 and NT:
103 </para>
104
105 <para>
106 Install a printer wich produces postscript output,
107    e.g.  apple laserwriter
108 </para>
109
110 <para>Connect the "fax" to your printer.</para>
111
112 <para>
113 Now write your first fax. Use your favourite wordprocessor,
114 write, winword, notepad or whatever you want, and start
115 with the headerpage.
116 </para>
117
118 <para>
119 Usually each fax has a header page. It carries your name,
120 your address, your phone/fax-number.
121 </para>
122
123 <para>
124 It carries also the recipient, his address and his *** fax
125 number ***. Now here is the trick:
126 </para>
127
128 <para>
129 Use the text:
130 <programlisting>
131 Fax-Nr: 123456789
132 </programlisting>
133 as the recipients fax-number. Make sure this text does not
134 occur in regular text ! Make sure this text is not broken
135 by formatting information, e.g. format it as a single entity.
136 (Windows Write and Win95 Wordpad are functional, maybe newer
137  versions of Winword are breaking formatting information).
138 </para>
139
140 <para>
141 The trick is that postscript output is human readable and
142 the faxfilter program scans the text for this pattern and
143 uses the found number as the fax-destination-number.
144 </para>
145
146 <para>
147 Now print your fax through the fax-printer and it will be
148 queued for later transmission. Use faxrunq for sending the
149 queue out.
150 </para>
151
152 </sect2>
153
154 <sect2>
155 <title>Example smb.conf</title>
156
157 <para><programlisting>
158 [global]
159  printcap name = /etc/printcap
160  print command = /usr/bin/lpr -r -P %p %s
161  lpq command = /usr/bin/lpq -P %p
162  lprm command = /usr/bin/lprm -P %p %j
163
164 [fax]
165     comment = FAX (mgetty+sendfax)
166     path = /tmp
167     printable = yes
168     public = yes
169     writable = no
170     create mode = 0700
171     browseable = yes
172     guest ok = no
173 </programlisting></para>
174
175 </sect2>
176 </sect1>
177
178 <sect1>
179 <title>Samba doesn't work well together with DHCP!</title>
180
181 <para>
182 We wish to help those folks who wish to use the ISC DHCP Server and provide
183 sample configuration settings. Most operating systems today come ship with
184 the ISC DHCP Server. ISC DHCP is available from:
185 <ulink url="ftp://ftp.isc.org/isc/dhcp">ftp://ftp.isc.org/isc/dhcp</ulink>
186 </para>
187
188 <para>
189 Incorrect configuration of MS Windows clients (Windows9X, Windows ME, Windows
190 NT/2000) will lead to problems with browsing and with general network
191 operation. Windows 9X/ME users often report problems where the TCP/IP and related
192 network settings will inadvertantly become reset at machine start-up resulting
193 in loss of configuration settings. This results in increased maintenance
194 overheads as well as serious user frustration.
195 </para>
196
197 <para>
198 In recent times users on one mailing list incorrectly attributed the cause of
199 network operating problems to incorrect configuration of Samba.
200 </para>
201
202 <para>
203 One user insisted that the only way to provent Windows95 from periodically
204 performing a full system reset and hardware detection process on start-up was
205 to install the NetBEUI protocol in addition to TCP/IP. This assertion is not
206 correct.
207 </para>
208
209 <para>
210 In the first place, there is NO need for NetBEUI. All Microsoft Windows clients
211 natively run NetBIOS over TCP/IP, and that is the only protocol that is
212 recognised by Samba. Installation of NetBEUI and/or NetBIOS over IPX will
213 cause problems with browse list operation on most networks. Even Windows NT
214 networks experience these problems when incorrectly configured Windows95
215 systems share the same name space. It is important that only those protocols
216 that are strictly needed for site specific reasons should EVER be installed.
217 </para>
218
219 <para>
220 Secondly, and totally against common opinion, DHCP is NOT an evil design but is
221 an extension of the BOOTP protocol that has been in use in Unix environments
222 for many years without any of the melt-down problems that some sensationalists
223 would have us believe can be experienced with DHCP. In fact, DHCP in covered by
224 rfc1541 and is a very safe method of keeping an MS Windows desktop environment
225 under control and for ensuring stable network operation.
226 </para>
227
228 <para>
229 Please note that MS Windows systems as of MS Windows NT 3.1 and MS Windows 95
230 store all network configuration settings a registry. There are a few reports
231 from MS Windows network administrators that warrant mention here. It would appear
232 that when one sets certain MS TCP/IP protocol settings (either directly or via
233 DHCP) that these do get written to the registry. Even though a subsequent
234 change of setting may occur the old value may persist in the registry. This
235 has been known to create serious networking problems.
236 </para>
237
238 <para>
239 An example of this occurs when a manual TCP/IP environment is configured to
240 include a NetBIOS Scope. In this event, when the administrator then changes the
241 configuration of the MS TCP/IP protocol stack, without first deleting the
242 current settings, by simply checking the box to configure the MS TCP/IP stack
243 via DHCP then the NetBIOS Scope that is still persistent in the registry WILL be
244 applied to the resulting DHCP offered settings UNLESS the DHCP server also sets
245 a NetBIOS Scope. It may therefore be prudent to forcibly apply a NULL NetBIOS
246 Scope from your DHCP server. The can be done in the dhcpd.conf file with the
247 parameter:
248 <command>option netbios-scope "";</command>
249 </para>
250
251 <para>
252 While it is true that the Microsoft DHCP server that comes with Windows NT
253 Server provides only a sub-set of rfc1533 functionality this is hardly an issue
254 in those sites that already have a large investment and commitment to Unix
255 systems and technologies. The current state of the art of the DHCP Server
256 specification in covered in rfc2132.
257 </para>
258
259 </sect1>
260
261 <sect1>
262 <title>How can I assign NetBIOS names to clients with DHCP?</title>
263
264 <para>
265 SMB network clients need to be configured so that all standard TCP/IP name to
266 address resolution works correctly. Once this has been achieved the SMB
267 environment provides additional tools and services that act as helper agents in
268 the translation of SMB (NetBIOS) names to their appropriate IP Addresses. One
269 such helper agent is the NetBIOS Name Server (NBNS) or as Microsoft called it
270 in their Windows NT Server implementation WINS (Windows Internet Name Server).
271 </para>
272
273 <para>
274 A client needs to be configured so that it has a unique Machine (Computer)
275 Name.
276 </para>
277
278 <para>
279 This can be done, but needs a few NT registry hacks and you need to be able to
280 speak UNICODE, which is of course no problem for a True Wizzard(tm) :)
281 Instructions on how to do this (including a small util for less capable
282 Wizzards) can be found at
283 </para>
284
285 <para><ulink url="http://www.unixtools.org/~nneul/sw/nt/dhcp-netbios-hostname.html">http://www.unixtools.org/~nneul/sw/nt/dhcp-netbios-hostname.html</ulink></para>
286
287 </sect1>
288
289 <sect1>
290 <title>How do I convert between unix and dos text formats?</title>
291
292 <para>
293 Jim barry has written an <ulink url="ftp://samba.org/pub/samba/contributed/fixcrlf.zip">
294 excellent drag-and-drop cr/lf converter for
295 windows</ulink>. Just drag your file onto the icon and it converts the file.
296 </para>
297
298 <para>
299 The utilities unix2dos and dos2unix(in the mtools package) should do 
300 the job under unix.
301 </para>
302
303 </sect1>
304
305 <sect1>
306 <title>Does samba have wins replication support?</title>
307
308 <para>
309 At the time of writing there is currently being worked on a wins replication implementation(wrepld).
310 </para>
311
312 </sect1>
313
314 </chapter>