pdinstall -- Installing PigeonDeliver

Carlo Contavalli

Revision History
Revision 1.0.02005/06/11
First document revision

Purpose of this document is to explain how to install PigeonDeliver on your systems, starting from the source files provided on the PigeonDeliver site.


Table of Contents
1. Before starting
1.1. Intended Audience
1.2. Copyright Notice
2. Introduction
2.1. What is PigeonDeliver?
2.2. System requirements
2.3. Quick Start
2.4. Downloading and extracting PigeonDeliver
3. Configuring PigeonDeliver and the configure script
3.1. Introducing modules, SAPI, services, utilities and customs
3.2. Modules: names and interfaces
3.3. Basic, required and recomended modules
3.4. Configuring and compiling
3.5. Libraries
3.6. Installation directories and directory tree
4. PigeonDeliver and Postfix
4.1. Compiling and Installing Postfix components
4.1.1. Installing with Postfix sources
4.1.2. Installing with Postfix shared libraries
4.2. Configuring Postfix to use PigeonDeliver
5. About PigeonDeliver modules
6. Installing PigeonDeliver utilities
7. Before running the configure script

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 feel free to 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 for administrators interested in compiling and installing PigeonDeliver source code on their systems.

The only purpose of this document is thus to introduce the reader to the PigeonDeliver build and install system, and to detail the steps needed to install PigeonDeliver on most systems.

This document will not discuss details regarding its configuration, usage or integration with other 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.