Difference between revisions of "Fetchmail"

From SME Server
Jump to navigationJump to search
m (div mods)
 
(21 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 +
{{Languages|Fetchmail}}
 
== Fetchmail for SME Server ==
 
== Fetchmail for SME Server ==
 +
{{warning box| Since SME9.2 update and smeserver-qpsmtpd-2.4.0-34.el6.sme.noarch and qpsmtpd-0.96-10.el6.sme.noarch fetchmail is not filtered by spamassassin until a fix is deployed see  Bug # [[bugzilla:10290]]
 +
 +
fixed in SME10 smeserver-qpsmtpd-2.7.0-7.el7.sme.noarch and qpsmtpd-0.96-21.el7.sme.noarch}}
 +
 +
==== Version ====
 +
{{ #smeversion: smeserver-fetchmail}}
  
 
=== Maintainer ===
 
=== Maintainer ===
Line 13: Line 20:
 
It's intended for Linux-newbies.
 
It's intended for Linux-newbies.
  
Before install, [http://www.schirrms.net/files/ check latest version here]
 
and replace filenames in step 2 & 3 if necessary.
 
  
 
=== Installation ===
 
=== Installation ===
Line 20: Line 25:
 
1. Log in (with username root) to the SMEserver console.
 
1. Log in (with username root) to the SMEserver console.
  
2. Download Fetchmail from Schirrm's site:
 
  
  wget http://www.schirrms.net/files/smeserver-fetchmail-1.3.5-01.noarch.rpm
+
2. Install Fetchmail:
 +
* For SME8
 +
  yum --enablerepo=smecontribs install smeserver-fetchmail
 +
signal-event console-save
  
3. Install Fetchmail:
+
You will get a y/N-question, answer y if it looks fine.
 +
* For SME9
  
  yum localinstall smeserver-fetchmail-1.3.5-01.noarch.rpm
+
  yum --enablerepo=smecontribs install smeserver-fetchmail
 +
signal-event console-save
  
 
You will get a y/N-question, answer y if it looks fine.
 
You will get a y/N-question, answer y if it looks fine.
  
4. Instructions at the end of previous installation advices the following commands:
+
 
 +
3. Instructions at the end of previous installation advices the following commands:
 
<br><code>"signal-event post-upgrade" and "signal-event reboot"</code>
 
<br><code>"signal-event post-upgrade" and "signal-event reboot"</code>
 
<br>But you can ignore that and move on
 
<br>But you can ignore that and move on
  
5. In the server-manager, part 'Collaboration' you should find a 'Mails Retrieval' option.
+
 
 +
4. In the server-manager, part 'Collaboration' you should find a 'Mails Retrieval' option.
  
 
This let you access on the main page of the Fetchmail configuration.
 
This let you access on the main page of the Fetchmail configuration.
Line 48: Line 59:
 
For more info check [http://schirrms.net/sme/SMEFetchMail.php Schirrm's HowTo] here.
 
For more info check [http://schirrms.net/sme/SMEFetchMail.php Schirrm's HowTo] here.
  
If you connect to the SMEserver console by Putty ssh-client (or similar) you can copy and paste the commands (very convenient).
+
To enable detailed logging on a per account basis for troubleshooting purposes do the following:
 +
 
 +
From the Fetchmail management interface, select mail retrevial, select the required account, set the option for: Do you want to debug this account  - YES
 +
 
 +
Look at the maillog log file a few hours later for possible clues.
 +
 
 +
 
 +
To enable detailed logging in Fetchmail (and be able to monitor it after typing /etc/startmail), manually edit /etc/fetchmail and put fetchmail in verbose mode.
 +
Then start it with /etc/startmail and check the log with tail -f
 +
 
 +
Taken from [http://forums.contribs.org/index.php/topic,44653.0.html this forum post].
 +
 
 +
===Configuration ===
 +
 
 +
if Fetchmail start to load multiple time the same emails, this might be a timeout problem, you should increase the default value (30 second):
 +
/sbin/e-smith/db configuration setprop FetchMails timeout 30
 +
/sbin/e-smith/expand-template /etc/fetchmail
 +
 
 +
If Fetchmail is unable to find te destination host, you can set it here:
 +
/sbin/e-smith/db configuration getprop FetchMails fetchhost
 +
/sbin/e-smith/expand-template /etc/fetchmail
 +
 
 +
=== FAQ ===
 +
'''Q: What do these strange mails with '#********' from cron mean?'''<br>
 +
A: If you enabled the debug option for an account in the Mail Retrieval panel in the server-manager you will possibly receive mail from Cron Daemon with the subject "Cron <root@YOURSERVER> /etc/startmail". The mail contains patterns like this: #********.
 +
You will stop receiving this mails if you disable debugging for all configured users in the Mail Retrieval panel in the server-manager.
 +
 
 +
 
 +
===E-mail Retrieval Error===
 +
If your ISP does not provide a custom sort field and you experience the following errors occuring when Multidrop is enabled and the "Select Sort Method (for multi-drop)" is set to Default:
 +
 
 +
fetchmail: warning: multidrop for pop3.mypopserver.com requires envelope option!
 +
fetchmail: warning: Do not ask for support if all mail goes to postmaster!
 +
 
 +
and/or
 +
 
 +
fetchmail: warning: multidrop for my.isp.domain requires envelope option!
 +
fetchmail: warning: Do not ask for support if all mail goes to postmaster!
 +
 
  
Please note that this was written in april 2007, if the software change then this howto may be outdated.
+
Set "Select Sort Method (for multi-drop) to 'Received' or 'for'
 +
As described at [[bugzilla:5602]] [[bugzilla:6483]]
  
Please do edit if you find errors or have improvements, but make sure that it works!
+
=== Bugs ===
 +
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-fetchmail component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-fetchmail|title=this link}}.
  
Good luck [http://wiki.contribs.org/User:Per /Per]
 
  
=== Tested software version ===
+
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-fetchmail |noresultsmessage="No open bugs found."}}
  
Host: SMEserver v7.1 with update 3 (7.1.3)
 
  
smeserver-fetchmail-1.3.5-01.noarch.rpm
+
=== Changelog ===
 +
Only versions released in smecontrib are listed here:
 +
{{ #smechangelog: smeserver-fetchmail }}
  
 
----
 
----
  
 
[[Category: Contrib]]
 
[[Category: Contrib]]
 +
[[Category: Mail]]

Latest revision as of 17:40, 17 November 2021


Fetchmail for SME Server

Warning.png Warning:
Since SME9.2 update and smeserver-qpsmtpd-2.4.0-34.el6.sme.noarch and qpsmtpd-0.96-10.el6.sme.noarch fetchmail is not filtered by spamassassin until a fix is deployed see Bug # bugzilla:10290

fixed in SME10 smeserver-qpsmtpd-2.7.0-7.el7.sme.noarch and qpsmtpd-0.96-21.el7.sme.noarch


Version

Devel 10:
Contrib 10:
Contrib 9:
smeserver-fetchmail
The latest version of smeserver-fetchmail is available in the SME repository, click on the version number(s) for more information.


Maintainer

Schirrm's Studio (software)

Description

  • Fetchmail retrieve mails from external mailboxes with many options.

Step-by-step silly HowTo for installation of Fetchmail on SMEserver.

It's intended for Linux-newbies.


Installation

1. Log in (with username root) to the SMEserver console.


2. Install Fetchmail:

  • For SME8
yum --enablerepo=smecontribs install smeserver-fetchmail
signal-event console-save

You will get a y/N-question, answer y if it looks fine.

  • For SME9
yum --enablerepo=smecontribs install smeserver-fetchmail
signal-event console-save

You will get a y/N-question, answer y if it looks fine.


3. Instructions at the end of previous installation advices the following commands:
"signal-event post-upgrade" and "signal-event reboot"
But you can ignore that and move on


4. In the server-manager, part 'Collaboration' you should find a 'Mails Retrieval' option.

This let you access on the main page of the Fetchmail configuration.

Check installed version

yum info installed smeserver-fetchmail

Uninstall

yum remove smeserver-fetchmail

Additional information

For more info check Schirrm's HowTo here.

To enable detailed logging on a per account basis for troubleshooting purposes do the following:

From the Fetchmail management interface, select mail retrevial, select the required account, set the option for: Do you want to debug this account - YES

Look at the maillog log file a few hours later for possible clues.


To enable detailed logging in Fetchmail (and be able to monitor it after typing /etc/startmail), manually edit /etc/fetchmail and put fetchmail in verbose mode. Then start it with /etc/startmail and check the log with tail -f

Taken from this forum post.

Configuration

if Fetchmail start to load multiple time the same emails, this might be a timeout problem, you should increase the default value (30 second):

/sbin/e-smith/db configuration setprop FetchMails timeout 30
/sbin/e-smith/expand-template /etc/fetchmail

If Fetchmail is unable to find te destination host, you can set it here:

/sbin/e-smith/db configuration getprop FetchMails fetchhost
/sbin/e-smith/expand-template /etc/fetchmail

FAQ

Q: What do these strange mails with '#********' from cron mean?
A: If you enabled the debug option for an account in the Mail Retrieval panel in the server-manager you will possibly receive mail from Cron Daemon with the subject "Cron <root@YOURSERVER> /etc/startmail". The mail contains patterns like this: #********. You will stop receiving this mails if you disable debugging for all configured users in the Mail Retrieval panel in the server-manager.


E-mail Retrieval Error

If your ISP does not provide a custom sort field and you experience the following errors occuring when Multidrop is enabled and the "Select Sort Method (for multi-drop)" is set to Default:

fetchmail: warning: multidrop for pop3.mypopserver.com requires envelope option!
fetchmail: warning: Do not ask for support if all mail goes to postmaster!

and/or

fetchmail: warning: multidrop for my.isp.domain requires envelope option! 
fetchmail: warning: Do not ask for support if all mail goes to postmaster! 


Set "Select Sort Method (for multi-drop) to 'Received' or 'for' As described at bugzilla:5602 bugzilla:6483

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-fetchmail component or use this link .


IDProductVersionStatusSummary (3 tasks)
9131SME Contribs9.0UNCONFIRMEDfetchmail loop if one mail contains a virus
9107SME Contribs9.0UNCONFIRMEDtrouble fetching mails when one of the list is infected
5067SME Contribs7.4CONFIRMEDfetchmail is noisy in /var/log/messges due to pam_unix


Changelog

Only versions released in smecontrib are listed here:

smeserver-fetchmail Changelog: SME 10 (smecontribs)
2022/11/11 Jean-Philippe Pialasse 1.6-26.sme
- Apply locale 2022-11-11 patch

2022/07/28 Jean-Philippe Pialasse 1.6-24.sme
- fix fetchmail restart downloading all emails after reboot [SME: 11979]

thanks to Stefano Zamboni for debuging and original fix.
2022/07/22 Jean-Philippe Pialasse 1.6-23.sme
- apply locale patch 2022-07-22

2021/11/17 Jean-Philippe Pialasse 1.6-22.sme
- fix panel [SME: 11058]

 removed SMTP proxy and blocking option and redirect to Proxy panel
TODO: module cleanup and cleanup of unused properties
2021/10/21 Terry Fage 1.6-21.sme
- fix template 60fetchmail force spamcheck [SME: 10289]