| 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.20 2006/01/01 11:51:43 neysx Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/quick-samba-howto.xml,v 1.26 2006/12/25 17:30:26 nightmorph Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | <guide link="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"> |
| … | |
… | |
| 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.12</version> |
23 | <version>1.15</version> |
| 24 | <date>2005-03-26</date> |
24 | <date>2006-12-25</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> |
| … | |
… | |
| 299 | <li> |
299 | <li> |
| 300 | While Active Directory, ACL, and PDC functions are out of the intended |
300 | While Active Directory, ACL, and PDC functions are out of the intended |
| 301 | scope of this HOWTO, you may find these links as helpful to your cause: |
301 | scope of this HOWTO, you may find these links as helpful to your cause: |
| 302 | <ul> |
302 | <ul> |
| 303 | <li><uri>http://www.bluelightning.org/linux/samba_acl_howto/</uri></li> |
303 | <li><uri>http://www.bluelightning.org/linux/samba_acl_howto/</uri></li> |
| 304 | <li><uri>http://open-projects.linuxcare.com/research-papers/winbind-08162000.html</uri></li> |
|
|
| 305 | <li><uri>http://www.wlug.org.nz/HowtoSamba3AndActiveDirectory</uri></li> |
304 | <li><uri>http://www.wlug.org.nz/HowtoSamba3AndActiveDirectory</uri></li> |
| 306 | </ul> |
305 | </ul> |
| 307 | </li> |
306 | </li> |
| 308 | </ul> |
307 | </ul> |
| 309 | |
308 | |
| … | |
… | |
| 679 | in the example are the directives that need to be changed: |
678 | in the example are the directives that need to be changed: |
| 680 | </p> |
679 | </p> |
| 681 | |
680 | |
| 682 | <pre caption="/etc/cups/cupsd.conf"> |
681 | <pre caption="/etc/cups/cupsd.conf"> |
| 683 | ServerName <i>PrintServer</i> <comment># your printserver name</comment> |
682 | ServerName <i>PrintServer</i> <comment># your printserver name</comment> |
| 684 | ServerAdmin <i>root@PrintServer</i> <comment># the person for printer-related hate-mail, eg you</comment> |
683 | ServerAdmin <i>root@PrintServer</i> <comment># the person for printer-related hate-mail, e.g. you</comment> |
| 685 | |
684 | |
| 686 | AccessLog /var/log/cups/access_log <comment># probably doesn't need changing</comment> |
685 | AccessLog /var/log/cups/access_log <comment># probably doesn't need changing</comment> |
| 687 | ErrorLog /var/log/cups/error_log <comment># doesn't really need changing either</comment> |
686 | ErrorLog /var/log/cups/error_log <comment># doesn't really need changing either</comment> |
| 688 | |
687 | |
| 689 | LogLevel debug <comment># only while isntalling and testing, should later be |
688 | LogLevel debug <comment># only while isntalling and testing, should later be |
| … | |
… | |
| 698 | |
697 | |
| 699 | <Location /> |
698 | <Location /> |
| 700 | Order Deny,Allow |
699 | Order Deny,Allow |
| 701 | Deny From All |
700 | Deny From All |
| 702 | Allow From <i>192.168.1.*</i> <comment># the addresses of your internel network |
701 | Allow From <i>192.168.1.*</i> <comment># the addresses of your internel network |
| 703 | # eg 192.168.1.* will allow connections from any host on |
702 | # e.g. 192.168.1.* will allow connections from any host on |
| 704 | # the 192.168.1.0 network. change to whatever suits you</comment> |
703 | # the 192.168.1.0 network. change to whatever suits you</comment> |
| 705 | </Location> |
704 | </Location> |
| 706 | |
705 | |
| 707 | <Location /admin> |
706 | <Location /admin> |
| 708 | AuthType Basic |
707 | AuthType Basic |
| … | |
… | |
| 754 | |
753 | |
| 755 | <p> |
754 | <p> |
| 756 | First, go to <uri link="http://linuxprinting.org">LinuxPrinting.Org</uri> to |
755 | First, go to <uri link="http://linuxprinting.org">LinuxPrinting.Org</uri> to |
| 757 | find and download the correct PPD file for your printer and CUPS. To do so, |
756 | find and download the correct PPD file for your printer and CUPS. To do so, |
| 758 | click the link Printer Listings to the left. Select your printers manufacturer |
757 | click the link Printer Listings to the left. Select your printers manufacturer |
| 759 | and the model in the pulldown menu, eg HP and DeskJet 930C. Click "Show". On |
758 | and the model in the pulldown menu, e.g. HP and DeskJet 930C. Click "Show". On |
| 760 | the page coming up click the "recommended driver" link after reading the |
759 | the page coming up click the "recommended driver" link after reading the |
| 761 | various notes and information. Then fetch the PPD file from the next page, |
760 | various notes and information. Then fetch the PPD file from the next page, |
| 762 | again after reading the notes and introductions there. You may have to select |
761 | again after reading the notes and introductions there. You may have to select |
| 763 | your printers manufacturer and model again. Reading the <uri |
762 | your printers manufacturer and model again. Reading the <uri |
| 764 | link="http://www.linuxprinting.org/cups-doc.html">CUPS quickstart guide</uri> |
763 | link="http://www.linuxprinting.org/cups-doc.html">CUPS quickstart guide</uri> |
| … | |
… | |
| 773 | interface is found at <path>http://PrintServer:631</path> once CUPS is running. |
772 | interface is found at <path>http://PrintServer:631</path> once CUPS is running. |
| 774 | </p> |
773 | </p> |
| 775 | |
774 | |
| 776 | <pre caption="Install the printer via command line"> |
775 | <pre caption="Install the printer via command line"> |
| 777 | # <i>lpadmin -p HPDeskJet930C -E -v usb:/dev/ultp0 -m HP-DeskJet_930C-hpijs.ppd</i> |
776 | # <i>lpadmin -p HPDeskJet930C -E -v usb:/dev/ultp0 -m HP-DeskJet_930C-hpijs.ppd</i> |
|
|
777 | # <i>/etc/init.d/cupsd restart</i> |
| 778 | </pre> |
778 | </pre> |
| 779 | |
779 | |
| 780 | <p> |
780 | <p> |
| 781 | Remember to adjust to what you have. Be sure to have the name |
781 | Remember to adjust to what you have. Be sure to have the name |
| 782 | (<c>-p</c> argument) right (the name you set above during the Samba |
782 | (<c>-p</c> argument) right (the name you set above during the Samba |
| … | |
… | |
| 804 | drivers automagically to the connecting client, avoiding the hassle of |
804 | drivers automagically to the connecting client, avoiding the hassle of |
| 805 | manually installing printer drivers locally. |
805 | manually installing printer drivers locally. |
| 806 | </p> |
806 | </p> |
| 807 | |
807 | |
| 808 | <p> |
808 | <p> |
| 809 | There are two sets of printer drivers for this. First, the Adobe PS |
809 | There are two sets of printer drivers for this. First, the Adobe PS drivers |
| 810 | drivers which can be obtained from <uri |
810 | which can be obtained from <uri |
| 811 | link="http://www.adobe.com/support/downloads/main.html">Adobe</uri> |
811 | link="http://www.adobe.com/support/downloads/main.html">Adobe</uri> (PostScript |
| 812 | (PostScript printer drivers). Second, there are the CUPS PS drivers, |
812 | 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 |
813 | 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 |
814 | 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 |
815 | 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 |
816 | 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 |
817 | 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 |
818 | Adobe drivers don't. |
| 819 | drivers seem to support some options the Adobe drivers don't. |
|
|
| 820 | </p> |
819 | </p> |
|
|
820 | <!-- |
|
|
821 | used to be available at www.cups.org/articles.php?L142+p4, but only 6.0 is |
|
|
822 | available. at some point, we should update this for 6.0. |
|
|
823 | --> |
| 821 | |
824 | |
| 822 | <p> |
825 | <p> |
| 823 | This HOWTO uses the CUPS drivers for Windows. The downloaded file is |
826 | 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 |
827 | called <path>cups-samba-5.0rc2.tar.gz</path>. Extract the files |
| 825 | contained into a directory. |
828 | contained into a directory. |
| … | |
… | |
| 837 | <path>cups5.hlp</path>, <path>cupsdrvr5.dll</path> and |
840 | <path>cups5.hlp</path>, <path>cupsdrvr5.dll</path> and |
| 838 | <path>cupsui5.dll</path>. These are the actual driver files. |
841 | <path>cupsui5.dll</path>. These are the actual driver files. |
| 839 | </p> |
842 | </p> |
| 840 | |
843 | |
| 841 | <warn> |
844 | <warn> |
| 842 | The script <c>cups-samba.install</c> may not work for all *nixes (ie FreeBSD) |
845 | The script <c>cups-samba.install</c> may not work for all *nixes (i.e. FreeBSD) |
| 843 | because almost everything which is not part of the base system is |
846 | because almost everything which is not part of the base system is |
| 844 | installed somewhere under the prefix <path>/usr/local/</path>. This |
847 | installed somewhere under the prefix <path>/usr/local/</path>. This |
| 845 | seems not to be the case for most things you install under GNU/Linux. |
848 | seems not to be the case for most things you install under GNU/Linux. |
| 846 | However, if your CUPS installation is somewhere other than |
849 | However, if your CUPS installation is somewhere other than |
| 847 | <path>/usr/share/cups/</path> see the example below. |
850 | <path>/usr/share/cups/</path> see the example below. |
| … | |
… | |
| 858 | # <i>tar -xf cups-samba.ss</i> |
861 | # <i>tar -xf cups-samba.ss</i> |
| 859 | <comment>(This extracts the files to usr/share/cups/drivers under the CURRENT WORKING DIRECTORY)</comment> |
862 | <comment>(This extracts the files to usr/share/cups/drivers under the CURRENT WORKING DIRECTORY)</comment> |
| 860 | # <i>cd usr/share/cups/drivers</i> |
863 | # <i>cd usr/share/cups/drivers</i> |
| 861 | <comment>(no leading / !)</comment> |
864 | <comment>(no leading / !)</comment> |
| 862 | # <i>cp cups* /usr/local/share/cups/drivers</i> |
865 | # <i>cp cups* /usr/local/share/cups/drivers</i> |
|
|
866 | # <i>/etc/init.d/cupsd restart</i> |
| 863 | </pre> |
867 | </pre> |
| 864 | |
868 | |
| 865 | <p> |
869 | <p> |
| 866 | Now we'll use the script <c>cupsaddsmb</c> provided by the CUPS |
870 | Now we'll use the script <c>cupsaddsmb</c> provided by the CUPS distribution. |
| 867 | distribution. It's man page is an interesting read. |
871 | Its man page is an interesting read. |
| 868 | </p> |
872 | </p> |
| 869 | |
873 | |
| 870 | <pre caption="Run cupsaddsmb"> |
874 | <pre caption="Run cupsaddsmb"> |
| 871 | # <i>cupsaddsmb -H PrintServer -U root -h PrintServer -v HPDeskJet930C</i> |
875 | # <i>cupsaddsmb -H PrintServer -U root -h PrintServer -v HPDeskJet930C</i> |
| 872 | <comment>(Instead of HPDeskJet930C you could also specify "-a", which will |
876 | <comment>(Instead of HPDeskJet930C you could also specify "-a", which will |
| 873 | "export all known printers".)</comment> |
877 | "export all known printers".)</comment> |
| 874 | # <i>cupsaddsmb -H PrintServer -U root -h PrintServer -a</i> |
878 | # <i>cupsaddsmb -H PrintServer -U root -h PrintServer -a</i> |
| 875 | </pre> |
879 | </pre> |
| 876 | |
880 | |
| 877 | <warn> |
881 | <warn> |
| 878 | The execution of this command often causes the most trouble. |
882 | The execution of this command often causes the most trouble. Read through the |
| 879 | Reading through the <uri |
|
|
| 880 | link="http://forums.gentoo.org/viewtopic.php?t=110931">posts in this |
883 | <uri link="http://forums.gentoo.org/viewtopic.php?t=110931">posts in this |
| 881 | thread</uri>. |
884 | thread</uri> for some troubleshooting tips. |
| 882 | </warn> |
885 | </warn> |
| 883 | |
886 | |
| 884 | <p> |
887 | <p> |
| 885 | Here are common errors that may happen: |
888 | Here are common errors that may happen: |
| 886 | </p> |
889 | </p> |
Parent Directory
| 
Revision Log
| 
Patch