PigeonDeliver and Postfix HOWTO

Carlo Contavalli

Revision History
Revision 1.0.02006/01/24
First document revision

This document describes how to install PigeonDeliver with Postfix, describing and detailing each and every step.

For a complete reference about compilation options and how to install PigeonDeliver, please refer to %%TODO%%.

Table of Contents
1. Before starting
1.1. Intended Audience
1.2. Copyright Notice
2. Introduction
3. Installing OpenLDAP
4. Notes about linux distributions
5. Configuring OpenLDAP
5.1. Enabling the HDB Backend
5.2. Adding PigeonDeliver schema files
5.3. Initializing OpenLDAP database
5.3.1. Removing the current database
5.3.2. Creating a DB_CONFIG file
5.3.3. Creating the LDAP Root
5.3.4. Starting slapd
6. Installing PigeonDeliver with Postfix
6.1. Non Debian systems
6.2. Debian based systems
7. Configuring Postfix to use PigeonDeliver
7.1. Configuring Postfix for local users
7.2. Configuring Postfix to deliver with PigeonDeliver
7.2.1. Configuring the master.cf file
7.2.2. Configuring the main.cf file
7.2.3. Configuring the dynamicmaps.cf file
7.2.4. The final result
8. Configuring PigeonDeliver and PigeonDeliver modules
8.1. Configuring the mailStore module
8.2. Configuring the mailAntivirus module
9. Conclusions

1. Before starting

This document was written as part of the documentation of the PigeonAir Project to provide help and support to users, system administrators or developers.

While every effort has been made to ensure that the information is accurate at the time of publication, this document may contain errors, omissions, incongruences or wrong technical details. No liability for damages is accepted by the Author/Authors, the publishers or any other organization or person providing the information, arising from any errors or omissions that may appear, however caused.

In case you find an error, you would like to propose better solutions than those discussed in this document or you would like to discuss an idea regarding this document or its content, we would be glad to hear from you and please contact us by writing directly to the author of this document or to the <pigeon-dev at ml.pigeonair.net> mailing list.

1.1. Intended Audience

This document was meant to provide an easy to follow, step by step guide at installing and setting up PigeonDeliver with Postfix on any linux system, even for non-professional users.

For that purpose, many details and technical descriptions were made using an overway simplified model, and often by using improper terms and definitions. The hope was to make the document more intuitive and easyer to read and understand, even for a non-technical reader.

Hope that you, as a reader, will understand my good will and will not regret nor blame me for the improper use of some terms and definitions, and for the simplified or even wrong models sometimes described or used just for the sake of creating a more intuitive and simplified environment.

This document will not discuss details regarding configuration files, the structure of the mail system, or the integration with other mail servers or systems.

1.2. Copyright Notice

This document was written by Carlo Contavalli <ccontavalli at masobit.net> and is thus Copyright (C) 2003,2004,2005,2006 Carlo Contavalli.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Back-Cover Texts, and no Front-Cover Text.

Any example of program code available in this document should be considered Copyright (C) 2003,2004,2005,2006 Carlo Contavalli, protected by the terms of the GNU General Public License, version 2.00.

You should have received a copy of the GNU General Public License along with this document; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Trademarks are owned by their respective owners.

  Next
  Introduction