|
|
Now you can start the installation . If it's your first "assp
deluxe for cpanel" installation , do not worry.
During the installation your clients will be able
to send and receive email
. If you follow the installation step by step you'll not have
problems. If you fail a step you can
email me
with your licensed ip and explain me where you started to have problems.
At the end of installation you should apply the POST INSTALLATION STEPS
HERE .
INSTALLATION
Time required to complete this installation,
20~30
minutes
Only If you need to uninstall correctly mailscanner
please read this
Deactivate/turn off spamassassin
To deactivate spamassassin open WHM then select
Service Configuration > Service Manager and uncheck
spamd

save Service Manager settings
then go to
Server Configuration > Tweak settings and uncheck
spamassassin and boxtrapper as shown below,
and save Tweak Settings.

- please be sure antirelayd service is running
go to WHM >> Service Configuration >> Service Manager and check antirelayd

- You need a default/reset exim configuration, since all the spam/virus filtering work will be done by
ASSP.
Exactly how to "clean/reset exim.conf" ? Open WHM , go to "Service Configuration" , then "Exim Configuration Editor" ,
then "Advanced editor". You should empty all text boxes (ACL too , it should be recreated automatically **) , then click on "save". Alternativelly (better solution) to "clean/reset exim.conf" , Open WHM , go to "Service Configuration" , then "Exim Configuration Editor" , and click on "RESET ALL CONFIGS TO DEFAULT"
** note : in some OS (for example on Trustix), I noticed that the ACL sections are not re-created automatically from cPanel , in this case you should execute "reset ACL config to default" or "RESET ALL CONFIGS TO DEFAULT" to recreate ACL section .
- On Cpanel 10 you should configure
WHM > Exim Configuration editor in
this way

