| 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.25 2006/06/19 12:08:14 flammie 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> |
| … | |
… | |
| 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.14</version> |
23 | <version>1.17</version> |
| 24 | <date>2006-03-11</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> |
| … | |
… | |
| 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> |
| … | |
… | |
| 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> |
| 177 | Before emerging anything, take a look at the various USE flags |
177 | Before emerging anything, take a look at some of the various USE flags available |
| 178 | available to Samba. |
178 | to 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:"> |
| 182 | kerberos mysql xml acl cups ldap pam readline python oav libclamav |
182 | kerberos acl cups ldap pam readline python oav |
| 183 | </pre> |
183 | </pre> |
| 184 | |
184 | |
| 185 | <p> |
185 | <p> |
| 186 | Depending on the network topology and the specific requirements of |
186 | Depending on the network topology and the specific requirements of |
| 187 | the server, the USE flags outlined below will define what to include or |
187 | the server, the USE flags outlined below will define what to include or |
| … | |
… | |
| 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> |
| … | |
… | |
| 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> |
| 289 | A couple of things worth mentioning about the USE flags and different |
265 | A couple of things worth mentioning about the USE flags and different |
| 290 | Samba functions include: |
266 | Samba functions include: |
| … | |
… | |
| 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> |
| 392 | You only need to emerge this if you use an HP printer. |
368 | You 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> |
| … | |
… | |
| 804 | drivers automagically to the connecting client, avoiding the hassle of |
780 | drivers automagically to the connecting client, avoiding the hassle of |
| 805 | manually installing printer drivers locally. |
781 | manually installing printer drivers locally. |
| 806 | </p> |
782 | </p> |
| 807 | |
783 | |
| 808 | <p> |
784 | <p> |
| 809 | There are two sets of printer drivers for this. First, the Adobe PS |
785 | There are two sets of printer drivers for this. First, the Adobe PS drivers |
| 810 | drivers which can be obtained from <uri |
786 | which can be obtained from <uri |
| 811 | link="http://www.adobe.com/support/downloads/main.html">Adobe</uri> |
787 | link="http://www.adobe.com/support/downloads/main.html">Adobe</uri> (PostScript |
| 812 | (PostScript printer drivers). Second, there are the CUPS PS drivers, |
788 | printer drivers). Second, there are the CUPS PS drivers, to be obtained <uri |
| 813 | to be obtained from <uri link="http://www.cups.org/software.php">the |
789 | link="http://dev.gentoo.org/~nightmorph/misc/cups-samba-5.0rc2.tar.gz">here</uri>. |
| 814 | CUPS homepage</uri> and selecting "CUPS Driver for Windows" from the |
790 | There doesn't seem to be a difference between the functionality of the two, but |
| 815 | pull down menu. There doesn't seem to be a difference between the |
791 | the Adobe PS drivers need to be extracted on a Windows System since it's a |
| 816 | functionality of the two, but the Adobe PS drivers need to be extracted |
792 | Windows binary. Also the whole procedure of finding and copying the correct |
| 817 | on a Windows System since it's a Windows binary. Also the whole procedure |
793 | files is a bit more hassle. The CUPS drivers seem to support some options the |
| 818 | of finding and copying the correct files is a bit more hassle. The CUPS |
794 | Adobe drivers don't. |
| 819 | drivers seem to support some options the Adobe drivers don't. |
|
|
| 820 | </p> |
795 | </p> |
|
|
796 | <!-- |
|
|
797 | used to be available at www.cups.org/articles.php?L142+p4, but only 6.0 is |
|
|
798 | available. at some point, we should update this for 6.0. |
|
|
799 | --> |
| 821 | |
800 | |
| 822 | <p> |
801 | <p> |
| 823 | This HOWTO uses the CUPS drivers for Windows. The downloaded file is |
802 | This HOWTO uses the CUPS drivers for Windows. The downloaded file is |
| 824 | called <path>cups-samba-5.0rc2.tar.gz</path>. Extract the files |
803 | called <path>cups-samba-5.0rc2.tar.gz</path>. Extract the files |
| 825 | contained into a directory. |
804 | contained into a directory. |
| … | |
… | |
| 874 | "export all known printers".)</comment> |
853 | "export all known printers".)</comment> |
| 875 | # <i>cupsaddsmb -H PrintServer -U root -h PrintServer -a</i> |
854 | # <i>cupsaddsmb -H PrintServer -U root -h PrintServer -a</i> |
| 876 | </pre> |
855 | </pre> |
| 877 | |
856 | |
| 878 | <warn> |
857 | <warn> |
| 879 | The execution of this command often causes the most trouble. |
858 | The execution of this command often causes the most trouble. Read through the |
| 880 | Reading through the <uri |
|
|
| 881 | link="http://forums.gentoo.org/viewtopic.php?t=110931">posts in this |
859 | <uri link="http://forums.gentoo.org/viewtopic.php?t=110931">posts in this |
| 882 | thread</uri>. |
860 | thread</uri> for some troubleshooting tips. |
| 883 | </warn> |
861 | </warn> |
| 884 | |
862 | |
| 885 | <p> |
863 | <p> |
| 886 | Here are common errors that may happen: |
864 | Here are common errors that may happen: |
| 887 | </p> |
865 | </p> |
| … | |
… | |
| 1145 | troubleshooting your installation: |
1123 | troubleshooting your installation: |
| 1146 | </p> |
1124 | </p> |
| 1147 | |
1125 | |
| 1148 | <ul> |
1126 | <ul> |
| 1149 | <li><uri link="http://www.cups.org/">CUPS Homepage</uri></li> |
1127 | <li><uri link="http://www.cups.org/">CUPS Homepage</uri></li> |
|
|
1128 | <li> |
| 1150 | <li><uri link="http://www.samba.org/">Samba Homepage</uri></li> |
1129 | <uri link="http://www.samba.org/">Samba Homepage</uri>, especially the <uri |
|
|
1130 | link="http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/CUPS-printing.html">chapter |
|
|
1131 | on Samba/CUPS configuration</uri> |
|
|
1132 | </li> |
| 1151 | <li><uri link="http://linuxprinting.org/">LinuxPrinting dot Org</uri></li> |
1133 | <li><uri link="http://linuxprinting.org/">LinuxPrinting dot Org</uri></li> |
| 1152 | <li> |
1134 | <li> |
| 1153 | <uri link="http://www.linuxprinting.org/kpfeifle/SambaPrintHOWTO/">Kurt |
1135 | <uri link="http://www.linuxprinting.org/kpfeifle/SambaPrintHOWTO/">Kurt |
| 1154 | Pfeifle's Samba Print HOWTO</uri> ( |
1136 | Pfeifle's Samba Print HOWTO</uri> ( |
| 1155 | This HOWTO really covers <e>ANYTHING</e> and <e>EVERYTHING</e> |
1137 | This HOWTO really covers <e>ANYTHING</e> and <e>EVERYTHING</e> |
Parent Directory
| 
Revision Log
| 
Patch