------------------------------------------------------------
revno: 129
committer: Mark Sapiro <m...@msapiro.net>
branch nick: admin
timestamp: Thu 2016-07-07 11:14:24 -0700
message:
Added some info and clarification to the Postfix virtual domains section.
modified:
doc/mailman-install.tex
--
lp:mailman-administrivia
https://code.launchpad.net/~mailman-administrivia/mailman-administrivia/admin
Your team Mailman Checkins is subscribed to branch lp:mailman-administrivia.
To unsubscribe from this branch go to
https://code.launchpad.net/~mailman-administrivia/mailman-administrivia/admin/+edit-subscription
=== modified file 'doc/mailman-install.tex'
--- doc/mailman-install.tex 2016-04-14 16:56:54 +0000
+++ doc/mailman-install.tex 2016-07-07 18:14:24 +0000
@@ -486,7 +486,8 @@
\begin{notice}[note]
If you are using virtual domains and you want Mailman to honor your virtual
-domains, read the \ref{postfix-virtual} section below first!
+domains, read the \ref{postfix-virtual} section below first! Then come back
+here and do these steps.
\end{notice}
\begin{itemize}
@@ -602,6 +603,32 @@
older version of Postfix which doesn't have the \var{virtual_alias_maps}
variable, use the \var{virtual_maps} variable instead.
+The default mappings in \file{virtual-mailman} map list addresses in virtual
+domains to unqualified local names as in:
+
+\begin{verbatim}
+ myl...@dom.ain mylist
+ mylist-requ...@dom.ain mylist-request
+ # and so on...
+\end{verbatim}
+
+In some Postfix configurations it may be necessary to qualify those local
+names as for example:
+
+\begin{verbatim}
+ myl...@dom.ain mylist@localhost
+ mylist-requ...@dom.ain mylist-request@localhost
+ # and so on...
+\end{verbatim}
+
+If this is the case, you can include
+
+\begin{verbatim}
+ VIRTUAL_MAILMAN_LOCAL_DOMAIN = 'localhost'
+\end{verbatim}
+
+or whatever qualification is needed in \file{mm_cfg.py}.
+
Next, in your \file{mm_cfg.py} file, you will want to set the variable
\var{POSTFIX_STYLE_VIRTUAL_DOMAINS} to the list of virtual domains that Mailman
should update. This may not be all of the virtual alias domains that your
@@ -609,9 +636,11 @@
against the \var{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 \code{dom1.ain}, \code{dom2.ain}, and \code{dom3.ain}, and further
-that in your \file{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 \code{dom1.ain}, \code{dom2.ain}, and
+\code{dom3.ain}, and further that in your \file{main.cf} file you've got the
+following settings:
\begin{verbatim}
myhostname = mail.dom1.ain
@@ -656,9 +685,28 @@
Now, any list that Mailman creates in either of those two domains, will have
the correct entries written to \file{/usr/local/mailman/data/virtual-mailman}.
-As above with the \file{data/aliases*} files, you want to make sure that both
-\file{data/virtual-mailman} and \file{data/virtual-mailman.db} are user and
-group owned by \code{mailman}.
+In a more usual configuration, \code{dom1.ain} would not be a virtual domain
+at all as in the following:
+
+\begin{verbatim}
+ 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
+\end{verbatim}
+
+In this case too, you would include \code{dom2.ain} and \code{dom3.ain} in
+\file{mm_cfg.py}:
+
+\begin{verbatim}
+ POSTFIX_STYLE_VIRTUAL_DOMAINS = ['dom2.ain', 'dom3.ain']
+\end{verbatim}
+
+As in the previous section with the \file{data/aliases*} files, you want to
+make sure that both \file{data/virtual-mailman} and
+\file{data/virtual-mailman.db} are user and group owned by \code{mailman}.
\subsubsection{An alternative approach}
_______________________________________________
Mailman-checkins mailing list
Mailman-checkins@python.org
Unsubscribe:
https://mail.python.org/mailman/options/mailman-checkins/archive%40jab.org