- On Cpanel 11 you should configure
WHM > Exim Configuration editor in
this way (all disabled except of "validate
sender")

Ok , now go to ssh console ,
execute following command to check your Perl version...
perl -v
if you have Perl version 5.8.7 or above you can continue (5.8.8 is better especially with cpanel 11) . Otherwise execute /scripts/perlinstaller and check again the perl version. If /scripts/perlinstaller fails to update Perl go to http://layer1.cpanel.net download the latest Perl installer and install it.
now execute following command to check your (Cpanel) php version...
/usr/local/cpanel/3rdparty/bin/php -v
if you have a php version 4.4.4 or above you can continue .
now check if you have ClamAV antivirus installed
clamd --v
or
/usr/sbin/clamd --v
if it returns ClamAV 0.91.1 or above you
can continue
Otherwise you should install/upgrade clamavconnector using WHM / ADD on modules
(WHM > Cpanel > plugins on cpanel 11).
If you are using a custom clamAV installation I recommend you to remove it
and use only ClamAV provided by WHM/Cpanel-
Ok now create the folder /usr/local/assp
mkdir /usr/local/assp
Now we install required perl modules
cd /usr/local/assp;wget http://www.grscripts.com/assp/assp_modules_installer
chmod 700 assp_modules_installer;./assp_modules_installer;rm -f
assp_modules_installer
Now we start with ASSP installation .
cd /usr/local/assp
wget
http://www.grscripts.com/131/ASSP_1.3.1-Install.zip
unzip -d /usr/local/assp /usr/local/assp/ASSP_1.3.1-Install.zip
mv --target-directory=/usr/local/assp /usr/local/assp/ASSP/*
mv --target-directory=/usr/local/assp /usr/local/assp/ASSP/.DS_Store
If mv --target-directory is not accepted try this
mv /usr/local/assp/ASSP/* /usr/local/assp;mv /usr/local/assp/ASSP/.DS_Store /usr/local/assp
then execute
rm -rf /usr/local/assp/__MACOSX
rm -rf /usr/local/assp/ASSP;rm -f ASSP_1.3.1-Install.zip
Now we get latest ASSP version and assp configuration file (latest blue line)
cd /usr/local/assp
wget -r -nH --cut-dirs=10
http://www.grscripts.com/135_50/assp.tar.gz
tar xvzf assp.tar.gz;rm -f assp.tar.gz
chmod 700 assp.pl;chmod 755 rebuildspamdb.pl;chmod 755 repair.pl
wget -r -nH --cut-dirs=10
http://www.grscripts.com/135_50/assp.cfg
Now we create working files and folders
cd /usr/local/assp;mkdir pb;cd pb
touch denysmtp.txt;touch exportedextreme.txt;touch pbdb.black.db
touch pbdb.rbl.db;touch pbdb.white.db
cd /usr/local/assp;mkdir notspam;mkdir spam;mkdir errors
mkdir /usr/local/assp/errors/notspam;mkdir /usr/local/assp/errors/spam
chmod 700 /usr/local/assp/spam;chmod 700 /usr/local/assp/notspam;chmod 700
/usr/local/assp/errors
assp service files .
assp (md5sum) fe30e822862be1779512b1d1afd2736d
start (md5sum) 9f45ed18d57e6e59c3ab32a73bd0681b
stop (md5sum) 85551ce48a568bb8b15d2aa9882131d0
cd /usr/local/assp
wget -r -nH --cut-dirs=10
http://www.grscripts.com/service/start
chmod 700 start
wget -r -nH --cut-dirs=10
http://www.grscripts.com/service/stop
chmod 700 stop
cd /etc/rc.d/init.d
wget -r -nH --cut-dirs=10
http://www.grscripts.com/service/assp
chmod 755 assp
cd /usr/local/assp
( note : ONLY If you have
Trustix OS execute this
cd /etc;mkdir rc.d;cd rc.d;mkdir init.d
cd /etc/rc.d/init.d
wget -r -nH --cut-dirs=10
http://www.grscripts.com/service/assp
chmod 755 assp
cd /etc/init.d;wget -r -nH --cut-dirs=10
http://www.grscripts.com/service/assp;chmod 755 assp
cd /usr/local/assp
)
Now we start to configure ASSP with ASSP Deluxe for cPanel .
First we install ASSP Deluxe scripts on /usr/local/assp/deluxe in this way
cd /usr/local/assp;mkdir deluxe;cd /usr/local/assp/deluxe
ln -s /etc/relayhosts /usr/local/assp/deluxe/relayhosts
wget -r -nH --cut-dirs=10
http://www.grscripts.com/assp150/deluxe/assp.tar.gz
tar xvzf assp.tar.gz;rm -f assp.tar.gz;chmod 755 *.*;chmod 755 *
chmod 666 *spam_lover;chmod 666 assp_catch_all;chmod 755 /usr/local/assp/rebuildspamdb.pl
Only if you have a 64 Bit OS you should execute
following commands too (it will update the /ioncube folder with 64 bit
encoders)
cd /usr/local/assp/deluxe/ioncube
wget -r -nH --cut-dirs=10
http://www.grscripts.com/ioncube64/ioncube64.tar.gz
tar xvzf ioncube64.tar.gz;rm -f ioncube64.tar.gz
WHM ASSP Deluxe for cPanel interface
Now you can install the WHM ASSP Deluxe for Cpanel interface .
cd /usr/local/cpanel/whostmgr/docroot/cgi
wget -r -nH --cut-dirs=10
http://www.grscripts.com/asspwhm/whm.tar.gz
tar xvzf whm.tar.gz;rm -f whm.tar.gz
Only if you have a 64 Bit OS you should execute
following commands too (it will update the /ioncube folder with 64 bit
encoders)
cd /usr/local/cpanel/whostmgr/docroot/cgi/ioncube
wget -r -nH --cut-dirs=10
http://www.grscripts.com/ioncube64/ioncube64.tar.gz
tar xvzf ioncube64.tar.gz;rm -f ioncube64.tar.gz
Now , if you open WHM , and go down to ADD-ons menu ,
you should find the link Grscripts ASSP Deluxe .
Cpanel ASSP Deluxe for cPanel user frontend
Now we install the ASSP Deluxe Cpanel Web interface .
Open WHM , go down to ADD-ons menu , and click
on the link Grscripts ASSP Deluxe
Go to Install / Upgrade Center ,
ASSP Deluxe for cPanel frontend

Select a supported Cpanel theme (x ,x2 , xmail , moonson ,
bluelagoon, rvskin , x3/x3mail, xcontroller, ALL THEMES) or
enter a custom Cpanel theme then click
the "ASSP Deluxe Cpanel Frontend" button to install the ASSP Deluxe
for Cpanel frontend.
If you receive a message like this you can continue

The web interface for your clients will be installed on
/usr/local/cpanel/base/frontend/yourskin/asspdeluxe
and you can view the web interface pointing your browser to
/usr/local/cpanel/base/frontend/yourskin/asspdeluxe/index.php
.
The installed above will adjust links on you cpanel theme .
Do not forget to
remove/disable spamassassin and boxtrapper everywhere from your control
panel and WHM .
To enable ASSP deluxe on RVSKIN theme
(note: with latest Rvskin versions ASSP Deluxe
is automatically detected, so you can skip the step below )
|

How to change/customize language or html for your ASSP deluxe for cPanel frontend
By default the ASSP Deluxe Cpanel frontend will use the english
and/or the spanish language .
If you
want use another language style or if you want change something on
the html layout please
read here .
(Of course you can do this step later) .
Ok ,
return to ssh console and execute this
# /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/ex_ips.php
# /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/ex_localdomains.php
# /usr/local/cpanel/3rdparty/bin/php /usr/local/assp/deluxe/update_email.php
If you receive no error you can continue .
Now you must set ASSP DELUXE cronjobs for ex_localdomains.php
, update_email.php and
status.php.
Execute crontab -e to add following cronjobs
10 12 * * * /usr/bin/freshclam --quiet --log-verbose
--daemon-notify
10 4 * * * cd /usr/local/assp;perl /usr/local/assp/rebuildspamdb.pl
*/59 * * * * /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/ex_localdomains.php
*/3 * * * * /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/update_email.php
*/1 * * * * /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/status.php
If you don't want receive email notification each time these cron execute (strongly recommended) enter them at the end of your cronjob list in this way (avoid the "> /dev/null" solution , since it will NOT work with these scripts.)
10 12 * * * /usr/bin/freshclam --quiet --log-verbose
--daemon-notify
10 4 * * * cd /usr/local/assp;perl /usr/local/assp/rebuildspamdb.pl
MAILTO=""
*/59 * * * * /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/ex_localdomains.php
*/3 * * * * /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/update_email.php
*/1 * * * * /usr/local/cpanel/3rdparty/bin/php
/usr/local/assp/deluxe/status.php
MAILTO=root
ex_localdomains.php creates 2 flat files very important to use ASSP on a cPanel server.-
update_email.php updates assp_local_email and
assp_local_domains . |
Now execute this
# replace :blackhole: :fail: -- /etc/valiases/*
# /usr/local/cpanel/3rdparty/bin/php /usr/local/assp/deluxe/fix_valiases.php
fix_valiases.php modifies files on /valiases to work with assp.
assp.cfg
You already downloaded some step above assp.cfg
. This assp configuration file assp.cfg
is already configured to work on
a cPanel server and to use the assp Deluxe for Cpanel. You should
change following parameters with your own settings;
open assp.cfg with an editor (pico,vi ...)
# cd /usr/local/assp
# pico assp.cfg
...and replace
the first 5 lines ;
webAdminPassword:=nospam4me
EmailAdminReportsTo:=email@youremail.com
EmailFrom:=email@youremail.com
EmailVirusReportsTo:=email@youremail.com
SpamError:=500 Mail appears to be unsolicited -- send error reports to
email@youremail.com
as follows....
a) email addresses
replace email@youremail.com
with your email address . Your email address should be
an internal email . I strongly suggest you to use
root@yourhostname.com (of
course replace yourhostname.com
with your hostname . You can get your hostname
executing
# hostname ).
b) change the default assp web interface password
(nospam4me) with a new password
webAdminPassword:=nospam4me
** DON'T USE YOUR ROOT PASSWORD FOR
YOUR ASSP WEB INTERFACE **
Save the file and close the editor.
|
Now we check if assp can run as a service
execute this
# service assp start
or
# /etc/rc.d/init.d/assp start
if assp starts without errors, you can continue
. If it doesn't start
or the command prompt returns only after a long delay
please
email me specifing your licensed ip
(if you want the problem solved asap provide me your root login too).
Now you can try if the ASSP Web Interface
works fine ; open your browser
and point it to
Login with "assp" and your assp password ,you set it before, some row above point b) .
If you want run exim also on another port (i.e. 26) be sure to turn off (yes off, because ASSP will handle the alternative port) the alternative port on WHM -> Service Configuration -> Service Manager (as shown below) .
|
If the ASSP Web Interface works fine, return to command line and execute this
# service assp status
or
# /etc/rc.d/init.d/assp status
if you receive something like "ASSP (pid 13625) is running" you can continue
Now if you want run assp automatically each time you restart the server (If
you have a FreeBSD or Fedora OS server skip this step)
chkconfig --add assp
Only if you have a FreeBSD server and you want run assp automatically each time you restart the server execute this
echo 'assp_enable="YES"' >> /etc/rc.conf
Only if you have a Fedora OS server and you want run assp automatically each time you restart the server execute this
echo '/etc/rc.d/init.d/assp start' >> /etc/rc.local
Now you should modify exim , only after
this step ASSP will start to process email.
Open WHM
, Exim Configuration Editor , then select Advanced Editor
On the first box enter the following code
###### enable assp proxy
######
local_interfaces = 127.0.0.1
daemon_smtp_ports = 125
log_selector = +arguments +subject
Now you should
empty/clear all other exim text boxes .
ACL section too
, it should be recreated automatically
** . Then
click on "save".
( Before saving exim , create a backup of your current /etc/exim.conf .
# cp /etc/exim.conf /etc/exim.conf_old
It will be useful only if you'll decide
to uninstall ASSP. )
** important note :
in some OS (for example on Trustix and centos 5), I noticed that the ACL
sections are not re-created automatically from cPanel , in
this case you should execute "reset ACL config to default"
to recreate ACL section after the "Save".
If exim does not restart at this step , execute this from console
# /etc/rc.d/init.d/assp stop;/etc/rc.d/init.d/assp start
and restart exim from whm or from command line with
# service exim restart
or
# /etc/rc.d/init.d/exim restart
exim should restart without errors. Now ASSP and exim should work fine .
To see if ASSP is working fine execute this
# cd /usr/local/assp/
# tail -f /usr/local/assp/maillog.txt
You may also execute
# /etc/rc.d/init.d/assp restart;tail -f /usr/local/assp/maillog.txt
To check errors exactly when assp (re)starts .
The command above should return something like this
Apr-3-08 02:53:14 ASSP version 1.3.5(5.0) (Perl 5.008007)
initializing
Apr-3-08 02:53:14 File::Scan::ClamAV module version 1.8 installed and
available
Apr-3-08 02:53:14 ASSP running on server: redhat.abcserver.com
Apr-3-08 02:53:14 Net::DNS module version 0.63 installed and available
Apr-3-08 02:53:14 Email::Valid module version 0.179 installed and available
Apr-3-08 02:53:14 Mail::SPF::Query module version 1.999001 installed and
available
Apr-3-08 02:53:14 Mail::SRS module version 0.31 installed - Sender Rewriting
Scheme available
Apr-3-08 02:53:14 Compress::Zlib module version 1.42 installed - HTTP
compression available
Apr-3-08 02:53:14 Digest::MD5 module version 2.36 installed - delaying can
use MD5 keys for hashes
Apr-3-08 02:53:14 File::ReadBackwards module version 1.04 installed -
searching of log files enabled
Apr-3-08 02:53:14 Time::HiRes module version 1.9712 installed - CPU usage
statistics available
Apr-3-08 02:53:14 Sys::Syslog module version 0.18 installed - Unix
centralized logging enabled
Apr-3-08 02:53:14 Tie::RDBM module version 0.70 installed - mysql usage
available
Apr-3-08 02:53:14 Net::IP::Match::Regexp module version 1.00 installed -
CIDR notation for IP range available
Apr-3-08 02:53:14 Net::CIDR::Lite module version 0.20 installed - hyphenated
IP address range available
Apr-3-08 02:53:14 Net::SenderBase module version 1.01 installed - Query the
senderbase service available
Apr-3-08 02:53:14 LWP::Simple module version 1.41 installed - procedural LWP
interface available
Apr-3-08 02:53:14 Listening for mail connections at 25 and admin
connections at 55555 and stat connections at 55553
Apr-3-08 02:53:14 Listening for additional mail connections at 26
Apr-3-08 11:43:40 Warning: Bayesian spam database is small or empty:
'/usr/local/assp/spamdb'
Apr-3-08 11:43:40 Warning: whitelist is small or empty:
'/usr/local/assp/whitelist' (ignore if this is a new install)
Apr-3-08 11:43:40 Starting PID: 28271
You can ignore the 2 warnings above because ASSP must still create a
bayesian database and a whitelist .
If you see some other errors you failed some step on the "how to" and it
should be fixed.
If all works fine and messages are processed correctly you can now check if also exim is working fine.
# tail -f /var/log/exim_mainlog
If email are processed with a final "completed" message like this ...
2007-11-13 11:25:20 1Irs1F-0000vx-9U -> em@my.com.tr
R=lookuphost T=remote_smtp H=my.com [84.1.1.1] X=TLSv1:AES256-SHA:256
2007-11-13 11:26:30 1Irs2P-0002XB-T3 Completed
It's all ok and you can CLICK HERE TO CONTINUE . If you see ACL errors like this
unknown ACL verb "check_recipient" in "check_recipient"
followed by a "unexpected disconnection while reading SMTP command"
. open WHM > exim configuration editor >
and try "reset ACL config to default" , then restart Exim and ASSP
using WHM and WHM assp interface.
If the problem is still not fixed open WHM > exim configuration editor > and
execute "Reset ALL config to defaults" .
After this step you should go again to WHM > exim configuration editor
> Advanced editor and re-enter
on the first box enter the following code
###### enable assp proxy
######
local_interfaces = 127.0.0.1
daemon_smtp_ports = 125
log_selector = +arguments +subject
Save exim . Now return to WHM > exim configuration editor and set again
"Standard Options" as was explained above in
this how to. Now restart ASSP using WHM. The ACL error on exim
mailllog should be fixed and all should be ok .
If on exim maillog you see "unexpected disconnection while reading SMTP command"
lines without ACL errors , it's a normal behavior , ASSP is
disconnecting from EXIM because the email was rejected due to spam (email
disctionary attack or other reason) .
Now please read and apply
the post installation FAQS
Maintenance
|
Uninstalling assp ?
Time required : 5 minutes
(#01)
uninstallation requires about 5 minutes ,
may I ask you
why ?
Note that if you had/have a temporarly ASSP problem there is no need to uninstall
it , simply follow
this procedure .
If you
want really uninstall it, follow this procedure ;
First , if you
are using ASSP MONITOR , uninstall it
using assp WHM , OR open WHM then select Service Configuration > Service Manager and
uncheck assp service. If you
are using the assp_monitor.php or status.php cronjob , remove it.
STOP ASSP using WHM assp (or from command line
# /etc/rc.d/init.d/assp stop).
Open WHM > exim configuration editor > and execute "Reset ALL config
to defaults"
Ok now you are already using exim without assp .
now execute
replace 'SMTPPORT = 125' '' -- /usr/local/cpanel/3rdparty/mailman/Mailman/mm_cfg.py
Now uninstall assp from your cPanel themes, you can use the WHM Interface
.
Go to Install / Upgrade Center , ASSP Deluxe
for cPanel frontend
, select the theme and check Uninstall
Now remove the ASSP WHM interface in this way
rm -f
/usr/local/cpanel/whostmgr/docroot/cgi/addon_assp_deluxe.php
rm -f /usr/local/cpanel/whostmgr/docroot/cgi/assp_deluxe*
rm -frd /usr/local/cpanel/whostmgr/docroot/cgi/deluxe
Now remove fully ASSP in this way
rm -frd /usr/local/assp
chkconfig --del assp
now remove all cronjobs required by assp and assp deluxe .
If you was using spamd and box trapper re-enable them from WHM/cPanel.
Now execute/force a cPanel update with
/scripts/upcp --force
Done !


