How to Install the Product
The PYTHEAS MailGate product is made up of four components:
Where to install it
You can install the PYTHEAS MailGate on any machine with the appropriate operating system on your LAN. Generally however, it may be a good idea to install it on your mail server itself.
Benefits of handling outgoing mail with PYTHEAS MailGate
When you run the PYTHEAS MailGate Control Panel for the first time, it will automatically launch the Configuration Wizard, which will ask you some questins:
The wizard will give you instructions on how to configure your mail server. After saving the basic configuration, you should be able to successfully download email from your first POP3 mailbox to the mailbox hosted on your internal mail server: check that the PYTHEAS MailGate service is running (use the Dashboard of the PYTHEAS MailGate Control Panel), start the Remote Control Program, and start a Download Session (use the toolbar button at the upper left).
Please note that you may want to
run this wizard again at a later time,
for example if you change your mail server, or want to activate outgoing mail handling
through PYTHEAS MailGate.
How to configure incoming mail handling
To handle incoming mail, PYTHEAS MailGate needs to know...
Creating a new POP3 Account entry
Add a new POP3 account entry. Once you have entered the basic information (POP3 server, username, password), check if you can successfully connect: use the Try connection button. Most of the time, it will be ok to leave the other settings as defined by default.
Creating a new Recipient entry
A Recipient is a pointer to a mailbox hosted on your internal mail server. The most important information is its SMTP address. This should be the SMTP address belonging to the Recipient's Internet POP3 mailbox. Have a look at the address book of your mail server. This e-mail address should be configured as the principal SMTP address for the mailbox. This is particular important for outgoing mail which will be sent from this mailbox, so that it will get a correct reply-address. Use it as SMTP address for the Recipient.
The next information to set is the POP3 account where the Recipient's mail comes from.
In the Message routing criteria, you configure how messages downloaded from the POP3 account should be distributed. You can have several Recipients receiving mail from a single POP3 account. The easiest case is a one-to-one relationship, where you would just check the route all mail from the POP3 account to this Recipient option. For one-POP3-account-to-many-Recipients scenarios ("catch-all POP3 mailboxes"), please see this page.
You can leave the other options with their default values; however, you may be interested in the following features:
Before closing the Recipient property sheet, you may want to send a test message: click on the corresponding button, then open the messaging client and confirm that the message has been delivered to the Recipient's mailbox.
If you have many Recipients and/or POP3 accounts (let's say, more than 50), you should consider storing their configuration data in separate files. You can learn more here. There will be another benefit: these files are tab-separated text files, and you can edit these lists with your favourite spreadsheet program. In such a case it may be advisable to configure several concurrent POP3 download tasks to speed up message download. You can do so on the EService options / Incoming mail page (you need the Pmg-MT license key option to activate this feature).
Setting the Schedule
Most of the time, you will want to start download sessions automatically at regular intervals; see the parameters on the "Service optioins / Schedule" page.
How to Configure Outgoing Mail
This feature is optional, so you may skip to the next section, if outgoing mail is not handled by PYTHEAS MailGate.
Understanding outgoing mail flow
Here's how it's supposed to work:
Have a glance at the Outbound transfer tab
Here is an example of what should appear in the Outbound transfer tab of the PYTHEAS MailGate Remote Control. When a message is accepted in the outgoing queue, you should see something like this:
[10:09] Queue  ESMTP Connection accepted from:
When the message is sent to the SMTP relay server (smarthost), you should get:
[10:10] Send: Connecting to smtprelay.isp.com...Login
successful...done. (ESMTP, Max size: 21000000, DSN)
If this does not work as expected, you may want to have a look at our article about troubleshooting of outgoing mail handling.
Outgoing mail schedule with a permanent Internet connection
Under these conditions, use the "No coordination" option on the "Service options / Schedule" page. Please note that with this choice, you can configure outgoing messages to be sent...
Outgoing mail schedule with a dial-up Internet connection
Under these conditions, you may want to use the "Coordinated" option, and the after collecting more, for... parameters for outgoing message sending. If you want to avoid triggering an Internet connection in behalf of outgoing mail, which means that outgoing mail will be sent only during the regular schedule for incoming mail download sessions, then use the when connected anyway option.
The outgoing mail queue
You can manage the outgoing mail queue from the PYTHEAS MailGate Control Panel, or with the Outgoing Queue management program. Besides viewing the list of messages in the queue, you can also freeze or unfreeze messages, or remove messages from the queue, which will then be returned to the sender.
To define exceptions in incoming message delivery, you can use content-checking rules. There are two kinds of rules: interception and pass-through. If a match occurs for an interception rule, the action associated with the rule will be performed. If a match occurs for a pass-through rule, message delivery will be done as usual; this kind of rule is used to stop the content checking engine trying to find a match at a certain point, when walking through the list of rules from top to bottom.
Let's see an example: we choose not to allow attachments containing executable files to be directly delivered to internal mailboxes. Proceed as follows:
The anti-virus interface submits each incoming message to a file-level real-time on-access virus scanner. We have a dedicated web page on this topic.
The PYTHEAS MailGate Remote Control program allows you to keep track in real time of what PYTHEAS MailGate is doing. You can also use it to start an out-of-sequence download session.
Install it on your workstation using the appropriate option of the PYTHEAS
MailGate setup program. When you run it for the first time,
go to the Preferences tab and enter the name of the machine where the
Another source of information are session log messages, which we already mentioned earlier in this document.
Keep track of Internet mail flow
For each incoming and outgoing message, PYTHEAS MailGate can write a line to a log file, which can be queried by a CGI program. Configure this feature on the Service options / Logging page.
All system messages which are generated by PYTHEAS MailGate are made from templates, which can be customized and translated. Please see the online help for more information, Templates for System Messages chapter.