aboutsummaryrefslogblamecommitdiffstats
path: root/doc/mailman-install.dvi
blob: 80c5c1be059f77a8c86e18a422befd56a00da93f (plain) (tree)






























































































































                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                
����;� TeX output 2007.12.05:1720�������n���>���n����썍���H���!���TD���l��H
phvr7t�GNU��Mailman�-�Installation�Man��Qual���Ǎ���L��l�
phvro7t�Release�U�2.1��*�Ǎ�{����l�ff
phvr7t�Barr�n�y��W��l�arsa��Jw�����*Y�3{�

ptmr7t�December��5,�2007���������l�	
phvr7t�barr�Ey��}(at)�list�dot�org���Ǎ��"��ߌ�	
ptmb7t�Abstract��0Ǎ��3{�	
ptmr7t�This��Mdocument��Ldescribes�ho��fw�to�install�GNU���Mailman�on�a�POSIX-based�system�such�as��8��	
ptmrc7t�Unix�,��MacOSX,�or����GNU/Linux.��AIt�,will�,co��vv�er�basic�installation�instructions,�gas�well�as�guidelines�,for�inte�grating�Mailman�,with�your����web�@and�mail�serv��vers.����The�@GNU�Mailman�website�is�at���http://www��u�.list.org���!����Contents��Y�����ߌ�

ptmb7t�1��Installation��Requir���ements��R��2�����2��Set��up�y��our�system��q-3�������2.1��&Add��the�group�and�user� ׍���.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 3������2.2��&Create��the�installation�directory������.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 3������3��Build��and�install�Mailman��Q��4�������3.1��&Run���congur���e��>�����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 4������3.2��&Mak��ge��and�install�pk����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 5������4��Check��y��our�installation��]�5�����5��Set��up�y��our�web�ser��gv�er��_��6�����6��Set��up�y��our�mail�ser��gv�er��^7L7�������6.1��&Using��the�Postx�mail�serv�٠er��썍��.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 7�����&Inte�٠grating��Postx�and�Mailman�������.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 7�����&V��fgirtual��domains������.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 9�����&An��alternati��v�٠e�approach�Q�����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 10������6.2��&Using��the�Exim�mail�serv�٠er�(�����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 10�����&Exim��conguration������.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 10�����&Main��conguration�settings�������.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 11�����&T��gransport��for�Exim�3�#z����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 11�����&Director��for�Exim�3��J����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 11�����&Router��for�Exim�4�rፍ��.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 12�����&T��gransports��for�Exim�4�?�����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 12�����&Additional��notes��덍��.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 12�����&Problems������.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 12�����&Recei��v�٠er��V����erication�2덍��.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 13�����&SMTP��Callback��8����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 13�����&Doing��VERP�with�Exim�and�Mailman��.����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 14������*��n���>�썍����fd������n����썑&�V��fgirtual��Domains�������.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 14�����&List��V����erication�G|����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 15�����&Document��History�V���.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 15������6.3��&Using��the�Sendmail�mail�serv�٠er�~����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 15�����&Sendmail��\smrsh"�compatibility��鍍��.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 16�����&Inte�٠grating��Sendmail�and�Mailman�pG����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 16�����&Performance��notes�L�����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 17������6.4��&Using��the�Qmail�mail�serv�٠er�T.����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 17�����&Information��on�VERP�+)����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 19�����&V��fgirtual��mail�serv�٠er�5�����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 19�����&More��information�r����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 19������7��Re�٠view��y��our�site�defaults��R9�20�����8��Cr���eate��a�site-wide�mailing�list��>I_20�����9��Set��up�cr���on����20�����10��Start��the�Mailman�qrunner��G��21�����11��Check��the�hostname�settings��C`Y22�����12��Cr���eate��the�site�passw��gord��TV
22�����13��Cr���eate��y��our�rst�mailing�list��D23�����14��T��B�r���oubleshooting��w23�����15��Platf��orm��and�operating�system�notes�� [B25�������15.1��&GNU/Linux��issues�Ga����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 25������15.2��&BSD��issues�(�����.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 25������15.3��&MacOSX��issues��ύ���.��������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.�������.����C 26����Ǎ����H���3pÍ��1��hInstallation��Requirements��
_��Kj�

ptmri7t�Please���note�that�the���information�on�this�pa��gg�e���may�be�out�of�date�٠.��A�Check�for�the�latest�installation�information�on�the���Mailman��wiki.���GNU�ΝMailman�ΰw��gorks�αon�most�POSIX-based�systems�such�as��8��

ptmrc7t�Unix�,��]MacOSX,�or�GNU/Linux.��It�does�not�currently���w��gork��on��W���indo��ws.���Y���gou�must�ha���v�٠e�a�mail�serv�٠er�that�you�can�send�messages�to,�C�and�a�web�serv�٠er�that�supports�the���CGI/1.1�FvAPI.�Apache�mak��ges�a�ne�choice�for�web�serv�٠er���,�Q�and�mail�serv�ers�such�as�Postx,�Q�Exim,�Sendmail,�and�Fvqmail���should��w��gork�just�ne.���T��37o���install�Mailman�from�source,���you�will�need�an�ANSI���C�compiler���to�b���uild�Mailman'��s8s�security���wrappers.�`�The�GNU���C��compiler�gcc�w��gorks�well.���Y���gou��Smust��Tha���v�٠e�the�Python�interpreter�installed�some��where�on�your�system.�P�As�of�this�writing,���Python�2.4.4�is�recom-���mended,��b���ut�see�the�wiki�page�abo�٠v�e��for�the�latest�information.���������ff��H�������l�

phvr7t�2�������U`e1�
Installation�ǧRequirements����������)��n���>�썍����fd������n����.̍��2��hSet��up�y��Jour�system��
_��Before�7Iinstalling�7HMailman,�E�you�need�to�prepare�your�system�by�adding�certain�users�and�groups.�[Y���gou�will�need�to�ha���v�٠e���root��pri��vile�٠ges�to�perform�the�steps�in�this�section.��"PÍ���l�
phvr7t�2.1���Add�U�the�g��Iroup�and�user��pō�Mailman��-requires�a�unique�user�and�group�name��.which�will�o��wn�its�les,���and�under�which�its�processes�will�run.���Mailman'��s8s���basic�security���is�based�on�group�o��wnership�permissions,��so�it'��s8s�important�to�get�this�step�right����^��3{�
ptmr7t�1����.�d7T��37ypically��Y�,���you��^will��]add�a�ne��w�user�and�a�ne��w�group,���both�called��(0��

pcrr7t�mailman�.�t�The��mailman��user�must�be�a�member�of�the����mailman�.4�group.�$6Mailman�will�be�.5installed�under�the��mailman��user�and�group,�Y�with�the�set-group-id�(setgid)�bit���enabled.���ǍIf�_�these�_�names�are�already�in�use,���you�can�choose�dierent�user�and�group�names,���as�long�as�you�remember�these���when���you���run��congur���e�.�W:If�you�choose�a�dierent�unique�user�name,�Yyou�will�ha���v�٠e�to�specify�this�with��congur���e�'��s8s����--with-user�٠name�Z�option,���and�if�you�Zchoose�a�dierent�group�name,���you�will�ha���v�٠e�to�specify�this�with��congur���e�'��s8s����--with-gr���oupname���option.���On�|Linux�systems,�|�you�can�use�the�follo��wing�commands�to�create�these�accounts.�ECheck�your�system'��s8s�manual�pages���for��details:�������2
�)0��	
pcrr7t�%�ffgroupadd�mailman����2
%�ffuseradd�-c''GNU�Mailman''�-s�/no/shell�-d�/no/home�-g�mailman�mailman�����I(Ӎ��2.2���Create�U�the�installation�director�\#y��pō�T��37ypically��Y�,�x�Mailman�v�is�installed�v�into�a�single�directory��Y�,�x�which�includes�both�the�Mailman�source�code�and�the�run-time���list��#and�archi��v�٠e�data.�2It�is�possible�to�split�the��$static�program�les�from�the�v�ariable�data�les��$and�install�them�in���separate��directories.��This�section�will�describe�the�a���v��ailable�options.���The��{def��gault��zis�to�install�all�of�Mailman�to�`�/usr/local/mailman�'����^��2����.��lY���gou�can�change�this�base�installation�directory�(referred���to�}�here�}�as��+3{�

ptmro7t�$�pr��Gex���)�by�specifying�the�directory�with�the��--pr���ex�congur�e�}�option.��If�you'���re�upgrading�from�a�pre��vious���v�٠ersion��of�Mailman,�you�may�w��gant�to�use�the��--pr���ex��option�unless�you�mo�v�e�your�mailing�lists.��$������������H�/��/�����������΍��W��Y�ar�٠ning:�
�8�Y���gou���cannot�install�Mailman�on�a�lesystem���that�is�mounted�with�the��nosuid��option.���This�will����break�L<Mailman,�V�which�relies�on�setgid�L=programs�for�its�security��Y�.�WIf�this�describes�your�en���vironment,�V�simply�install����Mailman��in�a�location�that�allo��ws�setgid�programs.��������H�/�����H�������Mak��ge��Wsure�the�installation�directory��Vis�set�to�group��mailman��(or�whate��v�٠er�you'���re�going�to�specify�with��--with-���gr���oupname�)���and���has�the�setgid�bit�set����^��3����.��$Y���gou�probably�also�w��gant�to�guarantee�that�this�directory�is�readable�and���e�٠x�ecutable��by�e��v�٠eryone.��F�or��e�xample,�these�shell�commands�will�accomplish�this:�������2
�%�ffcd�$prefix����2
%�ffchgrp�mailman�.����2
%�ffchmod�a+rx,g+ws�.�����C����Y���gou��are�no��w�ready�to�congure�and�install�the�Mailman�softw��gare.�����ff��-�	�荍���
�h��-:�'3{�
ptmr7t�1����fh� 3{�
ptmr7t�Y���ou�will�be�able�to�check�and�repair�your�permissions�after�installation�is�complete.��	�鍍���
�h��-:�2����fh�This�is�the�def��ault�for�Mailman�2.1.�z�Earlier�v��Mersions�of�Mailman�installed�e���v�erything�under�`�*�l�
phvr7t�/home/mailman�'�by�def��ault.�������
�h��-:�3����fh�BSD�users�should�see�the�15.2�section�for�additional�information.���������ff��H�������1��3����������J���n���>�썍����fd������n����P���3��hBuild��and�install�Mailman��
_���3.1���Run�U��,�ߌ�
ptmb7t�congur�ȹe��pō�Before��you�can�install�Mailman,�you�must�run��congur���e��to�set�v��arious�installation�options�your�system�might�need.���Ǎ�Note:�	�.�T��37ak��ge�]@special�]?note�of�the��--with-mail-gid��and��--with-cgi-gid��options�belo��w��Y�.��VY���gou�will�probably�need�to�use���these.���Y���gou�B�should��not�B��be�root�while�performing�the�steps�in�this�section.�Do�them�under�your�o��wn�login,�N�or�whate�v�٠er�account���you��Ytypically�use�to��Xinstall�softw��gare.�[�Y���gou�do�not�need�to�do�these�steps�as�user��mailman�,�/b���ut�you�could.�[�Ho��we�v�٠er���,���mak��ge�q�sure�q�that�the�login�used�is�a�member�of�the��mailman��group�as�that�that�group�has�write�permissions�to�the����$�pr��Gex�'��directory� made� in�the�pre��vious�step.���Y���gou�must�also�ha���v�٠e�permission�to�create�a�setgid�le�in�the�le�system���where��it�resides�(NFS�and�other�mounts�can�be�congured�to�inhibit�setgid�settings).���If�€you'���v�٠e��installed�other�GNU��nsoftw��gare,�� you�should�be�f��gamiliar�with�the��congur���e��script.��Usually�you�can�just��cd��to���the��directory�you�unpack��ged�the�Mailman�source�tarball�into,�and�run��congur���e��with�no�ar�guments:�������'@��%�ffcd�mailman-<version>����'@�%�ff./configure����'@�%�ffmake�install�����C����The��follo��wing�options�allo�w�you�to�customize�your�Mailman�installation.���Ǎ���--pr���ex=�-ڶ�%

ptmbi7t�dir���5�v�Standard�zGNU�y�congure�zoption�which�changes�the�base�directory�that�Mailman�is�installed�into.��By����def��gault���$�pr��Gex����is�`�/usr/local/mailman�'.��This�directory�must�already�e�٠xist,�and�be�set�up�as�described�in�2.2.������--exec-pr���ex=�dir���KιStandard�ߵGNU�ߝcongure�option�which�߶lets�you�specify�a�dierent�installation�directory�for�archi-����tecture��dependent�binaries.������--with-v��gar��G-pr���ex=�dir���]^{�Store�8ymutable�data�8zunder��dir�sX�instead�of�under�the��$�pr��Gex�@ �or��$�e���xec�����ff����pr�ex���.�CExamples�of�such����data��include�the�list�archi��v�٠es�and�list�settings�database.������--with-python=`�.�e9V	
phvb7t�/path/to/p��vython�'������Specify��an�alternati��v�٠e�Python�interpreter�to�use��for�the�wrapper�programs.���The����def��gault��is�to�use�the�interpreter�found�rst�on�your�shell'��s8s��$�P���A��GTH�s0�.������--with-user�٠name=�username-or-uid�����K�Specify�d�a�dierent�d�username�than��mailman�.�uThe�v��alue�of�this�option�can�be�an����inte�٠ger��user�id�or�a�user�name.��Be�sure�your��$�pr��Gex����directory�is�o��wned�by�this�user��s8.������--with-gr���oupname=�groupname-or-gid������Specify���a���dierent�groupname�than��mailman�.���The�v��alue�of�this�option�can����be��an�inte�٠ger�group�id�or�a�group�name.��Be�sure�your��$�pr��Gex����directory�is�group-o��wned�by�this�group.������--with-mail-gid=�group-or-groups����z{�Specify�&dan�alternati��v�٠e�group�for�running�scripts�&cvia�the�mail�wrapper��s8.�ļgr���oup-or���-����gr���oups���can�be��a�list�of�one�or�more�inte�٠ger�group�ids�or�symbolic�group�names.���The�rst�v��alue�in�the�list�that����resolv�٠es��to�an�e�xisting�group�is�used.��By�def��gault,�the�v��alue�is�the�list��mailman�,��other�,��mail�,�and��daemon�.�����Note:�
m�This���is�highly���system�dependent�and�you�must�get�this�right,��\because�the�group�id�is�compiled�into����the��smail��rwrapper�program�for�added�security��Y�.�O�On�systems�using��sendmail�,�Othe�`�sendmail.cf�'�conguration�le����designates���the���group�id�of��sendmail��processes�using�the��DefaultUser��عoption.�=�(If�commented�out,���it�still�may�be����indicating��the�def��gault...)����Check��your�mail�serv�٠er'��s8s�documentation�and�conguration�les�to�nd�the�right�v��alue�for�this�switch.������--with-cgi-gid=�group-or-groups�������Specify���an���alternati��v�٠e�group�for�running�scripts�via�the�CGI��xwrapper��s8.���gr���oup-or���-����gr���oups���can�be��a�list�of�one�or�more�inte�٠ger�group�ids�or�symbolic�group�names.���The�rst�v��alue�in�the�list�that����resolv�٠es��to�an�e�xisting�group�is�used.��By�def��gault,�the�v��alue�is�the�the�list��www�,��www-data�,�and��nobody�.���������ff��H������4�������W�D3�
Build�ǧand�install�Mailman����������[��n���>�썍����fd������n����썑�Note:��ƹThe�2�proper�2�v��alue�for�this�is�dependent�on�your�web�serv�٠er�conguration.���Y���gou�must�get�this�right,�Bbecause����the�Qmgroup�Qlid�is�compiled�into�the�CGI�Qawrapper�program�for�added�security��Y�,�Z�and�no�Mailman�CGI�Qascripts�will�run����if��this�is�incorrect.����If��you'���re�using�Apache,�check�the�v��alues�for�the��Gr���oup��option�in�your�`�httpd.conf�'�le.������--with-cgi-ext=�extension���kYC�Specify��Gan�e�٠xtension��Ffor�cgi-bin�programs.��lThe�CGI��'wrappers�placed�in�`�$�pr��Gex���/cgi-bin�'����will��ha���v�٠e�this�e�xtension�(some�web�serv�ers�require�an�e�xtension).���e���xtension��must�include�the�leading�dot.������--with-mailhost=�hostname���tB2�Specify�fthe�ffully�qualied�host�name�part�for�outgoing�email.���After�the�installation�is����complete,��this�v��alue�can�be�o�٠v�erriden��in�`�$�pr��Gex���/Mailman/mm�����ff����cfg.p��7y�'.������--with-urlhost=�hostname���n&�Specify�the�fully�qualied�host�name�part�of�urls.���After�the�installation�is�complete,�<�this����v��alue��can�be�o�٠v�erriden��in�`�$�pr��Gex���/Mailman/mm�����ff����cfg.p��7y�'.������--with-gcc=no���@��Don'���t��use�gcc,�e��v�٠en�if�it�is�found.��In�this�case,��cc��must�be�found�on�your��$�P���A��GTH�s0�.��"PÍ��3.2���Mak�“e�U�and�install��pō�Once��you'���v�٠e�run��congur���e�,�you�can�simply�run��mak��ge�,�then��mak�e�install��to�b���uild�and�install�Mailman.��'pÍ��4��hChec��Jk��y�our�installation��
_��After���you'���v�٠e�run��mak��ge�install�,�_you�should���check�that�your�installation�has�all�the�correct�permissions�and�group���o��wnerships�aby�brunning�the��check�����ff����perms��script.��First�change�to�the�installation�(i.e.���$�pr��Gex���)�directory��Y�,�Cythen�run�the����bin/check�����ff����perms���program.��Don'���t�try�to��run�bin/check�����ff��perms�from�the�source�directory;��it�will�only�run�from�the���installation��directory��Y�.���ǍIf��athis��`reports�no�problems,��xthen�it'��s8s�v�٠ery�lik��gely�<wink>�that�your�installation�is�set�up�correctly��Y�.�&�If�it�reports�problems,���then���you���can�either�x�them�manually��Y�,���re-run�the�installation,���or�use��bin/check�����ff����perms��to�x�the�problems�(probably���the��easiest�solution):���Ǎ�����
!",�

cmsy10������Y���gou��need�to�become�the�user�that�did�the�installation,�and�that�o��wns�all�the�les�in��$�pr��Gex���,�or�root.�������������Run���bin/check�����ff����perms�-f�������������Repeat��pre��vious�step�until�no�more�errors�are�reported!��e�����������H������������������܍��W��Y�ar�٠ning:�
;��If��you'���re��running�Mailman�on�a�shared�multiuser�system,�¥and�you�ha���v�٠e�mailing�lists�with�pri��v�ate����archi��v�٠es,��you���may�w��gant���to�hide�the�pri��v�ate���archi�v�٠e�directory�from���other�users�on�your�system.�z In�that�case,��you����should�]drop�]the�other�e�٠x�ecute�permission�](o-x)�from�the�`�archiv��fes/pr�"�iv�ate�'�]directory��Y�.���Ho��we�v�٠er���,��ethe�web�]serv�er����process�8�must�be�able�to�8�follo��w�the�symbolic�link�in�public�directory��Y�,�F�otherwise�your�public�Pipermail�archi��v�٠es�will����not��w��gork.��T��37o�set�this�up,�become�root�and�run�the�follo��wing�commands:�������#s��#�ffcd�<prefix>/archives����#s�#�ffchown�<web-server-user>�private����#s�#�ffchmod�o-x�private�����=�䍑�Y���gou���need�to���kno��w�what�user�your�web�serv�٠er�runs�as.��*It�may�be��www�,����apache�,��httpd����or��nobody�,���depending����on��your�serv�٠er'��s8s�conguration.��������H���������H�����N����������ff��H������3.2�
Mak���e�ǧand�install��������1�5����������l��n���>�썍����fd������n����.̍��5��hSet��up�y��Jour�w��$eb�ser�n�v���er��
_��Congratulations!�y.Y���gou'���v�٠e���installed���the�Mailman�softw��gare.�y-T��37o�get�e��v�٠erything�running�you�need�to�hook�Mailman�up�to���both��your�web�serv�٠er�and�your�mail�system.���ǍIf��you�plan�on�running�your�mail�and�web�serv�٠ers�on�dierent�machines,�jsharing�Mailman�installations�via�NFS,�be�sure���that���the���clocks�on�those�tw��go�machines�are�synchronized�closely��Y�.��)Y���gou�might�tak��ge�a�look�at�the�le�`�Mailman/Loc���kFile��v.p���y�';���the��constant��CLOCK�����ff����SLOP��helps�the�locking�mechanism�compensate�for�clock�sk��ge��w�in�this�type�of�en���vironment.���This��section�describes�some�of�the�things�you�need�to�do�to�connect�Mailman'��s8s�web�interf��gace�to�your�web�serv�٠er�.���The�xDinstructions�xChere�are�some��what�geared�to��w��gard�the�Apache�web�serv�٠er���,��Tso�you�should�consult�your�web�serv�٠er���documentation��for�details.���Y���gou���must�congure�your�web���serv�٠er�to�enable�CGI�Ʒscript�permission�in�the�`�$�pr��Gex���/cgi-bin�'�to�run�CGI�Ʒscripts.���The���line��Uyou��Vshould�add�might�look�something�lik��ge�the�follo��wing,��with�the�real�absolute�directory�substituted�for��$�pr��Gex���,���of��course:�������2
�Exec�+30/mailman/*� fd$prefix/cgi-bin/*�����+=���or:�������2
�ScriptAlias�ff/mailman/�%��$prefix/cgi-bin/�����<�͍����������H�#��#�����������΍��W��Y�ar�٠ning:���Y���gou���w��gant���to�be�v�ery�sure���that�the�user�id�under�which�your�CGI���scripts�run�is��not��in�the��mailman�����group��you�created�abo�٠v�e,��otherwise�pri��v�ate��archi�v�٠es�will�be�accessible�to�an�yone.��������H�#�����H�������Cop��gy�#bthe�#aMailman,�L:Python,�L9and�GNU�#8logos�to�a�location�accessible�to�your�web�serv�٠er��s8.��E.g.�with�Apache,�L:you'���v�٠e���usually��got�an�`�icons�'�directory�that�you�can�drop�the�images�into.��F�٠or�e�xample:�������2
�%�ffcp�$prefix/icons/*.{jpg,png}�/path/to/apache/icons�����.��Y���gou� .then� /w��gant�to�add�a�line�to�your�`�$�pr��Gex���/Mailman/mm�����ff����cfg.p��7y�'�le�which�sets�the�base�URL� for�the�logos.��#F�٠or���e�٠xample:�������'@��IMAGE_LOGOS�ff=�'/images/'�����-����The��def��gault�v��alue�for��IMA��gGE�����ff����LOGOS��x�is�`�/icons/�'.��Read�the�comment�in�`�Def���aults��v.p�y���.in�'��for�details.���Congure��your�web�serv�٠er�to�point�to�the�Pipermail�public�mailing�list�archi��v�es.��F�or�e�xample,�in�Apache:�������2
�Alias�32/pipermail/���$varprefix/archives/public/�����-�׍�where����$�varpr��Gex��)�is�usually����$�pr�ex��(�unless�you'���v�٠e���used�the��--with-v��gar��G-pr���ex��option�to��congur���e�.�?Also�be�sure�to���congure�fyour�e�web�serv�٠er�to�follo��w�symbolic�links�in�this�directory��Y�,��otherwise�public�Pipermail�archi��v�٠es�w��gon'���t�be���accessible.��F�٠or��Apache�users,�consult�the��F���7ollowSymLinks��option.���If��jyou'���re��kgoing�to�be�supporting�internationalized�public�archi��v�٠es,�"you�will�probably�w��gant�to�turn�o�an�٠y�def��gault�charset���directi��v�٠e�,%for�,$the�Pipermail�directory��Y�,�W-otherwise�your�multilingual�archi��v�٠e�pages�w��gon'���t�sho��w�up�correctly��Y�.�Here'��s8s�an���e�٠xample��for�Apache,�based�on�the�standard�installation�directories:���������ff��H������6�������_�^5�
Set�ǧup�y���our�w��geb�ser�L�v��er����������|e��n���>�썍����fd������n����썍���2
�<Directory�ff"/usr/local/mailman/archives/public/">����G�AddDefaultCharset�ffOff����2
</Directory>�����C����No��w��restart�your�web�serv�٠er��s8.��'pÍ��6��hSet��up�y��Jour�mail�ser�n�v���er��
_��This�+�section�describes�some�of�the�things�you�need�to�+�do�to�connect�Mailman'��s8s�email�interf��gace�to�your�mail�serv�٠er�.���The���instructions���here���are�dierent�for�each�mail�serv�٠er;�),if�your�mail�serv�٠er�is�not�described�in�the�follo��wing�subsections,���try���to�generalize�from�the�e�٠xisting�documentation,�and�consider�contrib���uting�documentation�updates�to�the�Mailman���de��v�٠elopers.��"PÍ��6.1���Using�U�the�P��ffostx�mail�ser�\#v��3er��pō�Mailman��
should��w��gork�pretty�much�out�of�the�box�with�a�standard�Postx�installation.�ӾIt�has�been�tested�with�v��arious���Postx��v�٠ersions�up�to�and�including�Postx�2.1.5.���ǍIn�M�order�M�to�support�Mailman'��s8s�optional�VERP�M�deli��v�٠ery��Y�,�W�you�will�w��gant�to�disable��luser_relay��(the�def��gault)�and�you���will�T�w��gant�T�to�set��recipient_delimiter��for�e�٠xtended�address�semantics.�/Y���gou�should�comment�out�an�٠y��luser_-���relay���v��alue�in�your�`�main.cf�'�and�just�go�with�the�def��gaults.��Also,�add�this�to�your�`�main.cf�'�le:�������2
�recipient_delimiter�ff=�+�����-����Using��(`�+�'�as��)the�delimiter�w��gorks�well�with�the�def��gault�v��alues�for��VERP�����ff����FORMA��GT���and��VERP�����ff��REGEXP���in�`�Def���aults��v.p�y�'.���When��wattempting�to��xdeli��v�٠er�a�message�to�a�non-e�٠xistent�local�address,��UPostx�may�return�a�450�error�code.�k�Since�this���is���a���transient�error�code,��Mailman�will�continue�to�attempt�to�deli��v�٠er�the�message�for��DELIVER���Y�����ff����RETR�Y�����ff��PERIOD��ɹ{���5�Bodays�Bnby�def��gault.�Y���gou�might�w��gant�to�set�Postx�up�so�that�it�returns�permanent�error�codes�for�non-e�٠xistent�local�users���by��adding�the�follo��wing�to�your�`�main.cf�'�le:�������2
�unknown_local_recipient_reject_code�ff=�550�����-����Finally��Y�,��if�you�are�using�Postx-style�virtual�domains,�read�the�section�on�virtual�domain�support�belo��w�.�� PÍ�Integ��gr�ating�ǧP���ostx�and�Mailman��pō�Y���gou���can���inte�٠grate�Postx�and�Mailman�such�that�when�ne��w�lists�are�created,�]or�lists�are�remo�٠v�ed,�]Postx'��s8s���alias���database��will�be�automatically�updated.��The�follo��wing�are�the�steps�you�need�to�tak��ge�to�mak�e�this�w�ork.���In��the�description�belo��w��Y�,��Xwe�assume�that�you'���v�٠e�installed�Mailman��in�the�def��gault�location,�i.e.�L�`�/usr/local/mailman�'.�If���that'��s8s�`<not�`=the�case,�f�adjust�the�instructions�according�to�your�use�of��congur���e�'��s8s��--pr�ex�`<�and��--with-v��gar��G-pr�ex�`<�options.����Note:�w}�If�you�are�using�virtual�domains�and�you�w��gant�Mailman�to�honor�your�virtual�domains,�5Xread�the�6.1�section���belo��w��rst!���Ǎ����������Add��this�to�the�bottom�of�the�`�$�pr��Gex���/Mailman/mm�����ff����cfg.p��7y�'�le:���������ff��H�������1��7��������������n���>�썍����fd������n����썍���`��MTA�ff=�'Postfix'������6�䍑�The��9MT���A���v��ariable�names��8a�module�in�the�`�Mailman/MT���A�'���directory�which�contains�the�mail�serv�٠er���-specic����functions��to�be�e�٠x�ecuted��when�a�list�is�created�or�remo�٠v�ed.�������������Look��sat��tthe�`�Def���aults��v.p�y�'�le��sfor�the�v��ariables��POSTFIX�����ff����ALIAS�����ff��CMD��)�and��s�POSTFIX�����ff��MAP�����ff��CMD��command.����Mak��ge�Vusure�Vvthese�point�to�your��postalias��and��postmap��programs�respecti��v�٠ely��Y�.���Remember�that�if�you�need�to����mak��ge��changes,�do�it�in�`�mm���<�ff�5��=qcfg.p���y�'.�������������Run��the��bin/genaliases��script�to�initialize�your�`�aliases�'�le.�������`��%�ffcd�/usr/local/mailman����`�%�ffbin/genaliases������A�䍑�Mak��ge���sure�that�the�o��wner�of�the���`�data/aliases�'�and�`�data/aliases��v.db�'�le�is��mailman�,���that�the�group�o�wner�for����those��les�is���mailman�,���or�whate��v�٠er�user�and�group�you�used�in�the�congure�command,���and�that�both�les�are����group��writable:������`��%�ffsu����`�%�ffchown�mailman:mailman�data/aliases*����`�%�ffchmod�g+w�data/aliases*������E�K�����������Hack��your�Postx'��s8s�`�main.cf�'�le�to�include�the�follo��wing�path�in�your��alias�����ff����maps��v�ariable:�������ks��/usr/local/mailman/data/aliases������6�K���Note��~that��}there�should�be�no�trailing��.db�.��Do�not�include�this�in�your��alias�����ff����database��v��ariable.��This�is�because����you���do�not���w��gant�Postx'��s8s��newaliases��command�to�modify�Mailman'��s8s�`�aliases��v.db�'�le,��mb���ut�you�do�w��gant�Postx����to��consult�`�aliases��v.db�'�when�looking�for�local�addresses.����Y���gou��probably�w��gant�to�use�a��hash:���style�database�for�this�entry��Y�.�Here'��s8s�an�e�٠xample:�������`��alias_maps�ff=�hash:/etc/postfix/aliases,����v@�hash:/usr/local/mailman/data/aliases������E�ԍ����������When�9�you�congure�Mailman,�huse�the��--with-mail-gid=mailman��switch;��kthis�will�be�the�9�def��gault�if�you�con-����gured�RMailman�after�Q�adding�the��mailman��o��wner��s8.���Because�the�o�wner�of�the�`�aliases��v.db�'�Q�le�is��mailman�,����Postx��will�e�٠x�ecute��Mailman'��s8s�wrapper�program�as�uid�and�gid��mailman�.���ǍThat'��s8s���it!�A�One�ca���v�٠eat:��"when�you�add���or�remo�v�e�a�list,��vthe���`�aliases��v.db�'�le�will�updated,�b���ut���it�will�not�automatically���run�f��postx�f�r���eload�.�!This�is�because�you�need�to�be�root�to�run�this�and�suid-root�scripts�are�not�secure.�!The�only�eect���of��this�is�that�it�will�tak��ge�about�a�minute�for�Postx�to�notice�the�change�to�the�`�aliases��v.db�'�le�and�update�its�tables.���������ff��H������8�������_�U6�
Set�ǧup�y���our�mail�ser�L�v��er����������	�Y��n���>�썍����fd������n������Vir�f`tual�ǧdomains��pō�Postx��2.0�supports�\virtual�alias�domains",��essentially�what�used�to��be�called�\Postx-style�virtual�domains"�in�earlier���Postx��3v�٠ersions.�p0T��37o�mak��ge�virtual�alias�domains�w�ork��2with�Mailman,��you�need�to�do�some�setup�in�both�Postx�and���Mailman.�j"Mailman�E�will�E�write�all�virtual�alias�mappings�to�a�le�called,�v�by�def��gault,�`�/usr/local/mailman/data/vir�\#tual-���mailman�'.��It��will�also�use��postmap��to�create�the��virtual-mailman.db��le�that�Postx�will�actually�use.���ǍFirst,��you���need�to���set�up�the�Postx�virtual�alias�domains�as�described�in�the�Postx�documentation�(see�Postx'��s8s����virtual(5)�mչmanpage).��Note�that�it'��s8s�your�responsibility�to�include�the��virtual-alias.domain�anything����line�2�as�described�manpage;�LvMailman�will�not�include�2�this�line�in�`�vir�\#tual-mailman�'.���Y���gou�are�highly�encouraged�to�mak��ge���sure��your�virtual�alias�domains�are�w��gorking�properly�before�inte�٠grating�with�Mailman.���Ne�٠xt,��add�a�path�to�Postx'��s8s��virtual�����ff����alias�����ff��maps���v��ariable,�pointing�to�the�virtual-mailman�le,�e.g.:�������2
�virtual_alias_maps�ff=�<your�normal�virtual�alias�files>,����G�hash:/usr/local/mailman/data/virtual-mailman�����8����assuming��kyou'���v�٠e�installed�Mailman�in�the�def��gault�location.��If�you'�re�using�an�older�v�٠ersion�of�Postx�which�doesn'���t���ha���v�٠e��the��virtual�����ff����alias�����ff��maps���v��ariable,�use�the��virtual�����ff����maps��v�ariable�instead.���Ne�٠xt,���in�a�your�a�`�mm���<�ff�5��=qcfg.p���y�'�le,�you�will�a�w��gant�to�set�the�v��ariable��POSTFIX�����ff����STYLE�����ff��VIRTU���AL�����ff��DOMAINS�u��to�a�the�list���of�i�virtual�i�domains�that�Mailman�should�update.�֬This�may�not�be�all�of�the�virtual�alias�domains�that�your�Postx���installation���supports!���The�v��alues���in�this�list�will�be�matched�ag��7ainst�the��host�����ff����name��attrib���ute�of�mailing�lists�objects,���and��must�be�an�e�٠xact�match.���Here'��s8s�?an�e�٠xample.�V�Say�that�?Postx�is�congured�to�handle�the�virtual�domains��dom1.ain�,����dom2.ain�,���and����dom3.ain�,��and�further�that�in�your�`�main.cf�'�le�you'���v�٠e�got�the�follo��wing�settings:������2
�myhostname�ff=�mail.dom1.ain����2
mydomain�ff=�dom1.ain����2
mydestination�ff=�$myhostname,�localhost.$mydomain����2
virtual_alias_maps�ff=����G�hash:/some/path/to/virtual-dom1,����G�hash:/some/path/to/virtual-dom2,����G�hash:/some/path/to/virtual-dom2�����d����If��in�your�`�vir�\#tual-dom1�'�le,�you'���v�٠e�got�the�follo��wing�lines:������2
�dom1.ain�
��IGNORE����2
@dom1.ain�ff@mail.dom1.ain�����-����this���tells�Postx�to���deli��v�٠er�an�ything�addressed�to��dom1.ain��to���the�same�mailbox�at��mail.dom1.com�,�its�def��gault���destination.���In��Mthis�case�you��Lw��gould�not�include��dom1.ain��in��POSTFIX�����ff����STYLE�����ff��VIRTU���AL�����ff��DOMAINS���because��Motherwise�Mailman���will��write�entries�for�mailing�lists�in�the�dom1.ain�domain�as�������2
�mylist@dom1.ain�0��mylist����2
mylist-request@dom1.ain�ffmylist-request����2
#�ffand�so�on...�����C����The��more�specic�entries�trump�your�more�general�entries,�thus�breaking�the�deli��v�٠ery�of�an�y��dom1.ain��mailing�list.���Ho��we�v�٠er���,��you�w��gould�include��dom2.ain��and��dom3.ain��in�`�mm���<�ff�5��=qcfg.p���y�':���������ff��H������6.1�
Using�ǧthe�P���ostx�mail�ser�L�v��er��������1�9����������
�5��n���>�썍����fd������n����썍���2
�POSTFIX_STYLE_VIRTUAL_DOMAINS�ff=�['dom2.ain',�'dom3.ain']�����-����No��w��Y�,��~an�٠y�6�list�that�Mailman�creates�in�either�of�those�tw��go�domains,�will�ha���v�٠e�the�correct�entries�written�to���`�/usr/local/mailman/data/vir�\#tual-mailman�'.���ǍAs�dabo�٠v�e�cwith�the�`�data/aliases*�'�les,�u�you�w��gant�to�mak��ge�sure�that�both�`�data/vir�\#tual-mailman�'�and�`�data/vir�\#tual-���mailman.db�'��are�user�and�group�o��wned�by��mailman�.�� PÍ�An�ǧalter�?�nativ��e�approach��pō�Fil���l@rez��vo���.net��has�an�alternati��v�٠e�approach�based�on�virtual�maps�and�re�gular�e�xpressions,�as�described�at:���Ǎ����������(French)����http://listes��v.rez�o���.net/comment.php��������������(English)����http://listes��v.rez�o���.net/ho�w��u�.php�����This���is�a�good�(and���simpler)�alternati��v�٠e�if�you�don'���t�mind�e�xposing�an�additional�hostname���in�the�domain�part�of���the�addresses�people�will�use�to�contact�your�list.���I.e.���if�people�should�use��mylist@lists.dom.ain��instead�of����mylist@dom.ain�.��"PÍ��6.2���Using�U�the�Exim�mail�ser�\#v��3er����Note:����This��section��is�deri��v�٠ed�from�Nigel�Metheringham'��s8s�\HO��gWT���O�r-�Using�Exim�and�Mailman�together",�@which���co�٠v�ers��_Mailman�2.0.x�and��`Exim�3.�%�It�has�been�updated�to�co�٠v�er��_Mailman�2.1�and�Exim�4.�%�The�original�document�is���here:����http://www��u�.e���xim.org/ho��vwto/mailman.html������.���ǍThere�t*is�t)no�Mailman�conguration�needed�other�than�the�standard�options�detailed�in�the�Mailman�install�documenta-���tion.��The��Exim��conguration�is�transparent�to�Mailman.��The�user�and�group�settings�for�Mailman�must�match�those���in��the�cong�fragments�gi��v�٠en�belo�w��Y�.�� PÍ�Exim�ǧcongur��gation����The��qExim��pconguration�is�b���uilt�so�that�a�list�created�within�Mailman�automatically�appears�to�Exim�without�the�need���for��dening�an�٠y�additional�aliases.���ǍThe�n�dra�٠wback�n�of�this�conguration�is�that�it�will�w��gork�poorly�on�systems�supporting�lists�in�se��v�٠eral�dierent�mail���domains.��While�=�Mailman�=�handles�virtual�domains,�K-it�does�not�yet�support�ha���ving�tw��go�distinct�lists�with�the�same�name���in��udierent��tvirtual�domains,��using�the�same�Mailman�installation.�4�This�will�e��v�٠entually�change.�4�(But�see�belo��w�for�a���v��ariation��on�this�scheme�that�should�accommodate�virtual�domains�better��s8.)���The���conguration���le�e�٠xcerpts�belo��w�are�for�use�in�an�already�functional�Exim�conguration,��2which�accepts�mail�for���the��domain��	in�which�the�list�resides.�K�If�this�domain�is�separate�from�the�others�handled�by�your�Exim�conguration,���then��you'��gll�need�to:���Ǎ����������add��the�list�domain,�\my��Y�.list.domain"�to��local�����ff����domains�������������add��a�\domains=my��Y�.list.domain"�option�to�the�director�(router)�for�the�list�������������(optional)��e�٠xclude�that�domain�from�your�other�directors�(routers)����Note:�	�The�90instructions�in�this�document�9/should�w��gork�with�either�Exim�3�or�Exim�4.�E'In�Exim�3,�g|you�must�ha���v�٠e�a����local�����ff����domains�d�conguration�setting;�@�in�Exim�4,� }you�most�lik��gely�ha���v�٠e�ea��local�����ff��domains��domainlist.���If�you�don'���t,� }you���������ff��H������10�������_�U6�
Set�ǧup�y���our�mail�ser�L�v��er�������������n���>�썍����fd������n����썹probably�j�kno��w�what�j�you'���re�doing�and�can�adjust�accordingly��Y�.�ڄSimilarly�,���in�j�Exim�4�the�concept�of�\directors"�has���disappeared�v{�there�are�uonly�routers�no��w��Y�.���So�if�you'���re�using�Exim�4,�BSwhene��v�٠er�this�document�says�\director",�BSread���\router".���ǍWhether��-you��,are�using�Exim�3�or�Exim�4,��8you�will�need�to�add�some�macros�to�the�main�section�of�your�Exim�cong���le.���Y���gou��will�also�need�to�dene�one�ne��w��transport.�W���ith�Exim�3,���you'��gll�need�to�add�a�ne��w��director;��with�Exim��4,�a���ne��w��router�plays�the�same�role.���Finally��Y�,��the��iconguration�supplied�here�should�allo��w�co-habiting�Mailman�2.0�and�2.1�installations,�with�the�pro�٠viso���that��you'��gll�probably�w�ant�to�use��mm21��in�place�of��mailman��{�e.g.,��MM21�����ff����HOME�:߹,��mm21�����ff��tr�٠ansport�.�,�etc.�� PÍ�Main�ǧcongur��gation�settings��pō�First,��Ryou�]�need�to�]�add�some�macros�to�the�top�of�your�Exim�cong�le.��+These�just�mak��ge�the�director�(router)�and���transport�1�belo��w�1�a�bit�cleaner��s8.���Ob�٠viously��Y�,�A�you'��gll�need�to�edit�these�based�on�ho��w�you�congured�and�installed�Mailman.�������2
�#�ffHome�dir�for�your�Mailman�installation�--�aka�Mailman's�prefix����2
#�ffdirectory.����2
MAILMAN_HOME=/usr/local/mailman����2
MAILMAN_WRAP=MAILMAN_HOME/mail/mailman�����2
#�ffUser�and�group�for�Mailman,�should�match�your�--with-mail-gid����2
#�ffswitch�to�Mailman's�configure�script.����2
MAILMAN_USER=mailman����2
MAILMAN_GROUP=mailman�������ҍ�T����r��ganspor�f`t�ǧf��7or�Exim�3��pō�Add��this�to�the�transports�section�of�your�Exim�cong�le,�i.e.��some��where�between�the�rst�and�second�\end"�line:�������'@��mailman_transport:����2
driver�ff=�pipe����2
command�ff=�MAILMAN_WRAP�\����h
{'${if�ffdef:local_part_suffix�\�����s�{${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}}�ff\�����s�{post}}'�ff\����h
{$local_part����2
current_directory�ff=�MAILMAN_HOME����2
home_directory�ff=�MAILMAN_HOME����2
user�ff=�MAILMAN_USER����2
group�ff=�MAILMAN_GROUP�������ҍ�Director�ǧf��7or�Exim�3����If��9you'���re��8using�Exim�3,���you'��gll�need�to�add�the�follo��wing�director�to�your�cong�le�(directors�go�between�the�second���and��Jthird�\end"��Klines).�vAlso,���don'���t�for�get��Kthat�order�matters�{�e.g.�vyou�can�mak��ge�Mailman�lists�tak��ge�precedence�o�٠v�er���system��aliases�by�putting�this�director�in�front�of�your�aliasle�director���,�or�vice-v�٠ersa.���������ff��H������6.2�
Using�ǧthe�Exim�mail�ser�L�v��er�������ʢ�11��������������n���>�썍����fd������n����썍���'@��#�ffHandle�all�addresses�related�to�a�list�'foo':�the�posting�address.����'@�#�ffAutomatically�detects�list�existence�by�looking����'@�#�fffor�lists/$local_part/config.pck�under�MAILMAN_HOME.����'@�mailman_director:����2
driver�ff=�smartuser����2
require_files�ff=�MAILMAN_HOME/lists/$local_part/config.pck����2
suffix_optional����2
suffix�ff=�-bounces�:�-bounces+*�:�\����b�-confirm+*�ff:�-join�:�-leave�:�\����b�-owner�ff:�-request�:�-admin����2
transport�ff=�mailman_transport�������ҍ�Router�ǧf��7or�Exim�4��pō�In���Exim���4,��\there'��s8s�no�such�thing�as�directors�{�you�need�to�add�a�ne��w�router�instead.���Also,��]the�canonical�order�of�the���conguration��le��w��gas�changed�so�routers�come�before�transports,�Gso�the�router�for�Exim�4�comes�rst�here.�`�Put�this���router��some��where�after�the�\be�٠gin�routers"�line�of�your�cong�le,�and�remember�that�order�matters.���Ǎ����'@��mailman_router:����2
driver�ff=�accept����2
require_files�ff=�MAILMAN_HOME/lists/$local_part/config.pck����2
local_part_suffix_optional����2
local_part_suffix�ff=�-bounces�:�-bounces+*�:�\�����
w-confirm+*�ff:�-join�:�-leave�:�\�����
w-owner�ff:�-request�:�-admin����2
transport�ff=�mailman_transport�������ҍ�T����r��ganspor�f`ts�ǧf��7or�Exim�4����The��stransport��rfor�Exim�4�is�the�same�as�for�Exim�3�(see�6.2;��,just�cop��gy�the�transport�gi��v�٠en�abo�v�e�to��rsome��where�under���the��\be�٠gin�transports"�line�of�your�Exim�cong�le.�� PÍ�Additional�ǧnotes����Exim�?�should�?�be�congured�to�allo��w�reasonable�v���olume�{�e.g.�Xvdon'���t�set��max�����ff����r��Gecipients��do��wn�to�a�silly�v��alue�{�and���with���normal�de�٠grees�of�security�{�specically��Y�,��be�sure�to�allo��w�relaying�from�127.0.0.1,�b���ut�pretty�much�nothing�else.���P�٠arallel�g�deli��v�eries�g�and�other�tweaks�can�also�be�used�if�you�lik��ge;�o�e�٠xperiment�with�your�setup�to�see�what�w��gorks.��Delay���w��garning�3{messages�should�be�switched�o�or�congured�3|to�only�happen�for�non-list�mail,�B�unless�you�lik�e�recei��ving�tons���of��mail�when�some�random�host�is�do��wn.�� PÍ�Prob���lems���������������Mailman�X�will�send�as�man�٠y��MAIL�FROM�/�RCPT�TO�X��as�X�it�needs.��tIt�may�result�in�more�than�10�or�100�mes-����sages�h�sent�in�one�connection,��;which�will�e�٠xceed�the�def��gault�v��alue�of�Exim'��s8s��smtp�����ff����accept�����ff��queue�����ff��per�����ff��connec-����tion�G��v��alue.�p�This�is�bad�because�it�will�cause�Exim�to�switch�into�queue�mode�and�se�v�٠erely�delay�deli�v�٠ery�of����your�C�list�messages.�e]The�w��gay�C�to�x�this�is�to�set�Mailman'��s8s��SMTP�����ff����MAX�����ff��SESSIONS�����ff��PER�����ff��CONNECTION��R�(in����`�$�pr��Gex���/Mailman/mm�����ff����cfg.p��7y�')��to�a�smaller�v��alue�than�Exim'��s8s��smtp�����ff��accept�����ff��queue�����ff��per�����ff��connection�.���������ff��H������12�������_�U6�
Set�ǧup�y���our�mail�ser�L�v��er����������
ʵ��n���>�썍����fd������n����썍���������Mailman��&should��%ignore�Exim�delay�w��garning�messages,�Qe��v�٠en�though�Exim�should�ne��v�٠er�send�this�to�list�messages.����Mailman�RG2.1'��s8s�RHgeneral�bounce�detection�and�VERP�Rsupport�should�greatly�impro�٠v�e�RGthe�bounce�detector'��s8s�hit����rates.�������������List�y)e�٠xistence�is�determined�by�the�e�xistence�y(of�a�`�cong.pc���k�'�le�for�a�list.�PIf�you�delete�lists�by�foul�means,�z�be����a�٠w��gare��of�this.�������������If�L�you�L�are�getting�Exim�or�Mailman�complaining�about�user�ids�when�you�send�mail�to�a�list,��check�that�the�����MAILMAN�����ff����USER�\��and�\��MAILMAN�����ff��GR���OUP��match�\�those�\�of�Mailman�itself�(i.e.�
�what�were�used�in�the��congur���e�����script).��Also��mak��ge�sure�you�do�not�ha���v�٠e�aliases�in�the�main�alias�le�for�the�list.�� PÍ�Receiv��er�ǧV��37er�&_ication��pō�Exim'��s8s�qrecei��v�٠er�v�erication�feature�qis�v�ery�useful�{�it�lets�Exim�reject�qunrouteable�addresses�at�SMTP�qtime.��Ho��we�v�er���,���this�qis�qmost�useful�for�e�٠xternally-originating�mail�that�is�addressed�to�mail�in�one�of�your�local�domains.��F�٠or�Mailman���list�>Xtrac,�Kzmail�originates�on�>Yyour�serv�٠er���,�and�is�addressed�to�random�>Ye�٠xternal�domains�that�are�not�under�your�control.���Furthermore,�Y�each�.8message�.9is�addressed�to�man�٠y�recipients�{�up�to�500�if�you�use�Mailman'��s8s�def��gault�conguration���and��don'���t�tweak��SMTP�����ff����MAX�����ff��RCPTS�x�.���ǍDoing�_#recei��v�٠er�_"v�erication�on�Mailman�list�_"trac�is�a�recipe�for�trouble.��In�particular���,���Exim�will�attempt�to�route���e��v�٠ery�B�recipient�B�addresses�in�outgoing�Mailman�list�posts.�a�Ev�٠en�though�this�requires�nothing�more�than�a�fe��w�DNS���lookups���for���each�address,���it�can�still�introduce�signicant�delays.��Therefore,���you�should�disable�recipient�v�٠erication���for��Mailman�trac.���Under��Exim�3,�put�this�in�your�main�conguration�section:�������2
�receiver_verify_hosts�ff=�!127.0.0.1�����-����Under��Exim��4,��this�is�probably�already�tak��gen�care�of�for�you�by�the�def��gault�recipient�v�٠erication�A���CL���statement�(in���the���RCPT�TO��A���CL):�������'@��accept�
��domains�%��=�ff+local_domains����Rs�endpass����Rs�message�%��=�ffunknown�user����Rs�verify�+30=�ffrecipient�����N����which��only�does�recipient�v�٠erication�on�addresses�in�your�domain.��(That'��s8s�not�e�xactly�the�same�as�doing�recipient���v�٠erication��only�on�messages�coming�from�non-127.0.0.1�hosts,�b���ut�it�should�do�the�trick�for�Mailman.)�� PÍ�SMTP�ǧCallbac���k��pō�Exim'��s8s�<�SMTP�<�callback�<�feature�is�an�e��v�٠en�more�po��werful�w��gay�to�detect�bogus�sender�addresses�than�normal�sender���v�٠erication.�(�Unfortunately��Y�,�[�lots�/�of�serv�ers�send�bounce�messages�with�a�bogus�address�in�the�header���,�[�and�there�are���plenty�Mthat�Nsend�bounces�with�bogus�en���v�٠elope�senders�(e��v�en�Nthough�the�y'���re�supposed�Nto�just�use�an�empty�en���v�٠elope���sender��for�bounces).���In�#�order�#�to�ensure�that�Mailman�can�disable/remo�٠v�e�#�bouncing�addresses,�L�you�generally�w��gant�to�recei��v�٠e�bounces�for���Mailman��blists,���e��v�٠en��aif�those�bounces�are�themselv�٠es�not�bounceable.�)�Thus,���you�might�w��gant�to�disable�SMTP��`callback���on��bounce�messages.���W���ith��Exim�4,�you�can�accomplish�this�using�something�lik��ge�the�follo��wing�in�your��RCPT�TO��A�CL:���������ff��H������6.2�
Using�ǧthe�Exim�mail�ser�L�v��er�������ʢ�13�����������S��n���>�썍����fd������n����썍���'@��#�ffAccept�bounces�to�lists�even�if�callbacks�or�other�checks�would�fail����'@�warn���message� fd=�ffX-WhitelistedRCPT-nohdrfromcallback:�Yes����W�Icondition���=�ff\����W�I${if�ffand�{{match{$local_part}{(.*)-bounces\+.*}}�\������E{exists�ff{MAILMAN_HOME/lists/$1/config.pck}}}�\����r�G{yes}{no}}����r�G{yes}{no}}�����'@�accept�32condition���=�ff\����W�I${if�ffand�{{match{$local_part}{(.*)-bounces\+.*}}�\������E{exists�ff{MAILMAN_HOME/lists/$1/config.pck}}}�\����r�G{yes}{no}}����r�G{yes}{no}}�����'@�#�ffNow,�check�sender�address�with�SMTP�callback.����'@�deny�32!verify�ff=�sender/callout=90s�����҂���If��you�also�do�SMTP�callbacks�on�header�addresses,�you'��gll�w�ant�something�lik�e�this�in�your��DATA��A���CL:���Ǎ����'@��deny�32!condition�ff=�$header_X-WhitelistedRCPT-nohdrfromcallback:����M
}!verify�ff=�header_sender/callout=90s�����G�V��Doing�ǧVERP�with�Exim�and�Mailman��pō�VERP��|will���send�one�email,�Ӳwith�a�separate�en���v�٠elope���sender�(return�path),�for�each�of�your�subscribers�{�read�the���information��"in�`�$�pr��Gex���/Mailman/Def��7aults�٠.p�y�'��#for��"the�options�that�start�with�VERP����.�In�a�nutshell,���all�you�need�to�do���to��enable�VERP�with�Exim�is�to�add�these�lines�to�`�$�pr��Gex���/Mailman/mm�����ff����cfg.p��7y�':�������2
�VERP_PASSWORD_REMINDERS�ff=�Yes����2
VERP_PERSONALIZED_DELIVERIES�ff=�Yes����2
VERP_DELIVERY_INTERVAL�ff=�Yes����2
VERP_CONFIRMATIONS�ff=�Yes�����N����(The��director�(router)�abo�٠v�e��is�smart�enough�to�deal�with�VERP�bounces.)�� PÍ�Vir�f`tual�ǧDomains��pō�One�Ecapproach�to�Ebhandling�virtual�domains�is�to�use�a�separate�Mailman�installation�for�each�virtual�domain.�Currently��Y�,���this��is�the�only�w��gay�to�ha���v�٠e�lists�with�the�same�name�in�dierent�virtual�domains�handled�by�the�same�machine.���In��&this�case,��pthe��MAILMAN�����ff����HOME����and��MAILMAN�����ff��WRAP���macros�are��'useless�{�you�can�remo�٠v�e��&them.��Change�your���director��(router)�to�something�lik��ge�this:�������'@��require_files�ff=�/virtual/${domain}/mailman/lists/${lc:$local_part}/config.pck�����-����and��change�your�transport�lik��ge�this:���������ff��H������14�������_�U6�
Set�ǧup�y���our�mail�ser�L�v��er�����������'��n���>�썍����fd������n����썍���'@��command�ff=�/virtual/${domain}/mailman/mail/mailman�\����]@�${if�ffdef:local_part_suffix�\����x@�{${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}}����x@�{post}}�ff\����h
{$local_part����'@�current_directory�ff=�/virtual/${domain}/mailman����'@�home_directory�ff=�/virtual/${domain}/mailman�����~���List�ǧV��37er�&_ication��pō�This��Gis�ho��w�a�set�of�address��Ftests�for�the�Exim�lists�look�on�a�w��gorking�system.��lThe�list�in�question�is��quixote-���users@mems-e���xchange��v.org�,���and��these��commands�were�run�on�the��mems-exchange.org��mail�serv�٠er�("%�"�indi-���cates��the�Unix�shell�prompt):���Ǎ����'@��%�ffexim�-bt�quixote-users����'@�quixote-users@mems-exchange.org����2
router�ff=�mailman_main_router,�transport�=�mailman_transport�����'@�%�ffexim�-bt�quixote-users-request����'@�quixote-users-request@mems-exchange.org����2
router�ff=�mailman_router,�transport�=�mailman_transport�����'@�%�ffexim�-bt�quixote-users-bounces����'@�quixote-users-bounces@mems-exchange.org����2
router�ff=�mailman_router,�transport�=�mailman_transport�����'@�%�ffexim�-bt�quixote-users-bounces+luser=example.com����'@�quixote-users-bounces+luser=example.com@mems-exchange.org����2
router�ff=�mailman_router,�transport�=�mailman_transport�����ǔ���If���your����exim�-bt��output�looks�something�lik��ge�this,��athat'��s8s�a�start:�@�at�least�it�means�Exim�will�pass�the�right�messages�to���the�2�right�Mailman�commands.���It�2�by�no�means�guarantees�that�your�Exim/Mailman�installation�is�functioning�perfectly��Y�,���though!�����Document�ǧHistor�L�y����Originally�M�written�by�Nigel�M�Metheringham��postmaster@e���xim.org�.�� Updated�by�Marc�Merlin��marc���<�ff�5��=qsoft@mer�"�lins��v.org����for��Mailman�2.1,�Exim�4.��Ov�٠erhauled/reformatted/claried/simplied�by�Gre�g�W��37ard��gw��vard@p���ython.net�.��!�썍�6.3���Using�U�the�Sendmail�mail�ser�\#v��3er��GcO�����ʸ����H�e�
��e�
��ϸ�����؜͍��W��Y�ar�٠ning:�
U�Y���gou�:�may�be�tempted�to�set�the��DELIVER���Y�����ff����MODULE�u6�conguration�:�v��ariable�in�`�mm���<�ff�5��=qcfg.p���y�'�to�����'Sendmail'��ݹwhen�using���the�Sendmail�mail�serv�٠er��s8.�<0�Don't�.�</The�`�Sendmail.p���y�'�module�is�misnamed�{�it'��s8s����really��{a�command��|line�based�message�hando�scheme�as�opposed�to�the�SMTP��sscheme�used�in�`�SMTPDirect.p���y�'����(the�^def��gault).���`�Sendmail.p���y�'�has�kno��wn�security�^holes�and�is�pro�٠vided�as�a�proof-of-concept�only����^��/Kj�
ptmri7t�a����.���If�you�are����ha���ving���problems�using���`�SMTPDirect.p���y�'�x�those�instead�of�using�`�Sendmail.p���y�',��or�you�may�open�your�system����up��to�security�e�٠xploits.������ff���	@�����
�h��-:�0Kj�
ptmri7t�a����fh�In�f��act,�in�later�v��Mersions�of�Mailman,�this�module�is�e�xplicitly�sabotaged.�z�Y���ou�ha��
v�e�to�kno���w�what�you'���re�doing�in�order�to�re-enable�it.��������H�e�
�����H�����3G��������ff��H������6.3�
Using�ǧthe�Sendmail�mail�ser�L�v��er�������ʢ�15�����������n���>�썍����fd������n������Sendmail�ǧ\smrsh"�compatibility��pō�Man�٠y�(Zne��wer�v�ersions�of�(YSendmail�come�with�a�restricted�e�x�ecution�(Yutility�called�\smrsh",�9�which�limits�the�e�x�ecutables���that���Sendmail���will�allo��w�to�be�used�as�mail�programs.�(9Y���gou�need�to�e�٠xplicitly�allo��w�Mailman'��s8s�wrapper�program�to�be���used���with�smrsh�or�Mailman�will�not�w��gork.�!EIf�mail�is�not�getting�deli��v�٠ered�to�Mailman'��s8s�wrapper�program�and�you'���re���getting��an�\operating�system�error"�in�your�mail�syslog,�this�could�be�your�problem.���ǍOne��good�w��gay�of�enabling�this�is:���Ǎ����������Find��out�where�your�Sendmail�e�٠x�ecutes��its�smrsh�wrapper�������v@��%�ffgrep�smrsh�/etc/mail/sendmail.cf������:�䍍���������Figure��out��where�smrsh�e�٠xpects�symlinks�for�allo��w��gable�mail�programs.���At�the�v�٠ery�be�ginning��of�the�follo��wing����output��you�will�see�a�full�path�to�some�directory��Y�,�e.g.��`�/v��far/adm/sm.bin�'�or�similar:�������v@��%�ffstrings�$path_to_smrsh�|�less������:�䍍���������cd��1into�`�/v��far/adm/sm.bin�',��}or�where�e��v�٠er��2it�happens�to�reside�on�your�system�{�alternati�v�٠es�include�`�/etc/smrsh�',����`�/v��far/smrsh�'��and�`�/usr/local/smrsh�'.�������v@��%�ffcd�/var/adm/sm.bin������:�䍍���������Create��a�symbolic�link�to�Mailman'��s8s�wrapper�program:�������v@��%�ffln�-s�/usr/local/mailman/mail/mailman�mailman������G�{��Integ��gr�ating�ǧSendmail�and�Mailman��pō�Da���vid�\�Champion�\�has�contrib�uted�\�a�recipe�for�more�closely�inte�٠grating�Sendmail�and�Mailman,���such�that�Sendmail���will�g�automatically�recognize�g�and�deli��v�٠er�to�ne�w�mailing�g�lists�as�the�٠y�are�created,�l�without�ha���ving�to�manually�edit�alias���tables.���ǍIn��the�`�contr�"�ib�'�directory�of�Mailman'��s8s�source�distrib���ution,�you�will�nd�four�les:���Ǎ����������`�mm-handler���.readme�'��-�an�e�٠xplanation�of�ho��w�to�set�e�v�٠erything�up�������������`�mm-handler�'��-�the�mail�deli��v�٠ery�agent�(MD���A)�������������`�mailman.mc�'��-�a�to��gy�conguration�le�sample�������������`�vir�\#tuser�tab���le�'��-�a�sample�for�RFC�2142�address�e�٠xceptions���������ff��H������16�������_�U6�
Set�ǧup�y���our�mail�ser�L�v��er�����������2��n���>�썍����fd������n������P���erf��7or�?�mance�ǧnotes��pō�One��of��the�surest�performance�killers�for�Sendmail�users�is�when�Sendmail�is�congured�to�synchronously�v�٠erify�the���recipient'��s8s�whost�via�DNS.�If�it�does�vthis�for�messages�posted�to�it�from�Mailman,�#you�will�get�horrible�performance.���Since��Mailman�usually�connects��via��localhost��(i.e.���127.0.0.1)�to�the�SMTP��port�of�Sendmail,���you�should�be�sure���to��congure�Sendmail�to��not��do�DNS�v�٠erication�synchronously�for�localhost�connections.��!�[���6.4���Using�U�the�Qmail�mail�ser�\#v��3er����There�c`are�casome�issues�that�users�of�the�qmail�mail�transport�agent�ha���v�٠e�encountered.�
None�of�the�core�maintainers�use���qmail,��so�תall�׫of�this�information�has�been�contrib���uted�by�the�Mailman�user�community��Y�,��especially�Martin�Preishuber���and��Christian�T��gismer���,�with�notes�by�Balazs�Nagy�(BN)�and�Norbert�Bollo��w�(NB).��	(�����������Y���gou�Cmight�Cneed�to�set�the�mail-gid�user�to�either��qmail�,�O@�mailman�,�or��nofiles�C�by�using�the��--with-mail-gid����congur���e���option.��D����BN:��ɹit�highly�depends�on�your�mail�storing�polic�٠y��Y�.�u�F�or���e�xample�if�you�use�the�simple�`�~alias/.qmail-*�'�les,��{you����can��use��`id�-g�alias`�.��But�if�you�use�`�/v��far/qmail/users�',�the�specied�mail�gid�can�be�used.����If�f�you�are�going�to�f�be�directing�virtual�domains�directly�to�the��mailman��user�(using�\virtualdomains"�on�a����list-only���domain,��rfor���e�٠xample),�you�will�ha���v�٠e���to�use��--with-mail-gid�=�gid�of�mailman�user'���s�gr���oup�.�i�This�is����incompatible��with�ha���ving�list�aliases�in�`�~alias�',�unless�that�alias�simply�forw��gards�to��mailman-listname*�.���������������If�=:there�=;is�a�user��mailman��on�your�system,�l�the�alias��mailman-owner��will�w��gork�only�in�`�~mailman�'.�QGY���gou����ha���v�٠e��to�do�a��touch�.qmail-o��gwner��in�`�~mailman�'�directory�to�create�this�alias.�����NB:�*��An�*�alternati��v�٠e,�U�IMHO�*�better�solution�is�to��cho��gwn�r���oot�~mailman�,�U�that�will�stop�qmail�from�considering�����mailman���to�be�a�user�to�whom�mail�can�be�deli��v�٠ered.��(See�\man�8�qmail-getpw".)���������������In�L�a�L�related�issue,�V�if�you�ha���v�٠e�an�y�L�users�with�the�same�name�as�one�of�your�mailing�lists,�V�you�will�ha���v�٠e�problems����if���list�names�contain�`�-�'�in�them.��EPutting�`�.qmail�'�redirections�into�the�user'��s8s�home�directory�doesn'���t�w��gork����because��the�Mailman�wrappers�will�not�get�spa�٠wned�with�the�proper�GID.�The�solution�is�to�put�the�follo��wing����lines��in�the�`�/v��far/qmail/users/assign�'�le:�������@@��+zope-:alias:112:11:/var/qmail/alias:-:zope-:����@@�.�����6ō��where��in�this�case�the�listname�is�e.g.���zope-users�.�����NB:��Alternati��v�٠ely��Y�,�7�you�could�host�the�lists�on�a�virtual�domain,�7�and�use�the�`�/v��far/qmail/control/vir�\#tualdomains�'����le��to�put�the��mailman��user�in�char���ge�of�this�virtual�domain.���������������BN:�If��inbound��messages�are�deli��v�٠ered�by�another�user�than��mailman�,�^�it'��s8s�necessary�to�allo��w�it�to�access����`�~mailman�'.���Be��sure��that�`�~mailman�'�has�group�writing�access�and�setgid�bit�is�set.���Then�put�the�deli��v�٠ering�user����to�]��mailman�]�group,�d�and�you�can�den�٠y�access�to�`�~mailman�'�to�others.�<Be�sure�that�you�can�do�the�same�with�the����WWW��service.��DፑBy��the�w��gay��the�best�thing�is�to�mak�e��a�virtual�mail�serv�٠er�to�handle�all�of�the�mail.�
�@�NB:��E.g.����mak��ge��lan��kadditional�"A"�DNS���record�for�the�virtual�mailserv�٠er�pointing�to�your�IP���address,���add�the����line����lists.kva.hu:mailman��to���`�/v��far/qmail/control/vir�\#tualdomains�'�and�a��lists.kva.hu��line�to����`�/v��far/qmail/control/rcpthosts�'��~le.��Don'���t�for�get�to�HUP��mthe�qmail-send�after�modifying�\virtualdomains".��Then����e��v�٠ery��mail�to�lists.kv�a.hu�will�arri�v�٠e�to�mail.kv�a.hu'��s8s�mailman�user�.����Then��mak��ge�your�aliases:�������ks��.qmail�K��=>�ffmailman@...'s�letters����ks�.qmail-owner�+30=>�ffmailman-owner's�letters������������ff��H������6.4�
Using�ǧthe�Qmail�mail�ser�L�v��er�������ʢ�17����������Š�n���>�썍����fd������n����썑�F�٠or��list�aliases,�you�can�either�create�them�manually:�������ks��.qmail-list�0��=>�ffposts�to�the�'list'�list����ks�.qmail-list-admin�32=>�ffposts�to�the�'list's�owner����ks�.qmail-list-request�ff=>�requests�to�'list'����ks�etc�����L�䍑�or�nfor�mautomatic�list�alias�handling�(when�using�the�lists.kv��a.hu�virtual�as�abo�٠v�e),��see�n`�contr�"�ib/qmail-to-����mailman.p���y�'��in�the�Mailman�source�distrib���ution.��Modify�the�`�~mailman/.qmail-def�ault�'�to�include:�������ks��|preline�ff/path/to/python�/path/to/qmail-to-mailman.py�����+�䍑�and��ne��w�lists�will�automatically�be�pick��ged�up.�������������Y���gou���ha���v�٠e�to���mak��ge�sure�that�the�localhost�can�relay��Y�.�ЏIf�you�start�qmail�via�inetd�and�tcpen���v��Y�,��<you�need�some�line����the��follo��wing�in�your�`�/etc/hosts��v.allo�w�'��le:�������U�M�tcp-env:�ff127.�10.205.200.�:�setenv�RELAYCLIENT�����+�䍑�where�b�10.205.200.��is�b�your�IP�b�address�block.�If�you�b�use�tcpserv�٠er���,�h�then�you�need�something�lik��ge�the�follo��wing�in����your��`�/etc/tcp��].smtp�'�le:�������U�M�10.205.200.:allow,RELAYCLIENT=""����U�M127.:allow,RELAYCLIENT=""�����:�䍍���������BN:��C�Bigger�`�/v��far/qmail/control/concurrencyremote�'��Dv��alues�w��gork�better�sending�outbound�messages,��within�rea-����son.�S7Unless�=�you�=�kno��w�your�system�can�handle�it�(man�٠y�if�not�most�cannot)�this�should�not�be�set�to�a�v��alue����greater��than�120.�������������More��information�about�setting�up�qmail�and�relaying�can�be�found�in�the�qmail�documentation.���Ǎ�BN:��T�Last�b���ut�not�least,�(here'��s8s�a�little�script�to�generate�aliases�to�your�lists�(if��Sfor�some�reason�you�can/will�not�ha�v�٠e���them��automatically�pick��ged�up�using�`�contr�"�ib/qmail-to-mailman.p���y�'):���ǍThis��script�is�for�the�Mailman�2.0�series:�������s��#!/bin/sh����s�if�ff[�$#�=�1�];�then����2
i=$1����2
echo�ffMaking�links�to�$i�in�the�current�directory...����2
echo�ff"|preline�/home/mailman/mail/mailman�post�$i"�>�.qmail-$i����2
echo�ff"|preline�/home/mailman/mail/mailman�mailowner�$i"�>�.qmail-$i-admin����2
echo�ff"|preline�/home/mailman/mail/mailman�mailowner�$i"�>�.qmail-$i-owner����2
echo�ff"|preline�/home/mailman/mail/mailman�mailowner�$i"�>�.qmail-owner-$i����2
echo�ff"|preline�/home/mailman/mail/mailman�mailcmd�$i"�>�.qmail-$i-request����s�fi����������Note:�	賹This�mais�m`for�a�ne��w�Mailman�2.1�installation.��Users�upgrading�from�Mailman�2.0�w��gould�most�lik��gely�change���`�/usr/local/mailman�'��?to��@`�/home/mailman�'.�UIf�in�doubt,���refer�to�the��--pr���ex��option�passed�to��congur���e��during�compile���time.���������ff��H������18�������_�U6�
Set�ǧup�y���our�mail�ser�L�v��er����������F��n���>�썍����fd������n����썍���s��#!/bin/sh����s�if�ff[�$#�=�1�];�then����2
i=$1����2
echo�ffMaking�links�to�$i�in�the�current�directory...����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�post�$i"�>�.qmail-$i����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�admin�$i"�>�.qmail-$i-admin����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�bounces�$i"�>�.qmail-$i-bounces����2
#�ffThe�following�line�is�for�VERP����2
#�ffecho�"|preline�/usr/local/mailman/mail/mailman�bounces�$i"�>�.qmail-$i-bounces-default����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�confirm�$i"�>�.qmail-$i-confirm����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�join�$i"�>�.qmail-$i-join����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�leave�$i"�>�.qmail-$i-leave����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�owner�$i"�>�.qmail-$i-owner����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�request�$i"�>�.qmail-$i-request����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�subscribe�$i"�>�.qmail-$i-subscribe����2
echo�ff"|preline�/usr/local/mailman/mail/mailman�unsubscribe�$i"�>�.qmail-$i-unsubscribe����s�fi������ҍ�Inf��7or�?�mation�ǧon�VERP��pō�Y���gou�
�will�note�in�
�the�alias�generating�script�for�2.1�abo�٠v�e,�-Cthere�
�is�a�line�for�VERP�
ythat�has�been�commented�out.��lIf���you�c<are�c;interested�in�VERP�c4there�are�tw��go�options.�The�rst�option�is�to�allo��w�Mailman�to�do�the�VERP�c5formatting.�T��37o���acti��v�ate��this,�uncomment�that�line�and�add�the�follo��wing�lines�to�your�`�mm���<�ff�5��=qcfg.p���y�'�le:���Ǎ����2
�VERP_FORMAT�ff=�'%(bounces)s-+%(mailbox)s=%(host)s'����2
VERP_REGEXP�ff=�r'^(?P<bounces>.*?)-\+(?P<mailbox>[^=]+)=(?P<host>[^@]+)@.*$'�����8����The��second�option�is�a�patch�on�SourceF�٠or���ge�located�at:�����http://sourcef���orge��v.net/tr���ac���k�er/?func=detail&atid=300103&aid=645513&g�roup���<�ff�5��=qid=103�����This��patch��currently�needs�more�testing�and�might�best�be�suitable�for�de��v�٠elopers�or�people�well�f��gamiliar�with�qmail.���Ha���ving��said�that,�this�patch�is�the�more�qmail-friendly�approach�resulting�in�lar���ge�performance�g��7ains.�� PÍ�Vir�f`tual�ǧmail�ser�L�v��er����As��mentioned�in�the�6.4�section�for�a�virtual�mail�serv�٠er���,�a�patch�under�testing�is�located�at:�����http://sf���.net/tr���ac���k�er/inde�x.php?func=detail&aid=621257&g���roup���<�ff�5��=qid=103&atid=300103�����Ag��7ain,��this�patch�is�for�people�f��gamiliar�with�their�qmail�installation.�� PÍ�More�ǧinf��7or�?�mation����Y���gou�2=might�2>be�interested�in�some�information�on�modifying�footers�that�Norbert�Bollo��w�has�written�about�Mailman���and��qmail,�a���v��ailable�here:�����http://mailman.cis��v.to/qmail-v��ferh/����������ff��H������6.4�
Using�ǧthe�Qmail�mail�ser�L�v��er�������ʢ�19����������"Ԡ�n���>�썍����fd������n����ύ��7��hRe��ovie��Jw��y�our�site�def��oaults��
_��Mailman��Nhas��Ma�lar���ge�number�of�site-wide�conguration�options�which�you�should�no��w�re�vie�w��Mand�change�according���to�yyour�xneeds.��Some�of�the�options�control�ho��w�Mailman�interacts�with�your�en���vironment,�:�and�other�options�select���def��gaults��for�ne��wly�created�lists����^��4����.��There�are�system�tuning�parameters�and�inte�٠gration�options.���ǍThe���full���set�of�site-wide�def��gaults�li��v�٠es�in�the�`�$�pr��Gex���/Mailman/Def��7aults�٠.p�y�'���le,�
ho��we�v�er���you�should����ne�v��ger��modify���this�yLle!�{Instead,���change�the�`�mm���<�ff�5��=qcfg.p���y�'�yKle�in�that�same�directory��Y�.�|Y���gou�only�need�to�add�v��alues�to�`�mm���<�ff�5��=qcfg.p���y�'���that��uare��tdierent�than�the�def��gaults�in�`�Def���aults��v.p�y�',���and��ufuture�Mailman�upgrades�are�guaranteed�ne��v�٠er�to�touch�your���`�mm���<�ff�5��=qcfg.p���y�'��le.���The��Q`�Def���aults��v.p�y�'��Ple�is�documented�e�٠xtensi��v�ely��Y�,�dso�the��Poptions�are�not�described�here.�v�The�`�Def���aults��v.p�y�'��Pand�`�mm���<�ff�5��=q-���cfg.p���y�'��are�both�Python�les�so�v��alid�Python�syntax�must�be�maintained�or�your�Mailman�installation�will�break.����Note:��@�Do�0��not�0��change�the��HOME�����ff����DIR�0V�or��MAILMAN�����ff��DIR�0V�v��ariables.�+$These�0�are�set�automatically�by�the��congur���e����script,��and�you�will�break�your�Mailman�installation�by�if�you�change�these.���Y���gou��should�mak��ge�an�٠y�changes�to�`�mm���<�ff�5��=qcfg.p���y�'�using�the�account�you�installed�Mailman�under�in�the�14�section.��'pÍ��8��hCreate��a�site-wide�mailing�list��
_��After���you���ha���v�٠e�completed�the�inte�gration���of�Mailman�and�your�mail�serv�٠er���,��you�need�to�create�a�\site-wide"�mailing���list.��This�!�is�the�one�that�passw��gord�reminders�will�appear�to�come�!�from,�4oand�it�is�required�for�proper�Mailman�operation.���Usually�fBthis�fAshould�be�a�list�called��mailman�,�khb���ut�if�you�need�to�change�this,�khbe�sure�to�change�the��MAILMAN�����ff����SITE�����ff��-���LIST�E�v��ariable��in�`�mm���<�ff�5��=qcfg.p���y�'.��Y���gou�can�create�the�site�list�with�this�command,�follo�wing�the�prompts:�������2
�%�ffbin/newlist�mailman�����-����No��w��-congure��,your�site�list.�UThere�is�a�con���v�٠enient�template�for�a�generic�site�list�in�the�installation�directory��Y�,�xunder���`�data/sitelist.cfg�'���which���can�help�you�with�this.���Y���gou�should�re��vie�w���the�conguration�options�in�the�template,���b���ut�note���that��an�٠y�options�not�named�in�the�`�sitelist.cfg�'�le�w��gon'���t�be�changed.���The��template�can�be�applied�to�your�site�list�by�running:�������2
�%�ffbin/config_list�-i�data/sitelist.cfg�mailman�����-����After��applying�the�`�sitelist.cfg�'�options,�be�sure�you�re��vie�w��the�site�list'��s8s�conguration�via�the�admin�pages.���Y���gou��should�also�subscribe�yourself�to�the�site�list.��'p��9��hSet��up�cron��
_��Se��v�٠eral��Mailman��features�occur�on�a�re�٠gular�schedule,���so�you�must�set�up��cr���on��to�run�the�right�programs�at�the�right���time����^��5����.���If�gmyour�glv�٠ersion�of�crontab�supports�the��-u��option,�lWyou�must�be�root�to�do�this�ne�٠xt�step.�gAdd�`�$�pr��Gex���/cron/crontab���.in�'���as��a�crontab�entry�by�e�٠x�ecuting��these�commands:�����ff��-�	�荍���
�h��-:�4����fh�In�h�general,��*changing�the�list�def��aults�described�in�h�this�section�will�not�aect�an��My�already�created�lists.���T��\,o�mak��e�changes�after�a�list�has�been��	��created,�use�the�web�interf��ace�or�the�command�line�scripts,�such�as��1�ߌ�
ptmb7t�bin/withlist��and��bin/cong��z��fffh���Hlist�.��	�鍍���
�h��-:�5����fh�Note��fthat��gif�you'���re�upgrading�from�a�pre���vious�v��Mersion�of�Mailman,��you'��ll�w�ant��fto�install�the�ne���w�crontab,��b��
ut�be�careful�if�you'���re�running���multiple�Mailman�installations�on�your�site!�z�Changing�the�crontab�could�mess�with�other�parallel�Mailman�installations.���������ff��H������20��������K9�
Set�ǧup�cron����������.l��n���>�썍����fd������n����썍���2
�%�ffcd�$prefix/cron����2
%�ffcrontab�-u�mailman�crontab.in�����8����If��syou��rused�the��--with-user�٠name��option,���use�that�user�name�instead�of��mailman��for�the��-u��ar���gument�v��alue.��If�your���crontab��does�not�support�the��-u��option,�try�these�commands:���Ǎ����2
�%�ffcd�$prefix/cron����2
%�ffsu�-�mailman����2
%�ffcrontab�crontab.in�����W
����10��i�Star��kt��the�Mailman�qr�7Bunner��
_��Mailman���depends�on���a�process�called�the�\qrunner"�to�deli��v�٠ery�all�email�messages�it�sees.�I'Y���gou�must�start�the�qrunner���by��e�٠x�ecuting�the�follo��wing�command�from�the��$�pr��Gex����directory:�������2
�%�ffbin/mailmanctl�start�����-����Y���gou�sprobably�w��gant�sto�start�Mailman�e��v�٠ery�time�you�reboot�your�system.���Exactly�ho��w�to�do�this�depends�on�your���operating��*system.��If�your��)OS��supports�the��chkcong��command�(e.g.�RedHat�and��)Mandrak��ge�Linux�٠es)�you�can�do�the���follo��wing��(as�root,�from�the�Mailman�install�directory):�������2
�%�ffcp�scripts/mailman�/etc/init.d/mailman����2
%�ffchkconfig�--add�mailman�����8����Note��that�`�/etc/init.d�'�may�be�`�/etc/rc.d/init.d�'�on�some�systems.���On��Gentoo�Linux,�you�can�do�the�follo��wing:�������2
�%�ffcp�scripts/mailman�/etc/init.d/mailman����2
%�ffrc-update�add�mailman�default�������On��Debian,�you�probably�w��gant�to�use:�������2
�%�ffupdate-rc.d�mailman�defaults�����-����F�٠or���Unix�es�that�don'���t�support��chkcong�,�you�might�try�the�follo��wing�set�of�commands:���������ff��H������ʢ��21����������?|��n���>�썍����fd������n����썍���2
�%�ffcp�scripts/mailman�/etc/init.d/mailman����2
%�ffcp�misc/mailman�/etc/init.d����2
%�ffcd�/etc/rc.d/rc0.d����2
%�ffln�-s�../init.d/mailman�K12mailman����2
%�ffcd�../rc1.d����2
%�ffln�-s�../init.d/mailman�K12mailman����2
%�ffcd�../rc2.d����2
%�ffln�-s�../init.d/mailman�S98mailman����2
%�ffcd�../rc3.d����2
%�ffln�-s�../init.d/mailman�S98mailman����2
%�ffcd�../rc4.d����2
%�ffln�-s�../init.d/mailman�S98mailman����2
%�ffcd�../rc5.d����2
%�ffln�-s�../init.d/mailman�S98mailman����2
%�ffcd�../rc6.d����2
%�ffln�-s�../init.d/mailman�K12mailman������
����11��i�Chec��Jk��the�hostname�settings��
_��Y���gou�j�should�check�the�v��alues�for��DEF��٠A���UL���T�����ff����EMAIL�����ff��HOST�/��and�j��DEF�A���UL���T�����ff��URL�����ff��HOST�/��in�j�`�Def���aults��v.p�y�'.���Mak��ge�an�٠y���necessary�h�changes�h�in�the�`�mm���<�ff�5��=qcfg.p���y�'�le,�me�not��in�the�`�Def�aults��v.p�y�'�h�le.��If�you�change�either�of�these�tw��go�v��alues,�mdyou'�ll���w��gant��to�add�the�follo��wing�afterw�ards�in�the�`�mm���<�ff�5��=qcfg.p���y�'�le:���Ǎ����2
�add_virtualhost(DEFAULT_URL_HOST,�ffDEFAULT_EMAIL_HOST)�����-����Y���gou��will�w��gant�to�run�the��bin/x�����ff����url.py��to�change�the�domain�of�an�٠y�e�xisting�lists.��'pÍ��12��i�Create��the�site�pass��ow��$ord����There��[are�tw��go�site-wide�passw�ords�that��Zyou�can�create�from�the�command�line,���using�the��bin/mmsitepass��script.�P�The���rst��Qis��Rthe�\site�passw��gord"�which�can�be�used�an�٠ywhere�a�passw��gord�is�required�in�the�system.���The�site�passw��gord�will���get�R�you�R�into�the�administration�page�for�an�٠y�list,��kand�it�can�be�used�to�log�in�as�an�٠y�user��s8.���Think��root��for�a�Unix���system,��so�pick�this�passw��gord�wisely!���ǍThe�k�second�passw��gord�k�is�a�site-wide�\list�creator"�passw��gord.���Y���gou�can�use�this�to�dele�٠g��7ate�the�ability�to�create�ne��w���mailing���lists���without�pro�٠viding�all�the�pri��vile�٠ges�of�the�site�passw��gord.�0?Of�course,��the�o��wner�of�the�site�passw��gord�can���also��create�ne��w�mailing�lists,�b���ut�the�list�creator�passw��gord�is�limited�to�just�that�special�role.���T��37o��set�the�site�passw��gord,�use�this�command:�������2
�%�ff$prefix/bin/mmsitepass�<your-site-password>�����-����T��37o��set�the�list�creator�passw��gord,�use�this�command:�������2
�%�ff$prefix/bin/mmsitepass�-c�<list-creator-password>�������It��is�okay�not�to�set�a�list�creator�passw��gord,�b���ut�you�probably�do�w�ant�a�site�passw�ord.���������ff��H������22�������Ro�12�
Create�ǧthe�site�pass��7w��gord����������F0��n���>�썍����fd������n����.̍��13��i�Create��y��Jour�rst�mailing�list��
_��F�٠or�5�more�detailed�information�about�5�using�Mailman,�D�including�creating�and�conguring�mailing�lists,�D�see�the�Mailman���List�*�Adminstration�Manual.��These�instructions�pro�٠vide�a�quick�*�guide�to�creating�your�rst�mailing�list�via�the�web���interf��gace:��wC�����������Start��by�visiting�the�url��http://my.dom.ain/mailman/create�.���������������Fill��qout�the�form�as�described��rin�the�on-screen�instructions,��Mand�in�the�\List�creator'��s8s�passw��gord"�eld,��Mtype�the����passw��gord��Gyou�entered��Fin�section�7.��lT��37ype�your�o��wn�email�address�for�the�\Initial�list�o��wner�address",��Xand�select����\Y����es"��to�notify�the�list�administrator��s8.���������������Click��on�the�\Create�List"�b���utton.�������������Check��your�email�for�a�message�from�Mailman�informing�you�that�your�ne��w�mailing�list�w��gas�created.�������������No��w�tvisit�sthe�list'��s8s�administration�page,���either�by�follo��wing�the�link�on�the�conrmation�web�page�or����clicking�1�on�the�link�from�1�the�email�Mailman�just�sent�you.�.TT��37ypically�the�url�will�be�something�lik��ge�����http://my.dom.ain/mailman/admin/mylist�.���������������T��37ype��in�the�list'��s8s�passw��gord�and�click�on�\Let�me�in...��L�"�������������Click��on�\Membership�Management"�and�then�on�\Mass�Subscription".�������������Enter��your�email�address�in�the�big�te�٠xt�eld,�and�click�on�\Submit�Y���gour�Changes".�������������No��w���go�to�your�email���and�send�a�message�to��mylist@my.dom.ain�.�?�W���ithin�a�minute�or�tw��go�you�should�see����your��message�re
ected�back�to�you�via�Mailman.��wC�Congratulations!��Y���gou'���v�٠e�M�just�M�set�up�and�tested�your�rst�Mailman�mailing�list.��If�you�had�an�٠y�problems�along�the�w��gay��Y�,���please��see�the�14�section.��'fh���14��i�T��E�roub��Jleshooting��
_��If��qyou�encounter�problems��rwith�running�Mailman,���rst�check�the�question�and�answer�section�belo��w��Y�.�)�If�your�problem���is��not�co�٠v�ered��there,�check�the�online�help,�including�the�F��B�A��s8Q�and�the�interacti��v�٠e�F�A��s8Q�wizard.���ǍAlso�#�check�for�errors�in�your�syslog�les,�L�your�mail�and�#�web�serv�٠er�log�les�and�in�Mailman'��s8s�`�$�pr��Gex���/logs/error�'���le.���If��_you'���re�still�ha���ving�problems,�vyou�should�send�a�message�to�the��mailman-users@p���ython.org��mailing�list����^��6����;�4�see�����http://mail.p���ython.org/mailman/listinf�o/mailman-users���d�for��more�information.���Be��sure�to�including�information�on�your�operating�system,��]which�v�٠ersion�of�Python�you'���re�using,��^and�which�v�ersion���of��Mailman�you'���re�installing.���Here��is�a�list�of�some�common�questions�and�answers:��wC�����������Pr���oblem:���All��Mailman�web�pages�gi��v�٠e�a�404�File�not�found�error��s8.������Solution:�'!�Y���gour���web�serv�٠er���has�not�been�set�up�properly�for�handling�Mailman'��s8s�CGI���programs.�-�Mak��ge�sure�you����ha���v�٠e:���~�����"�1.����/congured��the�web�serv�٠er�to�gi��v�e�permissions�to�`�$�pr��Gex���/cgi-bin�'���������"�2.����/restarted��the�web�serv�٠er�properly��Y�.����Consult��your�web�serv�٠er'��s8s�documentation�for�instructions�on�ho��w�to�do�check�these�issues.��y��ff��-�	�荍���
�h��-:�6����fh�Y���ou�must�subscribe�to�this�mailing�list�in�order�to�post�to�it,�b��
ut�the�mailing�list'��`s�archi���v��Mes�are�publicly�visible.���������ff��H������ʢ��23����������Q,��n���>�썍����fd������n����썍���������Pr���oblem:���All��Mailman�web�pages�gi��v�٠e�an�"Internal�Serv�er�Error".�����Solution:��ԹThe�Lylik��gely�problem�Lxis�that�you�are�using�the�wrong�user�or�group�for�the�CGI�Llscripts.�kCheck�your�web����serv�٠er'��s8s��log�les.��If�you�see�a�line�lik��ge�������v@��Attempt�ffto�exec�script�with�invalid�gid�51,�expected�99������6�䍑�you��will�need�to�reinstall�Mailman,�specifying�the�proper�CGI�group�id,�as�described�in�the�section.�������������Pr���oblem:���I��send�mail�to�the�list,�and�get�back�mail�saying�the�list�is�not�found!�����Solution:���Y���gou�K�probably�K�didn'���t�add�the�necessary�aliases�to�the�system�alias�database,�~�or�you�didn'���t�properly����inte�٠grate��Mailman��with�your�mail�serv�er��s8.�j�Perhaps�you��didn'���t�update�the�alias�database,���or�your�system�requires����you��to�run��newaliases��e�٠xplicitly��Y�.��Refer�to�your�serv�er�specic�instructions�in�the�6�section.�������������Pr���oblem:���I��send�mail�to�the�list,�and�get�back�mail�saying,�\unkno��wn�mailer�error".�����Solution:�ry�The�,plik��gely�problem�,qis�that�you�are�using�the�wrong�user�or�group�id�for�the�mail�wrappers.��Check����your��mail�serv�٠er'��s8s�log�les;�if�you�see�a�line�lik��ge�������v@��Attempt�ffto�exec�script�with�invalid�gid�51,�expected�99������6�䍑�you��will�need�to�reinstall�Mailman,�specifying�the�proper�mail�group�id�as�described�in�the�section.�������������Pr���oblem:�(�I��use��GPostx��Has�my�mail�serv�٠er�and�the�mail�wrapper�programs�are�logging�complaints�about�the����wrong��GID.�����Solution:����Mak��ge�n�sure�the�`�$�pr��Gex���/data/aliases�٠.db�'�le�is�n�user�o��wned�by��mailman��(or�whate�v�٠er�user�name����you���used���in�the��congur���e��command).���If�this�le�is�not�user�o��wned�by��mailman�,��7Postx�will�not�run�the�mail����programs��as�the�correct�user��s8.�������������Pr���oblem:�J�I��euse���Sendmail�as�my�mail�serv�٠er���,���and�when�I�send�mail�to�the�list,���I��dget�back�mail�saying,�\sh:����mailman��not�a���v��ailable�for�sendmail�programs".�����Solution:�&A�Y���gour�Usystem�uses�the�TSendmail�restricted�shell�(smrsh).���Y�ou�need�Tto�congure�smrsh�by�creating�a����symbolic��ilink��jfrom�the�mail�wrapper�(`�$�pr��Gex���/mail/mailman�')�to�the�directory�identifying�e�٠x�ecutables��iallo��wed����to��run�under�smrsh.����Some��common�names�for�this�directory�are�`�/v��far/admin/sm.bin�',�`�/usr/admin/sm.bin�'�or�`�/etc/smrsh�'.����Note���that�on���Debian�Linux,���the�system�mak��ges�`�/usr/lib/sm.bin�',���which�is�wrong,���you�will�need�to�create�the����directory��@`�/usr/admin/sm.bin�'�and�add�the�link�there.��XNote�further�an�٠y�aliases��newaliases��spits�out�will�need�to����be��adjusted�to�point�to�the�secure�link�to�the�wrapper��s8.�������������Pr���oblem:���I��messed�up�when�I�called��congur�e�.��Ho��w�do�I�clean�things�up�and�re-install?�����Solution:������`��%�ffmake�clean����`�%�ff./configure�--with-the-right-options����`�%�ffmake�install�������������ff��H������24�������zU�14�
T����roub���leshooting����������_���n���>�썍����fd������n����ύ��15��i�Platf��oor�\(m��and�oper��$ating�system�notes��
_��Generally��Y�,��jMailman��#runs��"on�an�٠y�POSIX-based�system,��ksuch�as�Solaris,�the�v��arious�BSD���v�ariants,��kLinux�systems,���MacOSX,�
and�other�generic��Unix��systems.���It�doesn'���t�run�on�W���indo��ws.���F�٠or�the�most�part,�E�the�generic�instructions���gi��v�٠en��Min��Nthis�document�should�be�sucient�to�get�Mailman�w��gorking�on�an�٠y�supported�platform.�ŀSome�operating���systems��ha���v�٠e�additional�recommended�installation�or�conguration�instructions.��"PÍ��15.1��#ZGNU/Lin��Iux�U�issues��pō�Linux�jjseems�to�jibe�the�most�popular�platform�for�running�Mailman.�fHere�are�some�hints�on�getting�Mailman�to�run�on���Linux:���Ǎ����������If��you��are�getting�errors�with�hard�link�creations�and/or�you�are�using�a�special�secure�k��gernel�(secure-����linux/openw��gall/grsecurity),�ssee�L\the�le�`�contr�"�ib/README.chec���k���<�ff�5��=qper�9�ms���<�ff�5��g���rsecur�ity�'�L\in�L]the�Mailman�source�dis-����trib���ution.����Note��that�if�you�are�using�Linux�Mandrak��ge�in�secure�mode,�you�are�probably�concerned�by�this.�������������Apparently�T�Mandrak��ge�T�9.0�changed�the�permissions�on�gcc,�]hso�if�you�b���uild�as�the��mailman��user���,�]hyou�need�to�be����sure���mailman��is�in�the��cctools��group.�������������If�lfyou�installed�lgPython�from�your�Linux�distrib���ution'��s8s�package�manager�(e.g.�.rpms�for�Redhat-deri��v�٠ed�systems����or���.deb���for�Debian),���you�must�install�the�\de��v�٠elopment"�package�of�Python,���or�you�may�not�get�e��v�٠erything�you����need.����F�٠or��[e�xample,���using�Python��Z2.2�on�Debian,�you�will��Zneed�to�install�the��python2.2-dev��package.��On�Redhat,����you��probably�need�the��python2-devel��package.����If��you�install�Python�from�source,�you�should�be�ne.����One��0symptom�of�this�problem,��<although�for�unkno��wn�reasons,�is��1that�you�might�get�an�error�such�as�this�during����your��install:�������ks��Traceback�ff(most�recent�call�last):����v@�File�ff"bin/update",�line�44,�in�?�����
}import�ffpaths����ks�ImportError:�ffNo�module�named�paths����ks�make:�ff***�[update]�Error�1������b�ԍ��If��this�happens,�7�install�the�Python�de��v�٠elopment�package�and�try��congur���e��and��mak��ge�install��ag��7ain.�ҖOr�install����the��latest�v�٠ersion�of�Python�from�source,�a���v��ailable�from���http://www��u�.p���ython.org��X�J�.����This��problem��can�manifest�itself�in�other�Linux�distrib���utions�in�dierent�w��gays,�FMalthough�usually�it�appears�as�����ImportErrors�.��"PÍ��15.2��#ZBSD�U�issues��pō�V��fgi��v�٠ek�\Khera�\writes�that�some�BSDs�do�nightly�security�scans�for�setuid�le�changes.���setgid�directories�also�come���up��=on�the��<scan�when�the�٠y�change.�RNAlso,�Lthe�setgid�bit�is�not�necessary�on�BSD��"systems�because�group�o��wnership�is���automatically���inherited�on�les�created�in�directories.�EOn��other��Unix�es,�� this�only�happens�when�the�directory�has�the���setgid��bit�turned�on.���ǍT��37o��kinstall�without�turning�on�the�setgid�bit�on�directories,��simply�pass�in�the��DIRSETGID��%�v��ariable�to��mak��ge�,�after���you'���v�٠e��run��congur���e�:���������ff��H������ʢ��25����������l���n���>�썍����fd������n����썍���2
�%�ffmake�DIRSETGID=:�install�����-����This��disables�the��chmod�g+s��command�on�installed�directories.��"-p���15.3��#ZMacOSX�U�issues��pō�Man�٠y�ߵpeople�ߴrun�Mailman�on�MacOSX.�Here�are�some�pointers�that�ha���v�٠e�been�collected�on�getting�Mailman�to�run���on��MacOSX.��섍����������Jaguar�Q�(MacOSX�Q{10.2)�comes�with�Python�2.2.�
While�this�isn'���t�the�v�٠ery�latest�Q�stable�v�ersion�of�Python,�Z�it�ought����to��be�sucient�to�run�Mailman�2.1.��������������Da���vid��B.�O'Donnell�has��a�web�page�describing�his�conguration�of�Mailman�2.0.13�and�Postx�on�MacOSX����Serv�٠er��s8.��ؿ����http://www��u�.afp548.com/Ar�\#ticles/mail/p���ython-mailman.html��������������Kathleen��W��37ebb�posted�her�e�٠xperiences�in�getting�Mailman�running�on�Jaguar�using�Sendmail.������http://mail.p���ython.org/piper�9�mail/mailman-users/2002-October/022944.html��������������P�٠anther�U%serv�er�U&(MacOSX�U10.3)�comes�with�Mailman;�coY���gour�operating�system�should�contain�documentation�that����will���help���you,���and�Apple�has�a�tech�document�about�a�problem�you�might�encounter�running�Mailman�on�Mac����OS��X�Serv�٠er�10.3:��������http://docs��v.inf���o���.apple�.com/ar�\#ticle�.html?ar�tn���um=107889���섍�T��L�erry�igAllen�pro�٠vides�the�follo��wing�detailed�instructions�on�running�ihMailman�on�the�'client'�v�ersion�of�OSX,�or�in���earlier��v�٠ersions�of�OSX:���ǍMac�9�OSX�9m10.3�and�9�onw��gards�has�the�basics�for�a�successful�Mailman�installation.�FmUsers�of�earlier�v�٠ersions�of�Mac���OSX��0contains��LSendmail��Kand�those�users�should�look�at�the�Sendmail�installation�section�for�tips.�RyY���gou�should�follo��w���the�Dbasic�installation�steps�as�described�earlier�in�this�manual,�usubstituting�as�appropriate,�u
the�steps�outlined�in�this���section.���By��def��gault,��Mac�OSX��10.3�'client'�v�٠ersion��does�not�ha���v�e��a�fully�functional�v�ersion��of�Postx.�\�Setting�up�a�w��gorking���MT���A�K�such�K�as�K�Postx�is�be�٠yond�the�scope�of�this�guide�and�you�should�refer�to���http://www��u�.postx.org��Z'�for�tips�on�getting���Postx���running.��An���easy�w��gay�to�set�Postx�up�is�to�install�and�run�Postx�Enabler���,��#a�stand-alone�tool�for�conguring���Postx��on�Mac�OSX,�a���v��ailable�from���http://www��u�.roadstead.com/w���eb���log/T���utor�"�ials/P���ostxEnab�ler�.html����j�.���Lik��ge��wise,�"\Mac��OSX��'client'�v�٠ersion�from�10.1��onw�ards�includes�a�w�orking�Apache��webserv�٠er��s8.��AThis�is��switched�on���using��9the��:System�Preferences�control�panel�under�the�'Sharing�tab'.�GDA��6useful�tool�for�conguring�the�Apache�on�Mac���OSX��is�W��37ebmin,�which�can�be�obtained�from���http://www��u�.w���ebmin.com��`�	�.���W��37ebmin���can�also���perform�conguration�for�other�system�tasks,��including�Postx,��adding�jobs�to�your�crontab,��adding���user��and�groups,�plus�adding�startup�and�shutdo��wn�jobs.���In�4la�4kstock�installation�of�OSX,�the�requirement�for�Mailman�is�to�ha���v�٠e�Python�installed.�6�Python�is�not�installed�by���def��gault,�-2so�}it�~is�advised�that�you�install�the�de��v�٠eloper'��s8s�tools�package,�-1which�may�ha���v�e�been�pro�vided�with�your�system.���It�̇can�also�̈be�do��wnloaded�from�the�Apple�de��v�٠eloper�site�at���http://connect.apple��v.com��d���.��.Not�only�is�the�de��v�٠eloper�tools���package�O2an�essential�requirement�for�installing�Mailman,���b���ut�it�O3will�come�in�handy�at�a�later�date�should�you�need���other��tools.��The�de��v�٠eloper'��s8s�tools�are�also�kno�w�by�the�name�XCode�tools.���As��a�minimum,�the�Python�v�٠ersion�should�be�2.2,�b���ut�2.3�is�recommended.���If���you���wish�to�add�a�user�and�group�using�the�command�line�in�OSX���instead�of�via�W��37ebmin�or�another�GUI���interf��gace,���open�P�your�terminal�P�application�and�follo��w�the�commands�as�indicated�belo��w�-�do�not�type�the�comments�follo��wing�the���`�#�'��since�the�٠y�are�just�notes:���������ff��H������26���������15�
Platf��7or�?�m�ǧand�oper��gating�system�notes����������z���n���>�썍����fd������n����썍���s��sudo�fftcsh����s�niutil�ff-create�/�/users/mailman����s�niutil�ff-createprop�/�/users/mailman�name�mailman����s�#�ffNote�that�xxx�is�a�free�user�ID�number�on�your�system����s�niutil�ff-createprop�/�/users/mailman�uid�xxx����s�niutil�ff-createprop�/�/users/mailman�home�/usr/local/mailman����s�mkdir�ff-p�/usr/local/mailman����s�niutil�ff-createprop�/�/users/mailman�shell�/bin/tcsh����s�passwd�ffmailman����s�#�ffTo�prevent�malicious�hacking,�supply�a�secure�password�here����s�niutil�ff-create�/�/groups/mailman����s�niutil�ff-createprop�/�/groups/mailman�name�mailman����s�#�ffNote�that�xxx�is�a�free�group�ID�number�on�your�system����s�niutil�ff-createprop�/�/groups/mailman�gid�xxx����s�niutil�ff-createprop�/�/groups/mailman�passwd�'*'����s�niutil�ff-createprop�/�/groups/mailman�users�'mailman'����s�chown�ffmailman:mailman�/usr/local/mailman����s�cd�ff/usr/local/mailman����s�chmod�ffa+rx,g+ws�.����s�exit����s�su�ffmailman�����	����F�٠or��setting��up�Apache�on�OSX���to�handle�Mailman,��the�steps�are�almost�identical�and�the�conguration�le�on�a�stock���Mac��OSX�Client�v�٠ersion�is�stored�in�the�nearly�standard�location�of�`�/etc/httpd/httpd.conf�'.���ǍThe���AFP548.com�site���has�a�time-sa���ving�automated�startup�item�creator�for�Mailman,��>which�can�be�found�at�����http://www��u�.afp548.com/Softw��vare/MailmanStar�\#tup��].tar���.gz�����T��37o���install���it,��>cop��gy�it�into�your�`�/Libr���ar�Ey/Star�\#tupItems�'�directory��Y�.���As�the�root�or�superuser���,��>from�the�terminal,��>enter�the���follo��wing:�������s��gunzip�ffMailmanStartup.tar.gz����s�tar�ffxvf�MailmanStartup.tar�����8����It��will�create�the�startup�item�for�you�so�that�when�you�reboot,�Mailman�will�start�up.���������ff��H������15.3�
MacOSX�ǧissues�������ʢ�27�����������Y���;�����H�1�ߌ�
ptmb7t�0Kj�
ptmri7t�/Kj�
ptmri7t�.�e9V	
phvb7t�-ڶ�%

ptmbi7t�,�ߌ�
ptmb7t�+3{�

ptmro7t�*�l�
phvr7t�)0��	
pcrr7t�(0��

pcrr7t�'3{�
ptmr7t� 3{�
ptmr7t�3{�
ptmr7t��l�
phvr7t��l�

phvr7t�8��

ptmrc7t��ߌ�

ptmb7t�8��	
ptmrc7t��ߌ�	
ptmb7t��l�	
phvr7t�3{�	
ptmr7t��l�ff
phvr7t��l�
phvro7t�Kj�

ptmri7t��l��H
phvr7t�3{�

ptmr7t�
!",�

cmsy10����������