Changes

From SME Server
Jump to navigationJump to search

Unjunkmgr (view source)

Revision as of 17:50, 24 September 2013

2,571 bytes added ,  17:50, 24 September 2013
→‎Installation
Line 1: Line 1: −
[[Category:Mail]][[Category:Contrib]]
  −
   
==Maintainer==
 
==Maintainer==
−
This contrib has been developed by [[User:Knuddi|Jesper Knudsen]]  
+
This contrib has been developed by [[User:Knuddi|Jesper Knudsen]] from [http://smeoptimizer.swerts-knudsen.dk SME Optimizer]
    
==Description==
 
==Description==
Line 17: Line 15:  
==Installation==
 
==Installation==
   −
The package needs the Perl-MIME-Lite package to be able to send out HTML formatted emails and MRTG to create the statistics graphs.
+
You can install this contribs by yum with the following command. You should use this method as you will have always the newest version.
 +
yum install --enablerepo=smecontribs smeserver-unjunkmgr
   −
  yum install perl-MIME-Lite --enablerepo=smecontribs
+
and then
−
  yum install mrtg --enablerepo=base
+
  expand-template /etc/crontab
−
{{Note box|Make sure you have the [base] repository enabled for yum or it cannot find the MRTG package!}}
+
expand-template /etc/httpd/conf/httpd.conf
 +
  /etc/rc.d/init.d/httpd-e-smith restart
   −
Then install the sme-unjunkmgr RPM from (I will get around and release to contribs later):
+
or
 +
signal-event post-upgrade; signal-event reboot
   −
rpm –Uvh http://sme.swerts-knudsen.com/downloads/unjunkmgr/sme-unjunkmgr-1.0.1-1.noarch.rpm
+
====Upgrading====
   −
====De-installation or de-activation====
+
  yum upgrade --enablerepo=smecontribs smeserver-unjunkmgr
−
You can simply remove the package again with the usual rpm command.  
+
====Uninstall====
 +
You can simply remove the package again with the usual yum command.  
   −
  rpm –e sme-unjunkmgr-1.0.1-1
+
  yum remove smeserver-unjunkmgr
   −
If you are uninstalling version 1.0.0-1 you also need to also expand templates.
+
NOTE: If you are uninstalling version '''1.0.0-1''' you also need to also expand templates.
 
  expand-template /etc/crontab
 
  expand-template /etc/crontab
 
  expand-template /etc/httpd/conf/httpd.conf
 
  expand-template /etc/httpd/conf/httpd.conf
 
  /etc/rc.d/init.d/httpd-e-smith restart
 
  /etc/rc.d/init.d/httpd-e-smith restart
   −
or disable the functionality with:
+
==Configuration==
 +
 
 +
====Email Notifications====
 +
The UnJunk Manager sends out the summary email every Friday at 1PM to all users with emails stored in their junkmail folder. If you wish the admin account to get copied on all these user emails then this can be enabled/disabled with (default: no):
   −
  /sbin/e-smith/db configuration set unjunkmgr service enabled <no|yes>
+
  /sbin/e-smith/db configuration setprop unjunkmgr adminemails <no|yes>
   −
==Configuration==
+
If you just want to use the UnJunk Manager to gather statistics and not send out any summary emails to the users you can disable this functionality with (default: yes):
   −
The SpamAssassin learning does require that the SpamAssassin bayes filters have been enabled though. How this is done can be read at http://wiki.contribs.org/Email#Setup_Blacklists_.26_Bayesian_Autolearning or through these few shell commands.
+
/sbin/e-smith/db configuration setprop unjunkmgr useremails <no|yes>
   −
config setprop spamassassin UseBayes 1
+
How do I configure the UnJunkMgr to use an IP address or a different hostname rather than the primary domain name when it sends out the weekly overview (default: domainname)?
−
config setprop spamassassin BayesAutoLearnThresholdSpam 4.00
  −
config setprop spamassassin BayesAutoLearnThresholdNonspam 0.10
  −
expand-template /etc/mail/spamassassin/local.cf
  −
sa-learn --sync --dbpath /var/spool/spamd/.spamassassin -u spamd
  −
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes_*
  −
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes.mutex
  −
chmod 640 /var/spool/spamd/.spamassassin/bayes_*
  −
config setprop spamassassin status enabled
  −
signal-event email-update
      +
/sbin/e-smith/db configuration setprop unjunkmgr unjunkhost <hostname|IP address>
   −
Personally I also think that the default 90 days of retention for emails in the junkmail folder is way to long - who bothers to look at 90 days old emails anyways? I run with 15 days of retention on all my installations.
+
The summary emails contain a link to an web page where emails can be unjunked (released to he inbox). These URLs cann, by default, only be seen from the local network (IP ranges defined in Local Network in the server-manager) but if you want this to be accessible from remote networks (public access) this can be done via (default: yes):
   −
  db configuration setprop spamassassin MessageRetentionTime 15  
+
  /sbin/e-smith/db configuration setprop unjunkmgr LocalOnly <no|yes>
−
  signal-event email-update
+
  expand-template /etc/httpd/conf/httpd.conf
 +
  /etc/rc.d/init.d/httpd-e-smith restart
    +
====Statistics====
    
The UnJunk Manager also collects statistics on the emails passing through the mail server. This is accessible from:
 
The UnJunk Manager also collects statistics on the emails passing through the mail server. This is accessible from:
Line 67: Line 66:  
http://your.domain.com/unjunkmgr
 
http://your.domain.com/unjunkmgr
   −
This web page and the unjunk functionality can, by default, only be seen from the local network (IP ranges defined in Local Network in the server-manager) but if you want this to be accessible from remote networks (public access) this can be done via:
+
This web page and the unjunk functionality as described above can, by default, only be seen from the local network (IP ranges defined in Local Network in the server-manager) but if you want this to be accessible from remote networks (public access) this can be done via (default: yes):
    
  /sbin/e-smith/db configuration setprop unjunkmgr LocalOnly <no|yes>
 
  /sbin/e-smith/db configuration setprop unjunkmgr LocalOnly <no|yes>
Line 73: Line 72:  
  /etc/rc.d/init.d/httpd-e-smith restart
 
  /etc/rc.d/init.d/httpd-e-smith restart
   −
[[Image:Unjunkweb.jpg]]
+
[[Image:Unjunkwebstat.jpg]]
    
An additional feature of the UnJunk Manager is to send the collected statistics to a central statistics central at http://central.swerts-knudsen.dk. The gathering of data is not stressful for the server and the data sent is not sensitive (well in my opinion) and consists of:
 
An additional feature of the UnJunk Manager is to send the collected statistics to a central statistics central at http://central.swerts-knudsen.dk. The gathering of data is not stressful for the server and the data sent is not sensitive (well in my opinion) and consists of:
−
-  amount of emails scanned
+
 
−
-  number of spam infected or virus infected emails
+
* Amount of emails scanned
−
-  if virus infected the name of the virus found
+
* Number of spam infected (tagged and rejected) or virus infected emails (if virus found the ClamAV name)
−
-  the version of SME server used
+
* The version of SME server used  
 +
* Public IP address of server (used to plot in Google Maps on central.swerts-knudsen.com)
    
Should you want to disable this functionality then this can obviously be done:
 
Should you want to disable this functionality then this can obviously be done:
Line 85: Line 85:  
  /sbin/e-smith/db configuration setprop unjunkmgr statsclient <disabled|enabled>
 
  /sbin/e-smith/db configuration setprop unjunkmgr statsclient <disabled|enabled>
   −
Today around ~850 servers still active with my sme-spamfilter contrib and ~450 servers using my sme-antivirus for SME 6x send in data for this “worldwide overview”.
+
====SpamAssassin bayes filters====
   −
[[Image:Centralweb.jpg]]
+
The SpamAssassin learning requires that the SpamAssassin bayes filters have been enabled though. How this is done can be read at http://wiki.contribs.org/Email#Setup_Blacklists_.26_Bayesian_Autolearning or through these few shell commands.
 +
 
 +
config setprop spamassassin UseBayes 1
 +
config setprop spamassassin BayesAutoLearnThresholdSpam 4.00
 +
config setprop spamassassin BayesAutoLearnThresholdNonspam 0.10
 +
expand-template /etc/mail/spamassassin/local.cf
 +
sa-learn --sync --dbpath /var/spool/spamd/.spamassassin -u spamd
 +
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes_*
 +
chown spamd.spamd /var/spool/spamd/.spamassassin/bayes.mutex
 +
chmod 640 /var/spool/spamd/.spamassassin/bayes_*
 +
config setprop spamassassin status enabled
 +
signal-event email-update
 +
 
 +
 
 +
Personally I also think that the default 90 days of retention for emails in the junkmail folder is way to long - who bothers to look at 90 days old emails anyways? I run with 15 days of retention on all my installations.
 +
 
 +
db configuration setprop spamassassin MessageRetentionTime 15 
 +
signal-event email-update
 +
 
 +
====Unofficial ClamAV signatures====
 +
I would also recommend to install the script that downloads all the unofficial ClamAV signatures as these detects not only virus but equally importantly various kinds of malware and spam.
 +
 
 +
Follow the guide for [[Virus:Additional_Signatures|Additional Virus Signatures]] to do that.
    
==FAQ==
 
==FAQ==
    
===How do I see what this Summary of Junkmail looks like without sending to all my users?===
 
===How do I see what this Summary of Junkmail looks like without sending to all my users?===
−
You will need to change the “$debug = 0;” to “$debug = 1;” in the configuration section of the /usr/local/unjunkmgr/spamreminder.pl file. Then launch the reminder manually with:  
+
You will need to change config via:
 +
/sbin/e-smith/db configuration setprop unjunkmgr useremails no
 +
/sbin/e-smith/db configuration setprop unjunkmgr adminemails yes
 +
 
 +
Then launch the reminder manually with:  
 
  /usr/local/unjunkmgr/spamreminder.pl
 
  /usr/local/unjunkmgr/spamreminder.pl
 +
 
All the summary emails will now be sent to “admin”.
 
All the summary emails will now be sent to “admin”.
   Line 167: Line 194:     
Improved uninstall to clean up properly  
 
Improved uninstall to clean up properly  
 +
|- style="background-color:#FFFFFF"
 +
|1.1.0-1
 +
|Updated statistics overview to use pie charts for spam and different tables for virus found
 +
 +
Added new configuration parameters for most commonly asked changes to avoid hard-coding
 +
 +
Improved log file checks to avoid catching errors and warnings from ClamAV
 +
 +
Generally improved code to remove warnings to admin when sending weekly summary emails
 +
|- style="background-color:#FFFFFF"
 +
|1.1.1-1
 +
|Fixed problem with weekly emails (error line 112 in spamreminder.pl)
 +
 +
Fixed problem in post-upgrade script that caused upgrades from earlier versions to fail
 +
 +
|- style="background-color:#FFFFFF"
 +
|1.1.3-1
 +
|Now also counting rejected emails that never reaches SpamAssassin (rejected due to missing mailbox, reverse DNS fails, etc.)
 +
 +
Fixed problem using unjunkhost configuration parameter
 +
 +
Updated style sheets (CSS) to show nicely also using IE
 +
 +
Added statistic for top spammed email accounts
 +
 
|}
 
|}
 +
----
 +
[[Category:Mail]]
 +
[[Category:Contrib]]
 +
[[Category:Administration:Content Spam Virus Blocking]]
 +
[[Category:Administration:Monitoring]]
Retrieved from "https://wiki.koozali.org/Special:MobileDiff/11748...21602"

Navigation menu