# HG changeset patch # User Paul Boddie # Date 1446141251 -3600 # Node ID ed234891467b7acfa748f6ce2db2c0b97a893bcc # Parent ecd915425718b07ec930a059abd804095a23096a Added more mail-related and Web-related details, linking to resources, and making various fixes. diff -r ecd915425718 -r ed234891467b docs/wiki/FrontPage --- a/docs/wiki/FrontPage Thu Oct 29 16:16:44 2015 +0100 +++ b/docs/wiki/FrontPage Thu Oct 29 18:54:11 2015 +0100 @@ -1,7 +1,8 @@ = imip-agent = -imip-agent is an extension for existing mail systems (such as Exim and -Postfix) providing extra support for calendaring and scheduling. +imip-agent is an extension for existing mail systems (such as +[[http://exim.org/|Exim]] and [[http://www.postfix.org/|Postfix]]) +providing extra support for calendaring and scheduling. * It uses the [[https://tools.ietf.org/html/rfc5545|iCalendar]], [[https://tools.ietf.org/html/rfc5546|iTIP]] and @@ -9,27 +10,28 @@ * It can inspect messages containing calendar objects and extract availability information for sharing and publication. You and your users - decide exactly which kind of messages it will inspect, whose messages it will - inspect, and for whom no inspection or sharing will occur at all. + decide exactly which kind of messages it will inspect, whose messages it + will inspect, and for whom no inspection or sharing will occur at all. - * It can provide a Web-based interface to calendar information for users who - cannot or choose not to use mail software with calendaring support. This is - optional and your users can choose to adjust, ignore or disable this - functionality. + * It can provide a [[/CalendarManager|Web-based interface]] to calendar + information for users who cannot or choose not to use mail software with + calendaring support. This is optional and your users can choose to adjust, + ignore or disable this functionality. * It supports autonomous entities such as meeting rooms and resources, automatically accepting or declining invitations according to their schedules. You can adjust this behaviour to implement your own policies. - * It is licensed as Free Software, giving you the freedom to see what the - software does, as well as the freedom to modify and share the software with - others. + * It is [[https://www.fsf.org/about/what-is-free-software|Free Software]], + giving you the freedom to see what the software does, as well as the freedom + to modify and share the software with others. Unlike some monolithic groupware solutions... - * It does not require you to change your mail delivery software or your mail - storage software (subject to existing support provided by imip-agent; support - for other software can always be added). + * It does not require you to change your [[/MailIntegration|mail delivery]] + software or your [[/MailboxIntegration|mail storage]] software (subject to + existing support provided by imip-agent; support for other software can + always be added). * It does not require your users to change their mail client software. @@ -90,6 +92,9 @@ == Deployment Notes == * [[/GettingStarted|Getting Started]] + * [[/Configuration|Configuration]] and [[/Preferences|Preferences]] + * [[/CalendarManager|Calendar Management Interface]] + * [[/FreeBusyPublishing|Free/Busy Publishing]] == Design and Implementation Notes == diff -r ecd915425718 -r ed234891467b docs/wiki/MailIntegration--Simple --- a/docs/wiki/MailIntegration--Simple Thu Oct 29 16:16:44 2015 +0100 +++ b/docs/wiki/MailIntegration--Simple Thu Oct 29 18:54:11 2015 +0100 @@ -10,7 +10,7 @@ == Using Lists with Exim == -Example configuration file for Exim are distributed in `conf/exim/simple`: +Example configuration files for Exim are distributed in `conf/exim/simple`: {{{#!table '''File''' || '''Purpose''' @@ -44,7 +44,7 @@ == Using Lists with Postfix == -Example configuration file for Postfix are distributed in `conf/postfix/simple`: +Example configuration files for Postfix are distributed in `conf/postfix/simple`: {{{#!table '''File''' || '''Purpose''' diff -r ecd915425718 -r ed234891467b docs/wiki/MailboxIntegration --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/wiki/MailboxIntegration Thu Oct 29 18:54:11 2015 +0100 @@ -0,0 +1,43 @@ += Mailbox Integration = + +Use of the imip-agent software should not affect the solutions chosen to store +mail received by your mail system. However, the software does support direct +connections to mail storage solutions employing the LMTP protocol. See the +[[../MailIntegration/LMTP|LMTP guide]] for more information. + +It can, however, be useful to see how delivery to various kinds of mailboxes +and mail storage is done, in case you have not already decided on a particular +solution. + +== Cyrus == + +[[http://www.cyrusimap.org/|Cyrus]] is a mail storage system that exposes +mailboxes using the [[http://tools.ietf.org/html/rfc3501|IMAP]] protocol. + +== Dovecot == + +[[http://dovecot.org/|Dovecot]] is a mail server that supports IMAP and +[[http://tools.ietf.org/html/rfc1939|POP3]]. It can be configured to serve +mail stored in traditional mailbox formats. + +The Dovecot documentation provides guides for integrating Dovecot with +[[http://wiki2.dovecot.org/LMTP/Exim|Exim]] and with +[[http://wiki2.dovecot.org/HowTo/PostfixDovecotLMTP|Postfix]]. + +Example configuration files for Exim and Dovecot are distributed in +`conf/exim/lmtp`: + +{{{#!table +'''File''' || '''Purpose''' +== +`30_exim4-config_dovecot_lmtp` +|| Delivers messages to Dovecot via LMTP +== +`890_exim4-config_dovecot_lmtp_local` +|| Routes messages for local system users to Dovecot +}}} + +On Debian systems, the former file would be copied into the +`/etc/exim4/conf.d/transport` directory, whereas the latter would be +copied into the `/etc/exim4/conf.d/router` directory. The latter file is +appropriate only if system user identities are to be employed for mail. diff -r ecd915425718 -r ed234891467b docs/wiki/WebServerIntegration --- a/docs/wiki/WebServerIntegration Thu Oct 29 16:16:44 2015 +0100 +++ b/docs/wiki/WebServerIntegration Thu Oct 29 18:54:11 2015 +0100 @@ -26,6 +26,14 @@ deployment with the Apache Web server software that exposes a directory for Web publishing containing the published free/busy information. +On Debian, to enable the serving of free/busy data, copy the configuration +file to the Apache configuration and enable it as follows + +{{{ +cp conf/apache/imip-agent.conf /etc/apache2/sites-available/ +a2ensite imip-agent +}}} + Access to free/busy information may not be moderated, but Web server directives can be introduced to impose access controls. Mail programs that wish to consult the free/busy information may have problems in dealing with @@ -40,6 +48,14 @@ `conf/apache/imip-manager.conf` file provides a configuration file for deployment with the Apache Web server software that enables this interface. +On Debian, to enable the management interface, copy the configuration file to +the Apache configuration and enable it as follows: + +{{{ +cp conf/apache/imip-manager.conf /etc/apache2/sites-available/ +a2ensite imip-manager +}}} + The management interface is deployed as a CGI program, meaning that a suitable module must be enabled in the Apache configuration. On Debian, this is done as follows: