Install ASSP

1. Go to your preferred download directory. If you don't have one, your home directory will be fine.
2. Download the ASSP program files. Go to its SourceForge project page (http://sourceforge.net/projects/assp/files/), copy the download link and paste it after a wget command. It should look something like this:
   * You should always download the latest stable version; version numbers used here are for example purposes only.

wget http://sourceforge.net/projects/assp/files/ASSP%20Installation/ASSP%201.8.1.1/ASSP_1.8.1.1-Install.zip

3. Unzip ASSP:

unzip ASSP_1.8.1.1-Install.zip

4. Create a directory for the ASSP program files:

mkdir /usr/share/assp

5. Copy ASSP to its new home directory:

cd ASSP_1.8.1.1-Install
cp -R ASSP/* /usr/share/assp

6. Install SSLeay dependencies (these will be needed for some perl modules in the next step):

apt-get install libssl-dev libdb-dev

7. Install required perl modules by runing the mod_inst.pl script:

cd /usr/share/assp
perl mod_inst.pl

8. Accept all defaults when prompted. This will take a while...
9. When the script is done, all modules should say [OK].
10. If any of the modules say [FAILED], try to re-run the mod_inst.pl script because sometimes a dependency may have gotten installed after that module tried to install.
11. In some cases the File::Scan::ClamAV perl module may fail to install. If this is the case, then just go into CPAN...

    perl -MCPAN -e shell

    ...and force the install at the CPAN prompt:

    force install File::Scan::ClamAV

12. Run the mod_inst.pl script again just to make sure everything is [OK]. If something isn't, check your perl dependencies.
13. Run ASSP for the first time. It should start without errors or significant warnings:

perl assp.pl &

Configure ASSP

This is just a very basic configuration to get you started and get some options up and running. After you finish this How-To, you should go to the ASSP wiki or forums to find documentation on how to fully configure ASSP.

1. From any web browser in the network, go to http://<hostname or ip>:55555 (default password is nospam4me, leave username blank) and change the following settings:
• Server Setup section:
  Enable "Run ASSP as a Daemon" (AsADaemon)
  Enable "Enable HTTP Compression in GUI" (EnableHTTPCompression)
• ClamAV and FileScan section:
  Enable "Use ClamAV" (UseAvClamd)
  Change "Port or file socket for ClamAV" (AvClamdPort) to /var/run/clamav/clamd.ctl
• SSL/TLS section:
  If you wish to offer secure/encrypted mail, enable "Enable SSL/TLS support" (enableSSL)
2. Stop ASSP and start it back up again.
3. Check to see if all perl modules are correctly installed and configured. On the Info and Stats page, check the Perl Modules section:
• All perl modules should be available (green). IPv6, SSL, and MySQL are optional.
• Ignore IO::Socket::SSL if you're not going to use SSL.
• Ignore IO::Socket::INET6 if you're not going to use IPv6.
• Ignore Tie::RDBM if you're not going to use MySQL.
4. Test the ASSP/Postfix server by telnetting to port 25.

telnet localhost 25

You should be able to see your Postfix SMTP server welcome text.
5. Enter the following HELO command:

helo yourhostname.yourdomain.tld

You should get a message similar to: 250 yourhostname.yourdomain.tld
6. Exit the SMTP server:

quit

Set Up A Startup Script For ASSP

1. Make sure that ASSP is not running. You might have to find and kill the running ASSP process if you left it running from a previous step:

ps -A | grep perl

Find the process id for the perl process (it should be the first number on the left). Kill the process:

kill -9 <proc id>

2. Make the assp.pl script executable:

cd /usr/share/assp
chmod 755 assp.pl

3. Go to this forum thread and copy the init script in the original post:
https://sourceforge.net/apps/phpbb/assp/viewtopic.php?f=5&t=980&sid=11242812618cab1504a1258cb585bb0b
4. Save the script as /etc/init.d/assp
5. Make the assp init script executable:

cd /etc/init.d
chmod 755 assp

6. Register the init script to create links and so that ASSP will run automatically at boot time (you may have to change the '50' number depending on the startup order you want):

update-rc.d assp defaults 50

7. Now you can start ASSP from the init script like this (the following commands are supported with this script: {start|stop|restart|reload|force-reload|status}):

/etc/init.d/assp start

8. Set up the GUI restart command. In the ASSP management page:
   • Automatic Update / Restart section:
     Change "OS-shell command for AutoRestart" (AutoRestartCmd) to: /etc/init.d/assp restart

Install Webmin (Optional)

Install Webmin to help you look at system resources and access most server's settings and configuration from a Web GUI.

1. Go to your preferred download directory. If you don't have one, your home directory will be fine.
2. Install Webmin dependencies:

apt-get install libnet-ssleay-perl libauthen-pam-perl libio-pty-perl apt-show-versions libapt-pkg-perl

3. Go to www.webmin.com, copy the download link to the Debian package, and paste it after a wget command:
* You should always download the latest stable version; version numbers used here are for example purposes only.

wget https://downloads.sourceforge.net/project/webadmin/webmin/1.520/webmin_1.520_all.deb

4. Install the Webmin .deb package:

dpkg -i webmin_1.520_all.deb

5. You can now logon to https://<hostname>:10000/ as root with your root password, or as any user who can use sudo to run commands as root.

Finished!

• Now go read up on some of the ASSP configuration settings and have fun setting it up.