You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 45 Next »

These instructions may change slightly with each version, so it is wise to read up on what's required each time before proceeding. Note that the configuration is slightly different in each version. You may wish to upgrade perl in conjunction with this since to do either requires disabling the processing of incoming e-mail to the e-mail server.

Information on running SpamD on Windows: SpamdOnWindows

http://www.openhandhome.com/howtosa.html provides more detailed step by step information. The below info is largely a digest of said info. This site is experiencing temporary domain name issues, and may be reached at http://64.142.36.76/howtosa.html in the meantime. It has not been modified recently.

This installation procedure is for installing SpamAssassin in native Windows (not Cygwin) using Active{{`Perl 5.8.7.813 or later 5.8.x. (Tested on Active}}`Perl 5.8.8.820.)

  1. Install or upgrade Perl if required:
    • If upgrading, make note of any modules you need to reinstall, uninstall ActivePerl and delete the /perl folder tree.
    • Download the current ActivePerl version 5.8.x from www.activestate.com.
    • Install it.
    • Get nmake from Microsoft: http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe
    • Extract the nmake.exe and nmake.err files into your /perl/bin folder
    • Use PPM to install the required perl modules: 
      ppm install Win32-Registry-File
ppm install Net-DNS
ppm install DB_File
ppm install IP-Country
ppm install Mail-SPF
ppm install Error
ppm install Digest-SHA
      2. If you want to use DKIM or Domainkeys support, you'll need some additional modules:
      • You will need a compiler for this process even if you use the precompiled openssl since the perl modules for openssl also require compilation at make time. I used Visual Studio 2003 for compiling.
      • Download and compile openssl for Windows. You can get a precompiled 0.98d version at http://webmail.wcg.org/~support/openssl.zip if you'd rather.
      • Create and run a batch file that calls vcvars32.bat (from Visual Studio), adds the include and lib folders to the beginning of the path, or use the openssl.bat included in the precompiled version.
      • Copy the items in the bin folder to c:\windows\system32.
      • Download and install Crypt-OpenSSL-BigNum from http://search.cpan.org
        • Extract the files to C:\
        • Edit makefile.pl and change the lib line to: 
               'LIBS'              => ['-llibeay32'],   # e.g., '-lm'
        • Run: perl makefile.pl
        • Run: nmake
        • Run: nmake install
        • If you don't have a compiler, it might work to download a premade version from http://webmail.wcg.org/~support/Crypt-OpenSSL-Bignum-0.03.zip, unzip it and run only "nmake install".
      • Download and install Crypt-OpenSSL-RSA from http://search.cpan.org
        • Extract the files to C:\
        • Edit makefile.pl and change the lib line to: 
               'LIBS'	=> ['-lssleay32 -llibeay32'],   # e.g., '-lm'
        • Run: perl makefile.pl
        • Run: nmake
        • Run: nmake install
        • If you don't have a compiler, it might work to download a premade version from http://webmail.wcg.org/~support/Crypt-OpenSSL-RSA-0.24.zip, unzip it and run only "nmake install".
      • Download and install <nowiki>Mail-DKIM</nowiki> from http://search.cpan.org
        • Extract the files to C:\
        • Run: perl makefile.pl
        • Run: nmake
        • Run: nmake install
          2. If you want to build spamc, install Microsoft Visual C++ 6.0 or later. For instructions on getting a no-cost version see BuildSpamcOnWindowsForFree. When you build SpamAssassin use a command prompt in which the VC++ environment variables are set.
          3. Download the SpamAssassin zip file from www.spamassassin.org
          4. Back up your settings if you already have it running.
          5. Stop and disable SpamAssassin if it's running
          6. Delete ~SpamAssassin directories, which may include:
    • c:\etc\mail\spamassassin
    • c:\perl\etc\mail\spamassassin
    • c:\perl\site\share\spamassassin
    • c:\perl\site\var\spamassassin
    • c:\perl\site\lib\mail\spamassassin.pm and spamassassin folder
    • c:\perl\site\etc\mail\spamassassin
    • c:\perl\html\site\lib\mail\spamassassin or c:\spamdocs or whereever you put the docs last time
    • From c:\perl\bin\, delete spamassassin.*, sa-learn.*, sa-compile.* and sa-update.*
      7. The following system environment variables may have to be set:
    • RES_NAMESERVERS=<your-dns-server-ip-address>
      If you do not set this variable, SpamAssassin should use the first DNS server in your network configuration. That is useful when, for example, you move your computer between different networks and have DNS automatically assigned. If you experience problems with domain name resolution, try setting this variable to force SpamAssassin to use the specified nameserver.
    • LANG=en_US
      This used to be required for SpamAssassin to work with perl 5.8.x. It should no longer be necessary, but there is no harm in having it set. If you have trouble getting SpamAssassin to run, try setting this.
      8. Install SpamAssassin:
    • extract it to the c:\ folder with use folder names
    • in a command prompt: cd\mail-spamassassin-3.2.0
    • perl makefile.pl
      Answer the questions as they are asked. Remember you can NOT build spamc without a C compiler installed and its environment set up.
    • nmake
    • nmake test (this is optional)
    • nmake install
      9. Documentation should now be generated automatically by the install.
      10. Copy the backed up configuration files into the site configuration folder, probably c:\perl\site\etc\mail\spamassassin.
      11. Simple test (you should have no errors): spamassassin -D < sample-spam.txt
      12. Make a test folder. Copy sample-spam.txt and sample-nonspam.txt to that folder.
      13. Open a command prompt to that folder.
      14. Test the two files. Make sure they both run fine and the spam reports on each result file are appropriate.
    • spamassassin -D -t < sample-nonspam.txt > results-nonspam.txt
    • spamassassin -D -t < sample-spam.txt > results-spam.txt

Once it's installed, you can edit the local.cf file in c:\perl\site\etc\mail\spamassassin. You may want to visit http://www.rulesemporium.com and get extra rulesets. These rulesets should also go in the c:\perl\site\etc\mail\spamassassin folder. (This assumes you've installed activeperl in c:\perl as it defaults to. If you install it somewhere else, you'll need to adjust the path accordingly.)

Note: ActivePerl's 5.8.8.820 ppm installer currently (2007-02-28) installs a separate copy of ERRNO if you install Mail-IMAPClient. The copy of ERRNO it installs is not complete and causes the SpamAssassin command-line interface to fail. If you need Mail-IMAPClient installed, download a copy from CPAN and use perl makefile.pl/nmake/nmake install to install it. You can install the Parse-RecDescent depencency using ppm if you need it-- just not Mail-IMAPClient itself.

Using sa-update

To use sa-update with GPG, you should download [http://www.gpg4win.org/ GPG for Windows], install it and add the 8.3 file path to your system path. The default path would be C:\PROGRA~1\GNU\GNUPG.

by BretMiller

CategoryInstall CategoryInstall

  • No labels