# HG changeset patch # User Paul Boddie # Date 1557075762 -7200 # Node ID 87ec4de5c43e94fd30caa92c672240fffe320d8d # Parent 4b655c8e7619e37d9c2db82293034e381f01a7e3 Added page links to various diagrams. diff -r 4b655c8e7619 -r 87ec4de5c43e docs/wiki/MailIntegration --- a/docs/wiki/MailIntegration Mon Apr 15 00:13:49 2019 +0200 +++ b/docs/wiki/MailIntegration Sun May 05 19:02:42 2019 +0200 @@ -12,6 +12,8 @@ Otherwise, few constraints should be imposed by each kind of system on the other. +######## A diagram summarising the mail transport integration. + {{{#!graphviz //format=svg //transform=notugly @@ -20,7 +22,8 @@ edge [tooltip="Mail integration"]; rankdir=LR; - mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan]; + mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan, + href="../IncomingMessages"]; subgraph { rank=same; @@ -32,12 +35,15 @@ subgraph { rank=same; personhandler [label="Person handler",style=filled,fillcolor=gold]; - resourcehandler [label="Resource handler",style=filled,fillcolor=gold]; + resourcehandler [label="Resource handler",style=filled,fillcolor=gold, + href="../Resources"]; scheduling [label="Scheduling",shape=ellipse,style=filled,fillcolor=gold]; - freebusy [label="Free/busy",shape=folder,style=filled,fillcolor=gold]; + freebusy [label="Free/busy",shape=folder,style=filled,fillcolor=gold, + href="../FreeBusyPublishing"]; } - mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes"]; + mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes", + href="../MailboxIntegration"]; mail -> personrouter -> personhandler -> mailbox; mail -> resourcerouter -> resourcehandler @@ -51,6 +57,8 @@ } }}} +######## + == MTAs == Currently, imip-agent supports [[http://exim.org/|Exim]] and diff -r 4b655c8e7619 -r 87ec4de5c43e docs/wiki/MailIntegration--LMTP --- a/docs/wiki/MailIntegration--LMTP Mon Apr 15 00:13:49 2019 +0200 +++ b/docs/wiki/MailIntegration--LMTP Sun May 05 19:02:42 2019 +0200 @@ -6,6 +6,8 @@ such solutions is avoided, but then those solutions must expose their LMTP interface appropriately. +######## A diagram summarising LMTP integration. + {{{#!graphviz //format=svg //transform=notugly @@ -14,7 +16,8 @@ edge [tooltip="LMTP delivery"]; rankdir=LR; - mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan]; + mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan, + href="../../IncomingMessages"]; subgraph { rank=same; @@ -27,7 +30,8 @@ personhandler [label="Person handler",style=filled,fillcolor=gold]; } - mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes"]; + mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes", + href="../../MailboxIntegration"]; mail -> personrouter -> personhandler -> mailbox; @@ -35,6 +39,8 @@ } }}} +######## + Although this topic is largely beyond the scope of this documentation, systems such as Cyrus and Dovecot can be configured to provide a Unix domain socket offering support for LMTP connections. diff -r 4b655c8e7619 -r 87ec4de5c43e docs/wiki/MailIntegration--LocalSMTP --- a/docs/wiki/MailIntegration--LocalSMTP Mon Apr 15 00:13:49 2019 +0200 +++ b/docs/wiki/MailIntegration--LocalSMTP Sun May 05 19:02:42 2019 +0200 @@ -3,6 +3,8 @@ By employing local SMTP, the burden of routing messages to suitable storage becomes a configuration problem within the mail system itself. +######## A diagram summarising SMTP integration. + {{{#!graphviz //format=svg //transform=notugly @@ -11,7 +13,8 @@ edge [tooltip="Local SMTP delivery"]; rankdir=LR; - mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan]; + mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan, + href="../../IncomingMessages"]; subgraph { rank=same; @@ -26,7 +29,8 @@ localtransport [label="Local transport"]; } - mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes"]; + mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes", + href="../../MailboxIntegration"]; mail -> personrouter -> personhandler; @@ -37,6 +41,8 @@ } }}} +######## + Here, imip-agent connects to the mail transport agent (MTA) and sends a message to an explicitly-indicated local user. For example: diff -r 4b655c8e7619 -r 87ec4de5c43e docs/wiki/imip-agent --- a/docs/wiki/imip-agent Mon Apr 15 00:13:49 2019 +0200 +++ b/docs/wiki/imip-agent Sun May 05 19:02:42 2019 +0200 @@ -33,6 +33,8 @@ giving you the freedom to see what the software does, as well as the freedom to modify and share the software with others. +######## A diagram showing a summary of the imip-agent architecture. + {{{#!graphviz //format=svg //transform=notugly @@ -42,19 +44,23 @@ rankdir=LR; mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan]; - MTA [label="MTA\n(Exim, Postfix, ...)",tooltip="MTA"]; + MTA [label="MTA\n(Exim, Postfix, ...)",tooltip="MTA",href="MailIntegration"]; subgraph { rank=same; - agent [label="imip-agent",style=filled,fillcolor=gold]; + agent [label="imip-agent",style=filled,fillcolor=gold,href="AgentPrograms"]; scheduling [label="Scheduling",shape=ellipse,style=filled,fillcolor=gold]; - freebusy [label="Free/busy",shape=folder,style=filled,fillcolor=gold]; - manager [label="imip-manager",style=filled,fillcolor=gold]; + freebusy [label="Free/busy",shape=folder,style=filled,fillcolor=gold, + href="FreeBusyPublishing"]; + manager [label="imip-manager",style=filled,fillcolor=gold, + href="CalendarManager"]; } - mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes"]; - webserver [label="Web server\n(Apache, ...)",tooltip="Web server"]; - client [label="Mail clients"]; + mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes", + href="MailboxIntegration"]; + webserver [label="Web server\n(Apache, ...)",tooltip="Web server", + href="WebServerIntegration"]; + client [label="Mail clients",href="MailClients"]; browser [label="Web browsers"]; mail -> MTA -> agent -> mailbox -> client; @@ -66,6 +72,8 @@ } }}} +######## + Unlike some monolithic groupware solutions... * It does not require you to change your [[/MailIntegration|mail delivery]]