mirror of
https://git.FreeBSD.org/ports.git
synced 2024-11-22 00:35:15 +00:00
854b45ea77
failing, please add detailed information how you set up your MTA, and Mailman, what user/group IDs are, how list aliases are managed, and thereabouts. - Update to 2.1.15. [2] Changes: click View the full Changelog on https://launchpad.net/mailman/2.1/2.1.15 - Fix without-NLS install: Install at least English template. [1] - Drop EXIM3 option, we don't have an Exim 3 port any more. - Drop INTEGRATION option, which would at best be confusing. - Reformat COMMENT to fit into common limits. - Fix typo in COURIER_DESC. - When Postfix integration is chosen, add BUILD and RUN_DEPENDS on Postfix because we need the postconf program. - Use htdig patches for Mailman version 2.1.12 and remove BROKEN tag, in an experimental attempt to revive htdig support. - Fix a few minor glitches in FreeBSD-post-install-notes. - Drop files/patch-Mailman__Cgi__confirm.py, integrated in upstream tarball. - Add launchpad.net to MASTER_SITES. - Update files/postfix-verp.diff. - Install a dummy one-line text file into PYTHON_SITELIBDIR so that Python's upgrade-site-packages would reinstall Mailman. [1] - Add "status" support for rc.d script. [3] - Change pre-fetch: to pre-everything:: - Revise formatting of pre-everything text to make clear it displays default values, not current values. To avoid ports/170280. PR: ports/135503 [1] PR: ports/170280 [2] PR: ports/170285 [2] PR: ports/176180 [1] PR: ports/181298 [3] Submitted by: Lowell Gilbert [1] Submitted by: Stefan Lasiewski [2] Submitted by: Oliver Fromme [3]
171 lines
5.9 KiB
Plaintext
171 lines
5.9 KiB
Plaintext
# ----------------------------------------------------------------------
|
|
# Post-installation instructions for the FreeBSD port/package of Mailman
|
|
# $FreeBSD$
|
|
# ----------------------------------------------------------------------
|
|
|
|
|
|
CONTENTS:
|
|
* VERY IMPORTANT NOTE
|
|
1) General post-installation instructions
|
|
2) Integrating Mailman with your web server
|
|
3) Integrating Mailman with various mail servers
|
|
3.1) Sendmail
|
|
3.2) Exim
|
|
3.3) Postfix
|
|
3.4) Qmail
|
|
4) Apache configuration
|
|
|
|
|
|
VERY IMPORTANT NOTE
|
|
|
|
The Mailman port has a number of build time options. Getting the values of
|
|
some of these right is CRUCIAL if you want your Mailman installation to work!
|
|
|
|
|
|
1) General post-installation instructions
|
|
|
|
You should find two files named "INSTALL" and "README" in the same
|
|
directory as this file. You should read them for general
|
|
post-installation instructions. Bear in mind that the installation of
|
|
Mailman from the FreeBSD port or package may have already taken care of
|
|
many of the steps you may read about in these files. Also, not everything
|
|
in these files is necessarily relevant to the FreeBSD port.
|
|
|
|
|
|
2) Integrating Mailman with your web server
|
|
|
|
You need to set up your webserver to find Mailman's CGI scripts. The
|
|
Mailman port works well with either Apache 1.3.x or Apache 2.x as
|
|
installed from their respective ports (www/apache13 and www/apache2).
|
|
|
|
If you are using Apache, you need to add at least two lines to your
|
|
httpd.conf. Assuming that you installed the Mailman port in the default
|
|
location (/usr/local/mailman), they are:
|
|
|
|
ScriptAlias /mailman "/usr/local/mailman/cgi-bin"
|
|
Alias /pipermail "/usr/local/mailman/archives/public"
|
|
|
|
If you installed the Mailman port to a non-standard location, replace
|
|
"/usr/local/mailman" as appropriate.
|
|
|
|
If your Apache is configured for multiple virtual servers, ensure that the
|
|
above configuration lines appear in all the relevant <VirtualHost>
|
|
sections.
|
|
|
|
Remember to restart your Apache server after you have changed httpd.conf!
|
|
|
|
No specific instructions exist at this time on how to integrate the
|
|
Mailman port with web servers other than Apache. Please submit any such
|
|
information to the maintainer of the Mailman port.
|
|
|
|
|
|
3) Integrating Mailman with various mail servers
|
|
|
|
|
|
3.1) Sendmail
|
|
|
|
You have to choose SENDMAIL option on config build and port will set
|
|
MAIL_GID=mailnull to you.
|
|
|
|
When your build is finished, please review the instructions found in
|
|
mailman-install.txt in the same directory port. The port is designed to
|
|
work with Sendmail by default.
|
|
|
|
No further instructions exist at this time on how to integrate the
|
|
Mailman port with Sendmail. Please submit any such information to the
|
|
maintainer of the Mailman port.
|
|
|
|
|
|
3.2) Exim
|
|
|
|
The following instructions assume that Exim has been set up from the
|
|
FreeBSD Exim port, and that it runs with a fairly default configuration.
|
|
Specifically, it assumes that Exim runs under the default UID and GID as
|
|
configured by the FreeBSD port. In other words, that the following
|
|
lines appear in Exim's configure file:
|
|
|
|
exim_user = mailnull
|
|
exim_group = mail
|
|
|
|
For Exim 4.x, the value of MAIL_GID has to be set to 'mail' (or 6) when
|
|
building the Mailman port, so you have to choose EXIM4 on build options to
|
|
set it to you.
|
|
|
|
Next, follow the instructions in mailman-install.txt found in the same
|
|
directory as this file. You can add the macros, transport and router
|
|
found in mailman-install.txt verbatim to your Exim's configure file.
|
|
|
|
Note that mailman-install.txt as installed with the FreeBSD port of
|
|
Mailman has been patched, and should be trusted over a version of the
|
|
file obtained from another source. Specifically, when adding the
|
|
macros found in mailman-install.txt, you should set the MAILMAN_USER
|
|
and MAILMAN_GROUP to the same values as those for Exim, namely:
|
|
|
|
MAILMAN_USER=mailnull
|
|
MAILMAN_GROUP=mail
|
|
|
|
Once you have finished editing configure, remember to re-HUP your Exim
|
|
server:
|
|
|
|
# kill -1 `cat /var/run/exim.pid`
|
|
|
|
Now, start Mailman's qrunner daemon:
|
|
|
|
# /usr/local/etc/rc.d/mailman start
|
|
|
|
Troubleshooting: If you ever see an error message such as the following
|
|
in your Exim's mainlog, that is a sure sign that Exim and Mailman
|
|
disagree about the GID under which mail is delivered:
|
|
|
|
** testlist@your.host.com R=mailman_router T=mailman_transport:
|
|
Child process of mailman_transport transport returned 2 from command:
|
|
/usr/local/mailman/mail/mailman
|
|
|
|
In this case, ensure that you have followed the instructions in this
|
|
section to the letter.
|
|
|
|
|
|
3.3) Postfix
|
|
|
|
The value of MAIL_GID has to be set to 'nobody' (or 65534) when building
|
|
the Mailman port, so you have to choose POSTFIX on build options to
|
|
set it to you.
|
|
|
|
NOTE: the group needs to be 'mailman' if you are using the Mailman
|
|
integration for generating the postfix virtual and aliases files.
|
|
|
|
Review the instructions found in mailman-install.txt in the same
|
|
directory as this file.
|
|
|
|
3.4) Qmail
|
|
|
|
The maintainer of the Mailman port has no information at this time as to
|
|
the required value of MAIL_GID for Mailman to work with Qmail. :-(
|
|
|
|
Review the instructions found in mailman-install.txt in the same
|
|
directory as this file.
|
|
|
|
No further instructions exist at this time on how to integrate the
|
|
Mailman port with Qmail. Please submit any such information to the
|
|
maintainer of the Mailman port.
|
|
|
|
|
|
4) Apache configuration
|
|
|
|
You should add the follow lines to your httpd.conf so
|
|
that the mailman interface works correctly:
|
|
|
|
<Directory "/usr/local/mailman">
|
|
Options FollowSymLinks ExecCGI
|
|
AllowOverride None
|
|
Order allow,deny
|
|
Allow from all
|
|
</Directory>
|
|
|
|
After that, restart your apache:
|
|
|
|
# apachectl restart.
|
|
|
|
-- Jean Milanez Melo <jmelo@FreeBSD.org>
|
|
(former Mailman port maintainer)
|