<title>Gentoo Samba3/CUPS/clamav HOWTO</title>

<title>Gentoo Samba3/CUPS/Clam AV HOWTO</title>

Setup, install and configure a Samba Server under Gentoo that shares 

Setup, install and configure a Samba Server under Gentoo that shares

files, printers without the need to install drivers and provides 

files, printers without the need to install drivers and provides

architechures and technologies, come together in a productive, 

architectures and technologies, come together in a productive, 

happily coexistant environment.

happily coexisting environment.

or appropriate entries in your /etc/hosts file. cupsaddsmb often

or appropriate entries in your <path>/etc/hosts</path> file.

borks if hostnames don't point to the correct machines.

<c>cupsaddsmb</c> often borks if hostnames don't point to the correct

machines.  

<title>Emerging clam-av</title>

<title>Emerging Clam AV</title>

Because the oav USE flag only provides an interface to allow on access 

Because the <e>oav</e> USE flag only provides an interface to allow on access 

used in this HOWTO is <e>net-mail/clamav</e>.

used in this HOWTO is Clam AV.

man page for <path>smb.conf</path>, the installed smb.conf.example, the Samba 

man page for <path>smb.conf</path>, the installed

Web site or any of the numerous Samba books available. 

<path>smb.conf.example</path>, the Samba Web site or any of the

numerous Samba books available.  

<p>

<warn>

There are several warnings that we should put here:

</p>

<ul>

If you like to use Samba's guest account to do anything concerning

  <li>

printing from Windows clients: don't set <c>guest only = yes</c> in

    If you like to use Samba's guest account to do anything concerning 

the <c>[global]</c> section.  The guest account seems to cause

    printing from Windows clients: don't

problems when running <c>cupsaddsmb</c> sometimes when trying to

  </li>

connect from Windows machines. See below, too, when we talk about

  <li>Don't set guest only = yes in the global section</li>

<c>cupsaddsmb</c> and the problems that can arise. Use a dedicated

  <li>

printer user, like <c>printeruser</c> or <c>printer</c> or

    The guest account seems to cause problems when running cupsaddsmb sometimes

<c>printme</c> or whatever. It doesn't hurt and it will certainly

    when trying to connect from Windows machines. See below, too, when we talk

protect you from a lot of problems.

    about cupsaddsmb and the problems that can arise. Use a dedicated printer 

</warn>

    user, like "printeruser" or "printer" or "printme" or whatever. It doesn't

    hurt and it will certainly protect you from a lot of problems.

  </li>

</ul>

<title>Configuring clam-av</title>

<title>Configuring Clam AV</title>

it to the default runlevel and then start the clamd service immediately.

it to the <e>default</e> runlevel and then start the <c>clamd</c> service immediately.

This is a little more complicated). CUPS' main config file is 

This is a little more complicated. CUPS' main config file is 

The changes to mime.convs and mime.types are needed to make CUPSprint Microsoft Office document files.

The changes to <path>mime.convs</path> and <path>mime.types</path> are

needed to make CUPS print Microsoft Office document files.  

named HP-DeskJet_930C-hpijs.ppd. You should now install the printer.  

named <path>HP-DeskJet_930C-hpijs.ppd</path>. You should now install the printer.  

interface is found at http://PrintServer:631 once CUPS is running.

interface is found at <path>http://PrintServer:631</path> once CUPS is running.

Remember to adjust to what you have. Be sure to have the name (-p) right (the 

Remember to adjust to what you have. Be sure to have the name

name you set above during the Samba configuration!) and to put in the 

(<c>-p</c> argument) right (the name you set above during the Samba

correct usb:/dev/usb/blah, parallel:/dev/blah or whatever device you 

configuration!) and to put in the correct <c>usb:/dev/usb/blah</c>,

are using for your printer.

<c>parallel:/dev/blah</c> or whatever device you are using for your

printer.

You should now be able to access the printer from the web interface. You 

You should now be able to access the printer from the web interface

should now be able to print a test page.

and be able to print a test page.

cups-samba.ss is a TAR archive containing three files:

<path>cups-samba.ss</path> is a TAR archive containing three files:

cups5.hlp, cupsdrvr5.dll and cupsui5.dll. These are the actual driver 

<path>cups5.hlp</path>, <path>cupsdrvr5.dll</path> and

files.

<path>cupsui5.dll</path>. These are the actual driver files.

The script cups-samba.install may not work for all *nixes (ie FreeBSD)

The script <c>cups-samba.install</c> may not work for all *nixes (ie FreeBSD)

<path>/usr/share/cups/</path> See the example below.

<path>/usr/share/cups/</path> see the example below.

    The hostname given as a parameter for -h and -H (PrintServer) often does

    The hostname given as a parameter for <c>-h</c> and <c>-H</c>

    not resolve correctly and doesn't identify the print server for CUPS/Samba 

    (<c>PrintServer</c>) often does not resolve correctly and doesn't

    interaction.

    identify the print server for CUPS/Samba interaction.  If an error

    If an error like: <b>Warning: No PPD file for printer "CUPS_PRINTER_NAME" - 

    like: <b>Warning: No PPD file for printer "CUPS_PRINTER_NAME" -

    skipping!</b> occurs, the first thing you should do is substitute 

    skipping!</b> occurs, the first thing you should do is substitute

    PrintServer with localhost and try it again.

    <c>PrintServer</c> with <c>localhost</c> and try it again.

    not very helpful. One thing to try is to temporarily set <b>security = 

    not very helpful. One thing to try is to temporarily set <c>security = 

    user</b> in your <path>smb.conf</path>. After/if the installation completes 

    user</c> in your <path>smb.conf</path>. After/if the installation completes 

browser to http://localhost:631 (on the CLIENT) and you'll see that 

browser to <c>http://localhost:631</c> on the client and you'll see that 

In order to setup a default printer, you have to edit 

In order to setup a default printer, you have to edit

<path>/etc/cups/client.conf</path> and set the directive ServerName to 

<path>/etc/cups/client.conf</path> and set the directive

your printserver. In the case of this guide that would be the 

<c>ServerName</c> to your printserver. In the case of this guide that

following example.

would be the following example.

The following will print foorbar.whatever.ps directly to the print 

The following will print <path>foorbar.whatever.ps</path> directly to the print 

    Setting the ServerName in client.conf seems to work well for only one 

    Setting the <c>ServerName</c> in <path>client.conf</path> seems to

    printer, there may be yet another way to set a client's default remote 

    work well for only one printer, there may be yet another way to

    printer.

    set a client's default remote printer.

    Also, when accessing http://localhost:631 on the client now, no printers 

    Also, when accessing <c>http://localhost:631</c> on the client

    seem to be "found" by the client-CUPS. This is to be expected when setting

    now, no printers seem to be "found" by the client-CUPS. This is to

    ServerName in <path>client.conf</path>.

    be expected when setting <c>ServerName</c> in

    <path>client.conf</path>.

Now is time to configure our kernel to support it the smbfs. Since I'm 

Now is time to configure our kernel to support smbfs. Since I'm 

For simplicity sake, make it as a module for ease of use.  It is the

For simplicity sake, make it a module for ease of use.  It is the

That's just a bit of point-and-click. Browse to \\PrintServer and right 

That's just a bit of point-and-click. Browse to

click on the printer (HPDeskJet930C) and click connect. This will 

<path>\\PrintServer</path> and right click on the printer

download the drivers to the Windows client and now every application 

(HPDeskJet930C) and click connect. This will download the drivers to

(such as Word or Acrobat) will offer HPDeskJet930C as an available 

the Windows client and now every application (such as Word or Acrobat)

printer to print to. :-)

will offer HPDeskJet930C as an available printer to print to. :-)