PYTHEAS Software & Services PYTHEAS MailGate - POP3 Connector for Microsoft Exchange and Lotus Domino

Known Problems

-

Messages sent to public folders by PYTHEAS MailGate are stored as a post (IPM.Post), not as a message (IPM.Note) as expected

Applies to All releases of PYTHEAS MailGate, running with Microsoft Exchange 2003 or 2000
Problem Please note that - strictly speaking - this is not a PYTHEAS MailGate problem. For more information, please see the Microsoft knowledgebase, article 817809.
Fix cf. the above mentioned article.
Top of page Top of page
-

Messages sent to a Microsoft Exchange 2007/2010 distribution list are not distributed

Applies to All releases of PYTHEAS MailGate, running with Microsoft Exchange 2007/2010.
Problem You configure a mail-enabled distribution list in Microsoft Exchange 20xx. When you send a message to the SMTP address of the distribution list, none of the members receives the message.

You can reproduce this problem with the Send test message function on the Recipient property page of the Recipient pointing to the distribution list. The SMTP dialog completes normally.

Please note that this is a Microsoft Exchange 20xx feature, not a PYTHEAS MailGate problem.

Fix Please check in the Exchange Management Console, Recipient Configuration / Distribution Group properties, Mail Flow Settings / Message Delivery Restrictions / Properties, that the checkbox Require that all senders are authenticated is unchecked.
Since v. 2.70, PYTHEAS MailGate can authenticate before sending mail to the Microsoft Exchange server, so you should no longer have this problem after configuring authentication.
Top of page Top of page
-

You get a 554 Maximum hop count exceeded - Possible mail loop detected error for incoming messages

Applies to All releases of PYTHEAS MailGate, running with Microsoft Exchange 2007/2010.
Problem Certain incoming messages are not accepted by your Microsoft Exchange Server. Looking at the Received header lines of such a message, you find out that there are a certain number of Received header lines (more than 30), but they do not correspond to a mail loop.
Fix By default, Microsoft Exchange fixes the maximum number of Received headers to a value of 30. If a message has more Received headers, it considers that there is probable mail loop producing these lines. However, depending of the architecture of the mail servers which the message runs through, this limit may be exceeded, even without a mail loop.

We recommend to first check (and count) the Received message header lines of one of such messages. As these are not transmitted successfully to the Exchange server, they remain in the POP3 mailbox, and you can read the message headers after opening the Properties pages of the POP3 account, Delete/Cleanup page, View Delete Messages form, View message headers button. If you do not find any evidence of a loop, proceed as indicated below.

The maximum number of Received headers corresponds to the MaxHopCount parameter of the Exchange Receive Connector listening on port 25 (by default, its name is Default <YourServerName>). To check the current value, issue this Exchange Management Shell command:
[PS] C:\>get-receiveconnector -identity "Default YourServerName" | Format-List
Look for the MaxHopCount value.
To change the value, use the following command:
[PS] C:\>set-receiveconnector -identity "Default YourServerName" -MaxHopCount:40

Top of page Top of page
-

Incoming messages from certain POP3 accounts are not correctly decoded by Microsoft Exchange 20xx

Applies to All releases of PYTHEAS MailGate, running with Microsoft Exchange 20xx
Problem Certain POP3 servers add a header line with illegal format (according to RFC822) to the beginning of each message. For this reason, Microsoft Exchange 20xx rejects the message headers of such messages altogether, and hence the message and its attachments are not decoded at all, leaving them in an unusable state most of the time.
Most of the time a header line is added to the top of the message source:
From xxxxx@yyy.zzz Thu Nov 11 10: 07:44 2007
Note that this line is not a valid line in the header part of a message according to RFC2822. Header lines must begin with a keyword (containing no white space) followed by a colon.
Fix Strictly speaking, this is not a PYTHEAS MailGate problem. However, for your convenience, a patch which circumvents the problem is integrated into PYTHEAS MailGate (beginning with the Communication Task release 2.12c).
To activate the patch, it is required to have the word BTConnect either in the Comment property of the PYTHEAS MailGate POP3 entry, or in the hostname of the POP3 server.

Historical note: this problem has been observed first with British Telecom BTConnect POP3 accounts, hence the choice of the keyword.

Top of page Top of page
-

The body of an e-mail message is garbled - incorrect character set used

Applies to PYTHEAS MailGate, release 2.40 and later,  running with Microsoft Exchange 2003
Problem Certain messages contain incorrect characters, belonging to a character set, which should not be used to display the message. The messages being concerned by this problem have a correct format, and character set specifications for the message headers and body parts of the message are correct.
Fix Strictly speaking, this is not a PYTHEAS MailGate problem. Microsoft released a hot fix to correct the problem. Please see http://support.microsoft.com/kb/916299 for more information about the problem, and to obtain the hot fix.
Top of page Top of page
-

The PYTHEAS MailGate Communication Task does not work as expected when running as a service, but works as expected when launched from the Start menu

Applies to All releases of PYTHEAS MailGate.
Problem When started as a Windows service, the Communication Task does not work as expected (remember that you can use the PYTHEAS MailGate Remote Control program to supervise the operation of the Communication Task). On the other hand, after stopping the PYTHEAS.Mailgate service, and after being launched from the Start menu, the Communication Task works as expected. Most of the time, this problem has been observed on Windows Server 2003.
Fix Use the Windows Services applet to make the PYTHEAS.MailGate service run within the context of a user session, as opposed to run it within the Localsystem context, which is the default.
Top of page Top of page
-

