PAL.C.T MINI SHELL
; TeX output 2009.01.11:0922 n>n썍 H!TDl H
phvr7tGNUMailman-InstallationManQualǍLl
phvro7tReleaseU2.1*Ǎ{l ff
phvr7tBarrny WlarsaJw'3{
ptmr7tJanuary 11,2009l
phvr7tbarrEy}(at)listdotorgǍ "ߌ
ptmb7tAbstract0Ǎ 3{
ptmr7tThisMdocumentLdescribeshofwtoinstallGNUMailmanonaPOSIX-basedsystemsuchas8
ptmrc7tUnix,MacOSX,or GNU/Linux.AIt,will,covverbasicinstallationinstructions,gaswellasguidelines,forintegratingMailman,withyour web@ andmailservvers. The@ GNUMailmanwebsiteisathttp://wwwu.list.org!ContentsYߌ
ptmb7t1 Installation RequirementsR2 2 Set upy oursystemq- 3 2.1& Add thegroupanduser ..........................................C 3 2.2& Create theinstallationdirectory ......................................C 33 Build andinstallMailmanQ4 3.1& Run con gure >...............................................C 4 3.2& Makge andinstallpk..............................................C 54 Check y ourinstallation]55 Set upy ourwebsergver_66 Set upy ourmailsergver^7L7 6.1& Using thePost xmailserv٠er썍.......................................C 7& Inte٠grating Post xandMailman.....................................C 7& Vfgirtual domains ..............................................C 9& An alternati v٠eapproachQ..........................................C 10 6.2& Using theEximmailserv٠er(........................................C 10& Exim con guration............................................C 10& Main con gurationsettings........................................C 11& Tgransport forExim3#z...........................................C 11& Director forExim3J............................................C 11& Router forExim4rፍ.............................................C 12& Tgransports forExim4?...........................................C 12& Additional notes 덍..............................................C 12& Problems.................................................C 12& Recei v٠er Veri cation2덍...........................................C 13& SMTP Callback8..............................................C 13& Doing VERPwithEximandMailman...................................C 14 *n>썍fdn썑& Vfgirtual Domains ..............................................C 14 & List Veri cationG|..............................................C 15& Document HistoryV.............................................C 15 6.3& Using theSendmailmailserv٠er ~......................................C 15& Sendmail \smrsh"compatibility鍍.....................................C 16& Inte٠grating SendmailandMailmanpG....................................C 16& Performance notesL............................................C 17 6.4& Using theQmailmailserv٠erT........................................C 17& Information onVERP+)...........................................C 19& Vfgirtual mailserv٠er5............................................C 19& More information r.............................................C 19 7 Re٠view y oursitedefaultsR9208 Create asite-widemailinglist>I_209 Set upcron 2010 Start theMailmanqrunnerG2111 Check thehostnamesettingsC`Y2212 Create thesitepasswgordTV
2213 Create y our rstmailinglistD 2314 TBroubleshootingw2315 Platf orm andoperatingsystemnotes [B25 15.1& GNU/Linux issuesGa............................................C 25 15.2& BSD issues(................................................C 25 15.3& MacOSX issuesύ..............................................C 26Ǎ H3pÍ1hInstallation Requirements
_Kj
ptmri7tPleasenotethattheinformationonthispaggemaybeoutofdate٠.ACheckforthelatestinstallationinformationontheMailman wiki.GNUΝMailmanΰwgorksαonmostPOSIX-basedsystemssuchas8
ptmrc7tUnix,]MacOSX,orGNU/Linux.Itdoesnotcurrentlywgork on Windo ws.Ygoumusthav٠eamailserv٠erthatyoucansendmessagesto,Candawebserv٠erthatsupportstheCGI/1.1FvAPI.Apachemakgesa nechoiceforwebserv٠er,QandmailserverssuchasPost x,QExim,Sendmail,andFvqmailshould wgorkjust ne.T37oinstallMailmanfromsource,youwillneedanANSICcompilertobuildMailman's8ssecuritywrappers.`TheGNUC compilergccwgorkswell.YgouSmustThav٠ethePythoninterpreterinstalledsome whereonyoursystem.PAsofthiswriting,Python2.4.4isrecom-mended, butseethewikipageabo٠ve forthelatestinformation. ffH l
phvr7t2U`e1
InstallationǧRequirements )n>썍fdn.̍2hSet upyJoursystem
_Before7Iinstalling7HMailman,Eyouneedtoprepareyoursystembyaddingcertainusersandgroups.[Ygouwillneedtohav٠e root pri vile٠gestoperformthestepsinthissection."PÍ l
phvr7t2.1 AddUthegIroupanduserpōMailman-requiresauniqueuserandgroupname.whichwillo wnits les,andunderwhichitsprocesseswillrun.Mailman's8sbasicsecurityisbasedongroupo wnershippermissions,soit's8simportanttogetthisstepright^ 3{
ptmr7t1 .d7T37ypicallyY,you^will]addane wuserandane wgroup,bothcalled(0
pcrr7tmailman.tThemailmanusermustbeamemberofthemailman.4group.$6Mailmanwillbe.5installedunderthemailmanuserandgroup,Ywiththeset-group-id(setgid)bitenabled.ǍIf_these_namesarealreadyinuse,youcanchoosedi erentuserandgroupnames,aslongasyourememberthesewhenyouruncon gure.W:Ifyouchooseadi erentuniqueusername,Yyouwillhav٠etospecifythiswithcon gure's8s--with-user٠nameZoption,andifyouZchooseadi erentgroupname,youwillhav٠etospecifythiswithcon gure's8s--with-groupname option.On|Linuxsystems,|youcanusethefollo wingcommandstocreatetheseaccounts.ECheckyoursystem's8smanualpagesfor details: 2
)0
pcrr7t%ffgroupaddmailman2
%ffuseradd-c''GNUMailman''-s/no/shell-d/no/home-gmailmanmailman I(Ӎ2.2 CreateUtheinstallationdirector\#ypōT37ypicallyY,xMailmanvisinstalledvintoasingledirectoryY,xwhichincludesboththeMailmansourcecodeandtherun-timelist#andarchi v٠edata.2Itispossibletosplitthe$staticprogram lesfromthevariabledata les$andinstalltheminseparate directories.Thissectionwilldescribetheav ailableoptions.The{defgaultzistoinstallallofMailmanto`/usr/local/mailman'^2 .lYgoucanchangethisbaseinstallationdirectory(referredto}here}as+3{
ptmro7t$prGe x)byspecifyingthedirectorywiththe--pre xcon gure}option.Ifyou'reupgradingfromapre viousv٠ersion ofMailman,youmaywganttousethe--pre xoptionunlessyoumoveyourmailinglists.$ H/ / WYar٠ning:
8YgoucannotinstallMailmanona lesystemthatismountedwiththenosuidoption.Thiswill breakL<Mailman,VwhichreliesonsetgidL=programsforitssecurityY.WIfthisdescribesyourenvironment,Vsimplyinstall Mailman inalocationthatallo wssetgidprograms.H / HMakgeWsuretheinstallationdirectoryVissettogroupmailman(orwhate v٠eryou'regoingtospecifywith--with-groupname)andhasthesetgidbitset^3 .$Ygouprobablyalsowganttoguaranteethatthisdirectoryisreadableande٠xecutable bye v٠eryone.For example,theseshellcommandswillaccomplishthis: 2
%ffcd$prefix2
%ffchgrpmailman.2
%ffchmoda+rx,g+ws. CYgou areno wreadytocon gureandinstalltheMailmansoftwgare. ff - 荍
h-:'3{
ptmr7t1fh 3{
ptmr7tY ou willbeabletocheckandrepairyourpermissionsafterinstallationiscomplete. 鍍
h-:2fhThis isthedefaultforMailman2.1.zEarliervMersionsofMailmaninstalledeverythingunder`*l
phvr7t/home/mailman'bydefault.
h-:3fhBSD usersshouldseethe15.2sectionforadditionalinformation. ffH 13 Jn>썍fdnP3hBuild andinstallMailman
_3.1 RunU,ߌ
ptmb7tcon gurȹepōBefore youcaninstallMailman,youmustruncon guretosetv ariousinstallationoptionsyoursystemmightneed.ǍNote: .T37akge]@special]?noteofthe--with-mail-gidand--with-cgi-gidoptionsbelo wY.VYgouwillprobablyneedtouse these.YgouBshouldnotBberootwhileperformingthestepsinthissection. Dothemunderyouro wnlogin,Norwhatev٠eraccountyouYtypicallyusetoXinstallsoftwgare.[Ygoudonotneedtodothesestepsasusermailman,/butyoucould.[Ho wev٠er,makgeqsureqthattheloginusedisamemberofthemailmangroupasthatthatgrouphaswritepermissionstothe$prGe x'directory made inthepre viousstep.Ygoumustalsohav٠epermissiontocreateasetgid leinthe lesystemwhere itresides(NFSandothermountscanbecon guredtoinhibitsetgidsettings).Ifyou'v٠einstalledotherGNUnsoftwgare, youshouldbefgamiliarwiththecon gurescript.Usuallyyoucanjustcdtothe directoryyouunpackgedtheMailmansourcetarballinto,andruncon gurewithnoarguments: '@%ffcdmailman-<version>'@%ff./configure'@%ffmakeinstall CThe follo wingoptionsallowyoutocustomizeyourMailmaninstallation.Ǎ--pre x=-ڶ%
ptmbi7tdir5vStandardzGNUycon gurezoptionwhichchangesthebasedirectorythatMailmanisinstalledinto.By defgault $prGe xis`/usr/local/mailman'.Thisdirectorymustalreadye٠xist,andbesetupasdescribedin2.2. --exec-pre x=dirKιStandardߵGNUߝcon gureoptionwhich߶letsyouspecifyadi erentinstallationdirectoryforarchi- tecture dependentbinaries.--with-vgarG-pre x=dir]^{Store8ymutabledata8zunderdirsXinsteadofunderthe$prGe x@ or$exec ff pre x.CExamplesofsuch data includethelistarchi v٠esandlistsettingsdatabase.--with-python=`.e9V
phvb7t/path/to/pvython' Specifyanalternati v٠ePythoninterpretertouseforthewrapperprograms.The defgault istousetheinterpreterfound rstonyourshell's8s$PAGTHs0.--with-user٠name=username-or-uid KSpecifydadi erentdusernamethanmailman.uThev alueofthisoptioncanbean inte٠ger useridorausername.Besureyour$prGe xdirectoryiso wnedbythisusers8.--with-groupname=groupname-or-gid Specifyadi erentgroupnamethanmailman.Thev alueofthisoptioncan be aninte٠gergroupidoragroupname.Besureyour$prGe xdirectoryisgroup-o wnedbythisgroup.--with-mail-gid=group-or-groups z{Specify&danalternati v٠egroupforrunningscripts&cviathemailwrappers8. ļgroup-or- groupscanbealistofoneormoreinte٠gergroupidsorsymbolicgroupnames.The rstv alueinthelistthat resolv٠es toanexistinggroupisused.Bydefgault,thev alueisthelistmailman,other,mail,anddaemon. Note:
mThisishighlysystemdependentandyoumustgetthisright,\becausethegroupidiscompiledinto thesmailrwrapperprogramforaddedsecurityY.OOnsystemsusingsendmail,Othe`sendmail.cf'con guration le designatesthegroupidofsendmailprocessesusingtheDefaultUserعoption.=(Ifcommentedout,itstillmaybe indicating thedefgault...) Check yourmailserv٠er's8sdocumentationandcon guration lesto ndtherightv alueforthisswitch. --with-cgi-gid=group-or-groups Specifyanalternati v٠egroupforrunningscriptsviatheCGIxwrappers8.group-or- groupscanbealistofoneormoreinte٠gergroupidsorsymbolicgroupnames.The rstv alueinthelistthat resolv٠es toanexistinggroupisused.Bydefgault,thev alueisthethelistwww,www-data,andnobody. ffH 4WD3
BuildǧandinstallMailman [n>썍fdn썑 Note:ƹThe2proper2v alueforthisisdependentonyourwebserv٠ercon guration.Ygoumustgetthisright,Bbecause theQmgroupQlidiscompiledintotheCGIQawrapperprogramforaddedsecurityY,ZandnoMailmanCGIQascriptswillrun if thisisincorrect. If you'reusingApache,checkthev aluesfortheGroupoptioninyour`httpd.conf' le. --with-cgi-ext=extensionkYCSpecifyGane٠xtensionFforcgi-binprograms.lTheCGI'wrappersplacedin`$prGe x/cgi-bin' will hav٠ethisextension(somewebserversrequireanextension).extensionmustincludetheleadingdot.--with-mailhost=hostnametB2Specifyftheffullyquali edhostnamepartforoutgoingemail.Aftertheinstallationis complete, thisv aluecanbeo٠verriden in`$prGe x/Mailman/mm ff cfg.p7y'.--with-urlhost=hostnamen& Specifythefullyquali edhostnamepartofurls.Aftertheinstallationiscomplete,<this v alue canbeo٠verriden in`$prGe x/Mailman/mm ff cfg.p7y'.--with-gcc=no@Don't usegcc,e v٠enifitisfound.Inthiscase,ccmustbefoundonyour$PAGTHs0."PÍ3.2 MakeUandinstallpōOnce you'v٠eruncon gure,youcansimplyrunmakge,thenmakeinstalltobuildandinstallMailman.'pÍ4hChecJk yourinstallation
_Afteryou'v٠erunmakgeinstall, _youshouldcheckthatyourinstallationhasallthecorrectpermissionsandgroupo wnerships aby brunningthecheck ff permsscript.Firstchangetotheinstallation(i.e.$prGe x)directoryY,Cythenrunthebin/check ff permsprogram. Don'ttrytorunbin/check ff permsfromthesourcedirectory;itwillonlyrunfromtheinstallation directoryY.ǍIfathis`reportsnoproblems,xthenit's8sv٠erylikgely<wink>thatyourinstallationissetupcorrectlyY.&Ifitreportsproblems,thenyoucaneither xthemmanuallyY,re-runtheinstallation,orusebin/check ff permsto xtheproblems(probablythe easiestsolution):Ǎ
!",
cmsy10 Ygou needtobecometheuserthatdidtheinstallation,andthato wnsallthe lesin$prGe x,orroot. Run bin/check ff perms-f Repeat pre viousstepuntilnomoreerrorsarereported!e H ܍ WYar٠ning:
;If you're runningMailmanonasharedmultiusersystem,¥andyouhav٠emailinglistswithpri vate archi v٠es,youmaywganttohidethepri vatearchiv٠edirectoryfromotherusersonyoursystem.z Inthatcase,you should] drop] theothere٠xecutepermission] (o-x)fromthe`archivfes/pr"ivate'] directoryY.Ho wev٠er,etheweb] server process8mustbeableto8follo wthesymboliclinkinpublicdirectoryY,FotherwiseyourpublicPipermailarchi v٠eswill not wgork.T37osetthisup,becomerootandrunthefollo wingcommands: #s#ffcd<prefix>/archives#s#ffchown<web-server-user>private#s#ffchmodo-xprivate =䍑 Ygouneedtokno wwhatuseryourwebserv٠errunsas.*Itmaybewww,apache,httpdornobody,depending on yourserv٠er's8scon guration.H HN ffH 3.2
Makeǧandinstall15 ln>썍fdn.̍5hSet upyJourw$ebsernver
_Congratulations!y.Ygou'v٠einstalledtheMailmansoftwgare.y-T37ogete v٠erythingrunningyouneedtohookMailmanupto both yourwebserv٠erandyourmailsystem.ǍIfyouplanonrunningyourmailandwebserv٠ersondi erentmachines, jsharingMailmaninstallationsviaNFS,besurethattheclocksonthosetwgomachinesaresynchronizedcloselyY.)Ygoumighttakgealookatthe le`Mailman/LockFilev.py';the constantCLOCK ff SLOPhelpsthelockingmechanismcompensateforclockskge winthistypeofenvironment.ThissectiondescribessomeofthethingsyouneedtodotoconnectMailman's8swebinterfgacetoyourwebserv٠er.ThexDinstructionsxCherearesome whatgearedto wgardtheApachewebserv٠er,Tsoyoushouldconsultyourwebserv٠erdocumentation fordetails.Ygoumustcon gureyourwebserv٠ertoenableCGIƷscriptpermissioninthe`$prGe x/cgi-bin'torunCGIƷscripts.ThelineUyouVshouldaddmightlooksomethinglikgethefollo wing,withtherealabsolutedirectorysubstitutedfor$prGe x,of course: 2
Exec+30/mailman/* fd$prefix/cgi-bin/* +=or: 2
ScriptAliasff/mailman/%$prefix/cgi-bin/ <͍ H# # WYar٠ning:YgouwganttobeverysurethattheuseridunderwhichyourCGIscriptsrunisnotinthemailman group youcreatedabo٠ve, otherwisepri vate archiv٠eswillbeaccessibletoanyone.H # HCopgy#bthe#aMailman,L:Python,L9andGNU#8logostoalocationaccessibletoyourwebserv٠ers8.E.g.withApache,L:you'v٠eusually gotan`icons'directorythatyoucandroptheimagesinto.F٠orexample: 2
%ffcp$prefix/icons/*.{jpg,png}/path/to/apache/icons .Ygou .then /wganttoaddalinetoyour`$prGe x/Mailman/mm ff cfg.p7y' lewhichsetsthebaseURL forthelogos.#F٠ore٠xample: '@IMAGE_LOGOSff='/images/' -The defgaultv alueforIMAgGE ff LOGOSxis`/icons/'.Readthecommentin`Defaultsv.py.in' fordetails.Con gure yourwebserv٠ertopointtothePipermailpublicmailinglistarchi ves.Forexample,inApache: 2
Alias32/pipermail/$varprefix/archives/public/ -where$varprGe x)isusually$pre x(unlessyou'v٠eusedthe--with-vgarG-pre xoptiontocon gure.? Alsobesuretocon guref yourewebserv٠ertofollo wsymboliclinksinthisdirectoryY,otherwisepublicPipermailarchi v٠eswgon'tbeaccessible.F٠or Apacheusers,consulttheF7ollowSymLinksoption.Ifjyou'rekgoingtobesupportinginternationalizedpublicarchi v٠es,"youwillprobablywganttoturno an٠ydefgaultcharsetdirecti v٠e,%for,$thePipermaildirectoryY,W-otherwiseyourmultilingualarchi v٠epageswgon'tsho wupcorrectlyY. Here's8sane٠xample forApache,basedonthestandardinstallationdirectories: ffH 6_^5
SetǧupyourwgebserLv er |en>썍fdn썍 2
<Directoryff"/usr/local/mailman/archives/public/">GAddDefaultCharsetffOff2
</Directory> CNo w restartyourwebserv٠ers8.'pÍ6hSet upyJourmailsernver
_This+sectiondescribessomeofthethingsyouneedto+dotoconnectMailman's8semailinterfgacetoyourmailserv٠er.The instructionsherearedi erentforeachmailserv٠er;),ifyourmailserv٠erisnotdescribedinthefollo wingsubsections,trytogeneralizefromthee٠xistingdocumentation,andconsidercontributingdocumentationupdatestotheMailmande v٠elopers."PÍ6.1 UsingUthePffost xmailser\#v3erpōMailman
should wgorkprettymuchoutoftheboxwithastandardPost xinstallation.ӾIthasbeentestedwithv ariousPost x v٠ersionsuptoandincludingPost x2.1.5.ǍInMorderMtosupportMailman's8soptionalVERPMdeli v٠eryY,Wyouwillwganttodisableluser_relay(thedefgault)andyouwillTwgantTtosetrecipient_delimiterfore٠xtendedaddresssemantics. /Ygoushouldcommentoutan٠yluser_-relay v alueinyour`main.cf'andjustgowiththedefgaults.Also,addthistoyour`main.cf' le: 2
recipient_delimiterff=+ -Using(`+'as)thedelimiterwgorkswellwiththedefgaultv aluesforVERP ff FORMAGTandVERP ff REGEXPin`Defaultsv.py'.Whenwattemptingtoxdeli v٠eramessagetoanon-e٠xistentlocaladdress,UPost xmayreturna450errorcode.kSincethisisatransienterrorcode, Mailmanwillcontinuetoattempttodeli v٠erthemessageforDELIVERY ff RETRY ff PERIODɹ{5BodaysBnbydefgault.YgoumightwganttosetPost xupsothatitreturnspermanenterrorcodesfornon-e٠xistentlocalusersby addingthefollo wingtoyour`main.cf' le: 2
unknown_local_recipient_reject_codeff=550 -FinallyY, ifyouareusingPost x-stylevirtualdomains,readthesectiononvirtualdomainsupportbelo w. PÍInteggratingǧPost xandMailmanpōYgoucaninte٠gratePost xandMailmansuchthatwhenne wlistsarecreated, ]orlistsareremo٠ved, ]Post x's8saliasdatabase willbeautomaticallyupdated.Thefollo wingarethestepsyouneedtotakgetomakethiswork.Inthedescriptionbelo wY,Xweassumethatyou'v٠einstalledMailmaninthedefgaultlocation,i.e.L`/usr/local/mailman'.Ifthat's8s`<not`=thecase,fadjusttheinstructionsaccordingtoyouruseofcon gure's8s--pre x`<and--with-vgarG-pre x`<options.Note:w}IfyouareusingvirtualdomainsandyouwgantMailmantohonoryourvirtualdomains,5Xreadthe6.1sectionbelo w rst!Ǎ Add thistothebottomofthe`$prGe x/Mailman/mm ff cfg.p7y' le: ffH 17 n>썍fdn썍 `MTAff='Postfix' 6䍑 The9MTAv ariablenames8amoduleinthe`Mailman/MTA'directorywhichcontainsthemailserv٠er-speci c functions tobee٠xecuted whenalistiscreatedorremo٠ved. Looksattthe`Defaultsv.py' lesforthev ariablesPOSTFIX ff ALIAS ff CMD)andsPOSTFIX ff MAP ff CMDcommand. MakgeVusureVvthesepointtoyourpostaliasandpostmapprogramsrespecti v٠elyY.Rememberthatifyouneedto makge changes,doitin`mm < ff 5=qcfg.py'. Run thebin/genaliasesscripttoinitializeyour`aliases' le. `%ffcd/usr/local/mailman`%ffbin/genaliases A䍑 Makgesurethattheo wnerofthe`data/aliases'and`data/aliasesv.db' leismailman,thatthegroupownerfor those lesismailman,orwhate v٠eruserandgroupyouusedinthecon gurecommand,andthatboth lesare group writable:`%ffsu `%ffchownmailman:mailmandata/aliases*`%ffchmodg+wdata/aliases* EK Hack yourPost x's8s`main.cf' letoincludethefollo wingpathinyouralias ff mapsvariable: ks/usr/local/mailman/data/aliases 6K Note~that}thereshouldbenotrailing.db.Donotincludethisinyouralias ff databasev ariable.Thisisbecause youdonotwgantPost x's8snewaliasescommandtomodifyMailman's8s`aliasesv.db' le,mbutyoudowgantPost x to consult`aliasesv.db'whenlookingforlocaladdresses. Ygou probablywganttouseahash:styledatabaseforthisentryY.Here's8sane٠xample: `alias_mapsff=hash:/etc/postfix/aliases,v@hash:/usr/local/mailman/data/aliases Eԍ When9youcon gureMailman,husethe--with-mail-gid=mailmanswitch;kthiswillbethe9defgaultifyoucon- guredR MailmanafterQaddingthemailmano wners8.Becausetheownerofthe`aliasesv.db'Q leismailman, Post x wille٠xecute Mailman's8swrapperprogramasuidandgidmailman.ǍThat's8sit!AOnecav٠eat:"whenyouaddorremovealist,vthe`aliasesv.db' lewillupdated,butitwillnotautomaticallyrunfpost xfreload.!Thisisbecauseyouneedtoberoottorunthisandsuid-rootscriptsarenotsecure.!Theonlye ectof thisisthatitwilltakgeaboutaminuteforPost xtonoticethechangetothe`aliasesv.db' leandupdateitstables. ffH 8_U6
SetǧupyourmailserLv er Yn>썍fdnVirf`tualǧdomainspōPost x2.0supports\virtualaliasdomains", essentiallywhatusedtobecalled\Post x-stylevirtualdomains"inearlier Post x3v٠ersions.p0T37omakgevirtualaliasdomainswork2withMailman,youneedtodosomesetupinbothPost xandMailman.j"MailmanEwillEwriteallvirtualaliasmappingstoa lecalled,vbydefgault,`/usr/local/mailman/data/vir\#tual-mailman'.It willalsousepostmaptocreatethevirtual-mailman.db lethatPost xwillactuallyuse.ǍFirst,youneedtosetupthePost xvirtualaliasdomainsasdescribedinthePost xdocumentation(seePost x's8svirtual(5)mչmanpage).Notethatit's8syourresponsibilitytoincludethevirtual-alias.domain anythingline2asdescribedmanpage;LvMailmanwillnotinclude2thislinein`vir\#tual-mailman'.Ygouarehighlyencouragedtomakgesure yourvirtualaliasdomainsarewgorkingproperlybeforeinte٠gratingwithMailman.Ne٠xt, addapathtoPost x's8svirtual ff alias ff maps v ariable,pointingtothevirtual-mailman le,e.g.: 2
virtual_alias_mapsff=<yournormalvirtualaliasfiles>,Ghash:/usr/local/mailman/data/virtual-mailman 8assumingkyou'v٠einstalledMailmaninthedefgaultlocation.Ifyou'reusinganolderv٠ersionofPost xwhichdoesn'thav٠e thevirtual ff alias ff maps v ariable,usethevirtual ff mapsvariableinstead.Ne٠xt,inayoura`mm < ff 5=qcfg.py' le,youwillawganttosetthev ariablePOSTFIX ff STYLE ff VIRTUAL ff DOMAINSutoathelistofivirtualidomainsthatMailmanshouldupdate.֬ThismaynotbeallofthevirtualaliasdomainsthatyourPost xinstallationsupports!Thev aluesinthislistwillbematchedag7ainstthehost ff nameattributeofmailinglistsobjects,and mustbeane٠xactmatch.Here's8s?ane٠xample.VSaythat?Post xiscon guredtohandlethevirtualdomainsdom1.ain,dom2.ain,anddom3.ain, andfurtherthatinyour`main.cf' leyou'v٠egotthefollo wingsettings:2
myhostnameff=mail.dom1.ain 2
mydomainff=dom1.ain2
mydestinationff=$myhostname,localhost.$mydomain2
virtual_alias_mapsff=Ghash:/some/path/to/virtual-dom1,Ghash:/some/path/to/virtual-dom2,Ghash:/some/path/to/virtual-dom2 dIf inyour`vir\#tual-dom1' le,you'v٠egotthefollo winglines:2
dom1.ain
IGNORE 2
@dom1.ainff@mail.dom1.ain -thistellsPost xtodeli v٠eranythingaddressedtodom1.aintothesamemailboxatmail.dom1.com,itsdefgaultdestination.InMthiscaseyouLwgouldnotincludedom1.aininPOSTFIX ff STYLE ff VIRTUAL ff DOMAINS becauseMotherwiseMailmanwill writeentriesformailinglistsinthedom1.aindomainas 2
mylist@dom1.ain0mylist2
mylist-request@dom1.ainffmylist-request2
#ffandsoon... CThe morespeci centriestrumpyourmoregeneralentries,thusbreakingthedeli v٠eryofanydom1.ainmailinglist.Ho wev٠er, youwgouldincludedom2.ainanddom3.ainin`mm < ff 5=qcfg.py': ffH 6.1
UsingǧthePost xmailserLv er19
5n>썍fdn썍 2
POSTFIX_STYLE_VIRTUAL_DOMAINSff=['dom2.ain','dom3.ain'] -No wY,~an٠y6listthatMailmancreatesineitherofthosetwgodomains,willhav٠ethecorrectentrieswrittento `/usr/local/mailman/data/vir\#tual-mailman'.ǍAsdabo٠vecwiththe`data/aliases*' les,uyouwganttomakgesurethatboth`data/vir\#tual-mailman'and`data/vir\#tual-mailman.db' areuserandgroupo wnedbymailman. PÍAnǧalter?nativ eapproachpōFil l@rezvo.nethasanalternati v٠eapproachbasedonvirtualmapsandregularexpressions,asdescribedat:Ǎ (French) http://listesv.rezo.net/comment.php (English) http://listesv.rezo.net/howu.phpThisisagood(andsimpler)alternati v٠eifyoudon'tmindexposinganadditionalhostnameinthedomainpartof theaddressespeoplewillusetocontactyourlist.I.e.ifpeopleshouldusemylist@lists.dom.aininsteadofmylist@dom.ain."PÍ6.2 UsingUtheEximmailser\#v3erNote:Thissectionisderi v٠edfromNigelMetheringham's8s\HOgWTOr-UsingEximandMailmantogether",@ whichco٠vers_Mailman2.0.xand`Exim3.%Ithasbeenupdatedtoco٠ver_Mailman2.1andExim4.%Theoriginaldocumentishere:http://wwwu.exim.org/hovwto/mailman.html .ǍTheret*ist)noMailmancon gurationneededotherthanthestandardoptionsdetailedintheMailmaninstalldocumenta-tion. TheEximcon gurationistransparenttoMailman. TheuserandgroupsettingsforMailmanmustmatchthosein thecon gfragmentsgi v٠enbelowY. PÍEximǧcon gurgationTheqEximpcon gurationisbuiltsothatalistcreatedwithinMailmanautomaticallyappearstoEximwithouttheneedfor de ningan٠yadditionalaliases.ǍThendra٠wbacknofthiscon gurationisthatitwillwgorkpoorlyonsystemssupportinglistsinse v٠eraldi erentmaildomains.While=Mailman=handlesvirtualdomains,K-itdoesnotyetsupporthavingtwgodistinctlistswiththesamenameinudi erenttvirtualdomains,usingthesameMailmaninstallation.4Thiswille v٠entuallychange.4(Butseebelo wforav ariation onthisschemethatshouldaccommodatevirtualdomainsbetters8.)Thecon guration lee٠xcerptsbelo wareforuseinanalreadyfunctionalEximcon guration,2whichacceptsmailforthedomain inwhichthelistresides.KIfthisdomainisseparatefromtheothershandledbyyourEximcon guration,then you'gllneedto:Ǎ add thelistdomain,\myY.list.domain"tolocal ff domains add a\domains=myY.list.domain"optiontothedirector(router)forthelist (optional) e٠xcludethatdomainfromyourotherdirectors(routers)Note: The90instructionsinthisdocument9/shouldwgorkwitheitherExim3orExim4.E'InExim3,g|youmusthav٠ea local ff domains dcon gurationsetting;@inExim4, }youmostlikgelyhav٠e ealocal ff domainsdomainlist.Ifyoudon't, }you ffH 10_U6
SetǧupyourmailserLv er n>썍fdn썹probablyjkno wwhatjyou'redoingandcanadjustaccordinglyY.ڄSimilarly,injExim4theconceptof\directors"has disappearedv{thereareuonlyroutersno wY.Soifyou'reusingExim4,BSwhene v٠erthisdocumentsays\director",BSread\router".ǍWhether-you,areusingExim3orExim4,8youwillneedtoaddsomemacrostothemainsectionofyourEximcon g le.Ygouwillalsoneedtode neonene wtransport.WithExim3,you'gllneedtoaddane wdirector;withExim4,ane w routerplaysthesamerole.FinallyY,theicon gurationsuppliedhereshouldallo wco-habitingMailman2.0and2.1installations,withthepro٠visothat you'gllprobablywanttousemm21inplaceofmailman{e.g.,MM21 ff HOME:߹,mm21 ff tr٠ansport.,etc. PÍMainǧcon gurgationsettingspōFirst,Ryou]needto]addsomemacrostothetopofyourEximcon g le.+Thesejustmakgethedirector(router)andtransport1belo w1abitcleaners8.Ob٠viouslyY,Ayou'gllneedtoeditthesebasedonho wyoucon guredandinstalledMailman. 2
#ffHomedirforyourMailmaninstallation--akaMailman'sprefix2
#ffdirectory.2
MAILMAN_HOME=/usr/local/mailman2
MAILMAN_WRAP=MAILMAN_HOME/mail/mailman2
#ffUserandgroupforMailman,shouldmatchyour--with-mail-gid2
#ffswitchtoMailman'sconfigurescript.2
MAILMAN_USER=mailman2
MAILMAN_GROUP=mailman ҍTrgansporf`tǧf7orExim3pōAdd thistothetransportssectionofyourEximcon g le,i.e.some wherebetweenthe rstandsecond\end"line: '@mailman_transport:2
driverff=pipe2
commandff=MAILMAN_WRAP\h
{'${ifffdef:local_part_suffix\ s{${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}}ff\ s{post}}'ff\h
{$local_part2
current_directoryff=MAILMAN_HOME2
home_directoryff=MAILMAN_HOME2
userff=MAILMAN_USER2
groupff=MAILMAN_GROUP ҍDirectorǧf7orExim3If9you're8usingExim3,you'gllneedtoaddthefollo wingdirectortoyourcon g le(directorsgobetweenthesecond andJthird\end"Klines).vAlso,don'tforgetKthatordermatters{e.g.vyoucanmakgeMailmanliststakgeprecedenceo٠versystem aliasesbyputtingthisdirectorinfrontofyouralias ledirector,orvice-v٠ersa. ffH 6.2
UsingǧtheEximmailserLv erʢ11 n>썍fdn썍 '@#ffHandlealladdressesrelatedtoalist'foo':thepostingaddress.'@#ffAutomaticallydetectslistexistencebylooking'@#ffforlists/$local_part/config.pckunderMAILMAN_HOME.'@mailman_director:2
driverff=smartuser2
require_filesff=MAILMAN_HOME/lists/$local_part/config.pck2
suffix_optional2
suffixff=-bounces:-bounces+*:\b-confirm+*ff:-join:-leave:\b-ownerff:-request:-admin2
transportff=mailman_transport Routerǧf7orExim4pōInExim4,\there's8snosuchthingasdirectors{youneedtoaddane wrouterinstead.Also,]thecanonicalorderofthe con guration lewgaschangedsorouterscomebeforetransports,GsotherouterforExim4comes rsthere.`Putthisrouter some whereafterthe\be٠ginrouters"lineofyourcon g le,andrememberthatordermatters.Ǎ '@mailman_router:2
driverff=accept2
require_filesff=MAILMAN_HOME/lists/$local_part/config.pck2
local_part_suffix_optional2
local_part_suffixff=-admin:-bounces:-bounces+*:\
w-confirmff:-confirm+*:\
w-joinff:-leave:\
w-ownerff:-request:\
w-subscribeff:-unsubscribe2
transportff=mailman_transport Trgansporf`tsǧf7orExim4ThestransportrforExim4isthesameasforExim3(see6.2;,justcopgythetransportgi v٠enabovetorsome whereunderthe \be٠gintransports"lineofyourEximcon g le. FAdditionalǧnotesExim?should?becon guredtoallo wreasonablevolume{e.g.Xvdon'tsetmax ff rGecipientsdo wntoasillyv alue{andwithnormalde٠greesofsecurity{speci callyY,besuretoallo wrelayingfrom127.0.0.1,butprettymuchnothingelse.P٠arallelgdeli veriesgandothertweakscanalsobeusedifyoulikge;oe٠xperimentwithyoursetuptoseewhatwgorks.Delaywgarning3{messagesshouldbeswitchedo orcon gured3|toonlyhappenfornon-listmail,Bunlessyoulikerecei vingtonsof mailwhensomerandomhostisdo wn. FProblems MailmanXwillsendasman٠yMAIL FROM/RCPTTOXasXitneeds.tItmayresultinmorethan10or100mes- sageshsentinoneconnection,;whichwille٠xceedthedefgaultv alueofExim's8ssmtp ff accept ff queue ff per ff connec- tionGv alue.pThisisbadbecauseitwillcauseEximtoswitchintoqueuemodeandsev٠erelydelaydeliv٠eryof yourClistmessages.e]ThewgayCto xthisistosetMailman's8sSMTP ff MAX ff SESSIONS ff PER ff CONNECTIONR(in `$prGe x/Mailman/mm ff cfg.p7y') toasmallerv aluethanExim's8ssmtp ff accept ff queue ff per ff connection. ffH 12_U6
SetǧupyourmailserLv er
ʵn>썍fdn썍 Mailman&should%ignoreEximdelaywgarningmessages,Qe v٠enthoughEximshouldne v٠ersendthistolistmessages. MailmanRG2.1's8sRHgeneralbouncedetectionandVERPRsupportshouldgreatlyimpro٠veRGthebouncedetector's8shit rates. Listy)e٠xistenceisdeterminedbytheexistencey(ofa`con g.pck' leforalist.PIfyoudeletelistsbyfoulmeans,zbe a٠wgare ofthis. IfLyouLaregettingEximorMailmancomplainingaboutuseridswhenyousendmailtoalist,checkthatthe MAILMAN ff USER\and\MAILMAN ff GROUPmatch\those\ofMailmanitself(i.e.
whatwereusedinthecon gure script).Also makgesureyoudonothav٠ealiasesinthemainalias leforthelist. PÍReceiv erǧV37er&_i cationpōExim's8sq recei v٠erveri cationfeatureq isveryuseful{itletsEximrejectq unrouteableaddressesatSMTPqtime.Ho wever,thisqisqmostusefulfore٠xternally-originatingmailthatisaddressedtomailinoneofyourlocaldomains.F٠orMailmanlist>Xtrac,Kzmailoriginateson>Yyourserv٠er,andisaddressedtorandom>Ye٠xternaldomainsthatarenotunderyourcontrol.Furthermore,Yeach.8message.9isaddressedtoman٠yrecipients{upto500ifyouuseMailman's8sdefgaultcon gurationand don'ttweakSMTP ff MAX ff RCPTSx.ǍDoing_#recei v٠er_"veri cationonMailmanlist_"tracisarecipefortrouble. Inparticular,Eximwillattempttoroutee v٠eryBrecipientBaddressesinoutgoingMailmanlistposts.aEv٠enthoughthisrequiresnothingmorethanafe wDNSlookupsforeachaddress,itcanstillintroducesigni cantdelays.Therefore,youshoulddisablerecipientv٠eri cationfor Mailmantrac.Under Exim3,putthisinyourmaincon gurationsection: 2
receiver_verify_hostsff=!127.0.0.1 -UnderExim4, thisisprobablyalreadytakgencareofforyoubythedefgaultrecipientv٠eri cationACLstatement(inthe RCPT TOACL): '@accept
domains%=ff+local_domainsRsendpassRsmessage%=ffunknownuserRsverify+30=ffrecipient Nwhichonlydoesrecipientv٠eri cationonaddressesinyourdomain.(That's8snotexactlythesameasdoingrecipientv٠eri cation onlyonmessagescomingfromnon-127.0.0.1hosts,butitshoulddothetrickforMailman.) PÍSMTPǧCallbackpōExim's8s<SMTP<callback<featureisane v٠enmorepo werfulwgaytodetectbogussenderaddressesthannormalsenderv٠eri cation.(UnfortunatelyY,[lots/ofserverssendbouncemessageswithabogusaddressintheheader,[andthereareplentyMthatNsendbounceswithbogusenv٠elopesenders(e venNthoughthey'resupposedNtojustuseanemptyenv٠elopesender forbounces).In#order#toensurethatMailmancandisable/remo٠ve#bouncingaddresses,Lyougenerallywganttorecei v٠ebouncesforMailmanblists,e v٠enaifthosebouncesarethemselv٠esnotbounceable.)Thus,youmightwganttodisableSMTP`callbackon bouncemessages.With Exim4,youcanaccomplishthisusingsomethinglikgethefollo winginyourRCPT TOACL: ffH 6.2
UsingǧtheEximmailserLv erʢ13 גn>썍fdn썍 '@#ffAcceptbouncestolistsevenifcallbacksorothercheckswouldfail'@warnmessage fd=ffX-WhitelistedRCPT-nohdrfromcallback:YesWIcondition=ff\WI${ifffand{{match{$local_part}{(.*)-bounces\+.*}}\ E{existsff{MAILMAN_HOME/lists/$1/config.pck}}}\rG{yes}{no}}'@accept32condition=ff\WI${ifffand{{match{$local_part}{(.*)-bounces\+.*}}\ E{existsff{MAILMAN_HOME/lists/$1/config.pck}}}\rG{yes}{no}}'@#ffNow,checksenderaddresswithSMTPcallback.'@deny32!verifyff=sender/callout=90s If youalsodoSMTPcallbacksonheaderaddresses,you'gllwantsomethinglikethisinyourDATAACL:Ǎ '@deny32!conditionff=$header_X-WhitelistedRCPT-nohdrfromcallback:M
}!verifyff=header_sender/callout=90s GVDoingǧVERPwithEximandMailmanpōVERP|willsendoneemail,Ӳwithaseparateenv٠elopesender(returnpath),foreachofyoursubscribers{readthe information"in`$prGe x/Mailman/Def7aults٠.py'#for"theoptionsthatstartwithVERP.Inanutshell,allyouneedtodoto enableVERPwithEximistoaddtheselinesto`$prGe x/Mailman/mm ff cfg.p7y': 2
VERP_PASSWORD_REMINDERSff=Yes2
VERP_PERSONALIZED_DELIVERIESff=Yes2
VERP_DELIVERY_INTERVALff=Yes2
VERP_CONFIRMATIONSff=Yes N(The director(router)abo٠ve issmartenoughtodealwithVERPbounces.) PÍVirf`tualǧDomainspōOneEcapproachtoEbhandlingvirtualdomainsistouseaseparateMailmaninstallationforeachvirtualdomain.CurrentlyY,this istheonlywgaytohav٠elistswiththesamenameindi erentvirtualdomainshandledbythesamemachine.In&thiscase,ptheMAILMAN ff HOMEandMAILMAN ff WRAPmacrosare'useless{youcanremo٠ve&them. Changeyourdirector (router)tosomethinglikgethis: '@require_filesff=/virtual/${domain}/mailman/lists/${lc:$local_part}/config.pck -and changeyourtransportlikgethis: ffH 14_U6
SetǧupyourmailserLv er fn>썍fdn썍 '@commandff=/virtual/${domain}/mailman/mail/mailman\]@${ifffdef:local_part_suffix\x@{${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}}x@{post}}ff\h
{$local_part'@current_directoryff=/virtual/${domain}/mailman'@home_directoryff=/virtual/${domain}/mailman ~ListǧV37er&_i cationpōThisGisho wasetofaddressFtestsfortheEximlistslookonawgorkingsystem.lThelistinquestionisquixote- users@mems-exchangev.org,andthesecommandswererunonthemems-exchange.orgmailserv٠er("%"indi-cates theUnixshellprompt):Ǎ '@%ffexim-btquixote-users'@quixote-users@mems-exchange.org2
routerff=mailman_main_router,transport=mailman_transport'@%ffexim-btquixote-users-request'@quixote-users-request@mems-exchange.org2
routerff=mailman_router,transport=mailman_transport'@%ffexim-btquixote-users-bounces'@quixote-users-bounces@mems-exchange.org2
routerff=mailman_router,transport=mailman_transport'@%ffexim-btquixote-users-bounces+luser=example.com'@quixote-users-bounces+luser=example.com@mems-exchange.org2
routerff=mailman_router,transport=mailman_transport ǔIfyourexim-btoutputlookssomethinglikgethis,athat's8sastart:@atleastitmeansEximwillpasstherightmessagestothe2rightMailmancommands.It2bynomeansguaranteesthatyourExim/MailmaninstallationisfunctioningperfectlyY,though! DocumentǧHistorLyOriginallyMwrittenbyNigelMMetheringhampostmaster@exim.org. UpdatedbyMarcMerlinmarc < ff 5=qsoft@mer"linsv.orgfor Mailman2.1,Exim4.Ov٠erhauled/reformatted/clari ed/simpli edbyGregW37ardgwvard@python.net.!썍6.3 UsingUtheSendmailmailser\#v3erGcOʸ He
e
ϸ͍ WYar٠ning:
UYgou:maybetemptedtosettheDELIVERY ff MODULEu6con guration:v ariablein`mm < ff 5=qcfg.py'to 'Sendmail'ݹwhenusingtheSendmailmailserv٠ers8.<0Don't.</The`Sendmail.py'moduleismisnamed{it's8s really{acommand|linebasedmessagehando schemeasopposedtotheSMTPsschemeusedin`SMTPDirect.py' (the^defgault).`Sendmail.py'haskno wnsecurity^holesandispro٠videdasaproof-of-conceptonly^/Kj
ptmri7ta .Ifyouare havingproblemsusing`SMTPDirect.py' xthoseinsteadofusing`Sendmail.py',oryoumayopenyoursystem up tosecuritye٠xploits. ff @
h-:0Kj
ptmri7tafhIn fact,inlatervMersionsofMailman,thismoduleisexplicitlysabotaged.zY ouha
vetoknowwhatyou'redoinginordertore-enableit.H e
H3G ffH 6.3
UsingǧtheSendmailmailserLv erʢ15 ︠n>썍fdnSendmailǧ\smrsh"compatibilitypōMan٠y(Zne werversionsof(YSendmailcomewitharestrictedexecution(Yutilitycalled\smrsh",9whichlimitstheexecutables thatSendmailwillallo wtobeusedasmailprograms.(9Ygouneedtoe٠xplicitlyallo wMailman's8swrapperprogramtobeusedwithsmrshorMailmanwillnotwgork.!EIfmailisnotgettingdeli v٠eredtoMailman's8swrapperprogramandyou'regetting an\operatingsystemerror"inyourmailsyslog,thiscouldbeyourproblem.ǍOne goodwgayofenablingthisis:Ǎ Find outwhereyourSendmaile٠xecutes itssmrshwrapper v@%ffgrepsmrsh/etc/mail/sendmail.cf :䍍 Figureoutwheresmrshe٠xpectssymlinksforallo wgablemailprograms.Atthev٠erybeginningofthefollo wing output youwillseeafullpathtosomedirectoryY,e.g.`/vfar/adm/sm.bin'orsimilar: v@%ffstrings$path_to_smrsh|less :䍍 cd1into`/vfar/adm/sm.bin',}orwheree v٠er2ithappenstoresideonyoursystem{alternativ٠esinclude`/etc/smrsh', `/vfar/smrsh' and`/usr/local/smrsh'. v@%ffcd/var/adm/sm.bin :䍍 Create asymboliclinktoMailman's8swrapperprogram: v@%ffln-s/usr/local/mailman/mail/mailmanmailman G{InteggratingǧSendmailandMailmanpōDavid\Champion\hascontributed\arecipeformorecloselyinte٠gratingSendmailandMailman,suchthatSendmailwillgautomaticallyrecognizeganddeli v٠ertonewmailingglistsasthe٠yarecreated,lwithouthavingtomanuallyeditaliastables.ǍIn the`contr"ib'directoryofMailman's8ssourcedistribution,youwill ndfour les:Ǎ `mm-handler.readme' -ane٠xplanationofho wtosetev٠erythingup `mm-handler' -themaildeli v٠eryagent(MDA) `mailman.mc' -atogycon guration lesample `vir\#tusertable' -asampleforRFC2142addresse٠xceptions ffH 16_U6
SetǧupyourmailserLv er On>썍fdnPerf7or?manceǧnotespōOneofthesurestperformancekillersforSendmailusersiswhenSendmailiscon guredtosynchronouslyv٠erifythe recipient's8swhostviaDNS.IfitdoesvthisformessagespostedtoitfromMailman,#youwillgethorribleperformance.SinceMailmanusuallyconnectsvialocalhost(i.e.127.0.0.1)totheSMTPportofSendmail,youshouldbesureto con gureSendmailtonotdoDNSv٠eri cationsynchronouslyforlocalhostconnections.![6.4 UsingUtheQmailmailser\#v3erTherec`arecasomeissuesthatusersoftheqmailmailtransportagenthav٠eencountered.
Noneofthecoremaintainersuseqmail,soתallofthisinformationhasbeencontributedbytheMailmanusercommunityY,especiallyMartinPreishuberand ChristianTgismer,withnotesbyBalazsNagy(BN)andNorbertBollo w(NB). ( YgouCmightCneedtosetthemail-gidusertoeitherqmail,O@mailman,ornofilesCbyusingthe--with-mail-gid con gure option.D BN:ɹithighlydependsonyourmailstoringpolic٠yY.uForexampleifyouusethesimple`~alias/.qmail-*' les,{you can use`id-galias`.Butifyouuse`/vfar/qmail/users',thespeci edmailgidcanbeused. Iffyouaregoingtofbedirectingvirtualdomainsdirectlytothemailmanuser(using\virtualdomains"ona list-onlydomain,rfore٠xample),youwillhav٠etouse--with-mail-gid=gidofmailmanuser'sgroup.iThisis incompatible withhavinglistaliasesin`~alias',unlessthataliassimplyforwgardstomailman-listname*. If=:there=;isausermailmanonyoursystem,lthealiasmailman-ownerwillwgorkonlyin`~mailman'.QGYgou hav٠e todoatouch.qmail-ogwnerin`~mailman'directorytocreatethisalias. NB:*An*alternati v٠e,UIMHO*bettersolutionistochogwnroot~mailman,Uthatwillstopqmailfromconsidering mailman tobeausertowhommailcanbedeli v٠ered.(See\man8qmail-getpw".) InLaLrelatedissue,Vifyouhav٠eanyLuserswiththesamenameasoneofyourmailinglists,Vyouwillhav٠eproblems iflistnamescontain`-'inthem.EPutting`.qmail'redirectionsintotheuser's8shomedirectorydoesn'twgork becausetheMailmanwrapperswillnotgetspa٠wnedwiththeproperGID.Thesolutionistoputthefollo wing lines inthe`/vfar/qmail/users/assign' le: @@+zope-:alias:112:11:/var/qmail/alias:-:zope-:@@. 6ō where inthiscasethelistnameise.g.zope-users. NB:Alternati v٠elyY,7youcouldhostthelistsonavirtualdomain,7andusethe`/vfar/qmail/control/vir\#tualdomains' le toputthemailmanuserinchargeofthisvirtualdomain. BN:If inbound messagesaredeli v٠eredbyanotheruserthanmailman,^it's8snecessarytoallo wittoaccess `~mailman'.Be surethat`~mailman'hasgroupwritingaccessandsetgidbitisset.Thenputthedeli v٠eringuser to]mailman]group,dandyoucanden٠yaccessto`~mailman'toothers.<Besurethatyoucandothesamewiththe WWW service.Dፑ Bythewgaythebestthingistomakeavirtualmailserv٠ertohandleallofthemail.
@NB:E.g. makgelankadditional"A"DNSrecordforthevirtualmailserv٠erpointingtoyourIPaddress,addthe linelists.kva.hu:mailmanto`/vfar/qmail/control/vir\#tualdomains'andalists.kva.hulineto `/vfar/qmail/control/rcpthosts'~ le.Don'tforgettoHUPmtheqmail-sendaftermodifying\virtualdomains".Then e v٠ery mailtolists.kva.huwillarriv٠etomail.kva.hu's8smailmanuser. Then makgeyouraliases: ks.qmailK=>ffmailman@...'slettersks.qmail-owner+30=>ffmailman-owner'sletters ffH 6.4
UsingǧtheQmailmailserLv erʢ17 n>썍fdn썑 F٠or listaliases,youcaneithercreatethemmanually: ks.qmail-list0=>ffpoststothe'list'listks.qmail-list-admin32=>ffpoststothe'list'sownerks.qmail-list-requestff=>requeststo'list'ksetc L䍑 ornformautomaticlistaliashandling(whenusingthelists.kv a.huvirtualasabo٠ve),seen`contr"ib/qmail-to- mailman.py' intheMailmansourcedistribution.Modifythe`~mailman/.qmail-default'toinclude: ks|prelineff/path/to/python/path/to/qmail-to-mailman.py +䍑 and ne wlistswillautomaticallybepickgedup. Ygouhav٠etomakgesurethatthelocalhostcanrelayY.ЏIfyoustartqmailviainetdandtcpenvY,<youneedsomeline the follo winginyour`/etc/hostsv.allow' le: UMtcp-env:ff127.10.205.200.:setenvRELAYCLIENT +䍑 whereb10.205.200.isbyourIPbaddressblock.Ifyoubusetcpserv٠er,hthenyouneedsomethinglikgethefollo wingin your `/etc/tcp].smtp' le: UM10.205.200.:allow,RELAYCLIENT=""UM127.:allow,RELAYCLIENT="" :䍍 BN:CBigger`/vfar/qmail/control/concurrencyremote'Dv alueswgorkbettersendingoutboundmessages,withinrea- son.S7Unless=you=kno wyoursystemcanhandleit(man٠yifnotmostcannot)thisshouldnotbesettoav alue greater than120. More informationaboutsettingupqmailandrelayingcanbefoundintheqmaildocumentation.ǍBN:TLastbutnotleast,(here's8salittlescripttogeneratealiasestoyourlists(ifSforsomereasonyoucan/willnothav٠ethem automaticallypickgedupusing`contr"ib/qmail-to-mailman.py'):ǍThis scriptisfortheMailman2.0series: s#!/bin/sh sifff[$#=1];then2
i=$12
echoffMakinglinksto$iinthecurrentdirectory...2
echoff"|preline/home/mailman/mail/mailmanpost$i">.qmail-$i2
echoff"|preline/home/mailman/mail/mailmanmailowner$i">.qmail-$i-admin2
echoff"|preline/home/mailman/mail/mailmanmailowner$i">.qmail-$i-owner2
echoff"|preline/home/mailman/mail/mailmanmailowner$i">.qmail-owner-$i2
echoff"|preline/home/mailman/mail/mailmanmailcmd$i">.qmail-$i-request sfi Note: 賹Thismaism`forane wMailman2.1installation.UsersupgradingfromMailman2.0wgouldmostlikgelychange`/usr/local/mailman'?to@`/home/mailman'. UIfindoubt,refertothe--pre xoptionpassedtocon gureduringcompiletime. ffH 18_U6
SetǧupyourmailserLv er cn>썍fdn썍 s#!/bin/sh sifff[$#=1];then2
i=$12
echoffMakinglinksto$iinthecurrentdirectory...2
echoff"|preline/usr/local/mailman/mail/mailmanpost$i">.qmail-$i2
echoff"|preline/usr/local/mailman/mail/mailmanadmin$i">.qmail-$i-admin2
echoff"|preline/usr/local/mailman/mail/mailmanbounces$i">.qmail-$i-bounces2
#ffThefollowinglineisforVERP2
#ffecho"|preline/usr/local/mailman/mail/mailmanbounces$i">.qmail-$i-bounces-default2
echoff"|preline/usr/local/mailman/mail/mailmanconfirm$i">.qmail-$i-confirm2
echoff"|preline/usr/local/mailman/mail/mailmanjoin$i">.qmail-$i-join2
echoff"|preline/usr/local/mailman/mail/mailmanleave$i">.qmail-$i-leave2
echoff"|preline/usr/local/mailman/mail/mailmanowner$i">.qmail-$i-owner2
echoff"|preline/usr/local/mailman/mail/mailmanrequest$i">.qmail-$i-request2
echoff"|preline/usr/local/mailman/mail/mailmansubscribe$i">.qmail-$i-subscribe2
echoff"|preline/usr/local/mailman/mail/mailmanunsubscribe$i">.qmail-$i-unsubscribe sfi ҍInf7or?mationǧonVERPpōYgou
willnotein
thealiasgeneratingscriptfor2.1abo٠ve,-Cthere
isalineforVERP
ythathasbeencommentedout.lIf youc<arec;interestedinVERPc4therearetwgooptions.The rstoptionistoallo wMailmantodotheVERPc5formatting.T37oacti vate this,uncommentthatlineandaddthefollo winglinestoyour`mm < ff 5=qcfg.py' le:Ǎ 2
VERP_FORMATff='%(bounces)s-+%(mailbox)s=%(host)s'2
VERP_REGEXPff=r'^(?P<bounces>.*?)-\+(?P<mailbox>[^=]+)=(?P<host>[^@]+)@.*$' 8The secondoptionisapatchonSourceF٠orgelocatedat:http://sourceforgev.net/tracker/?func=detail&atid=300103&aid=645513&group < ff 5=qid=103Thispatchcurrentlyneedsmoretestingandmightbestbesuitableforde v٠elopersorpeoplewellfgamiliarwithqmail. Having saidthat,thispatchisthemoreqmail-friendlyapproachresultinginlargeperformanceg7ains. PÍVirf`tualǧmailserLv erAs mentionedinthe6.4sectionforavirtualmailserv٠er,apatchundertestingislocatedat:http://sf.net/tracker/index.php?func=detail&aid=621257&group < ff 5=qid=103&atid=300103Ag7ain, thispatchisforpeoplefgamiliarwiththeirqmailinstallation. PÍMoreǧinf7or?mationYgou2=might2>beinterestedinsomeinformationonmodifyingfootersthatNorbertBollo whaswrittenaboutMailman and qmail,av ailablehere:http://mailman.cisv.to/qmail-vferh/ ffH 6.4
UsingǧtheQmailmailserLv erʢ19 "n>썍fdnύ7hReovieJw yoursitedefoaults
_MailmanNhasMalargenumberofsite-widecon gurationoptionswhichyoushouldno wreviewMandchangeaccording toyyourxneeds.Someoftheoptionscontrolho wMailmaninteractswithyourenvironment,:andotheroptionsselectdefgaults forne wlycreatedlists^4 .Therearesystemtuningparametersandinte٠grationoptions.ǍThefullsetofsite-widedefgaultsli v٠esinthe`$prGe x/Mailman/Def7aults٠.py' le,
ho weveryoushouldnevgermodifythisyL le!{Instead,changethe`mm < ff 5=qcfg.py'yK leinthatsamedirectoryY.|Ygouonlyneedtoaddv aluesto`mm < ff 5=qcfg.py'thatuaretdi erentthanthedefgaultsin`Defaultsv.py',andufutureMailmanupgradesareguaranteedne v٠ertotouchyour`mm < ff 5=qcfg.py' le.TheQ`Defaultsv.py'P leisdocumentede٠xtensi velyY,dsothePoptionsarenotdescribedhere.vThe`Defaultsv.py'Pand`mm < ff 5=q-cfg.py' arebothPython lessov alidPythonsyntaxmustbemaintainedoryourMailmaninstallationwillbreak.Note:@Do0not0changetheHOME ff DIR0VorMAILMAN ff DIR0Vv ariables.+$These0aresetautomaticallybythecon gurescript, andyouwillbreakyourMailmaninstallationbyifyouchangethese.Ygou shouldmakgean٠ychangesto`mm < ff 5=qcfg.py'usingtheaccountyouinstalledMailmanunderinthe14section.'pÍ8hCreate asite-widemailinglist
_Afteryouhav٠ecompletedtheintegrationofMailmanandyourmailserv٠er,youneedtocreatea\site-wide"mailinglist. This!istheonethatpasswgordreminderswillappeartocome!from,4oanditisrequiredforproperMailmanoperation.UsuallyfBthisfAshouldbealistcalledmailman,khbutifyouneedtochangethis,khbesuretochangetheMAILMAN ff SITE ff -LISTEv ariable in`mm < ff 5=qcfg.py'.Ygoucancreatethesitelistwiththiscommand,followingtheprompts: 2
%ffbin/newlistmailman -No w-con gure,yoursitelist.U Thereisaconv٠enienttemplateforagenericsitelistintheinstallationdirectoryY,xunder`data/sitelist.cfg'whichcanhelpyouwiththis.Ygoushouldre viewthecon gurationoptionsinthetemplate,butnotethat an٠yoptionsnotnamedinthe`sitelist.cfg' lewgon'tbechanged.The templatecanbeappliedtoyoursitelistbyrunning: 2
%ffbin/config_list-idata/sitelist.cfgmailman -After applyingthe`sitelist.cfg'options,besureyoure view thesitelist's8scon gurationviatheadminpages.Ygou shouldalsosubscribeyourselftothesitelist.'pÍ9hSet upcron
_Se v٠eralMailmanfeaturesoccuronare٠gularschedule,soyoumustsetupcrontoruntherightprogramsattherighttime^5 .Ifgmyourglv٠ersionofcrontabsupportsthe-uoption,lWyoumustberoottodothisne٠xtstep.gAdd`$prGe x/cron/crontab.in'as acrontabentrybye٠xecuting thesecommands: ff - 荍
h-:4fhInhgeneral,*changingthelistdefaultsdescribedinhthissectionwillnota ectanMyalreadycreatedlists.T\,omakechangesafteralisthasbeen created, usethewebinterfaceorthecommandlinescripts,suchas1ߌ
ptmb7tbin/withlistandbin/con gz ff fhHlist. 鍍
h-:5fhNotefthatgifyou'reupgradingfromapreviousvMersionofMailman,you'llwantftoinstallthenewcrontab,b
utbecarefulifyou'rerunningmultiple Mailmaninstallationsonyoursite!zChangingthecrontabcouldmesswithotherparallelMailmaninstallations. ffH 20K9
Setǧupcron .n>썍fdn썍 2
%ffcd$prefix/cron2
%ffcrontab-umailmancrontab.in 8Ifsyourusedthe--with-user٠nameoption,usethatusernameinsteadofmailmanforthe-uargumentv alue.Ifyour crontab doesnotsupportthe-uoption,trythesecommands:Ǎ 2
%ffcd$prefix/cron2
%ffsu-mailman2
%ffcrontabcrontab.in W
10 iStar kt theMailmanqr7Bunner
_Mailmandependsonaprocesscalledthe\qrunner"todeli v٠eryallemailmessagesitsees.I'Ygoumuststarttheqrunnerby e٠xecutingthefollo wingcommandfromthe$prGe xdirectory: 2
%ffbin/mailmanctlstart -YgousprobablywgantstostartMailmane v٠erytimeyourebootyoursystem.Exactlyho wtodothisdependsonyouroperating*system.Ifyour)OS supportsthechkcon gcommand(e.g.RedHatand)MandrakgeLinux٠es)youcandothefollo wing (asroot,fromtheMailmaninstalldirectory): 2
%ffcpscripts/mailman/etc/init.d/mailman2
%ffchkconfig--addmailman 8Note that`/etc/init.d'maybe`/etc/rc.d/init.d'onsomesystems.On GentooLinux,youcandothefollo wing: 2
%ffcpscripts/mailman/etc/init.d/mailman2
%ffrc-updateaddmailmandefault On Debian,youprobablywganttouse: 2
%ffupdate-rc.dmailmandefaults -F٠or Unixesthatdon'tsupportchkcon g,youmighttrythefollo wingsetofcommands: ffH ʢ21 ?n>썍fdn썍 2
%ffcpscripts/mailman/etc/init.d/mailman2
%ffcpmisc/mailman/etc/init.d2
%ffcd/etc/rc.d/rc0.d2
%ffln-s../init.d/mailmanK12mailman2
%ffcd../rc1.d2
%ffln-s../init.d/mailmanK12mailman2
%ffcd../rc2.d2
%ffln-s../init.d/mailmanS98mailman2
%ffcd../rc3.d2
%ffln-s../init.d/mailmanS98mailman2
%ffcd../rc4.d2
%ffln-s../init.d/mailmanS98mailman2
%ffcd../rc5.d2
%ffln-s../init.d/mailmanS98mailman2
%ffcd../rc6.d2
%ffln-s../init.d/mailmanK12mailman
11 iChecJk thehostnamesettings
_Ygoujshouldcheckthev aluesforDEF٠AULT ff EMAIL ff HOST/andjDEFAULT ff URL ff HOST/inj`Defaultsv.py'.Makgean٠y necessaryhchangeshinthe`mm < ff 5=qcfg.py' le,menotinthe`Defaultsv.py'h le.Ifyouchangeeitherofthesetwgov alues,mdyou'llwgant toaddthefollo wingafterwardsinthe`mm < ff 5=qcfg.py' le:Ǎ 2
add_virtualhost(DEFAULT_URL_HOST,ffDEFAULT_EMAIL_HOST) -Ygou willwganttorunthebin/ x ff url.pytochangethedomainofan٠yexistinglists.'pÍ12 iCreate thesitepassow$ordThere[aretwgosite-widepasswordsthatZyoucancreatefromthecommandline,usingthebin/mmsitepassscript.PThe rstQisRthe\sitepasswgord"whichcanbeusedan٠ywhereapasswgordisrequiredinthesystem.ThesitepasswgordwillgetRyouRintotheadministrationpageforan٠ylist,kanditcanbeusedtologinasan٠yusers8.ThinkrootforaUnixsystem, sopickthispasswgordwisely!ǍTheksecondpasswgordkisasite-wide\listcreator"passwgord.Ygoucanusethistodele٠g7atetheabilitytocreatene wmailinglistswithoutpro٠vidingallthepri vile٠gesofthesitepasswgord.0?Ofcourse,theo wnerofthesitepasswgordcanalso createne wmailinglists,butthelistcreatorpasswgordislimitedtojustthatspecialrole.T37o setthesitepasswgord,usethiscommand: 2
%ff$prefix/bin/mmsitepass<your-site-password> -T37o setthelistcreatorpasswgord,usethiscommand: 2
%ff$prefix/bin/mmsitepass-c<list-creator-password> It isokaynottosetalistcreatorpasswgord,butyouprobablydowantasitepassword. ffH 22Ro12
Createǧthesitepass7wgord FMn>썍fdn.̍13 iCreate yJour rstmailinglist
_F٠or5moredetailedinformationabout5usingMailman,Dincludingcreatingandcon guringmailinglists,DseetheMailman List*AdminstrationManual.Theseinstructionspro٠videaquick*guidetocreatingyour rstmailinglistviathewebinterfgace:wC Start byvisitingtheurlhttp://my.dom.ain/mailman/create. Fillqouttheformasdescribedrintheon-screeninstructions,Mandinthe\Listcreator's8spasswgord" eld,Mtypethe passwgordGyouenteredFinsection7.lT37ypeyouro wnemailaddressforthe\Initiallisto wneraddress",Xandselect \Yes" tonotifythelistadministrators8. Click onthe\CreateList"button. Check youremailforamessagefromMailmaninformingyouthatyourne wmailinglistwgascreated. No wtvisitsthelist's8sadministrationpage,eitherbyfollo wingthelinkonthecon rmationwebpageor clicking1onthelinkfrom1theemailMailmanjustsentyou. .TT37ypicallytheurlwillbesomethinglikge http://my.dom.ain/mailman/admin/mylist. T37ype inthelist's8spasswgordandclickon\Letmein...L" Click on\MembershipManagement"andthenon\MassSubscription". Enter youremailaddressinthebigte٠xt eld,andclickon\SubmitYgourChanges". No wgotoyouremailandsendamessagetomylist@my.dom.ain.?Withinaminuteortwgoyoushouldsee your messagere
ectedbacktoyouviaMailman.wCCongratulations!Ygou'v٠eMjustMsetupandtestedyour rstMailmanmailinglist.Ifyouhadan٠yproblemsalongthewgayY,please seethe14section.'fh14 iTEroubJleshooting
_IfqyouencounterproblemsrwithrunningMailman, rstcheckthequestionandanswersectionbelo wY.)Ifyourproblemis notco٠vered there,checktheonlinehelp,includingtheFBAs8QandthecommunityFAs8Qwiki.ǍAlso#checkforerrorsinyoursyslog les,Lyourmailand#webserv٠erlog lesandinMailman's8s`$prGe x/logs/error' le.If_you'restillhavingproblems,vyoushouldsendamessagetothemailman-users@python.orgmailinglist^6 ;4seehttp://mail.python.org/mailman/listinfo/mailman-users dfor moreinformation.Besuretoincludinginformationonyouroperatingsystem,]whichv٠ersionofPythonyou'reusing,^andwhichversionof Mailmanyou'reinstalling.Here isalistofsomecommonquestionsandanswers:wC Problem:All Mailmanwebpagesgi v٠ea404Filenotfounderrors8. Solution:'!Ygourwebserv٠erhasnotbeensetupproperlyforhandlingMailman's8sCGIprograms.-Makgesureyou hav٠e:~"1./ con gured thewebserv٠ertogi vepermissionsto`$prGe x/cgi-bin'"2./ restarted thewebserv٠erproperlyY. Consult yourwebserv٠er's8sdocumentationforinstructionsonho wtodochecktheseissues.y ff - 荍
h-:6fhY ou mustsubscribetothismailinglistinordertoposttoit,b
utthemailinglist'`sarchivMesarepubliclyvisible. ffH ʢ23 QIn>썍fdn썍 Problem:All Mailmanwebpagesgi v٠ean"InternalServerError". Solution:ԹTheLylikgelyproblemLxisthatyouareusingthewronguserorgroupfortheCGILlscripts.kCheckyourweb serv٠er's8s log les.Ifyouseealinelikge v@Attemptfftoexecscriptwithinvalidgid51,expected99 6䍑 you willneedtoreinstallMailman,specifyingtheproperCGIgroupid,asdescribedinthesection. Problem:I sendmailtothelist,andgetbackmailsayingthelistisnotfound! Solution:YgouKprobablyKdidn'taddthenecessaryaliasestothesystemaliasdatabase,~oryoudidn'tproperly inte٠grateMailmanwithyourmailservers8.jPerhapsyoudidn'tupdatethealiasdatabase,oryoursystemrequires you torunnewaliasese٠xplicitlyY.Refertoyourserverspeci cinstructionsinthe6section. Problem:I sendmailtothelist,andgetbackmailsaying,\unkno wnmailererror". Solution:ryThe,plikgelyproblem,qisthatyouareusingthewronguserorgroupidforthemailwrappers. Check your mailserv٠er's8slog les;ifyouseealinelikge v@Attemptfftoexecscriptwithinvalidgid51,expected99 6䍑 you willneedtoreinstallMailman,specifyingthepropermailgroupidasdescribedinthesection. Problem: (IuseGPost xHasmymailserv٠erandthemailwrapperprogramsareloggingcomplaintsaboutthe wrong GID. Solution:Makgensurethe`$prGe x/data/aliases٠.db' leisnusero wnedbymailman(orwhatev٠erusername youusedinthecon gurecommand).Ifthis leisnotusero wnedbymailman,7Post xwillnotrunthemail programs asthecorrectusers8. Problem:JIeuseSendmailasmymailserv٠er,andwhenIsendmailtothelist,Idgetbackmailsaying,\sh: mailman notav ailableforsendmailprograms". Solution:&AYgourUsystemusestheTSendmailrestrictedshell(smrsh).YouneedTtocon guresmrshbycreatinga symbolicilinkjfromthemailwrapper(`$prGe x/mail/mailman')tothedirectoryidentifyinge٠xecutablesiallo wed to runundersmrsh. Some commonnamesforthisdirectoryare`/vfar/admin/sm.bin',`/usr/admin/sm.bin'or`/etc/smrsh'. NotethatonDebianLinux,thesystemmakges`/usr/lib/sm.bin',whichiswrong,youwillneedtocreatethe directory@`/usr/admin/sm.bin'andaddthelinkthere.XNotefurtheran٠yaliasesnewaliasesspitsoutwillneedto be adjustedtopointtothesecurelinktothewrappers8. Problem:I messedupwhenIcalledcon gure.Ho wdoIcleanthingsupandre-install? Solution:`%ffmakeclean `%ff./configure--with-the-right-options`%ffmakeinstall ffH 24zU14
Troubleshooting _Ӡn>썍fdnύ15 iPlatfoor\(m andoper$atingsystemnotes
_GenerallyY,jMailman#runs"onan٠yPOSIX-basedsystem,ksuchasSolaris,thev ariousBSDvariants,kLinuxsystems, MacOSX,
and othergenericUnixsystems.Itdoesn'trunonWindo ws.F٠orthemostpart,Ethegenericinstructionsgi v٠enMinNthisdocumentshouldbesucienttogetMailmanwgorkingonan٠ysupportedplatform.ŀSomeoperatingsystems hav٠eadditionalrecommendedinstallationorcon gurationinstructions."PÍ15.1#ZGNU/LinIuxUissuespōLinuxjjseemstojibethemostpopularplatformforrunningMailman.fHerearesomehintsongettingMailmantorunonLinux:Ǎ Ifyouaregettingerrorswithhardlinkcreationsand/oryouareusingaspecialsecurekgernel(secure- linux/openwgall/grsecurity),sseeL\the le`contr"ib/README.check < ff 5=qper9ms < ff 5grsecurity'L\inL]theMailmansourcedis- tribution. Note thatifyouareusingLinuxMandrakgeinsecuremode,youareprobablyconcernedbythis. ApparentlyTMandrakgeT9.0changedthepermissionsongcc,]hsoifyoubuildasthemailmanuser,]hyouneedtobe sure mailmanisinthecctoolsgroup. IflfyouinstalledlgPythonfromyourLinuxdistribution's8spackagemanager(e.g..rpmsforRedhat-deri v٠edsystems or.debforDebian),youmustinstallthe\de v٠elopment"packageofPython,oryoumaynotgete v٠erythingyou need. F٠or[example,usingPythonZ2.2onDebian,youwillZneedtoinstallthepython2.2-devpackage. OnRedhat, you probablyneedthepython2-develpackage. If youinstallPythonfromsource,youshouldbe ne. One0symptomofthisproblem,<althoughforunkno wnreasons,is1thatyoumightgetanerrorsuchasthisduring your install: ksTracebackff(mostrecentcalllast):v@Fileff"bin/update",line44,in?
}importffpathsksImportError:ffNomodulenamedpathsksmake:ff***[update]Error1 bԍ Ifthis happens,7installthePythonde v٠elopmentpackageandtrycon gureandmakgeinstallag7ain.ҖOrinstall the latestv٠ersionofPythonfromsource,av ailablefromhttp://wwwu.python.orgXJ. This problem canmanifestitselfinotherLinuxdistributionsindi erentwgays,FMalthoughusuallyitappearsas ImportErrors."PÍ15.2#ZBSDUissuespōVfgi v٠ek\Khera\writesthatsomeBSDsdonightlysecurityscansforsetuid lechanges.setgiddirectoriesalsocomeup=onthe<scanwhenthe٠ychange.RNAlso,LthesetgidbitisnotnecessaryonBSD"systemsbecausegroupo wnershipisautomaticallyinheritedon lescreatedindirectories.EOnotherUnixes, thisonlyhappenswhenthedirectoryhasthesetgid bitturnedon.ǍT37okinstallwithoutturningonthesetgidbitondirectories,simplypassintheDIRSETGID%v ariabletomakge,afteryou'v٠e runcon gure: ffH ʢ25 mn>썍fdn썍 2
%ffmakeDIRSETGID=:install -This disablesthechmodg+scommandoninstalleddirectories."-p15.3#ZMacOSXUissuespōMan٠yߵpeopleߴrunMailmanonMacOSX.Herearesomepointersthathav٠ebeencollectedongettingMailmantorun on MacOSX.섍 JaguarQ(MacOSXQ{10.2)comeswithPython2.2.
Whilethisisn'tthev٠erylatestQstableversionofPython,Zitought to besucienttorunMailman2.1. DavidB.O'Donnellhasawebpagedescribinghiscon gurationofMailman2.0.13andPost xonMacOSX Serv٠ers8.ؿ http://wwwu.afp548.com/Ar\#ticles/mail/python-mailman.html Kathleen W37ebbpostedhere٠xperiencesingettingMailmanrunningonJaguarusingSendmail. http://mail.python.org/piper9mail/mailman-users/2002-October/022944.html P٠antherU%serverU&(MacOSXU10.3)comeswithMailman;coYgouroperatingsystemshouldcontaindocumentationthat willhelpyou,andApplehasatechdocumentaboutaproblemyoumightencounterrunningMailmanonMac OS XServ٠er10.3: http://docsv.info.apple.com/ar\#ticle.html?artnum=107889섍TLerryigAllenpro٠videsthefollo wingdetailedinstructionsonrunningihMailmanonthe'client'versionofOSX,orinearlier v٠ersionsofOSX:ǍMac9OSX9m10.3and9onwgardshasthebasicsforasuccessfulMailmaninstallation.FmUsersofearlierv٠ersionsofMacOSX0containsLSendmailKandthoseusersshouldlookattheSendmailinstallationsectionfortips.RyYgoushouldfollo wtheD basicinstallationstepsasdescribedearlierinthismanual,usubstitutingasappropriate,u
thestepsoutlinedinthissection.Bydefgault,MacOSX10.3'client'v٠ersiondoesnothaveafullyfunctionalversionofPost x.\SettingupawgorkingMTAKsuchKasKPost xisbe٠yondthescopeofthisguideandyoushouldrefertohttp://wwwu.post x.orgZ'fortipsongettingPost xrunning. AneasywgaytosetPost xupistoinstallandrunPost xEnabler,#astand-alonetoolforcon guringPost x onMacOSX,av ailablefromhttp://wwwu.roadstead.com/weblog/Tutor"ials/Post xEnabler.html j.Likge wise,"\MacOSX'client'v٠ersionfrom10.1onwardsincludesaworkingApachewebserv٠ers8.AThisisswitchedonusing9the:SystemPreferencescontrolpanelunderthe'Sharingtab'.GDA6usefultoolforcon guringtheApacheonMacOSX isW37ebmin,whichcanbeobtainedfromhttp://wwwu.webmin.com` .W37ebmincanalsoperformcon gurationforothersystemtasks,includingPost x,addingjobstoyourcrontab,addinguser andgroups,plusaddingstartupandshutdo wnjobs.In4la4kstockinstallationofOSX,therequirementforMailmanistohav٠ePythoninstalled.6Pythonisnotinstalledbydefgault,-2so}it~isadvisedthatyouinstallthede v٠eloper's8stoolspackage,-1whichmayhavebeenprovidedwithyoursystem.Iṫcanalsöbedo wnloadedfromtheApplede v٠elopersiteathttp://connect.applev.comd..Notonlyisthede v٠elopertoolspackageO2anessentialrequirementforinstallingMailman,butitO3willcomeinhandyatalaterdateshouldyouneedother tools.Thede v٠eloper's8stoolsarealsoknowbythenameXCodetools.As aminimum,thePythonv٠ersionshouldbe2.2,but2.3isrecommended.IfyouwishtoaddauserandgroupusingthecommandlineinOSXinsteadofviaW37ebminoranotherGUIinterfgace,openPyourterminalPapplicationandfollo wthecommandsasindicatedbelo w-donottypethecommentsfollo wingthe`#' sincethe٠yarejustnotes: ffH 26 15
Platf7or?mǧandopergatingsystemnotes zn>썍fdn썍 ssudofftcsh sniutilff-create//users/mailman sniutilff-createprop//users/mailmannamemailman s#ffNotethatxxxisafreeuserIDnumberonyoursystem sniutilff-createprop//users/mailmanuidxxx sniutilff-createprop//users/mailmanhome/usr/local/mailman smkdirff-p/usr/local/mailman sniutilff-createprop//users/mailmanshell/bin/tcsh spasswdffmailman s#ffTopreventmalicioushacking,supplyasecurepasswordhere sniutilff-create//groups/mailman sniutilff-createprop//groups/mailmannamemailman s#ffNotethatxxxisafreegroupIDnumberonyoursystem sniutilff-createprop//groups/mailmangidxxx sniutilff-createprop//groups/mailmanpasswd'*' sniutilff-createprop//groups/mailmanusers'mailman' schownffmailman:mailman/usr/local/mailman scdff/usr/local/mailman schmodffa+rx,g+ws. sexit ssuffmailman F٠orsettingupApacheonOSXtohandleMailman,thestepsarealmostidenticalandthecon guration leonastock Mac OSXClientv٠ersionisstoredinthenearlystandardlocationof`/etc/httpd/httpd.conf'.ǍTheAFP548.comsitehasatime-savingautomatedstartupitemcreatorforMailman,>whichcanbefoundathttp://wwwu.afp548.com/Softwvare/MailmanStar\#tup].tar.gzT37oinstallit,>copgyitintoyour`/LibrarEy/Star\#tupItems'directoryY.Astherootorsuperuser,>fromtheterminal,>enterthefollo wing: sgunzipffMailmanStartup.tar.gz starffxvfMailmanStartup.tar 8It willcreatethestartupitemforyousothatwhenyoureboot,Mailmanwillstartup. ffH 15.3
MacOSXǧissuesʢ27 l ; H 1ߌ
ptmb7t0Kj
ptmri7t/Kj
ptmri7t.e9V
phvb7t-ڶ%
ptmbi7t,ߌ
ptmb7t+3{
ptmro7t*l
phvr7t)0
pcrr7t(0
pcrr7t'3{
ptmr7t 3{
ptmr7t 3{
ptmr7t l
phvr7t l
phvr7t8
ptmrc7tߌ
ptmb7t8
ptmrc7tߌ
ptmb7tl
phvr7t3{
ptmr7tl ff
phvr7tl
phvro7tKj
ptmri7tl H
phvr7t3{
ptmr7t
!",
cmsy10
y~or5J ={Eeu磝Qk ᯘG{?+]ן?wM3X^歌>{7پK>on\jy R g/=fOroNVv~Y+ NGuÝHWyw[eQʨSb> >}Gmx[o[<{Ϯ_qF vM IENDB`