diff options
Diffstat (limited to 'doc/mailman-install.txt')
| -rw-r--r-- | doc/mailman-install.txt | 61 |
1 files changed, 49 insertions, 12 deletions
diff --git a/doc/mailman-install.txt b/doc/mailman-install.txt index 50190500..7cdd36d3 100644 --- a/doc/mailman-install.txt +++ b/doc/mailman-install.txt @@ -11,7 +11,7 @@ GNU Mailman - Installation Manual barry (at) list dot org Release 2.1 - April 14, 2016 + July 7, 2016 Front Matter @@ -406,7 +406,8 @@ GNU Mailman - Installation Manual and --with-var-prefix options. Note: If you are using virtual domains and you want Mailman to honor - your virtual domains, read the 6.1 section below first! + your virtual domains, read the 6.1 section below first! Then come back + here and do these steps. * Add this to the bottom of the $prefix/Mailman/mm_cfg.py file: MTA = 'Postfix' @@ -493,6 +494,26 @@ GNU Mailman - Installation Manual using an older version of Postfix which doesn't have the virtual_alias_maps variable, use the virtual_maps variable instead. + The default mappings in virtual-mailman map list addresses in virtual + domains to unqualified local names as in: + + mylist@dom.ain mylist + mylist-request@dom.ain mylist-request + # and so on... + + In some Postfix configurations it may be necessary to qualify those + local names as for example: + + mylist@dom.ain mylist@localhost + mylist-request@dom.ain mylist-request@localhost + # and so on... + + If this is the case, you can include + + VIRTUAL_MAILMAN_LOCAL_DOMAIN = 'localhost' + + or whatever qualification is needed in mm_cfg.py. + Next, in your mm_cfg.py file, you will want to set the variable POSTFIX_STYLE_VIRTUAL_DOMAINS to the list of virtual domains that Mailman should update. This may not be all of the virtual alias domains @@ -500,9 +521,11 @@ GNU Mailman - Installation Manual be matched against the host_name attribute of mailing lists objects, and must be an exact match. - Here's an example. Say that Postfix is configured to handle the virtual - domains dom1.ain, dom2.ain, and dom3.ain, and further that in your - main.cf file you've got the following settings: + Here's an example. Note that this example describes an unusual + configuration. A more usual configuration is described next. Say that + Postfix is configured to handle the virtual domains dom1.ain, dom2.ain, + and dom3.ain, and further that in your main.cf file you've got the + following settings: myhostname = mail.dom1.ain mydomain = dom1.ain @@ -539,9 +562,23 @@ GNU Mailman - Installation Manual have the correct entries written to /usr/local/mailman/data/virtual-mailman. - As above with the data/aliases* files, you want to make sure that both - data/virtual-mailman and data/virtual-mailman.db are user and group - owned by mailman. + In a more usual configuration, dom1.ain would not be a virtual domain + at all as in the following: + + myhostname = mail.dom1.ain + mydomain = dom1.ain + mydestination = $myhostname, $mydomain localhost.$mydomain + virtual_alias_maps = + hash:/some/path/to/virtual-dom2, + hash:/some/path/to/virtual-dom2 + + In this case too, you would include dom2.ain and dom3.ain in mm_cfg.py: + + POSTFIX_STYLE_VIRTUAL_DOMAINS = ['dom2.ain', 'dom3.ain'] + + As in the previous section with the data/aliases* files, you want to + make sure that both data/virtual-mailman and data/virtual-mailman.db + are user and group owned by mailman. 6.1.3 An alternative approach @@ -1559,12 +1596,12 @@ tar xvf MailmanStartup.tar About this document ... - GNU Mailman - Installation Manual, April 14, 2016, Release 2.1 + GNU Mailman - Installation Manual, July 7, 2016, Release 2.1 This document was generated using the LaTeX2HTML translator. - LaTeX2HTML is Copyright © 1993, 1994, 1995, 1996, 1997, Nikos Drakos, - Computer Based Learning Unit, University of Leeds, and Copyright © + LaTeX2HTML is Copyright © 1993, 1994, 1995, 1996, 1997, Nikos Drakos, + Computer Based Learning Unit, University of Leeds, and Copyright © 1997, 1998, Ross Moore, Mathematics Department, Macquarie University, Sydney. @@ -1613,4 +1650,4 @@ tar xvf MailmanStartup.tar Previous Page Up one Level Next Page GNU Mailman - Installation Manual __________________________________________________________________ - Release 2.1, documentation updated on April 14, 2016. + Release 2.1, documentation updated on July 7, 2016. |