xemaps's response is good, but perhaps a bit confusing for some not familiar with exim.conf editing, and it misses a few points.
So here's the
official install instructions for now:
These instructions are only for use with installations already running SpamBlocker2; if you're still running an earlier version of SpamBlocker you should update your installation to SpamBlocker2 before beginning this installation, as it requres the addition of several files in /etc/virtual, and also possibly the moving of information from one file to two new files.
Once we've released the final version we'll be offering an installation service, and of course anyone else may do the same.
We recommend using the latest version of exim the DirectAdmin staff has made available for your distribution; how to verify that is beyond the scope of this post, but you should know that all our tests have been performed with Exim version 4.60 as available on the DA download site. If updating Exim wants to install a new exim.conf file, you can ignore that as you'll be installing your own further down in this post.
The following must be done before writing the new SpamBlocker3 exim.conf file over your current file at /etc/exim.conf.
First backup your current exim.conf and exim.pl files:
Code:
# cp /etc/exim.conf /root
# cp /etc/exim.pl /root
Then install the new empty file needed by the new exim.conf file.
Code:
# touch /etc/virtual/skip_av_domains
# chown mail:mail /etc/virtual/skip_av_domains
# chmod 644 /etc/virtual/skip_av_domains
Next, install ClamAV by your favorite method. The method we suggest in our ReadMe installs ClamAV from source and is fully compatible with the av_scanner line in the new exim.conf file. However, you may use any method of installing ClamAV, as long as you edit the av_scanner line in the new exim.conf file to match where your installation of ClamAV installs the necessary socket. In a new installation of our SpamBlocker3 exim.conf file the line with the av_scanner setting is probably line 210, but this could change.
Next, download the correct copy of the SpamBlocker exim.conf file for your installation; they're currently available at:
http://www.nobaloney.net/downloads/spamblocker/DirectAdminSpamBlocker3/
We have four different versions available now:
SpamBlockerNoClamAV-Dovecot.exim.conf.3.0-beta 23-Dec-2006 20:35 39k
SpamBlockerNoClamAV-mbox.exim.conf.3.0-beta 23-Dec-2006 20:35 39k
SpamBlockerYesClamAV-Dovecot.exim.conf.3.0-beta 23-Dec-2006 20:35 40k
SpamBlockerYesClamAV-mbox.exim.conf.3.0-beta 23-Dec-2006 20:35 40k
Be sure to download the right version. Installing a version not currently compatible with your system will NOT update the sytem; it will simply create a system that won't work.
However do NOT install the new file yet; download it to a work area first.
Then, so you don't forget, download and install the new exim.pl file. This file was written by DirectAdmin; all we do is provide a convenient place to get it, on the same page where we've put our beta Spamblocker3 exim.conf files.
You may download the exim.pl file on the same page as the above listed SpamBlocker3 exim.conf files, or you may download it from DirectAdmin.
You should install the exim.pl file right away by overwriting the file at /etc/exim.pl. If you download it directly from our site to your server you can use it as is but remember if you download it using wget, from the same directory where it already exists; it won't overwrite the working file; the new download will be renamed with a .# suffix where the # may be 1 or higher.
Installing the exim.pl file immediately will not affect your exim installation, so do it before you do anything further.
After you've done that it's your responsibility to modify the new exim.conf file: find the lines including:
http://www.example.com/
and replace the reference with a reference to your own SpamBlocker unblock page, so that anyone who may become accidentally unblocked will have a place where they can visit to learn how to be unblocked. In a new installation of our SpamBlocker3 exim.conf file those lines are probably: 405, 411, 416, 423, 505, 513, 520, 527, 534, 541 and 553, but this could change.
Next create the page, if you've not already done so.
You may want to have unblock instructions on your unblock page; we find that allowing everyone to request unblocking, and unblocking everyone, doesn't cause problems as spammers never get to the page.
You can either have folk contact you using a form or by email. If you want people to be able to reach you by email you have to supply a whitelisted email address for them to use or they may not be able to reach you.
If you decide to use an email address for receiving unblock requests rather than a form be sure to unblock that address; in the new exim.conf file find the three lines which include:
[email protected]
In our distributed file it may be at or near line 386, but that may change.
You don't need to change that line but you should change the next two lines. local_parts needs to be equal to the left side of the @ symbol in the address you use, and domains needs to be equal to the right side of the @ symbol.
Once you've done that you should be ready to install the newly edited exim.conf file.
If you've edited the file on a desktop system you'll need to ftp it to your server as an ascii file.
Then copy the file over your current exim.conf file:
Code:
# cp SpamBlocker*ClamAV-*.exim.conf /etc/exim.conf
Now restart exim.
How you restart exim from the command line differs depending on your OS distribution; if you don't know how to do it from the command line do it from your control panel login.
Be sure to tail the exim mainlog for a while to make sure everything is working:
Code:
# tail -f /var/log/exim/mainlog
If you have problems restore the old exim.conf file and restart exim again to restore your old configuration.
I hope this helps.
Jeff