1.1 --- a/docs/wiki/FrontPage Thu Oct 29 16:16:44 2015 +0100
1.2 +++ b/docs/wiki/FrontPage Thu Oct 29 18:54:11 2015 +0100
1.3 @@ -1,7 +1,8 @@
1.4 = imip-agent =
1.5
1.6 -imip-agent is an extension for existing mail systems (such as Exim and
1.7 -Postfix) providing extra support for calendaring and scheduling.
1.8 +imip-agent is an extension for existing mail systems (such as
1.9 +[[http://exim.org/|Exim]] and [[http://www.postfix.org/|Postfix]])
1.10 +providing extra support for calendaring and scheduling.
1.11
1.12 * It uses the [[https://tools.ietf.org/html/rfc5545|iCalendar]],
1.13 [[https://tools.ietf.org/html/rfc5546|iTIP]] and
1.14 @@ -9,27 +10,28 @@
1.15
1.16 * It can inspect messages containing calendar objects and extract
1.17 availability information for sharing and publication. You and your users
1.18 - decide exactly which kind of messages it will inspect, whose messages it will
1.19 - inspect, and for whom no inspection or sharing will occur at all.
1.20 + decide exactly which kind of messages it will inspect, whose messages it
1.21 + will inspect, and for whom no inspection or sharing will occur at all.
1.22
1.23 - * It can provide a Web-based interface to calendar information for users who
1.24 - cannot or choose not to use mail software with calendaring support. This is
1.25 - optional and your users can choose to adjust, ignore or disable this
1.26 - functionality.
1.27 + * It can provide a [[/CalendarManager|Web-based interface]] to calendar
1.28 + information for users who cannot or choose not to use mail software with
1.29 + calendaring support. This is optional and your users can choose to adjust,
1.30 + ignore or disable this functionality.
1.31
1.32 * It supports autonomous entities such as meeting rooms and resources,
1.33 automatically accepting or declining invitations according to their
1.34 schedules. You can adjust this behaviour to implement your own policies.
1.35
1.36 - * It is licensed as Free Software, giving you the freedom to see what the
1.37 - software does, as well as the freedom to modify and share the software with
1.38 - others.
1.39 + * It is [[https://www.fsf.org/about/what-is-free-software|Free Software]],
1.40 + giving you the freedom to see what the software does, as well as the freedom
1.41 + to modify and share the software with others.
1.42
1.43 Unlike some monolithic groupware solutions...
1.44
1.45 - * It does not require you to change your mail delivery software or your mail
1.46 - storage software (subject to existing support provided by imip-agent; support
1.47 - for other software can always be added).
1.48 + * It does not require you to change your [[/MailIntegration|mail delivery]]
1.49 + software or your [[/MailboxIntegration|mail storage]] software (subject to
1.50 + existing support provided by imip-agent; support for other software can
1.51 + always be added).
1.52
1.53 * It does not require your users to change their mail client software.
1.54
1.55 @@ -90,6 +92,9 @@
1.56 == Deployment Notes ==
1.57
1.58 * [[/GettingStarted|Getting Started]]
1.59 + * [[/Configuration|Configuration]] and [[/Preferences|Preferences]]
1.60 + * [[/CalendarManager|Calendar Management Interface]]
1.61 + * [[/FreeBusyPublishing|Free/Busy Publishing]]
1.62
1.63 == Design and Implementation Notes ==
1.64
2.1 --- a/docs/wiki/MailIntegration--Simple Thu Oct 29 16:16:44 2015 +0100
2.2 +++ b/docs/wiki/MailIntegration--Simple Thu Oct 29 18:54:11 2015 +0100
2.3 @@ -10,7 +10,7 @@
2.4
2.5 == Using Lists with Exim ==
2.6
2.7 -Example configuration file for Exim are distributed in `conf/exim/simple`:
2.8 +Example configuration files for Exim are distributed in `conf/exim/simple`:
2.9
2.10 {{{#!table
2.11 '''File''' || '''Purpose'''
2.12 @@ -44,7 +44,7 @@
2.13
2.14 == Using Lists with Postfix ==
2.15
2.16 -Example configuration file for Postfix are distributed in `conf/postfix/simple`:
2.17 +Example configuration files for Postfix are distributed in `conf/postfix/simple`:
2.18
2.19 {{{#!table
2.20 '''File''' || '''Purpose'''
3.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
3.2 +++ b/docs/wiki/MailboxIntegration Thu Oct 29 18:54:11 2015 +0100
3.3 @@ -0,0 +1,43 @@
3.4 += Mailbox Integration =
3.5 +
3.6 +Use of the imip-agent software should not affect the solutions chosen to store
3.7 +mail received by your mail system. However, the software does support direct
3.8 +connections to mail storage solutions employing the LMTP protocol. See the
3.9 +[[../MailIntegration/LMTP|LMTP guide]] for more information.
3.10 +
3.11 +It can, however, be useful to see how delivery to various kinds of mailboxes
3.12 +and mail storage is done, in case you have not already decided on a particular
3.13 +solution.
3.14 +
3.15 +== Cyrus ==
3.16 +
3.17 +[[http://www.cyrusimap.org/|Cyrus]] is a mail storage system that exposes
3.18 +mailboxes using the [[http://tools.ietf.org/html/rfc3501|IMAP]] protocol.
3.19 +
3.20 +== Dovecot ==
3.21 +
3.22 +[[http://dovecot.org/|Dovecot]] is a mail server that supports IMAP and
3.23 +[[http://tools.ietf.org/html/rfc1939|POP3]]. It can be configured to serve
3.24 +mail stored in traditional mailbox formats.
3.25 +
3.26 +The Dovecot documentation provides guides for integrating Dovecot with
3.27 +[[http://wiki2.dovecot.org/LMTP/Exim|Exim]] and with
3.28 +[[http://wiki2.dovecot.org/HowTo/PostfixDovecotLMTP|Postfix]].
3.29 +
3.30 +Example configuration files for Exim and Dovecot are distributed in
3.31 +`conf/exim/lmtp`:
3.32 +
3.33 +{{{#!table
3.34 +'''File''' || '''Purpose'''
3.35 +==
3.36 +`30_exim4-config_dovecot_lmtp`
3.37 +|| Delivers messages to Dovecot via LMTP
3.38 +==
3.39 +`890_exim4-config_dovecot_lmtp_local`
3.40 +|| Routes messages for local system users to Dovecot
3.41 +}}}
3.42 +
3.43 +On Debian systems, the former file would be copied into the
3.44 +`/etc/exim4/conf.d/transport` directory, whereas the latter would be
3.45 +copied into the `/etc/exim4/conf.d/router` directory. The latter file is
3.46 +appropriate only if system user identities are to be employed for mail.
4.1 --- a/docs/wiki/WebServerIntegration Thu Oct 29 16:16:44 2015 +0100
4.2 +++ b/docs/wiki/WebServerIntegration Thu Oct 29 18:54:11 2015 +0100
4.3 @@ -26,6 +26,14 @@
4.4 deployment with the Apache Web server software that exposes a directory for
4.5 Web publishing containing the published free/busy information.
4.6
4.7 +On Debian, to enable the serving of free/busy data, copy the configuration
4.8 +file to the Apache configuration and enable it as follows
4.9 +
4.10 +{{{
4.11 +cp conf/apache/imip-agent.conf /etc/apache2/sites-available/
4.12 +a2ensite imip-agent
4.13 +}}}
4.14 +
4.15 Access to free/busy information may not be moderated, but Web server
4.16 directives can be introduced to impose access controls. Mail programs that
4.17 wish to consult the free/busy information may have problems in dealing with
4.18 @@ -40,6 +48,14 @@
4.19 `conf/apache/imip-manager.conf` file provides a configuration file for
4.20 deployment with the Apache Web server software that enables this interface.
4.21
4.22 +On Debian, to enable the management interface, copy the configuration file to
4.23 +the Apache configuration and enable it as follows:
4.24 +
4.25 +{{{
4.26 +cp conf/apache/imip-manager.conf /etc/apache2/sites-available/
4.27 +a2ensite imip-manager
4.28 +}}}
4.29 +
4.30 The management interface is deployed as a CGI program, meaning that a suitable
4.31 module must be enabled in the Apache configuration. On Debian, this is done as
4.32 follows: