Install ASSP

To install ASSP you will need to follow the install directions
provided in the ASSP documentation that is included with this install.


For a NEW installation:
copy the contents of the folder ASSP to a folder called ASSP and then
follow the module installation instructions at the end of this text.

For an UPDATE installation:
make sure you have a backup of the existing ASSP folder
do it again!

copy the following files  to your existing  ASSP folder:
- assp.pl
- rebuildspamdb.pl

copy the following folders  to your existing  ASSP folder:
- images
- reports
- certs
- docs
- notes

copy from folder "files" into the folder "files" inside your old ASSP folder:
(you may have to merge your modifications in the old files with the new files)
- invalidptr.txt
- URIBLCCTLDS.txt 
- nodelay.txt (merge)
- redre.txt
- ipnp.txt (merge)
- blockreportuser.txt
- validptr.txt
- bombre.txt (merge)
- whiteorg.txt (merge)
- denyalways.txt (this file is empty, delete the old one)
- strictspf.txt (merge)
- invalidhelo.txt

After you have started assp use the webadmin to change the settings to this files:

denySMTPConnectionsFromAlways: file:files/denyalways.txt
invalidFormatHeloRe: file:files/invalidhelo.txt


Attention: Because of the new Password Encryption since version 1.4.3 you cannot simply fallback to versions prior to 1.4.x
You have to restore the password directly in the assp.cfg file if you want to go back.

Perl Version 5.8 or higher is needed

List of the perl modules to be installed :

New in 1.5.1:
IO::Socket::SSL version 1.13 - native SSL support
IO::Socket::INET6  version 2.56
Email::Send version 2.192 - resend mail from block report and log
Text::Iconv - kyrillic charset converter 

New in 1.4.3:
Email::MIME::Modifier version 1.442  - attachment detection 
Mail::SPF  version 2.005
Net::CIDR::Lite version 0.20  - hyphenated IP address range 
Net::IP::Match::Regexp version 1.01  - CIDR notation for IP range 
Net::SenderBase version 1.01  - countrycode checks 

Before:
Net::LDAP version 0.33 
Net::DNS version 0.63 
Email::Valid version 0.179 
Mail::SPF::Query version 1.999001 
Mail::SPF  version 2.005
Mail::SRS version 0.31  - Sender Rewriting Scheme 
Compress::Zlib version 2.015  - HTTP compression 
Digest::MD5 version 2.36  - delaying can use MD5 keys for hashes
Digest::SHA1 version 2.11  
File::ReadBackwards version 1.04  - searching of log files enabled
Time::HiRes version 1.9715  - CPU usage statistics 
Sys::Syslog version 0.27  - Unix centralized logging possible
Net::Syslog version 0.03  - network Syslog logging possible
Tie::RDBM  - mysql usage 
Net::IP::Match::Regexp version 1.01  - CIDR notation for IP range 
Net::CIDR::Lite version 0.20  - hyphenated IP address range 
Net::SenderBase version 1.01  - countrycode checks 
LWP::Simple version 1.41  - griplist 
Email::MIME::Modifier version 1.442  - attachment detection 
Net::SMTP version 2.31  - Verify Recipients 

############################################################
Installs Perl modules used by ASSP 1.5.1.x 
############################################################

*nix (including Mac OS X) per script:

- cd to assp directory
- Run 'perl mod_inst.pl'

*nix per hand :
sudo perl -MCPAN -e shell
o conf make /usr/bin/make (Mac OS X only)

install Compress::Zlib
install Convert::TNEF
install Digest::MD5	
install Email::MIME
install Email::MIME::Modifier
install Email::Send
install Email::Valid
install File::ReadBackwards	
install File::Scan::ClamAV	
install LWP::Simple	
install MIME::Types 
install Mail::SPF
install Mail::SRS	
install Net::CIDR::Lite
install Net::DNS	
install Net::IP::Match::Regexp
install Net::LDAP	
install Net::SMTP
install Net::SenderBase	
install Net::Syslog	
install NetAddr::IP
install Sys::MemInfo 
install Sys::Syslog
install Tie::RDBM	
install Time::HiRes

only for kyrillic needed:
install Text::Iconv

Windows per script:

1). Download and install the latest version of Active Perl which currently is Version 5.10.0.1004: http://www.activestate.com/activeperl/downloads/. As you move through the installation wizard, make sure the option "Add Perl to the Path environment variable" is selected.


2). Download the Anti-Spam SMTP Proxy (ASSP) distributable and copy the ASSP folder and all contents within the zip files ASSP directory to the root of your C:\ drive. You will have C:\ASSP.

OR

Create the following directory: 
c:\assp 
then copy all of the files and directories under the ASSP folder within the zip file to C:\assp.


3). Download "assp.mod.zip" from
http://www.magicvillage.de/~Fritz_Borgs ... ?WasRead=1
and unzip the folder asp.mod into the c:/assp base directory.


4). Open a Windows command line, Run > cmd.exe and change directory to c:/assp/assp.mod/install 

If you are running a default installation and are not using an Internet Proxy, enter
perl mod_inst.pl

If you have to use an Internet Proxy OR you have not done a default installation, then
A). Edit the install.cmd file
B). Edit the blank line if the location of your ASSP installation is not default! I.E. set ASSPDIR=D:\assp
C). Please set your Proxy, if you need it.
D). Save the file install.cmd
E). Run 'install.cmd'


5). Open a Windows command line, Run > cmd.exe and change directory to c:/assp. Edit the assp.cfg file with notepad or your favorite text editor. Search for: 
webAdminPassword
Ensure this is set as follows: 
webAdminPassword:=nospam4me
Save the file.


TESTING

Open a Windows command line, Run > cmd.exe and change directory to C:\ASSP and enter 
perl assp.pl

Your command window should have some stuff appear and now you can open you favorite web browser and enter http://127.0.0.1:55555. A login window will appear. There is no user, just a password and that is nospam4me or whatever you set in step 5 above.

Surf around. You may find some URLS and other passwords that are not needed and you can simply change them to default values for now.

If you are going to install as a service, close the running assp command window.

INSTALL AS A WINDOWS SERVICE

A). Open a Windows command line, Run > cmd.exe and change directory to C:\ASSP.
B). Enter perl assp.pl c:\assp i
C). After it is installed, start the service: Right click My Computer > Manage. Double click Services and Applications. Double click Services. Right click Anti Spam SMTP Proxy and click start. The service should already be set to automatic. So a computer reboot will start the ASSP service.
D). Open your web browser and again go to http://127.0.0.1:55555 and under Server Setup make certain that Run ASSP as a Windows Service (asService) is checked.

Windows per hand:	
Make sure that the following modules are installed:
   
  	compress-zlib
  	digest-md5
  	email-mime-modifier
  	email-send
  	email-valid
  	file-readbackwards
  	file-scan-clamav (if you are going to use the virus protection from ClamAV)
  	lwp-simple
  	mail-spf
  	mail-srs
  	net-cidr-lite
  	net-dns
  	net-ip-match-regexp
  	net-ldap (if you are going to use LDAP)
  	net-smtp
  	net-senderbase
  	time-hires
	win32-daemon (if you are going to run ASSP as a service))



There is a Win32 Quick Start guide included in this release for
those who are installing on the windows platform. See file Win32-
quickstart-guide.txt

It can also be found at

http://apps.sourceforge.net/mediawiki/assp/index.php?title=Win32

Unix Installation:
https://apps.sourceforge.net/mediawiki/assp/index.php?title=Unix

If you want to run assp.pl as a daemon start first from command line:

perl assp.pl
Point your browser to http://127.0.0.1:55555/
Password: nospam4me
Section: Server Setup
Change the options and click "Apply Changes" (and restart)

AsADaemon: Run ASSP as a Daemon -- In Linux/BSD/Unix/OSX fork and close file handles. Similar to the command "perl assp.pl &;", but better.
runAsUser: Run as UID -- The *nix user name to assume after startup (*nix only). Examples: assp, nobody
runAsGroup: Run as GID -- The *nix group to assume after startup (*nix only). Examples: assp, nobody

************************************************************

Check out the ASSP project status at:
http://www.magicvillage.de/~Fritz_Borgstedt/assp/S064D398D?WasRead=1 

Go here http://sourceforge.net/mail/?group_id=69172 to subscribe to
the email list.

Visit the community forums at:
http://apps.sourceforge.net/mediawiki/phpbb/

For updated info and help visit the WIKI for ASSP at
http://apps.sourceforge.net/mediawiki/assp/

Don't forget to read the ASSP Documentation that can be found in the
wiki: https://apps.sourceforge.net/mediawiki/assp/index.php?title=ASSP_Documentation

Getting Started at
https://apps.sourceforge.net/mediawiki/assp/index.php?title=Getting_Started

ASSP workflows can be seen here:
Basic: https://apps.sourceforge.net/mediawiki/assp/index.php?title=ASSP_Basic_Workflow
Advanced: https://apps.sourceforge.net/mediawiki/assp/index.php?title=ASSP_Advanced_Workflow





