Priority email gateway

De Trustedbird Client Wiki
English | Français

> Documentation > Priority email gateway

Download priority-email-gateway

ChangeLog


Priority email gateway is a configuration system for an email gateway sending messages based on their priority.

Priorities are assigned from message headers. Several different priorities can be assigned to a message, for primary recipients (To) and for copy recipients (Cc and Bcc).

A set of rules identifies headers and chooses priorities to assign.

The system is based on Postfix MTA with Qpsmtpd SMTP server. It works on Debian-based Linux distributions (tested with Debian Etch with backports, Debian Lenny and Ubuntu 8.04).


→ Translation in progress: see French documentation for more detailed information.


Architecture

Schema

Priority-mail-server-en.jpg

Principle

TODO

Message path

TODO

Installation

Requirements

The system is intended to be installed on Debian-based Linux distributions, e.g.:

  • Debian Etch (4.0) or Lenny (5.0),
  • Ubuntu server (8.4).

Postfix version should be at least 2.5 in order to have better concurrency scheduler.

For Debian Etch, Postfix should be installed from repository etch‑backports.

Installation of Postfix and Qpsmtpd

First step consists of installing Postfix, Qpsmtpd and SNMP agent.

# apt-get install postfix qpsmtpd snmpd

SNMP agent is used for supervision and is optional.

Installer could want to remove another mail server already installed to replace it with Postfix.

Choose Internet site option in order to generate a default configuration.

Default Postfix settings in /etc/postfix will be used to generate other configurations for all Postfix instances. It will be used only for initial creation of configurations.

It can now be customized with options which will be common to all instances.


Useful settings to be changed in /etc/postfix/main.cf are, for example, myhostname which is used to specify the name of the server. Authentication and listen ports must not be setup now because they are different in every instances.

Installation of priority system

Priority system packet contains a tool to generate settings for all Postfix instances and Qpsmtpd, scripts for supervision and also startup scripts.

Download Debian package, then launch installation with the following command:

# dpkg -i priority-email-gateway_VERSION.deb

Packet will install the system and create, from default configuration in /etc/postfix, settings for all Postfix instances in /etc/postfix‑frontend, /etc/postfix0, /etc/postfix1, /etc/postfix2, ...

Qpsmtpd and Postfix instances will be started at the end.


Configuration

File list

  • /etc/priority-email-gateway.conf: count and settings of priority instances.
  • /etc/postfix: base Postfix settings used only during installation in order to generate other configurations.
  • /etc/postfix-frontend: settings of frontend Postfix instance.
  • /etc/postfix0, /etc/postfix1, ...: settings of Postfix instances managing different priorities.

Postfix main configuration files are main.cf and master.cf.

  • /etc/qpsmtpd/addPrivatePriorityDomain.conf: rules to identify message headers in order to assign priorities.

Tools / Scripts

  • /etc/init.d/postfix-priority: starting script for all Postfix instances.
  • /etc/init.d/qpsmtpd-priority: starting script for Qpsmtpd.
  • /usr/sbin/update-priority-email-gateway: tool used to generate or update settings for all Postfix instances and Qpsmtpd.
  • /usr/sbin/priority-email-gateway-showQueues: tool used to display message counts in all queues of all Postfix instances.

General setup

Qpsmtpd parameters

TODO

Postfix parameters

TODO

Event when sending a bounce back to message originator

TODO

Customization of Postfix frontend

TODO

Customization of Postfix priority instances

TODO

Customization of rules to identify message headers

TODO

Start/stop of priority system

Priority system service is automatically launched when the server starts. Scripts used are /etc/init.d/postfix‑priority and /etc/init.d/qpsmtpd‑priority. They control all configured Postfix instances and Qpsmtpd.

Start service:

# /etc/init.d/postfix‑priority start
# /etc/init.d/qpsmtpd‑priority start

Stop service:

# /etc/init.d/postfix‑priority stop
# /etc/init.d/qpsmtpd‑priority stop

Restart service:

# /etc/init.d/postfix‑priority restart
# /etc/init.d/qpsmtpd‑priority restart

After an configuration update with update‑priority‑email‑gateway, service is automatically restarted.


Supervision

Console

TODO

Log

TODO

SNMP

TODO