/[gentoo]/xml/htdocs/doc/en/quick-samba-howto.xml
Gentoo

Diff of /xml/htdocs/doc/en/quick-samba-howto.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.27 Revision 1.28
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/quick-samba-howto.xml,v 1.27 2007/06/05 21:33:31 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/quick-samba-howto.xml,v 1.28 2007/06/06 22:42:25 nightmorph Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4<guide link="/doc/en/quick-samba-howto.xml"> 4<guide link="/doc/en/quick-samba-howto.xml">
5<title>Gentoo Samba3/CUPS/ClamAV HOWTO</title> 5<title>Gentoo Samba3/CUPS/ClamAV HOWTO</title>
6<author title="Author"> 6<author title="Author">
7 <mail link="daff at dword dot org">Andreas "daff" Ntaflos</mail> 7 <mail link="daff at dword dot org">Andreas "daff" Ntaflos</mail>
8</author> 8</author>
9<author title="Author"> 9<author title="Author">
10 <mail link="joshua@sungentoo.homeunix.com">Joshua Preston</mail> 10 <mail link="joshua@sungentoo.homeunix.com">Joshua Preston</mail>
11</author> 11</author>
12 12
13<abstract> 13<abstract>
14Setup, install and configure a Samba Server under Gentoo that shares 14Setup, install and configure a Samba Server under Gentoo that shares
15files, printers without the need to install drivers and provides 15files, printers without the need to install drivers and provides
16automatic virus scanning. 16automatic virus scanning.
17</abstract> 17</abstract>
18 18
19<!-- The content of this document is licensed under the CC-BY-SA license --> 19<!-- The content of this document is licensed under the CC-BY-SA license -->
20<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 20<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
21<license/> 21<license/>
22 22
23<version>1.16</version> 23<version>1.17</version>
24<date>2007-06-05</date> 24<date>2007-06-06</date>
25 25
26<chapter> 26<chapter>
27<title>Introduction to this HOWTO</title> 27<title>Introduction to this HOWTO</title>
28<section> 28<section>
29<title>Purpose</title> 29<title>Purpose</title>
30<body> 30<body>
31 31
32<p> 32<p>
33This HOWTO is designed to help you move a network from many different 33This HOWTO is designed to help you move a network from many different
34clients speaking different languages, to many different machines that 34clients speaking different languages, to many different machines that
35speak a common language. The ultimate goal is to help differing 35speak a common language. The ultimate goal is to help differing
36architectures and technologies, come together in a productive, 36architectures and technologies, come together in a productive,
37happily coexisting environment. 37happily coexisting environment.
38</p> 38</p>
39 39
134</body> 134</body>
135</section> 135</section>
136<section> 136<section>
137<title>Requirements</title> 137<title>Requirements</title>
138<body> 138<body>
139 139
140<p> 140<p>
141We will need the following: 141We will need the following:
142</p> 142</p>
143 143
144<ul> 144<ul>
145 <li>net-fs/samba</li> 145 <li>net-fs/samba</li>
146 <li>app-antivirus/clamav</li> 146 <li>app-antivirus/clamav</li>
147 <li>net-print/cups</li> 147 <li>net-print/cups</li>
148 <li>net-print/foomatic</li> 148 <li>net-print/foomatic</li>
149 <li>net-print/hpijs (if you have an HP printer)</li> 149 <li>net-print/hplip (if you have an HP printer)</li>
150 <li>A kernel of sorts (preferably 2.4.24+ or 2.6.x)</li> 150 <li>A kernel of sorts (2.6)</li>
151 <li>A printer (PS or non-PS, maybe not TOO new or fancy)</li> 151 <li>A printer (PS or non-PS, maybe not TOO new or fancy)</li>
152 <li> 152 <li>
153 A working network (home/office/etc) consisting of more than one machine) 153 A working network (home/office/etc) consisting of more than one machine)
154 </li> 154 </li>
155</ul> 155</ul>
156 156
157<p> 157<p>
158The main package we use here is net-fs/samba, however, you will need 158The main package we use here is net-fs/samba, however, you will need
159a kernel with smbfs support enabled in order to mount a samba or windows 159a kernel with smbfs support enabled in order to mount a samba or windows
160share from another computer. CUPS will be emerged if it is not already. 160share from another computer. CUPS will be emerged if it is not already.
161app-antivirus/clamav will be used also, but others should be easily adapted 161app-antivirus/clamav will be used also, but others should be easily adapted
162to work with Samba. Gentoo's samba ebuild supports all kinds of virus scanning 162to work with Samba. Gentoo's samba ebuild supports all kinds of virus scanning
163technologies, such as Sophos, FProt, Fsav, Trend, Icap, Nai, ... 163technologies, such as Sophos, FProt, Fsav, Trend, Icap, Nai, ...
164</p> 164</p>
165 165
166</body> 166</body>
167</section> 167</section>
168</chapter> 168</chapter>
169 169
170<chapter> 170<chapter>
171<title>Getting acquainted with Samba</title> 171<title>Getting acquainted with Samba</title>
172<section> 172<section>
173<title>The USE Flags</title> 173<title>The USE Flags</title>
174<body> 174<body>
175 175
176<p> 176<p>
177Before emerging anything, take a look at the various USE flags 177Before emerging anything, take a look at some of the various USE flags available
178available to Samba. 178to Samba.
179</p> 179</p>
180 180
181<pre caption="Samba uses the following USE Variables:"> 181<pre caption="Samba uses the following USE Variables:">
182kerberos mysql xml acl cups ldap pam readline python oav libclamav 182kerberos acl cups ldap pam readline python oav
183</pre> 183</pre>
184 184
185<p> 185<p>
186Depending on the network topology and the specific requirements of 186Depending on the network topology and the specific requirements of
187the server, the USE flags outlined below will define what to include or 187the server, the USE flags outlined below will define what to include or
188exclude from the emerging of Samba. 188exclude from the emerging of Samba.
189</p> 189</p>
190 190
191<table> 191<table>
192<tr> 192<tr>
193 <th><b>USE flag</b></th> 193 <th><b>USE flag</b></th>
194 <th>Description</th> 194 <th>Description</th>
195</tr> 195</tr>
196<tr> 196<tr>
197 <th><b>kerberos</b></th> 197 <th><b>kerberos</b></th>
198 <ti> 198 <ti>
199 Include support for Kerberos. The server will need this if it is 199 Include support for Kerberos. The server will need this if it is
200 intended to join an existing domain or Active Directory. See the note 200 intended to join an existing domain or Active Directory. See the note
201 below for more information. 201 below for more information.
202 </ti>
203</tr>
204<tr>
205 <th><b>mysql</b></th>
206 <ti>
207 This will allow Samba to use MySQL in order to do password authentication.
208 It will store ACLs, usernames, passwords, etc in a database versus a
209 flat file. If Samba is needed to do password authentication, such as
210 acting as a password validation server or a Primary Domain Controller
211 (PDC).
212 </ti>
213</tr>
214<tr>
215 <th><b>xml</b></th>
216 <ti>
217 The xml USE option for Samba provides a password database backend allowing
218 Samba to store account details in XML files, for the same reasons listed in
219 the mysql USE flag description.
220 </ti> 202 </ti>
221</tr> 203</tr>
222<tr> 204<tr>
223 <th><b>acl</b></th> 205 <th><b>acl</b></th>
224 <ti> 206 <ti>
225 Enables Access Control Lists. The ACL support in Samba uses a patched 207 Enables Access Control Lists. The ACL support in Samba uses a patched
226 ext2/ext3, or SGI's XFS in order to function properly as it extends more 208 ext2/ext3, or SGI's XFS in order to function properly as it extends more
227 detailed access to files or directories; much more so than typical *nix 209 detailed access to files or directories; much more so than typical *nix
228 GID/UID schemas. 210 GID/UID schemas.
229 </ti> 211 </ti>
230</tr> 212</tr>
231<tr> 213<tr>
232 <th><b>cups</b></th> 214 <th><b>cups</b></th>
233 <ti> 215 <ti>
234 This enables support for the Common Unix Printing System. This 216 This enables support for the Common Unix Printing System. This
265<tr> 247<tr>
266 <th><b>python</b></th> 248 <th><b>python</b></th>
267 <ti> 249 <ti>
268 Python bindings API. Provides an API that will allow Python to 250 Python bindings API. Provides an API that will allow Python to
269 interface with Samba. 251 interface with Samba.
270 </ti> 252 </ti>
271</tr> 253</tr>
272<tr> 254<tr>
273 <th><b>oav</b></th> 255 <th><b>oav</b></th>
274 <ti> 256 <ti>
275 Provides on-access scanning of Samba shares with FRISK F-Prot 257 Provides on-access scanning of Samba shares with FRISK F-Prot
276 Daemon, Kaspersky AntiVirus, OpenAntiVirus.org ScannerDaemon, Sophos Sweep 258 Daemon, Kaspersky AntiVirus, OpenAntiVirus.org ScannerDaemon, Sophos Sweep
277 (SAVI), Symantec CarrierScan, and Trend Micro (VSAPI). 259 (SAVI), Symantec CarrierScan, and Trend Micro (VSAPI).
278 </ti> 260 </ti>
279</tr> 261</tr>
280<tr>
281 <th><b>libclamav</b></th>
282 <ti>
283 Use the ClamAV library instead of the clamd daemon
284 </ti>
285</tr>
286</table> 262</table>
287 263
288<p> 264<p>
289A couple of things worth mentioning about the USE flags and different 265A couple of things worth mentioning about the USE flags and different
290Samba functions include: 266Samba functions include:
291</p> 267</p>
292 268
293<ul> 269<ul>
294 <li> 270 <li>
295 ACLs on ext2/3 are implemented through extended attributes (EAs). EA and 271 ACLs on ext2/3 are implemented through extended attributes (EAs). EA and
296 ACL kernel options for ext2 and/or ext3 will need to be enabled 272 ACL kernel options for ext2 and/or ext3 will need to be enabled
297 (depending on which file system is being used - both can be enabled). 273 (depending on which file system is being used - both can be enabled).
298 </li> 274 </li>
299 <li> 275 <li>
300 While Active Directory, ACL, and PDC functions are out of the intended 276 While Active Directory, ACL, and PDC functions are out of the intended
373</pre> 349</pre>
374 350
375</body> 351</body>
376</section> 352</section>
377<section> 353<section>
378<title>Emerging foomatic</title> 354<title>Emerging foomatic</title>
379<body> 355<body>
380 356
381<pre caption="Emerge foomatic"> 357<pre caption="Emerge foomatic">
382# <i>emerge net-print/foomatic</i> 358# <i>emerge net-print/foomatic</i>
383</pre> 359</pre>
384 360
385</body> 361</body>
386</section> 362</section>
387<section> 363<section>
388<title>Emerging net-print/hpijs</title> 364<title>Emerging net-print/hplip</title>
389<body> 365<body>
390 366
391<p> 367<p>
392You only need to emerge this if you use an HP printer. 368You only need to emerge this if you use an HP printer.
393</p> 369</p>
394 370
395<pre caption="Emerge hpijs"> 371<pre caption="Emerge hplip">
396# <i>emerge net-print/hpijs</i> 372# <i>emerge net-print/hplip</i>
397</pre> 373</pre>
398 374
399</body> 375</body>
400</section> 376</section>
401</chapter> 377</chapter>
402 378
403<chapter> 379<chapter>
404<title>Server Configuration</title> 380<title>Server Configuration</title>
405<section> 381<section>
406<title>Configuring Samba</title> 382<title>Configuring Samba</title>
407<body> 383<body>
408 384
409<p> 385<p>
410The main Samba configuration file is <path>/etc/samba/smb.conf</path>. 386The main Samba configuration file is <path>/etc/samba/smb.conf</path>.
411It is divided in sections indicated by [sectionname]. Comments are either 387It is divided in sections indicated by [sectionname]. Comments are either

Legend:
Removed from v.1.27  
changed lines
  Added in v.1.28

  ViewVC Help
Powered by ViewVC 1.1.20