X-Git-Url: http://gitweb.michael.orlitzky.com/?a=blobdiff_plain;f=net-mail%2Fmailman%2Ffiles%2FREADME.gentoo-r3;fp=net-mail%2Fmailman%2Ffiles%2FREADME.gentoo-r3;h=e5e0e3bdfd05fc9eba22f3afb7ebf6c37ade63a5;hb=5d22954c11b6b303ff0b4fcdbcf746a5179083ee;hp=0000000000000000000000000000000000000000;hpb=611a5e9c308cf2e3b3a48e038f28815e6f5b0ff9;p=mjo-overlay.git diff --git a/net-mail/mailman/files/README.gentoo-r3 b/net-mail/mailman/files/README.gentoo-r3 new file mode 100644 index 0000000..e5e0e3b --- /dev/null +++ b/net-mail/mailman/files/README.gentoo-r3 @@ -0,0 +1,182 @@ +# Copyright 1999-2004 Gentoo Foundation +# Distributed under the terms of the GNU General Public License v2 +# $Header: /var/cvsroot/gentoo-x86/net-mail/mailman/files/README.gentoo-r3,v 1.2 2008/11/14 11:07:55 hanno Exp $ + +Follow these instructions to finish setting up mailman. This file and the +original ebuild were tweaked by me but were graciously +submitted by Joby Walker (YOU RULE!) +2003 Jul 09: updated by Jesus Perez and re-tweaked by me +for 2.1.x. + +Please view the documentation on Mailman at: http://www.list.org/ + +This documentation assumes you're using the default gentoo path +(/usr/lib/mailman/), if you've changed it with MAILMAN_PREFIX, adjust them +accordingly. + +1) If this is your first time installing mailman, after your "emerge mailman", +you need to add -D MAILMAN to /etc/conf.d/apache or /etc/conf.d/apache2 and restart +apache. + +2) In your /etc/conf.d/apache (for apache 1.x) + or /etc/conf.d/apache2 (for apache 2.x) + file add the additional option to the + APACHE_OPTS or APACHE2_OPTS variable: + + -D MAILMAN + +3) Make sure mailman is a part of the cron group + +4) This must be done as user mailman: + + su - mailman + +Add the cron jobs: + + cd cron + crontab crontab.in + cd .. + +Create the site password: + + bin/mmsitepass + +and main list: + + bin/newlist mailman + + +5) Change back to root: + + exit + +(Postfix users: read the notes at the end of this file before you continue) +Add this to /etc/mail/aliases (and see point 9 for notes): + mailman: "|/usr/lib/mailman/mail/mailman post mailman" + mailman-admin: "|/usr/lib/mailman/mail/mailman admin mailman" + mailman-bounces: "|/usr/lib/mailman/mail/mailman bounces mailman" + mailman-confirm: "|/usr/lib/mailman/mail/mailman confirm mailman" + mailman-join: "|/usr/lib/mailman/mail/mailman join mailman" + mailman-leave: "|/usr/lib/mailman/mail/mailman leave mailman" + mailman-owner: "|/usr/lib/mailman/mail/mailman owner mailman" + mailman-request: "|/usr/lib/mailman/mail/mailman request mailman" + mailman-subscribe: "|/usr/lib/mailman/mail/mailman subscribe mailman" + mailman-unsubscribe: "|/usr/lib/mailman/mail/mailman unsubscribe mailman" + +For courier, the aliases have to go to /etc/courier/aliases and you have to skip +the quotes. + +Run newaliases (only if you use sendmail). + + newaliases + +6) Start the mailman daemon: + + /etc/init.d/mailman start + +and add it to default runlevel (optional but recommended): + + rc-update add mailman default + +7) For each list created (either with web interface or with bin/newlist) +this must be added to /etc/mail/aliases (see smrsh notes below) +replace with the name of the list: + + : "|/usr/lib/mailman/mail/mailman post " + -admin: "|/usr/lib/mailman/mail/mailman admin " + -bounces: "|/usr/lib/mailman/mail/mailman bounces " + -confirm: "|/usr/lib/mailman/mail/mailman confirm " + -join: "|/usr/lib/mailman/mail/mailman join " + -leave: "|/usr/lib/mailman/mail/mailman leave " + -owner: "|/usr/lib/mailman/mail/mailman owner " + -request: "|/usr/lib/mailman/mail/mailman request " + -subscribe: "|/usr/lib/mailman/mail/mailman subscribe " + -unsubscribe: "|/usr/lib/mailman/mail/mailman unsubscribe " + +For courier, the aliases have to go to /etc/courier/aliases and you have to skip +the quotes. + +Run newaliases: + + newaliases + +smrsh notes +----------- +(if you use sendmail, you are surely using srmsh) you must note that +sendmail won't run any program outside of EBINDIR. I tried to change +EBINDIR using,define(`confEBINDIR', `/usr/lib/mailman/mail')dnl in +sendmail.mc but it didn't work, so mailman must be placed in EBINDIR, +which in Gentoo is /usr/adm/sm.bin, so you must run as root: + + ln -s /usr/lib/mailman/mail/mailman /usr/adm/sm.bin/mailman + +And the lines in /etc/mail/aliases which refer to +/usr/lib/mailman/mail/mailman must be changed to mailman: + + : "|mailman post " + -admin: "|mailman admin " + -bounces: "|mailman bounces " + -confirm: "|mailman confirm " + -join: "|mailman join " + -leave: "|mailman leave " + -owner: "|mailman owner " + -request: "|mailman request " + -subscribe: "|mailman subscribe " + -unsubscribe: "|mailman unsubscribe " + +exim notes +---------- +You can write an exim stanza for the router and transport that looks something +like (Derived from, and in part taken from cpanel): + +mailman_virtual_router: + driver = accept + require_files = /var/lib/mailman/lists/${lc::$local_part}/config.pck + local_part_suffix_optional + local_part_suffix = -admin : \ + -bounces : -bounces+* : \ + -confirm : -confirm+* : \ + -join : -leave : \ + -owner : -request : \ + -subscribe : -unsubscribe + transport = mailman_virtual_transport + +mailman_virtual_transport: + driver = pipe + command = /usr/lib/mailman/mail/mailman \ + '${if def:local_part_suffix \ + {${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}} \ + {post}}' \ + ${lc:$local_part} + current_directory = /usr/lib/mailman + home_directory = /usr/lib/mailman + user = mailman + group = mailman + +Note the double colon in the require files. See +http://wiki.exim.org/FAQ/General_Debugging/Q0060 for more information. + +This should be modified if you're using the vhosts USE flag, specifically you +need to modify the location of the config.pck file, to be +${lc::$local_part}-${lc::$domain} instead of simply ${lc::$local_part}, and for the +transport you need to change the last part of the command in the same fashion. + +Other Helpful things to know... +------------------------------- +run "bin/check_perms -f" from the root mailman directory +(/usr/lib/mailman) to check and fix permission problems. + +The INSTALL file is located in /usr/share/doc/mailman-$VERSION/ + +Postfix notes +------------- +If you're using Postfix, don't manually change your /etc/mail/aliases +file, as described above. Instead, follow these instructions: + +http://list.org/mailman-install/node13.html + +This will set up Mailman and Postfix to automatically generate the new +aliases when you create new lists. It will also make sure that Postfix +uses the correct group ID when it's talking to Mailman, otherwise you +will get security errors from Mailman. +