Here, we explain how to install LibAntispam in your system, and how to patch and install an MTA (Mail Transport Agent) with LibAntispam support.

   Currently Sendmail-8.14.x, MeTA1-1.x, Exim-4.x and Postfix-2.8.x have stable patches support for LibAntispam use. The Sendmail-X patch support for LibAntispam isn't avaiable anymore.

   First of all, we will adopt the following conventions for installations names, paths, URLs, etc. You can change them if you feel safe about it, but we would still recommend using the defaults values:

• We are installing the complete LibAntispam package, including the LibAntispam-GUI (LibAntispam Graphical User Interface).
  
  NOTE: The client's browser SHOULD support javascript in order to navigate in LibAntispam-GUI pages!
  
  By default, the libraries (including LibVBMcgi libraries) are installed in /usr/local/lib, the headers (including LibVBMcgi headers) are installed in /usr/local/include and the configuration files are installed in /etc/antispam. The MTA-Antispam support of LibAntispam will create the directory /var/graylist if Graylisting support is set and the directory /var/rdssc if Remote Domain SMTP Sender Check is set too.


• The machine where the LibAntispam will be installed should have Apache 2.2.x with https support enabled (for LibAntispam-GUI secure access) and the Apache http-server must have been installed in the directory /usr/local/www. You may put this http-server behind a firewall, to prevent external unauthorized access.
  By default, the http-docs root directory is /usr/local/www/data, the libantispam-GUI system binary files are installed in /usr/local/www/bin and the Libantispam-GUI system script files are placed in /usr/local/www/scripts. The LibAntispam-GUI temporary directory is /usr/local/www/antispam and the LibAntispam-GUI users password access file (the passwd file) is placed in the directory /usr/local/www/LA_users_pwd.

NOTE: In this example the MTA and the HTTP servers run in the same machine, but you can put the http-server in another machine and export LibAntispam configurations to your Mail Exchange servers using shells-scripts and nfs, sftp, scp, etc. Into LibAntispam distribution example/sharing_configurations directory you will find a tested script shell with use instructions.


• The antispam user configuration accounts are placed in the directory /usr/local/www/data/scfantispam, including system and users cgi-bin support programs for LibAntispam-GUI configuration. The antispam user configuration accounts do not have any direct correlation with system user accounts.


• In your Apache ssl.conf file, you should set a secure (https) virtual host (i.e. antispam-conf.<YOUR_DOMAIN>). Pay attention to the fact that serious problems may occur if you run LibAntispam without secure http (https) connections, and that is your own responsibility! You can find an ssl.conf example in examples/apache directory, into the LibAntispam source code distribution.

NOTE #1: You SHOULD change the DirectoryIndex directive (in httpd.conf file) to LibAntispam-GUI work correctly:

              From: DirectoryIndex index.html index.html.var

              To:      DirectoryIndex index.html index.html.var index.cgi

NOTE #2: Don't forget to uncomment this line in httpd.conf file too: AddHandler cgi-script .cgi

NOTE #3: The /usr/local/www/data/scfantispam directory (in ssl.conf file) SHOULD have this options (see in examples/apache-2.x): Options +MultiViews -Indexes -FollowSymLinks +SymLinksIfOwnerMatch +IncludesNoExec +ExecCGI

Example:

<Directory "/usr/local/www/data/scfantispam">
        AllowOverride FileInfo AuthConfig Limit Options
        Options +MultiViews -Indexes -FollowSymLinks +SymLinksIfOwnerMatch +IncludesNoExec +ExecCGI
        <Limit GET POST OPTIONS PROPFIND>
                Order allow,deny
                Allow from all
        </Limit>
        <LimitExcept GET POST OPTIONS PROPFIND>
                Order deny,allow
                Deny from all
        </LimitExcept>
</Directory>

	APPENDDEF(`confINCDIRS',`-I/usr/local/include')
	APPENDDEF(`confLIBDIRS',`-L/usr/local/lib')
	APPENDDEF(`confLIBS',`-lantispam')

	/usr/sbin/sendmail -L sm-mta -bd -q15m
	/usr/sbin/sendmail -L sm-msp-queue -Ac -q15m

        LOOKUP_INCLUDE=-I/usr/local/include
        LOOKUP_LIBS=-L/usr/local/lib -lantispam