aboutsummaryrefslogtreecommitdiffstats
path: root/doc/mailman-install.txt
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--doc/mailman-install.txt61
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.