The PYTHEAS MailGate Communication Task stops working unexpectedly

Applies to All releases of PYTHEAS MailGate. A real-time virus scanner is working on the same machine.
Problem When downloading a particular message, the Communication Task (or the Pytheas.Mailgate service) quits unexpectedly. Restarting it does not fix the problem.
This probably happens because temporary files created by the Communication Task are blocked by the virus scanner because they are considered infected. You may want to check the virus scanner log if you find a trace of such events.
Fix Please read the blue box on the top right on this page.
Top of page Top of page
-

PYTHEAS MailGate does not correctly recognize outgoing message priority

Applies to Releases of PYTHEAS MailGate up to and including 2.33a, running with Microsoft Exchange 2007, and maybe other mail servers.
Problem All outgoing messages are handled as "normal priority".
Fix Open PMailGat.INI, and modify the following lines in the [Outgoing mail] section, to configure how to recognize high and low priority messages. For example, with Microsoft Exchange 2007, modify them so that they read as follows:
Delivery priority header=Importance
High priority delivery value=high
Low priority delivery value=low
To find the appropriate values for your mail server brand, send high and low priority messages and have a look at the message headers of the outgoing messages. You may catch them in the PytheasMailgate\Outgoing folder while they are in the queue of outgoing messages. Restart PYTHEAS MailGate after modifying PMailGat.INI.
Top of page Top of page
-

The PYTHEAS MailGate service does not start at system start-up

Applies to All releases of PYTHEAS MailGate
Problem The PYTHEAS.MailGate service does not start at system start-up, in spite of being configured for automatic start-up. An event log entry reports that this service did not respond in a timely fashion.
Fix If you are on a Microsoft Windows 2008 server, be sure to read this article first.

This can happen if the server is very busy at system start-up. Please have a look at http://support.microsoft.com/kb/922918, or it may help to make the Pytheas.MailGate service dependent on some other service which starts up late; you may want to have a look at the application event log to get an idea which one to choose for this purpose. If PYTHEAS MailGate is installed with a Microsoft Exchange 2003/2000 server, its POP3 service (POP3Svc) may be a good candidate. We pick this one as an example here.

To configure the dependency, proceed as follows:
- Open Regedt32.exe (not Regedit.exe);
- Go to HKEY_LOCAL_MACHINE/System/Currentcontrolset/Services/Pytheas.MailGate
- Open the DependOnService value. By default, it has 3 lines: Eventlog, RpcSc, TcpIp.
- Add the line: POP3Svc to the end of the list. This will make the Pytheas.Mailgate service dependent on this service.

Top of page Top of page
-

Configuration Program: Deleting messages with the POP3 Account View/Delete messages function does not work

Applies to PYTHEAS MailGate release 2.70
Problem You cannot delete messages with this function. However, listing the contents, downloading messages and displaying message headers works as expected.
Fix The problem has been fixed in v. 2.71.
Top of page Top of page
-

 Outgoing mail: message erroneously reported as "sent"

Applies to PYTHEAS MailGate release 2.70, configured to send outgoing mail via a SMTP relay server
Problem Under certain error conditions it could happen that a message which had not been sent, was reported as being successfully sent.
Fix The problem has been fixed in v. 2.71.
Top of page Top of page
-

Timeout error with empty POP3 mailbox

Applies to All releases of PYTHEAS MailGate
Problem With a certain type of POP3 server, you systematically get a Timeout error when the Communication Task connects to the POP3 server. Messages in the maildrop are correctly downloaded.
Explication (not the solution)

The POP3 server does not conform to RFC 1939. Use the Try connection button of the Configuration Program, POP3 account property page, to see the POP3 dialog when the mailbox is empty. Check if you get a dialog like:

+OK IMS POP3 Server 0.87 Ready
USER username
+OK username is welcome here
PASS xxxxxxxxxxx
+OK username's mailbox has 0 message(s) (0 octets)
LIST
+OK 0 message (0 octets)
0 messages (0 octets)


The problem is that the "0 messages (0 octets)" line should not be there, and that the response to the "LIST" command is not terminated by a single point on a line.
Here is what RFC 1939 (POP3, May 1996) says on the subject (we did the bold typesetting):

(...)
Responses to certain commands are multi-line. In these cases, which are clearly indicated below, after sending the first line of the response and a CRLF, any additional lines are sent, each terminated by a CRLF pair. When all lines of the response have been sent, a final line is sent, consisting of a termination octet (decimal code 046, ".") and a CRLF pair.
(...)
LIST [msg]
Arguments: a message-id (optionally) If a message-id is given, it may NOT refer to a message marked as deleted.
Restrictions: may only be given in the TRANSACTION state.

Discussion:
If an argument was given and the POP3 server issues a positive response with a line containing information for that message. This line is called a "scan listing" for that message.
If no argument was given and the POP3 server issues a positive response, then the response given is multi-line. After the initial +OK, for each message in the maildrop, the POP3 server responds with a line containing information for that message. This line is called a "scan listing" for that message. If there are no messages in the maildrop, then the POP3 server responds with no scan listings--it issues a positive response followed by a line containing a termination octet and a CRLF pair.

Workaround None. Besides setting timeouts for the Communication Task to a low value, and setting the error retries to 0.
Top of page Top of page