diff options
Diffstat (limited to '')
-rw-r--r-- | doc/mailman-install.ps | 991 |
1 files changed, 506 insertions, 485 deletions
diff --git a/doc/mailman-install.ps b/doc/mailman-install.ps index fcee1f12..6b57b0dc 100644 --- a/doc/mailman-install.ps +++ b/doc/mailman-install.ps @@ -11,7 +11,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -N0 -o mailman-install.ps mailman-install %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2009.01.11:0922 +%DVIPSSource: TeX output 2009.12.14:1003 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -320,7 +320,7 @@ rf /Fp 134[33 33 48 33 33 18 26 22 1[33 33 33 52 18 33 rf /Fq 134[37 37 55 37 42 23 32 32 42 42 42 42 60 23 37 1[23 42 42 23 37 42 37 42 42 7[46 51 69 51 60 46 42 51 1[51 60 55 69 46 55 1[28 60 60 51 51 60 55 51 51 6[28 -7[42 42 2[21 28 5[28 36[42 2[{TeXBase1Encoding ReEncodeFont}54 +7[42 42 1[23 21 28 5[28 36[42 2[{TeXBase1Encoding ReEncodeFont}55 83.022 /Times-Italic rf /Fr 103[28 30[42 42 60 42 46 28 32 37 46 46 42 46 69 23 46 1[23 46 42 28 37 46 37 46 42 28 8[83 2[55 46 60 1[51 1[60 78 3[32 4[60 60 55 @@ -363,8 +363,8 @@ TeXDict begin %%Page: 1 1 TeXDict begin 1 0 bop 0 83 3901 9 v 700 357 a Fz(GNU)57 b(Mailman)g(-)g(Installation)h(Man)n(ual)3368 504 y Fy(Release)30 -b(2.1)3153 859 y Fx(Barr)t(y)i(W)-5 b(arsa)n(w)3330 1213 -y Fw(January)19 b(11,)h(2009)3229 1360 y Fv(barr)r(y)g(\(at\))g(list)g +b(2.1)3153 859 y Fx(Barr)t(y)i(W)-5 b(arsa)n(w)3248 1213 +y Fw(December)18 b(14,)i(2009)3229 1360 y Fv(barr)r(y)g(\(at\))g(list)g (dot)g(org)1811 1581 y Fu(Abstract)208 1732 y Ft(This)30 b(document)j(describes)f(ho)n(w)g(to)f(install)f(GNU)h(Mailman)h(on)f (a)g(POSIX-based)g(system)h(such)g(as)h(U)t Fs(N)t(I)t(X)r @@ -504,7 +504,7 @@ h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g b(25)125 2922 y(15.2)43 b(BSD)22 b(issues)72 b(.)41 b(.)g(.)h(.)f(.)g (.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.) g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h -(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)102 b(25)125 3022 y(15.3)43 +(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)102 b(26)125 3022 y(15.3)43 b(MacOSX)21 b(issues)44 b(.)e(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)102 @@ -600,395 +600,401 @@ b(Mailman,)h(which)g(relies)h(on)f(setgid)h(programs)d(for)i(its)i 4353 y(e)o(x)o(ecutable)18 b(by)i(e)n(v)o(eryone.)i(F)o(or)e(e)o (xample,)f(these)h(shell)h(commands)d(will)j(accomplish)e(this:)416 4592 y Fk(\045)44 b(cd)h($prefix)416 4683 y(\045)f(chgrp)g(mailman)g(.) -416 4774 y(\045)g(chmod)g(a+rx,g+ws)g(.)0 5061 y Fw(Y)-9 -b(ou)20 b(are)g(no)n(w)f(ready)h(to)g(con\002gure)e(and)i(install)h -(the)f(Mailman)f(softw)o(are.)p 0 5132 1560 4 v 90 5187 -a Fi(1)120 5211 y Fp(Y)-7 b(ou)16 b(will)i(be)f(able)i(to)e(check)h -(and)g(repair)g(your)g(permissions)g(after)g(installation)j(is)c -(complete.)90 5269 y Fi(2)120 5292 y Fp(This)f(is)h(the)h(def)o(ault)h +416 4774 y(\045)g(chmod)g(a+rx,g+ws)g(.)p 0 5002 1560 +4 v 90 5057 a Fi(1)120 5081 y Fp(Y)-7 b(ou)16 b(will)i(be)f(able)i(to)e +(check)h(and)g(repair)g(your)g(permissions)g(after)g(installation)j(is) +c(complete.)90 5138 y Fi(2)120 5162 y Fp(This)f(is)h(the)h(def)o(ault)h (for)e(Mailman)i(2.1.)h(Earlier)e(v)o(ersions)g(of)f(Mailman)i (installed)g(e)n(v)o(erything)h(under)e(`)p Fh(/home/mailman)p -Fp(')i(by)d(def)o(ault.)90 5350 y Fi(3)120 5373 y Fp(BSD)f(users)h +Fp(')i(by)d(def)o(ault.)90 5219 y Fi(3)120 5243 y Fp(BSD)f(users)h (should)h(see)g(the)f(15.2)g(section)i(for)e(additional)j(information.) p 0 5549 3901 4 v 3854 5649 a Fo(3)p eop end %%Page: 4 4 -TeXDict begin 4 3 bop 0 86 a Fx(3)120 b(Build)33 b(and)i(install)d -(Mailman)0 336 y Fn(3.1)100 b(Run)29 b Fg(con\002gur)n(e)0 -539 y Fw(Before)20 b(you)f(can)h(install)h(Mailman,)e(you)g(must)h(run) -g Fr(con\002gur)o(e)f Fw(to)i(set)g(v)n(arious)e(installation)g -(options)h(your)f(system)h(might)g(need.)0 686 y Fr(Note:)79 +TeXDict begin 4 3 bop 0 17 3901 17 v 0 311 17 295 v 75 +135 a Fr(W)-5 b(ar)o(ning:)96 b Fw(The)31 b(installation)g(directory)-5 +b(,)33 b Fj($)p Fq(pr)m(e\002x)p Fw(,)g(cannot)e(be)h(the)g(same)f +(directory)g(that)g(the)h(source)f(tarball)h(has)g(been)75 +235 y(unpack)o(ed)18 b(to)i(and)g(in)g(which)g(you)f(run)g +Fr(con\002gur)o(e)p Fw(,)h(b)n(ut)g(it)h(can,)e(if)i(you)e(wish,)i(be)f +(a)g(subdirectory)-5 b(,)17 b(e.g.,)j Fj($)p Fq(pr)m(e\002x/sr)m(c)p +Fw(.)p 3883 311 V 0 328 3901 17 v 0 483 a(Y)-9 b(ou)20 +b(are)g(no)n(w)f(ready)h(to)g(con\002gure)e(and)i(install)h(the)f +(Mailman)f(softw)o(are.)0 807 y Fx(3)120 b(Build)33 b(and)i(install)d +(Mailman)0 1057 y Fn(3.1)100 b(Run)29 b Fg(con\002gur)n(e)0 +1260 y Fw(Before)20 b(you)f(can)h(install)h(Mailman,)e(you)g(must)h +(run)g Fr(con\002gur)o(e)f Fw(to)i(set)g(v)n(arious)e(installation)g +(options)h(your)f(system)h(might)g(need.)0 1406 y Fr(Note:)79 b Fw(T)-7 b(ak)o(e)27 b(special)h(note)f(of)g(the)g Fr(--with-mail-gid) f Fw(and)h Fr(--with-cgi-gid)e Fw(options)i(belo)n(w)-5 b(.)45 b(Y)-9 b(ou)27 b(will)h(probably)d(need)i(to)g(use)0 -785 y(these.)0 932 y(Y)-9 b(ou)18 b(should)f Fr(not)h +1506 y(these.)0 1653 y(Y)-9 b(ou)18 b(should)f Fr(not)h Fw(be)g(root)g(while)g(performing)d(the)j(steps)h(in)f(this)h(section.) 24 b(Do)18 b(them)g(under)f(your)g(o)n(wn)h(login,)f(or)h(whate)n(v)o -(er)f(account)0 1032 y(you)23 b(typically)g(use)g(to)h(install)h(softw) +(er)f(account)0 1753 y(you)23 b(typically)g(use)g(to)h(install)h(softw) o(are.)34 b(Y)-9 b(ou)24 b(do)f(not)g(need)g(to)h(do)f(these)h(steps)g (as)h(user)e Fl(mailman)p Fw(,)h(b)n(ut)g(you)e(could.)35 -b(Ho)n(we)n(v)o(er)m(,)0 1131 y(mak)o(e)28 b(sure)g(that)g(the)g(login) +b(Ho)n(we)n(v)o(er)m(,)0 1852 y(mak)o(e)28 b(sure)g(that)g(the)g(login) f(used)h(is)h(a)f(member)f(of)h(the)g Fl(mailman)f Fw(group)f(as)j (that)f(that)g(group)f(has)h(write)g(permissions)f(to)i(the)0 -1231 y Fj($)p Fq(pr)m(e\002x)c Fw(directory)e(made)i(in)h(the)f(pre)n +1952 y Fj($)p Fq(pr)m(e\002x)c Fw(directory)e(made)i(in)h(the)f(pre)n (vious)f(step.)41 b(Y)-9 b(ou)24 b(must)i(also)g(ha)n(v)o(e)e (permission)h(to)g(create)g(a)h(setgid)f(\002le)h(in)g(the)f(\002le)h -(system)0 1331 y(where)20 b(it)g(resides)h(\(NFS)f(and)g(other)f +(system)0 2051 y(where)20 b(it)g(resides)h(\(NFS)f(and)g(other)f (mounts)h(can)g(be)g(con\002gured)e(to)i(inhibit)g(setgid)g -(settings\).)0 1477 y(If)i(you')l(v)o(e)e(installed)j(other)e(GNU)i +(settings\).)0 2198 y(If)i(you')l(v)o(e)e(installed)j(other)e(GNU)i (softw)o(are,)f(you)f(should)h(be)g(f)o(amiliar)g(with)h(the)f Fr(con\002gur)o(e)f Fw(script.)32 b(Usually)22 b(you)f(can)i(just)f -Fr(cd)h Fw(to)0 1577 y(the)d(directory)f(you)g(unpack)o(ed)f(the)i +Fr(cd)h Fw(to)0 2298 y(the)d(directory)f(you)g(unpack)o(ed)f(the)i (Mailman)g(source)f(tarball)h(into,)g(and)f(run)h Fr(con\002gur)o(e)f -Fw(with)i(no)e(ar)o(guments:)326 1815 y Fk(\045)45 b(cd)f -(mailman-<version>)326 1907 y(\045)h(./configure)326 -1998 y(\045)g(make)f(install)0 2284 y Fw(The)20 b(follo)n(wing)e +Fw(with)i(no)e(ar)o(guments:)326 2536 y Fk(\045)45 b(cd)f +(mailman-<version>)326 2627 y(\045)h(./configure)326 +2719 y(\045)g(make)f(install)0 3005 y Fw(The)20 b(follo)n(wing)e (options)i(allo)n(w)g(you)f(to)h(customize)g(your)f(Mailman)g -(installation.)0 2514 y Fr(--pr)o(e\002x=)p Ff(dir)40 +(installation.)0 3218 y Fr(--pr)o(e\002x=)p Ff(dir)40 b Fw(Standard)27 b(GNU)i(con\002gure)d(option)h(which)h(changes)f(the)i (base)f(directory)f(that)h(Mailman)g(is)h(installed)f(into.)49 -b(By)208 2614 y(def)o(ault)19 b Fj($)p Fq(pr)m(e\002x)h +b(By)208 3318 y(def)o(ault)19 b Fj($)p Fq(pr)m(e\002x)h Fw(is)h(`)p Fv(/usr/local/mailman)p Fw('.)f(This)h(directory)d(must)i (already)g(e)o(xist,)g(and)f(be)h(set)h(up)f(as)h(described)e(in)h -(2.2.)0 2780 y Fr(--exec-pr)o(e\002x=)p Ff(dir)39 b Fw(Standard)22 +(2.2.)0 3477 y Fr(--exec-pr)o(e\002x=)p Ff(dir)39 b Fw(Standard)22 b(GNU)h(con\002gure)f(option)g(which)h(lets)h(you)e(specify)h(a)h(dif)n (ferent)d(installation)i(directory)f(for)g(archi-)208 -2880 y(tecture)d(dependent)f(binaries.)0 3046 y Fr(--with-v)o(ar)m(-pr) +3577 y(tecture)d(dependent)f(binaries.)0 3736 y Fr(--with-v)o(ar)m(-pr) o(e\002x=)p Ff(dir)38 b Fw(Store)26 b(mutable)f(data)h(under)f Fq(dir)k Fw(instead)d(of)g(under)e(the)j Fj($)p Fq(pr)m(e\002x)e -Fw(or)h Fj($)p Fq(e)n(xec)p 3023 3046 25 4 v 29 w(pr)m(e\002x)p -Fw(.)43 b(Examples)25 b(of)h(such)208 3145 y(data)20 +Fw(or)h Fj($)p Fq(e)n(xec)p 3023 3736 25 4 v 29 w(pr)m(e\002x)p +Fw(.)43 b(Examples)25 b(of)h(such)208 3836 y(data)20 b(include)f(the)h(list)h(archi)n(v)o(es)e(and)h(list)h(settings)g -(database.)0 3311 y Fr(--with-python=`)p Fe(/path/to/p)o(ython)o +(database.)0 3995 y Fr(--with-python=`)p Fe(/path/to/p)o(ython)o Fr(')36 b Fw(Specify)29 b(an)g(alternati)n(v)o(e)g(Python)g (interpreter)f(to)i(use)g(for)f(the)h(wrapper)f(programs.)52 -b(The)208 3411 y(def)o(ault)19 b(is)i(to)g(use)f(the)g(interpreter)f +b(The)208 4095 y(def)o(ault)19 b(is)i(to)g(use)f(the)g(interpreter)f (found)f(\002rst)j(on)f(your)f(shell')-5 b(s)21 b Fj($)p -Fq(P)-7 b(A)m(TH)t Fw(.)0 3577 y Fr(--with-user)o(name=)p +Fq(P)-7 b(A)m(TH)t Fw(.)0 4254 y Fr(--with-user)o(name=)p Ff(username-or-uid)40 b Fw(Specify)19 b(a)g(dif)n(ferent)f(username)g (than)h Fl(mailman)p Fw(.)24 b(The)19 b(v)n(alue)f(of)h(this)h(option)e -(can)h(be)h(an)208 3677 y(inte)o(ger)f(user)h(id)g(or)g(a)h(user)f +(can)h(be)h(an)208 4354 y(inte)o(ger)f(user)h(id)g(or)g(a)h(user)f (name.)k(Be)d(sure)f(your)f Fj($)p Fq(pr)m(e\002x)g Fw(directory)g(is)i -(o)n(wned)e(by)h(this)h(user)-5 b(.)0 3843 y Fr(--with-gr)o(oupname=)p +(o)n(wned)e(by)h(this)h(user)-5 b(.)0 4513 y Fr(--with-gr)o(oupname=)p Ff(groupname-or-gid)37 b Fw(Specify)21 b(a)h(dif)n(ferent)e(groupname)f (than)i Fl(mailman)p Fw(.)30 b(The)21 b(v)n(alue)g(of)h(this)g(option)f -(can)208 3942 y(be)f(an)g(inte)o(ger)f(group)f(id)j(or)f(a)g(group)f +(can)208 4613 y(be)f(an)g(inte)o(ger)f(group)f(id)j(or)f(a)g(group)f (name.)24 b(Be)d(sure)f(your)f Fj($)p Fq(pr)m(e\002x)g Fw(directory)g(is)i(group-o)n(wned)16 b(by)k(this)h(group.)0 -4108 y Fr(--with-mail-gid=)p Ff(group-or-groups)37 b +4772 y Fr(--with-mail-gid=)p Ff(group-or-groups)37 b Fw(Specify)25 b(an)g(alternati)n(v)o(e)g(group)f(for)h(running)e (scripts)j(via)g(the)f(mail)h(wrapper)-5 b(.)40 b Fq(gr)l(oup-or)n(-) -208 4208 y(gr)l(oups)23 b Fw(can)h(be)g(a)h(list)g(of)f(one)f(or)h +208 4872 y(gr)l(oups)23 b Fw(can)h(be)g(a)h(list)g(of)f(one)f(or)h (more)g(inte)o(ger)f(group)f(ids)j(or)f(symbolic)f(group)f(names.)37 b(The)23 b(\002rst)i(v)n(alue)f(in)g(the)g(list)h(that)208 -4308 y(resolv)o(es)19 b(to)h(an)h(e)o(xisting)e(group)f(is)k(used.)i +4972 y(resolv)o(es)19 b(to)h(an)h(e)o(xisting)e(group)f(is)k(used.)i (By)d(def)o(ault,)e(the)h(v)n(alue)g(is)h(the)f(list)h Fl(mailman)p Fw(,)f Fl(other)p Fw(,)f Fl(mail)p Fw(,)h(and)g -Fl(daemon)p Fw(.)208 4440 y Fr(Note:)85 b Fw(This)29 +Fl(daemon)p Fw(.)208 5101 y Fr(Note:)85 b Fw(This)29 b(is)h(highly)e(system)h(dependent)d(and)j(you)f(must)h(get)g(this)g (right,)i(because)d(the)h(group)e(id)i(is)h(compiled)e(into)208 -4540 y(the)23 b(mail)h(wrapper)e(program)f(for)i(added)g(security)-5 +5201 y(the)23 b(mail)h(wrapper)e(program)f(for)i(added)g(security)-5 b(.)34 b(On)23 b(systems)h(using)f Fr(sendmail)p Fw(,)i(the)f(`)p Fv(sendmail.cf)p Fw(')d(con\002guration)g(\002le)208 -4640 y(designates)f(the)g(group)f(id)i(of)f Fr(sendmail)h +5300 y(designates)f(the)g(group)f(id)i(of)f Fr(sendmail)h Fw(processes)g(using)f(the)g Fq(DefaultUser)j Fw(option.)i(\(If)20 -b(commented)e(out,)i(it)i(still)g(may)e(be)208 4739 y(indicating)e(the) -j(def)o(ault...\))208 4872 y(Check)e(your)g(mail)i(serv)o(er')-5 -b(s)19 b(documentation)f(and)h(con\002guration)f(\002les)j(to)f(\002nd) -g(the)g(right)g(v)n(alue)g(for)f(this)i(switch.)0 5038 -y Fr(--with-cgi-gid=)p Ff(group-or-groups)37 b Fw(Specify)29 +b(commented)e(out,)i(it)i(still)g(may)e(be)208 5400 y(indicating)e(the) +j(def)o(ault...\))p 0 5549 3901 4 v 0 5649 a Fo(4)2807 +b(3)83 b(Build)25 b(and)e(install)h(Mailman)p eop end +%%Page: 5 5 +TeXDict begin 5 4 bop 208 83 a Fw(Check)19 b(your)g(mail)i(serv)o(er') +-5 b(s)19 b(documentation)f(and)h(con\002guration)f(\002les)j(to)f +(\002nd)g(the)g(right)g(v)n(alue)g(for)f(this)i(switch.)0 +236 y Fr(--with-cgi-gid=)p Ff(group-or-groups)37 b Fw(Specify)29 b(an)h(alternati)n(v)o(e)f(group)g(for)g(running)f(scripts)j(via)f(the) -g(CGI)h(wrapper)-5 b(.)54 b Fq(gr)l(oup-or)n(-)208 5138 +g(CGI)h(wrapper)-5 b(.)54 b Fq(gr)l(oup-or)n(-)208 336 y(gr)l(oups)23 b Fw(can)h(be)g(a)h(list)g(of)f(one)f(or)h(more)g(inte)o (ger)f(group)f(ids)j(or)f(symbolic)f(group)f(names.)37 b(The)23 b(\002rst)i(v)n(alue)f(in)g(the)g(list)h(that)208 -5237 y(resolv)o(es)19 b(to)h(an)h(e)o(xisting)e(group)f(is)k(used.)i -(By)d(def)o(ault,)e(the)h(v)n(alue)g(is)h(the)f(the)g(list)i +435 y(resolv)o(es)19 b(to)h(an)h(e)o(xisting)e(group)f(is)k(used.)i(By) +d(def)o(ault,)e(the)h(v)n(alue)g(is)h(the)f(the)g(list)i Fl(www)p Fw(,)e Fl(www-data)p Fw(,)f(and)g Fl(nobody)p -Fw(.)p 0 5549 3901 4 v 0 5649 a Fo(4)2807 b(3)83 b(Build)25 -b(and)e(install)h(Mailman)p eop end -%%Page: 5 5 -TeXDict begin 5 4 bop 208 83 a Fr(Note:)47 b Fw(The)17 -b(proper)f(v)n(alue)h(for)g(this)i(is)f(dependent)e(on)h(your)f(web)i -(serv)o(er)f(con\002guration.)k(Y)-9 b(ou)17 b(must)h(get)g(this)g -(right,)f(because)208 183 y(the)h(group)f(id)i(is)h(compiled)d(into)h -(the)h(CGI)g(wrapper)e(program)g(for)h(added)g(security)-5 -b(,)17 b(and)h(no)h(Mailman)f(CGI)h(scripts)g(will)g(run)208 -282 y(if)h(this)h(is)g(incorrect.)208 415 y(If)f(you')l(re)e(using)i +Fw(.)208 562 y Fr(Note:)47 b Fw(The)17 b(proper)f(v)n(alue)h(for)g +(this)i(is)f(dependent)e(on)h(your)f(web)i(serv)o(er)f +(con\002guration.)k(Y)-9 b(ou)17 b(must)h(get)g(this)g(right,)f +(because)208 661 y(the)h(group)f(id)i(is)h(compiled)d(into)h(the)h(CGI) +g(wrapper)e(program)g(for)h(added)g(security)-5 b(,)17 +b(and)h(no)h(Mailman)f(CGI)h(scripts)g(will)g(run)208 +761 y(if)h(this)h(is)g(incorrect.)208 887 y(If)f(you')l(re)e(using)i (Apache,)f(check)g(the)h(v)n(alues)g(for)g(the)g Fq(Gr)l(oup)g Fw(option)e(in)j(your)e(`)p Fv(httpd.conf)p Fw(')e(\002le.)0 -581 y Fr(--with-cgi-ext=)p Ff(extension)38 b Fw(Specify)24 +1040 y Fr(--with-cgi-ext=)p Ff(extension)38 b Fw(Specify)24 b(an)g(e)o(xtension)e(for)i(cgi-bin)f(programs.)35 b(The)24 b(CGI)h(wrappers)e(placed)g(in)h(`)p Fj($)p Fq(pr)m(e\002x)p -Fo(/cgi-bin)p Fw(')208 681 y(will)c(ha)n(v)o(e)g(this)h(e)o(xtension)e +Fo(/cgi-bin)p Fw(')208 1140 y(will)c(ha)n(v)o(e)g(this)h(e)o(xtension)e (\(some)g(web)h(serv)o(ers)g(require)f(an)h(e)o(xtension\).)j Fq(e)n(xtension)d Fw(must)g(include)f(the)h(leading)f(dot.)0 -847 y Fr(--with-mailhost=)p Ff(hostname)39 b Fw(Specify)27 +1293 y Fr(--with-mailhost=)p Ff(hostname)39 b Fw(Specify)27 b(the)h(fully)f(quali\002ed)g(host)g(name)g(part)h(for)f(outgoing)e -(email.)47 b(After)28 b(the)f(installation)h(is)208 946 +(email.)47 b(After)28 b(the)f(installation)h(is)208 1392 y(complete,)18 b(this)j(v)n(alue)f(can)g(be)g(o)o(v)o(erriden)d(in)k(`) -p Fj($)p Fq(pr)m(e\002x)p Fo(/Mailman/mm)p 2308 946 25 -4 v 30 w(cfg.p)n(y)p Fw('.)0 1112 y Fr(--with-urlhost=)p +p Fj($)p Fq(pr)m(e\002x)p Fo(/Mailman/mm)p 2308 1392 +25 4 v 30 w(cfg.p)n(y)p Fw('.)0 1545 y Fr(--with-urlhost=)p Ff(hostname)39 b Fw(Specify)25 b(the)g(fully)f(quali\002ed)h(host)g (name)f(part)h(of)g(urls.)39 b(After)25 b(the)g(installation)g(is)h -(complete,)f(this)208 1212 y(v)n(alue)19 b(can)h(be)g(o)o(v)o(erriden)e +(complete,)f(this)208 1645 y(v)n(alue)19 b(can)h(be)g(o)o(v)o(erriden)e (in)i(`)p Fj($)p Fq(pr)m(e\002x)p Fo(/Mailman/mm)p 1821 -1212 V 30 w(cfg.p)n(y)p Fw('.)0 1378 y Fr(--with-gcc=no)40 +1645 V 30 w(cfg.p)n(y)p Fw('.)0 1798 y Fr(--with-gcc=no)40 b Fw(Don')o(t)18 b(use)j(gcc,)f(e)n(v)o(en)f(if)h(it)h(is)g(found.)j (In)19 b(this)i(case,)g Fr(cc)f Fw(must)g(be)g(found)f(on)h(your)f -Fj($)p Fq(P)-7 b(A)m(TH)t Fw(.)0 1663 y Fn(3.2)100 b(Mak)n(e)28 -b(and)h(install)0 1866 y Fw(Once)20 b(you')l(v)o(e)e(run)h +Fj($)p Fq(P)-7 b(A)m(TH)t Fw(.)0 2077 y Fn(3.2)100 b(Mak)n(e)28 +b(and)h(install)0 2280 y Fw(Once)20 b(you')l(v)o(e)e(run)h Fr(con\002gur)o(e)p Fw(,)g(you)h(can)g(simply)f(run)h Fr(mak)o(e)p Fw(,)g(then)g Fr(mak)o(e)h(install)f Fw(to)h(b)n(uild)e -(and)h(install)h(Mailman.)0 2193 y Fx(4)120 b(Chec)n(k)34 -b(y)n(our)f(installation)0 2426 y Fw(After)e(you')l(v)o(e)d(run)i +(and)h(install)h(Mailman.)0 2601 y Fx(4)120 b(Chec)n(k)34 +b(y)n(our)f(installation)0 2834 y Fw(After)e(you')l(v)o(e)d(run)i Fr(mak)o(e)i(install)p Fw(,)h(you)d(should)g(check)g(that)h(your)f (installation)g(has)i(all)f(the)g(correct)f(permissions)g(and)g(group)0 -2526 y(o)n(wnerships)24 b(by)h(running)e(the)i Fr(check)p -1130 2526 V 30 w(perms)h Fw(script.)40 b(First)26 b(change)e(to)i(the)f +2934 y(o)n(wnerships)24 b(by)h(running)e(the)i Fr(check)p +1130 2934 V 30 w(perms)h Fw(script.)40 b(First)26 b(change)e(to)i(the)f (installation)g(\(i.e.)40 b Fj($)p Fq(pr)m(e\002x)p Fw(\))24 -b(directory)-5 b(,)24 b(then)h(run)g(the)0 2625 y Fr(bin/check)p -346 2625 V 30 w(perms)30 b Fw(program.)47 b(Don')o(t)28 -b(try)g(to)h(run)f(bin/check)p 1881 2625 V 27 w(perms)g(from)g(the)g +b(directory)-5 b(,)24 b(then)h(run)g(the)0 3033 y Fr(bin/check)p +346 3033 V 30 w(perms)30 b Fw(program.)47 b(Don')o(t)28 +b(try)g(to)h(run)f(bin/check)p 1881 3033 V 27 w(perms)g(from)g(the)g (source)g(directory;)j(it)e(will)h(only)d(run)h(from)g(the)0 -2725 y(installation)20 b(directory)-5 b(.)0 2872 y(If)20 +3133 y(installation)20 b(directory)-5 b(.)0 3280 y(If)20 b(this)h(reports)e(no)h(problems,)f(then)h(it')-5 b(s)21 b(v)o(ery)f(lik)o(ely)g(\241wink\277)f(that)i(your)e(installation)h(is) h(set)g(up)f(correctly)-5 b(.)24 b(If)c(it)h(reports)e(problems,)0 -2972 y(then)j(you)g(can)h(either)f(\002x)h(them)g(manually)-5 +3379 y(then)j(you)g(can)h(either)f(\002x)h(them)g(manually)-5 b(,)21 b(re-run)g(the)i(installation,)g(or)f(use)h Fr(bin/check)p -2651 2972 V 30 w(perms)h Fw(to)f(\002x)g(the)g(problems)e(\(probably)0 -3071 y(the)f(easiest)h(solution\):)125 3301 y Fd(\017)41 +2651 3379 V 30 w(perms)h Fw(to)f(\002x)g(the)g(problems)e(\(probably)0 +3479 y(the)f(easiest)h(solution\):)125 3676 y Fd(\017)41 b Fw(Y)-9 b(ou)19 b(need)h(to)g(become)f(the)h(user)g(that)h(did)e(the) i(installation,)e(and)h(that)g(o)n(wns)g(all)h(the)f(\002les)h(in)f -Fj($)p Fq(pr)m(e\002x)p Fw(,)g(or)g(root.)125 3467 y -Fd(\017)41 b Fw(Run)20 b Fr(bin/check)p 713 3467 V 30 -w(perms)h(-f)125 3633 y Fd(\017)41 b Fw(Repeat)20 b(pre)n(vious)e(step) -j(until)f(no)g(more)f(errors)g(are)i(reported!)p 0 3806 -3901 17 v 0 5109 17 1303 v 75 3922 a Fr(W)-5 b(ar)o(ning:)83 +Fj($)p Fq(pr)m(e\002x)p Fw(,)g(or)g(root.)125 3829 y +Fd(\017)41 b Fw(Run)20 b Fr(bin/check)p 713 3829 V 30 +w(perms)h(-f)125 3982 y Fd(\017)41 b Fw(Repeat)20 b(pre)n(vious)e(step) +j(until)f(no)g(more)f(errors)g(are)i(reported!)p 0 4123 +3901 17 v 0 5425 17 1303 v 75 4238 a Fr(W)-5 b(ar)o(ning:)83 b Fw(If)28 b(you')l(re)f(running)f(Mailman)i(on)h(a)g(shared)e (multiuser)h(system,)j(and)d(you)f(ha)n(v)o(e)h(mailing)g(lists)i(with) -f(pri)n(v)n(ate)75 4021 y(archi)n(v)o(es,)23 b(you)g(may)h(w)o(ant)g +f(pri)n(v)n(ate)75 4337 y(archi)n(v)o(es,)23 b(you)g(may)h(w)o(ant)g (to)g(hide)g(the)g(pri)n(v)n(ate)f(archi)n(v)o(e)f(directory)h(from)g (other)g(users)h(on)f(your)g(system.)37 b(In)23 b(that)i(case,)g(you)75 -4121 y(should)h(drop)g(the)i(other)e(e)o(x)o(ecute)g(permission)g +4437 y(should)h(drop)g(the)i(other)e(e)o(x)o(ecute)g(permission)g (\(o-x\))g(from)h(the)g(`)p Fv(archiv)n(es/pr)q(iv)n(ate)p Fw(')e(directory)-5 b(.)44 b(Ho)n(we)n(v)o(er)m(,)27 -b(the)g(web)h(serv)o(er)75 4221 y(process)17 b(must)h(be)g(able)g(to)g +b(the)g(web)h(serv)o(er)75 4537 y(process)17 b(must)h(be)g(able)g(to)g (follo)n(w)f(the)h(symbolic)f(link)g(in)h(public)f(directory)-5 b(,)16 b(otherwise)h(your)g(public)g(Pipermail)g(archi)n(v)o(es)g(will) -75 4320 y(not)j(w)o(ork.)k(T)-7 b(o)20 b(set)h(this)g(up,)e(become)g +75 4636 y(not)j(w)o(ork.)k(T)-7 b(o)20 b(set)h(this)g(up,)e(become)g (root)h(and)g(run)f(the)h(follo)n(wing)f(commands:)311 -4511 y Fk(#)45 b(cd)f(<prefix>/archives)311 4602 y(#)h(chown)f -(<web-server-user>)e(private)311 4694 y(#)j(chmod)f(o-x)g(private)75 -4933 y Fw(Y)-9 b(ou)21 b(need)h(to)g(kno)n(w)f(what)h(user)g(your)f +4827 y Fk(#)45 b(cd)f(<prefix>/archives)311 4919 y(#)h(chown)f +(<web-server-user>)e(private)311 5010 y(#)j(chmod)f(o-x)g(private)75 +5249 y Fw(Y)-9 b(ou)21 b(need)h(to)g(kno)n(w)f(what)h(user)g(your)f (web)h(serv)o(er)g(runs)g(as.)31 b(It)23 b(may)e(be)h Fl(www)p Fw(,)h Fl(apache)p Fw(,)f Fl(httpd)g Fw(or)g -Fl(nobody)p Fw(,)f(depending)75 5033 y(on)e(your)g(serv)o(er')-5 -b(s)20 b(con\002guration.)p 3883 5109 V 0 5125 3901 17 +Fl(nobody)p Fw(,)f(depending)75 5349 y(on)e(your)g(serv)o(er')-5 +b(s)20 b(con\002guration.)p 3883 5425 V 0 5442 3901 17 v 0 5549 3901 4 v 0 5649 a Fo(3.2)83 b(Mak)n(e)24 b(and)f(install)3059 b(5)p eop end %%Page: 6 6 -TeXDict begin 6 5 bop 0 88 a Fx(5)120 b(Set)34 b(up)g(y)n(our)f(w)o(eb) -i(ser)t(v)m(er)0 321 y Fw(Congratulations!)26 b(Y)-9 +TeXDict begin 6 5 bop 0 410 a Fx(5)120 b(Set)34 b(up)g(y)n(our)f(w)o +(eb)i(ser)t(v)m(er)0 643 y Fw(Congratulations!)26 b(Y)-9 b(ou')l(v)o(e)19 b(installed)i(the)h(Mailman)e(softw)o(are.)28 b(T)-7 b(o)21 b(get)g(e)n(v)o(erything)e(running)g(you)h(need)h(to)g -(hook)f(Mailman)h(up)f(to)0 421 y(both)f(your)g(web)h(serv)o(er)g(and)f -(your)g(mail)i(system.)0 567 y(If)15 b(you)g(plan)g(on)g(running)e +(hook)f(Mailman)h(up)f(to)0 743 y(both)f(your)g(web)h(serv)o(er)g(and)f +(your)g(mail)i(system.)0 890 y(If)15 b(you)g(plan)g(on)g(running)e (your)i(mail)g(and)g(web)h(serv)o(ers)f(on)g(dif)n(ferent)f(machines,)h (sharing)f(Mailman)h(installations)h(via)f(NFS,)h(be)g(sure)0 -667 y(that)g(the)f(clocks)h(on)f(those)h(tw)o(o)g(machines)e(are)i +989 y(that)g(the)f(clocks)h(on)f(those)h(tw)o(o)g(machines)e(are)i (synchronized)d(closely)-5 b(.)23 b(Y)-9 b(ou)15 b(might)g(tak)o(e)g(a) i(look)d(at)j(the)e(\002le)i(`)p Fv(Mailman/Loc)o(kFile)o(.p)n(y)p -Fw(';)0 767 y(the)j(constant)g Fq(CLOCK)p 696 767 25 +Fw(';)0 1089 y(the)j(constant)g Fq(CLOCK)p 696 1089 25 4 v 31 w(SLOP)g Fw(helps)g(the)g(locking)f(mechanism)g(compensate)g (for)g(clock)h(sk)o(e)n(w)g(in)g(this)h(type)f(of)g(en)m(vironment.)0 -914 y(This)29 b(section)f(describes)g(some)g(of)g(the)h(things)f(you)f +1236 y(This)29 b(section)f(describes)g(some)g(of)g(the)h(things)f(you)f (need)h(to)h(do)f(to)h(connect)e(Mailman')-5 b(s)28 b(web)g(interf)o -(ace)g(to)h(your)e(web)h(serv)o(er)-5 b(.)0 1013 y(The)28 +(ace)g(to)h(your)e(web)h(serv)o(er)-5 b(.)0 1336 y(The)28 b(instructions)f(here)h(are)g(some)n(what)f(geared)g(to)n(w)o(ard)h (the)g(Apache)g(web)g(serv)o(er)m(,)g(so)h(you)e(should)h(consult)f -(your)g(web)h(serv)o(er)0 1113 y(documentation)17 b(for)j(details.)0 -1260 y(Y)-9 b(ou)22 b(must)g(con\002gure)f(your)g(web)i(serv)o(er)e(to) +(your)g(web)h(serv)o(er)0 1435 y(documentation)17 b(for)j(details.)0 +1582 y(Y)-9 b(ou)22 b(must)g(con\002gure)f(your)g(web)i(serv)o(er)e(to) i(enable)f(CGI)h(script)f(permission)g(in)g(the)h(`)p Fj($)p Fq(pr)m(e\002x)p Fo(/cgi-bin)p Fw(')e(to)i(run)f(CGI)h(scripts.) -32 b(The)0 1359 y(line)23 b(you)f(should)g(add)g(might)h(look)f +32 b(The)0 1682 y(line)23 b(you)f(should)g(add)g(might)h(look)f (something)f(lik)o(e)j(the)f(follo)n(wing,)e(with)i(the)g(real)g (absolute)g(directory)e(substituted)h(for)h Fj($)p Fq(pr)m(e\002x)p -Fw(,)0 1459 y(of)d(course:)416 1697 y Fk(Exec)358 b(/mailman/)1359 -1710 y(*)1671 1697 y($prefix/cgi-bin/)2391 1710 y(*)0 -1965 y Fw(or:)416 2203 y Fk(ScriptAlias)43 b(/mailman/)312 -b($prefix/cgi-bin/)p 0 2449 3901 17 v 0 2740 17 292 v -75 2565 a Fr(W)-5 b(ar)o(ning:)65 b Fw(Y)-9 b(ou)24 b(w)o(ant)g(to)g +Fw(,)0 1781 y(of)d(course:)416 2019 y Fk(Exec)358 b(/mailman/)1359 +2032 y(*)1671 2019 y($prefix/cgi-bin/)2391 2032 y(*)0 +2287 y Fw(or:)416 2525 y Fk(ScriptAlias)43 b(/mailman/)312 +b($prefix/cgi-bin/)p 0 2772 3901 17 v 0 3063 17 292 v +75 2887 a Fr(W)-5 b(ar)o(ning:)65 b Fw(Y)-9 b(ou)24 b(w)o(ant)g(to)g (be)g(v)o(ery)f(sure)h(that)g(the)g(user)g(id)h(under)d(which)i(your)f (CGI)h(scripts)h(run)e(is)i Fr(not)f Fw(in)g(the)h Fl(mailman)75 -2664 y Fw(group)18 b(you)h(created)h(abo)o(v)o(e,)e(otherwise)i(pri)n +2987 y Fw(group)18 b(you)h(created)h(abo)o(v)o(e,)e(otherwise)i(pri)n (v)n(ate)f(archi)n(v)o(es)g(will)i(be)f(accessible)g(to)h(an)o(yone.)p -3883 2740 V 0 2757 3901 17 v 0 2912 a(Cop)o(y)k(the)h(Mailman,)g +3883 3063 V 0 3079 3901 17 v 0 3235 a(Cop)o(y)k(the)h(Mailman,)g (Python,)f(and)g(GNU)h(logos)f(to)g(a)h(location)f(accessible)g(to)h (your)e(web)i(serv)o(er)-5 b(.)40 b(E.g.)g(with)26 b(Apache,)g(you')l -(v)o(e)0 3012 y(usually)20 b(got)f(an)i(`)p Fv(icons)p +(v)o(e)0 3334 y(usually)20 b(got)f(an)i(`)p Fv(icons)p Fw(')e(directory)f(that)j(you)e(can)h(drop)f(the)h(images)g(into.)25 -b(F)o(or)20 b(e)o(xample:)416 3250 y Fk(\045)44 b(cp)h($prefix/icons/) -1270 3263 y(*)1315 3250 y(.{jpg,png})40 b(/path/to/apache/icons)0 -3541 y Fw(Y)-9 b(ou)25 b(then)g(w)o(ant)g(to)h(add)f(a)g(line)h(to)f +b(F)o(or)20 b(e)o(xample:)416 3572 y Fk(\045)44 b(cp)h($prefix/icons/) +1270 3585 y(*)1315 3572 y(.{jpg,png})40 b(/path/to/apache/icons)0 +3864 y Fw(Y)-9 b(ou)25 b(then)g(w)o(ant)g(to)h(add)f(a)g(line)h(to)f (your)g(`)p Fj($)p Fq(pr)m(e\002x)p Fo(/Mailman/mm)p -1992 3541 25 4 v 30 w(cfg.p)n(y)p Fw(')g(\002le)h(which)e(sets)j(the)e -(base)h(URL)g(for)f(the)g(logos.)40 b(F)o(or)0 3641 y(e)o(xample:)326 -3879 y Fk(IMAGE_LOGOS)j(=)i('/images/')0 4166 y Fw(The)20 -b(def)o(ault)f(v)n(alue)h(for)f Fq(IMA)m(GE)p 977 4166 +1992 3864 25 4 v 30 w(cfg.p)n(y)p Fw(')g(\002le)h(which)e(sets)j(the)e +(base)h(URL)g(for)f(the)g(logos.)40 b(F)o(or)0 3963 y(e)o(xample:)326 +4201 y Fk(IMAGE_LOGOS)j(=)i('/images/')0 4488 y Fw(The)20 +b(def)o(ault)f(v)n(alue)h(for)f Fq(IMA)m(GE)p 977 4488 V 30 w(LOGOS)h Fw(is)i(`)p Fv(/icons/)p Fw('.)h(Read)e(the)f(comment)f (in)h(`)p Fv(Def)n(aults)o(.p)n(y)-7 b(.in)p Fw(')16 -b(for)j(details.)0 4312 y(Con\002gure)g(your)g(web)h(serv)o(er)f(to)i +b(for)j(details.)0 4635 y(Con\002gure)g(your)g(web)h(serv)o(er)f(to)i (point)e(to)h(the)h(Pipermail)e(public)g(mailing)h(list)h(archi)n(v)o -(es.)j(F)o(or)c(e)o(xample,)e(in)j(Apache:)416 4551 y +(es.)j(F)o(or)c(e)o(xample,)e(in)j(Apache:)416 4873 y Fk(Alias)133 b(/pipermail/)223 b($varprefix/archives/public/)0 -4841 y Fw(where)28 b Fj($)p Fq(varpr)m(e\002x)g Fw(is)i(usually)e +5163 y Fw(where)28 b Fj($)p Fq(varpr)m(e\002x)g Fw(is)i(usually)e Fj($)p Fq(pr)m(e\002x)g Fw(unless)h(you')l(v)o(e)e(used)i(the)g Fr(--with-v)o(ar)m(-pr)o(e\002x)d Fw(option)h(to)i Fr(con\002gur)o(e)p -Fw(.)51 b(Also)29 b(be)g(sure)f(to)0 4941 y(con\002gure)e(your)g(web)i +Fw(.)51 b(Also)29 b(be)g(sure)f(to)0 5263 y(con\002gure)e(your)g(web)i (serv)o(er)e(to)i(follo)n(w)f(symbolic)g(links)h(in)f(this)i(directory) -5 b(,)27 b(otherwise)g(public)f(Pipermail)i(archi)n(v)o(es)e(w)o(on')o -(t)h(be)0 5040 y(accessible.)e(F)o(or)20 b(Apache)f(users,)h(consult)g -(the)g Fq(F)-9 b(ollowSymLinks)20 b Fw(option.)0 5187 -y(If)c(you')l(re)e(going)h(to)h(be)g(supporting)e(internationalized)f -(public)i(archi)n(v)o(es,)h(you)f(will)i(probably)c(w)o(ant)k(to)f -(turn)f(of)n(f)g(an)o(y)h(def)o(ault)f(charset)0 5287 -y(directi)n(v)o(e)25 b(for)g(the)g(Pipermail)h(directory)-5 -b(,)24 b(otherwise)i(your)e(multilingual)g(archi)n(v)o(e)h(pages)g(w)o -(on')o(t)g(sho)n(w)g(up)h(correctly)-5 b(.)40 b(Here')-5 -b(s)26 b(an)0 5386 y(e)o(xample)19 b(for)g(Apache,)g(based)h(on)g(the)g -(standard)f(installation)h(directories:)p 0 5549 3901 -4 v 0 5649 a Fo(6)2873 b(5)83 b(Set)24 b(up)g(y)n(our)e(w)o(eb)i(ser)r -(v)n(er)p eop end +(t)h(be)0 5363 y(accessible.)e(F)o(or)20 b(Apache)f(users,)h(consult)g +(the)g Fq(F)-9 b(ollowSymLinks)20 b Fw(option.)p 0 5549 +3901 4 v 0 5649 a Fo(6)2873 b(5)83 b(Set)24 b(up)g(y)n(our)e(w)o(eb)i +(ser)r(v)n(er)p eop end %%Page: 7 7 -TeXDict begin 7 6 bop 416 174 a Fk(<Directory)43 b -("/usr/local/mailman/archives/public/")o(>)595 266 y(AddDefaultCharset) -f(Off)416 357 y(</Directory>)0 644 y Fw(No)n(w)20 b(restart)g(your)f -(web)h(serv)o(er)-5 b(.)0 971 y Fx(6)120 b(Set)34 b(up)g(y)n(our)f -(mail)g(ser)t(v)m(er)0 1204 y Fw(This)18 b(section)f(describes)g(some)g -(of)g(the)h(things)f(you)f(need)h(to)h(do)f(to)g(connect)g(Mailman')-5 -b(s)17 b(email)g(interf)o(ace)g(to)g(your)g(mail)g(serv)o(er)-5 -b(.)24 b(The)0 1303 y(instructions)f(here)g(are)h(dif)n(ferent)e(for)h +TeXDict begin 7 6 bop 0 83 a Fw(If)16 b(you')l(re)e(going)h(to)h(be)g +(supporting)e(internationalized)f(public)i(archi)n(v)o(es,)h(you)f +(will)i(probably)c(w)o(ant)k(to)f(turn)f(of)n(f)g(an)o(y)h(def)o(ault)f +(charset)0 183 y(directi)n(v)o(e)25 b(for)g(the)g(Pipermail)h +(directory)-5 b(,)24 b(otherwise)i(your)e(multilingual)g(archi)n(v)o(e) +h(pages)g(w)o(on')o(t)g(sho)n(w)g(up)h(correctly)-5 b(.)40 +b(Here')-5 b(s)26 b(an)0 282 y(e)o(xample)19 b(for)g(Apache,)g(based)h +(on)g(the)g(standard)f(installation)h(directories:)416 +520 y Fk(<Directory)43 b("/usr/local/mailman/archives/public/")o(>)595 +612 y(AddDefaultCharset)f(Off)416 703 y(</Directory>)0 +990 y Fw(No)n(w)20 b(restart)g(your)f(web)h(serv)o(er)-5 +b(.)0 1317 y Fx(6)120 b(Set)34 b(up)g(y)n(our)f(mail)g(ser)t(v)m(er)0 +1550 y Fw(This)18 b(section)f(describes)g(some)g(of)g(the)h(things)f +(you)f(need)h(to)h(do)f(to)g(connect)g(Mailman')-5 b(s)17 +b(email)g(interf)o(ace)g(to)g(your)g(mail)g(serv)o(er)-5 +b(.)24 b(The)0 1649 y(instructions)f(here)g(are)h(dif)n(ferent)e(for)h (each)h(mail)g(serv)o(er;)h(if)f(your)e(mail)j(serv)o(er)e(is)h(not)g (described)e(in)i(the)g(follo)n(wing)e(subsections,)0 -1403 y(try)i(to)g(generalize)f(from)g(the)h(e)o(xisting)f +1749 y(try)i(to)g(generalize)f(from)g(the)h(e)o(xisting)f (documentation,)f(and)h(consider)g(contrib)n(uting)f(documentation)f -(updates)i(to)h(the)g(Mailman)0 1503 y(de)n(v)o(elopers.)0 -1788 y Fn(6.1)100 b(Using)28 b(the)h(P)-5 b(ost\002x)27 -b(mail)i(ser)s(v)n(er)0 1990 y Fw(Mailman)22 b(should)f(w)o(ork)g +(updates)i(to)h(the)g(Mailman)0 1849 y(de)n(v)o(elopers.)0 +2134 y Fn(6.1)100 b(Using)28 b(the)h(P)-5 b(ost\002x)27 +b(mail)i(ser)s(v)n(er)0 2337 y Fw(Mailman)22 b(should)f(w)o(ork)g (pretty)h(much)f(out)h(of)g(the)g(box)f(with)i(a)f(standard)f (Post\002x)i(installation.)30 b(It)23 b(has)f(been)g(tested)g(with)h(v) -n(arious)0 2090 y(Post\002x)d(v)o(ersions)g(up)f(to)i(and)e(including)g -(Post\002x)h(2.1.5.)0 2237 y(In)e(order)g(to)g(support)g(Mailman')-5 +n(arious)0 2436 y(Post\002x)d(v)o(ersions)g(up)f(to)i(and)e(including)g +(Post\002x)h(2.1.5.)0 2583 y(In)e(order)g(to)g(support)g(Mailman')-5 b(s)18 b(optional)f(VERP)i(deli)n(v)o(ery)-5 b(,)17 b(you)h(will)h(w)o (ant)g(to)f(disable)h Fl(luser_relay)e Fw(\(the)h(def)o(ault\))f(and)h -(you)0 2337 y(will)i(w)o(ant)e(to)h(set)h Fl(recipient_delimiter)c +(you)0 2683 y(will)i(w)o(ant)e(to)h(set)h Fl(recipient_delimiter)c Fw(for)i(e)o(xtended)f(address)h(semantics.)25 b(Y)-9 b(ou)18 b(should)g(comment)f(out)h(an)o(y)g Fl(luser_-)0 -2436 y(relay)i Fw(v)n(alue)f(in)i(your)e(`)p Fv(main.cf)p +2782 y(relay)i Fw(v)n(alue)f(in)i(your)e(`)p Fv(main.cf)p Fw(')f(and)i(just)h(go)f(with)g(the)g(def)o(aults.)25 b(Also,)20 b(add)g(this)g(to)h(your)e(`)p Fv(main.cf)p -Fw(')g(\002le:)416 2674 y Fk(recipient_delimiter)41 b(=)k(+)0 -2961 y Fw(Using)15 b(`)p Fl(+)p Fw(')h(as)g(the)f(delimiter)g(w)o(orks) +Fw(')g(\002le:)416 3020 y Fk(recipient_delimiter)41 b(=)k(+)0 +3307 y Fw(Using)15 b(`)p Fl(+)p Fw(')h(as)g(the)f(delimiter)g(w)o(orks) g(well)h(with)g(the)f(def)o(ault)g(v)n(alues)g(for)g -Fq(VERP)p 2306 2961 25 4 v 29 w(FORMA)m(T)22 b Fw(and)15 -b Fq(VERP)p 3022 2961 V 29 w(REGEXP)f Fw(in)i(`)p Fv(Def)n(aults)o(.p)n -(y)p Fw('.)0 3108 y(When)21 b(attempting)f(to)h(deli)n(v)o(er)f(a)h +Fq(VERP)p 2306 3307 25 4 v 29 w(FORMA)m(T)22 b Fw(and)15 +b Fq(VERP)p 3022 3307 V 29 w(REGEXP)f Fw(in)i(`)p Fv(Def)n(aults)o(.p)n +(y)p Fw('.)0 3454 y(When)21 b(attempting)f(to)h(deli)n(v)o(er)f(a)h (message)g(to)g(a)h(non-e)o(xistent)d(local)i(address,)f(Post\002x)i (may)e(return)g(a)i(450)e(error)g(code.)27 b(Since)21 -b(this)0 3207 y(is)i(a)f(transient)f(error)g(code,)g(Mailman)g(will)i +b(this)0 3554 y(is)i(a)f(transient)f(error)g(code,)g(Mailman)g(will)i (continue)d(to)i(attempt)f(to)h(deli)n(v)o(er)f(the)h(message)f(for)g -Fq(DELIVER)o(Y)p 3240 3207 V 29 w(RETR)o(Y)p 3513 3207 -V 28 w(PERIOD)g Fw(\226)0 3307 y(5)d(days)g(by)g(def)o(ault.)24 +Fq(DELIVER)o(Y)p 3240 3554 V 29 w(RETR)o(Y)p 3513 3554 +V 28 w(PERIOD)g Fw(\226)0 3653 y(5)d(days)g(by)g(def)o(ault.)24 b(Y)-9 b(ou)17 b(might)h(w)o(ant)g(to)g(set)h(Post\002x)g(up)f(so)g (that)g(it)h(returns)f(permanent)e(error)h(codes)h(for)f(non-e)o -(xistent)f(local)i(users)0 3407 y(by)i(adding)f(the)h(follo)n(wing)e -(to)j(your)e(`)p Fv(main.cf)p Fw(')f(\002le:)416 3645 +(xistent)f(local)i(users)0 3753 y(by)i(adding)f(the)h(follo)n(wing)e +(to)j(your)e(`)p Fv(main.cf)p Fw(')f(\002le:)416 3991 y Fk(unknown_local_recipient_reject_code)38 b(=)45 b(550)0 -3931 y Fw(Finally)-5 b(,)19 b(if)i(you)e(are)h(using)g(Post\002x-style) +4277 y Fw(Finally)-5 b(,)19 b(if)i(you)e(are)h(using)g(Post\002x-style) g(virtual)f(domains,)g(read)h(the)g(section)g(on)g(virtual)f(domain)g -(support)g(belo)n(w)-5 b(.)0 4200 y Fo(Integ)o(r)o(ating)25 -b(P)l(ost\002x)d(and)h(Mailman)0 4403 y Fw(Y)-9 b(ou)30 +(support)g(belo)n(w)-5 b(.)0 4546 y Fo(Integ)o(r)o(ating)25 +b(P)l(ost\002x)d(and)h(Mailman)0 4749 y Fw(Y)-9 b(ou)30 b(can)h(inte)o(grate)f(Post\002x)h(and)f(Mailman)g(such)h(that)g(when)f (ne)n(w)h(lists)h(are)f(created,)i(or)d(lists)j(are)d(remo)o(v)o(ed,)h -(Post\002x')-5 b(s)32 b(alias)0 4502 y(database)20 b(will)h(be)f +(Post\002x')-5 b(s)32 b(alias)0 4848 y(database)20 b(will)h(be)f (automatically)e(updated.)24 b(The)c(follo)n(wing)e(are)i(the)g(steps)h (you)f(need)f(to)h(tak)o(e)h(to)f(mak)o(e)g(this)g(w)o(ork.)0 -4649 y(In)g(the)h(description)e(belo)n(w)-5 b(,)20 b(we)h(assume)g +4995 y(In)g(the)h(description)e(belo)n(w)-5 b(,)20 b(we)h(assume)g (that)g(you')l(v)o(e)d(installed)j(Mailman)f(in)h(the)g(def)o(ault)f (location,)f(i.e.)27 b(`)p Fv(/usr/local/mailman)p Fw('.)c(If)0 -4749 y(that')-5 b(s)20 b(not)e(the)i(case,)f(adjust)g(the)g +5095 y(that')-5 b(s)20 b(not)e(the)i(case,)f(adjust)g(the)g (instructions)g(according)e(to)i(your)f(use)h(of)g Fr(con\002gur)o(e)p Fw(')-5 b(s)19 b Fr(--pr)o(e\002x)f Fw(and)h Fr(--with-v)o(ar)m(-pr)o -(e\002x)d Fw(options.)0 4896 y Fr(Note:)69 b Fw(If)25 +(e\002x)d Fw(options.)0 5242 y Fr(Note:)69 b Fw(If)25 b(you)f(are)g(using)h(virtual)f(domains)g(and)g(you)g(w)o(ant)h (Mailman)f(to)i(honor)d(your)g(virtual)i(domains,)f(read)h(the)g(6.1)f -(section)0 4995 y(belo)n(w)c(\002rst!)125 5225 y Fd(\017)41 -b Fw(Add)19 b(this)i(to)f(the)h(bottom)e(of)g(the)i(`)p -Fj($)p Fq(pr)m(e\002x)p Fo(/Mailman/mm)p 1946 5225 V -30 w(cfg.p)n(y)p Fw(')f(\002le:)p 0 5549 3901 4 v 3854 -5649 a Fo(7)p eop end +(section)0 5341 y(belo)n(w)c(\002rst!)p 0 5549 3901 4 +v 3854 5649 a Fo(7)p eop end %%Page: 8 8 -TeXDict begin 8 7 bop 802 174 a Fk(MTA)45 b(=)f('Postfix')208 -538 y Fw(The)30 b(MT)-8 b(A)31 b(v)n(ariable)f(names)h(a)g(module)f(in) -h(the)g(`)p Fv(Mailman/MT)-9 b(A)p Fw(')28 b(directory)h(which)i -(contains)f(the)h(mail)g(serv)o(er)n(-speci\002c)208 -638 y(functions)18 b(to)j(be)f(e)o(x)o(ecuted)e(when)i(a)g(list)i(is)f -(created)e(or)h(remo)o(v)o(ed.)125 804 y Fd(\017)41 b -Fw(Look)28 b(at)i(the)g(`)p Fv(Def)n(aults)o(.p)n(y)p -Fw(')c(\002le)k(for)f(the)h(v)n(ariables)f Fq(POSTFIX)p -2145 804 25 4 v 28 w(ALIAS)p 2391 804 V 29 w(CMD)h Fw(and)f -Fq(POSTFIX)p 3113 804 V 29 w(MAP)p 3313 804 V 29 w(CMD)i -Fw(command.)208 903 y(Mak)o(e)26 b(sure)h(these)h(point)e(to)i(your)d -Fr(postalias)i Fw(and)g Fr(postmap)g Fw(programs)e(respecti)n(v)o(ely) --5 b(.)44 b(Remember)26 b(that)h(if)h(you)e(need)g(to)208 -1003 y(mak)o(e)19 b(changes,)g(do)h(it)h(in)f(`)p Fv(mm)p -1128 1003 23 4 v 27 w(cfg.p)n(y)p Fw('.)125 1169 y Fd(\017)41 -b Fw(Run)20 b(the)g Fr(bin/genaliases)g Fw(script)h(to)f(initialize)g -(your)f(`)p Fv(aliases)p Fw(')g(\002le.)802 1393 y Fk(\045)45 -b(cd)g(/usr/local/mailman)802 1485 y(\045)g(bin/genaliases)208 -1848 y Fw(Mak)o(e)21 b(sure)h(that)g(the)g(o)n(wner)e(of)i(the)g(`)p -Fv(data/aliases)p Fw(')c(and)j(`)p Fv(data/aliases)o(.db)p -Fw(')c(\002le)23 b(is)f Fl(mailman)p Fw(,)g(that)g(the)f(group)f(o)n -(wner)h(for)208 1948 y(those)f(\002les)h(is)g Fl(mailman)p -Fw(,)e(or)h(whate)n(v)o(er)f(user)h(and)g(group)e(you)i(used)g(in)g -(the)g(con\002gure)f(command,)f(and)i(that)g(both)f(\002les)j(are)208 -2048 y(group)c(writable:)802 2180 y Fk(\045)45 b(su)802 -2272 y(\045)g(chown)f(mailman:mailman)e(data/aliases)2418 -2285 y(*)802 2363 y(\045)j(chmod)f(g+w)g(data/aliases)1880 -2376 y(*)125 2760 y Fd(\017)d Fw(Hack)19 b(your)g(Post\002x')-5 -b(s)21 b(`)p Fv(main.cf)p Fw(')e(\002le)i(to)f(include)g(the)g(follo)n -(wing)e(path)i(in)g(your)f Fq(alias)p 2730 2760 25 4 -v 30 w(maps)h Fw(v)n(ariable:)892 2985 y Fk -(/usr/local/mailman/data/aliases)208 3349 y Fw(Note)h(that)h(there)f -(should)g(be)g(no)h(trailing)f Fl(.db)p Fw(.)29 b(Do)22 +TeXDict begin 8 7 bop 125 83 a Fd(\017)41 b Fw(Add)19 +b(this)i(to)f(the)h(bottom)e(of)g(the)i(`)p Fj($)p Fq(pr)m(e\002x)p +Fo(/Mailman/mm)p 1946 83 25 4 v 30 w(cfg.p)n(y)p Fw(')f(\002le:)802 +307 y Fk(MTA)45 b(=)f('Postfix')208 671 y Fw(The)30 b(MT)-8 +b(A)31 b(v)n(ariable)f(names)h(a)g(module)f(in)h(the)g(`)p +Fv(Mailman/MT)-9 b(A)p Fw(')28 b(directory)h(which)i(contains)f(the)h +(mail)g(serv)o(er)n(-speci\002c)208 771 y(functions)18 +b(to)j(be)f(e)o(x)o(ecuted)e(when)i(a)g(list)i(is)f(created)e(or)h +(remo)o(v)o(ed.)125 937 y Fd(\017)41 b Fw(Look)28 b(at)i(the)g(`)p +Fv(Def)n(aults)o(.p)n(y)p Fw(')c(\002le)k(for)f(the)h(v)n(ariables)f +Fq(POSTFIX)p 2145 937 V 28 w(ALIAS)p 2391 937 V 29 w(CMD)h +Fw(and)f Fq(POSTFIX)p 3113 937 V 29 w(MAP)p 3313 937 +V 29 w(CMD)i Fw(command.)208 1036 y(Mak)o(e)26 b(sure)h(these)h(point)e +(to)i(your)d Fr(postalias)i Fw(and)g Fr(postmap)g Fw(programs)e +(respecti)n(v)o(ely)-5 b(.)44 b(Remember)26 b(that)h(if)h(you)e(need)g +(to)208 1136 y(mak)o(e)19 b(changes,)g(do)h(it)h(in)f(`)p +Fv(mm)p 1128 1136 23 4 v 27 w(cfg.p)n(y)p Fw('.)125 1302 +y Fd(\017)41 b Fw(Run)20 b(the)g Fr(bin/genaliases)g +Fw(script)h(to)f(initialize)g(your)f(`)p Fv(aliases)p +Fw(')g(\002le.)802 1526 y Fk(\045)45 b(cd)g(/usr/local/mailman)802 +1617 y(\045)g(bin/genaliases)208 1981 y Fw(Mak)o(e)21 +b(sure)h(that)g(the)g(o)n(wner)e(of)i(the)g(`)p Fv(data/aliases)p +Fw(')c(and)j(`)p Fv(data/aliases)o(.db)p Fw(')c(\002le)23 +b(is)f Fl(mailman)p Fw(,)g(that)g(the)f(group)f(o)n(wner)h(for)208 +2081 y(those)f(\002les)h(is)g Fl(mailman)p Fw(,)e(or)h(whate)n(v)o(er)f +(user)h(and)g(group)e(you)i(used)g(in)g(the)g(con\002gure)f(command,)f +(and)i(that)g(both)f(\002les)j(are)208 2180 y(group)c(writable:)802 +2313 y Fk(\045)45 b(su)802 2405 y(\045)g(chown)f(mailman:mailman)e +(data/aliases)2418 2418 y(*)802 2496 y(\045)j(chmod)f(g+w)g +(data/aliases)1880 2509 y(*)125 2893 y Fd(\017)d Fw(Hack)19 +b(your)g(Post\002x')-5 b(s)21 b(`)p Fv(main.cf)p Fw(')e(\002le)i(to)f +(include)g(the)g(follo)n(wing)e(path)i(in)g(your)f Fq(alias)p +2730 2893 25 4 v 30 w(maps)h Fw(v)n(ariable:)892 3117 +y Fk(/usr/local/mailman/data/aliases)208 3481 y Fw(Note)h(that)h(there) +f(should)g(be)g(no)h(trailing)f Fl(.db)p Fw(.)29 b(Do)22 b(not)f(include)g(this)h(in)g(your)e Fq(alias)p 2727 -3349 V 30 w(database)g Fw(v)n(ariable.)28 b(This)22 b(is)g(because)208 -3448 y(you)e(do)h(not)g(w)o(ant)g(Post\002x')-5 b(s)22 +3481 V 30 w(database)g Fw(v)n(ariable.)28 b(This)22 b(is)g(because)208 +3581 y(you)e(do)h(not)g(w)o(ant)g(Post\002x')-5 b(s)22 b Fr(newaliases)g Fw(command)d(to)j(modify)e(Mailman')-5 b(s)21 b(`)p Fv(aliases)o(.db)p Fw(')d(\002le,)k(b)n(ut)f(you)g(do)g(w) -o(ant)g(Post\002x)208 3548 y(to)f(consult)g(`)p Fv(aliases)o(.db)p +o(ant)g(Post\002x)208 3681 y(to)f(consult)g(`)p Fv(aliases)o(.db)p Fw(')d(when)i(looking)g(for)g(local)i(addresses.)208 -3681 y(Y)-9 b(ou)19 b(probably)f(w)o(ant)i(to)h(use)f(a)h +3813 y(Y)-9 b(ou)19 b(probably)f(w)o(ant)i(to)h(use)f(a)h Fl(hash:)k Fw(style)20 b(database)g(for)f(this)i(entry)-5 -b(.)24 b(Here')-5 b(s)20 b(an)g(e)o(xample:)802 3905 +b(.)24 b(Here')-5 b(s)20 b(an)g(e)o(xample:)802 4038 y Fk(alias_maps)44 b(=)g(hash:/etc/postfix/aliases,)982 -3996 y(hash:/usr/local/mailman/data/aliases)125 4394 +4129 y(hash:/usr/local/mailman/data/aliases)125 4527 y Fd(\017)d Fw(When)26 b(you)f(con\002gure)f(Mailman,)j(use)g(the)f Fr(--with-mail-gid=mailman)e Fw(switch;)30 b(this)d(will)g(be)f(the)g -(def)o(ault)g(if)g(you)f(con-)208 4493 y(\002gured)g(Mailman)i(after)f +(def)o(ault)g(if)g(you)f(con-)208 4626 y(\002gured)g(Mailman)i(after)f (adding)g(the)h Fl(mailman)f Fw(o)n(wner)-5 b(.)45 b(Because)27 b(the)g(o)n(wner)f(of)h(the)g(`)p Fv(aliases)o(.db)p -Fw(')d(\002le)k(is)g Fl(mailman)p Fw(,)208 4593 y(Post\002x)20 +Fw(')d(\002le)k(is)g Fl(mailman)p Fw(,)208 4726 y(Post\002x)20 b(will)h(e)o(x)o(ecute)e(Mailman')-5 b(s)20 b(wrapper)e(program)g(as)j -(uid)f(and)g(gid)g Fl(mailman)p Fw(.)0 4823 y(That')-5 +(uid)f(and)g(gid)g Fl(mailman)p Fw(.)0 4956 y(That')-5 b(s)24 b(it!)35 b(One)23 b(ca)n(v)o(eat:)31 b(when)23 b(you)g(add)f(or)i(remo)o(v)o(e)d(a)j(list,)h(the)e(`)p Fv(aliases)o(.db)p Fw(')e(\002le)j(will)g(updated,)e(b)n(ut)i(it)g -(will)g(not)f(automatically)0 4922 y(run)c Fr(post\002x)g(r)o(eload)p +(will)g(not)f(automatically)0 5055 y(run)c Fr(post\002x)g(r)o(eload)p Fw(.)24 b(This)19 b(is)h(because)f(you)g(need)f(to)i(be)f(root)g(to)g (run)g(this)h(and)f(suid-root)e(scripts)j(are)f(not)g(secure.)25 -b(The)19 b(only)f(ef)n(fect)0 5022 y(of)i(this)h(is)g(that)f(it)h(will) +b(The)19 b(only)f(ef)n(fect)0 5155 y(of)i(this)h(is)g(that)f(it)h(will) g(tak)o(e)f(about)f(a)i(minute)e(for)h(Post\002x)g(to)h(notice)e(the)i (change)d(to)j(the)f(`)p Fv(aliases)o(.db)p Fw(')d(\002le)k(and)f (update)f(its)i(tables.)p 0 5549 3901 4 v 0 5649 a Fo(8)2873 @@ -1831,431 +1837,446 @@ Fl(mailman)g Fw(for)g(the)h Fr(-u)g Fw(ar)o(gument)d(v)n(alue.)32 b(If)23 b(your)0 652 y(crontab)c(does)h(not)g(support)e(the)j Fr(-u)f Fw(option,)f(try)h(these)g(commands:)416 891 y Fk(\045)44 b(cd)h($prefix/cron)416 982 y(\045)f(su)h(-)f(mailman)416 -1073 y(\045)g(crontab)g(crontab.in)0 1522 y Fx(10)120 -b(Star)5 b(t)34 b(the)g(Mailman)f(qr)r(unner)0 1755 y -Fw(Mailman)20 b(depends)f(on)i(a)g(process)f(called)h(the)f -(\223qrunner\224)e(to)j(deli)n(v)o(ery)e(all)j(email)e(messages)h(it)h -(sees.)27 b(Y)-9 b(ou)20 b(must)h(start)g(the)g(qrunner)0 -1854 y(by)f(e)o(x)o(ecuting)e(the)i(follo)n(wing)f(command)f(from)h -(the)h Fj($)p Fq(pr)m(e\002x)g Fw(directory:)416 2093 -y Fk(\045)44 b(bin/mailmanctl)f(start)0 2379 y Fw(Y)-9 -b(ou)27 b(probably)f(w)o(ant)i(to)h(start)f(Mailman)g(e)n(v)o(ery)e -(time)j(you)e(reboot)g(your)f(system.)49 b(Exactly)27 -b(ho)n(w)h(to)g(do)g(this)g(depends)f(on)h(your)0 2479 -y(operating)20 b(system.)30 b(If)21 b(your)g(OS)h(supports)f(the)g -Fr(chkcon\002g)h Fw(command)e(\(e.g.)29 b(RedHat)22 b(and)f(Mandrak)o -(e)f(Linux)o(es\))g(you)h(can)g(do)h(the)0 2578 y(follo)n(wing)d(\(as)h -(root,)f(from)h(the)g(Mailman)f(install)i(directory\):)416 -2817 y Fk(\045)44 b(cp)h(scripts/mailman)d(/etc/init.d/mailman)416 -2908 y(\045)i(chkconfig)g(--add)g(mailman)0 3194 y Fw(Note)20 -b(that)g(`)p Fv(/etc/init.d)p Fw(')e(may)h(be)h(`)p Fv -(/etc/rc.d/init.d)p Fw(')d(on)j(some)g(systems.)0 3341 +1073 y(\045)g(crontab)g(crontab.in)p 0 1320 3901 17 v +0 2751 17 1432 v 75 1435 a Fr(W)-5 b(ar)o(ning:)52 b +Fw(If)20 b(you)g(accepted)g(the)g(def)o(aults)h(for)f(the)h +Fr(--with-user)o(name)e Fw(option)h(and)g(for)g(the)h(name)f(of)g(the)h +(site)h(list,)f(and)f(one)75 1535 y(of)h(the)g(cron)f(jobs)h(e)n(v)o +(er)g(encounters)e(an)i(error)m(,)f(the)h(cron)g(daemon)e(will)j(mail)g +(the)f(error)f(output)g(to)h(the)h('mailman')d(user)i(and)g(it)75 +1634 y(will)j(most)f(lik)o(ely)g(be)g(deli)n(v)o(ered)f(to)h(the)g +('mailman')f(site)i(list)h(and)d(possibly)h(not)g(be)g(accepted.)33 +b(F)o(or)23 b(this)h(reason)e(it)i(is)h(a)e(good)75 1734 +y(idea)d(to)g(insert)490 1925 y Fk(MAILTO=user@example.com)75 +2145 y Fw(or)490 2336 y Fk(MAILTO=mailman-owner)75 2576 +y Fw(at)g(the)g(be)o(ginning)d(of)i(crontab)m(.in)f(before)g +(installing)h(it)i(to)f(cause)f(this)i(output)d(to)i(be)g(mailed)f(to)h +(a)g(real)g(user)f(or)h(to)g(the)f(o)n(wner)g(of)75 2675 +y(the)h(site)h(list)g(or)f(to)h(con\002gure)d(the)i(site)h(list)g +(\(see)g(section)f(8\))g(to)g(accept)g(this)h(mail.)p +3883 2751 V 0 2768 3901 17 v 0 3104 a Fx(10)120 b(Star)5 +b(t)34 b(the)g(Mailman)f(qr)r(unner)0 3336 y Fw(Mailman)20 +b(depends)f(on)i(a)g(process)f(called)h(the)f(\223qrunner\224)e(to)j +(deli)n(v)o(ery)e(all)j(email)e(messages)h(it)h(sees.)27 +b(Y)-9 b(ou)20 b(must)h(start)g(the)g(qrunner)0 3436 +y(by)f(e)o(x)o(ecuting)e(the)i(follo)n(wing)f(command)f(from)h(the)h +Fj($)p Fq(pr)m(e\002x)g Fw(directory:)416 3674 y Fk(\045)44 +b(bin/mailmanctl)f(start)0 3961 y Fw(Y)-9 b(ou)27 b(probably)f(w)o(ant) +i(to)h(start)f(Mailman)g(e)n(v)o(ery)e(time)j(you)e(reboot)g(your)f +(system.)49 b(Exactly)27 b(ho)n(w)h(to)g(do)g(this)g(depends)f(on)h +(your)0 4060 y(operating)20 b(system.)30 b(If)21 b(your)g(OS)h +(supports)f(the)g Fr(chkcon\002g)h Fw(command)e(\(e.g.)29 +b(RedHat)22 b(and)f(Mandrak)o(e)f(Linux)o(es\))g(you)h(can)g(do)h(the)0 +4160 y(follo)n(wing)d(\(as)h(root,)f(from)h(the)g(Mailman)f(install)i +(directory\):)416 4398 y Fk(\045)44 b(cp)h(scripts/mailman)d +(/etc/init.d/mailman)416 4489 y(\045)i(chkconfig)g(--add)g(mailman)0 +4776 y Fw(Note)20 b(that)g(`)p Fv(/etc/init.d)p Fw(')e(may)h(be)h(`)p +Fv(/etc/rc.d/init.d)p Fw(')d(on)j(some)g(systems.)0 4923 y(On)g(Gentoo)f(Linux,)g(you)h(can)g(do)f(the)h(follo)n(wing:)416 -3579 y Fk(\045)44 b(cp)h(scripts/mailman)d(/etc/init.d/mailman)416 -3671 y(\045)i(rc-update)g(add)g(mailman)g(default)0 3957 -y Fw(On)20 b(Debian,)f(you)h(probably)e(w)o(ant)i(to)g(use:)416 -4196 y Fk(\045)44 b(update-rc.d)f(mailman)h(defaults)0 -4483 y Fw(F)o(or)22 b(U)t Fp(N)t(I)t(X)r Fw(es)f(that)f(don')o(t)f -(support)g Fr(chkcon\002g)p Fw(,)h(you)f(might)h(try)g(the)g(follo)n -(wing)e(set)j(of)f(commands:)p 0 5549 3901 4 v 3808 5649 -a Fo(21)p eop end +5161 y Fk(\045)44 b(cp)h(scripts/mailman)d(/etc/init.d/mailman)416 +5252 y(\045)i(rc-update)g(add)g(mailman)g(default)p 0 +5549 3901 4 v 3808 5649 a Fo(21)p eop end %%Page: 22 22 -TeXDict begin 22 21 bop 416 174 a Fk(\045)44 b(cp)h(scripts/mailman)d -(/etc/init.d/mailman)416 266 y(\045)i(cp)h(misc/mailman)e(/etc/init.d) -416 357 y(\045)h(cd)h(/etc/rc.d/rc0.d)416 448 y(\045)f(ln)h(-s)f -(../init.d/mailman)e(K12mailman)416 540 y(\045)i(cd)h(../rc1.d)416 -631 y(\045)f(ln)h(-s)f(../init.d/mailman)e(K12mailman)416 -722 y(\045)i(cd)h(../rc2.d)416 814 y(\045)f(ln)h(-s)f -(../init.d/mailman)e(S98mailman)416 905 y(\045)i(cd)h(../rc3.d)416 -996 y(\045)f(ln)h(-s)f(../init.d/mailman)e(S98mailman)416 -1088 y(\045)i(cd)h(../rc4.d)416 1179 y(\045)f(ln)h(-s)f -(../init.d/mailman)e(S98mailman)416 1270 y(\045)i(cd)h(../rc5.d)416 -1362 y(\045)f(ln)h(-s)f(../init.d/mailman)e(S98mailman)416 -1453 y(\045)i(cd)h(../rc6.d)416 1544 y(\045)f(ln)h(-s)f -(../init.d/mailman)e(K12mailman)0 1993 y Fx(11)120 b(Chec)n(k)34 -b(the)h(hostname)g(settings)0 2226 y Fw(Y)-9 b(ou)27 +TeXDict begin 22 21 bop 0 83 a Fw(On)20 b(Debian,)f(you)h(probably)e(w) +o(ant)i(to)g(use:)416 321 y Fk(\045)44 b(update-rc.d)f(mailman)h +(defaults)0 608 y Fw(F)o(or)22 b(U)t Fp(N)t(I)t(X)r Fw(es)f(that)f +(don')o(t)f(support)g Fr(chkcon\002g)p Fw(,)h(you)f(might)h(try)g(the)g +(follo)n(wing)e(set)j(of)f(commands:)416 847 y Fk(\045)44 +b(cp)h(scripts/mailman)d(/etc/init.d/mailman)416 938 +y(\045)i(cp)h(misc/mailman)e(/etc/init.d)416 1029 y(\045)h(cd)h +(/etc/rc.d/rc0.d)416 1120 y(\045)f(ln)h(-s)f(../init.d/mailman)e +(K12mailman)416 1212 y(\045)i(cd)h(../rc1.d)416 1303 +y(\045)f(ln)h(-s)f(../init.d/mailman)e(K12mailman)416 +1394 y(\045)i(cd)h(../rc2.d)416 1486 y(\045)f(ln)h(-s)f +(../init.d/mailman)e(S98mailman)416 1577 y(\045)i(cd)h(../rc3.d)416 +1668 y(\045)f(ln)h(-s)f(../init.d/mailman)e(S98mailman)416 +1760 y(\045)i(cd)h(../rc4.d)416 1851 y(\045)f(ln)h(-s)f +(../init.d/mailman)e(S98mailman)416 1942 y(\045)i(cd)h(../rc5.d)416 +2034 y(\045)f(ln)h(-s)f(../init.d/mailman)e(S98mailman)416 +2125 y(\045)i(cd)h(../rc6.d)416 2216 y(\045)f(ln)h(-s)f +(../init.d/mailman)e(K12mailman)0 2665 y Fx(11)120 b(Chec)n(k)34 +b(the)h(hostname)g(settings)0 2898 y Fw(Y)-9 b(ou)27 b(should)g(check)g(the)h(v)n(alues)f(for)g Fq(DEF)-10 -b(A)l(UL)n(T)p 1481 2226 25 4 v 30 w(EMAIL)p 1756 2226 +b(A)l(UL)n(T)p 1481 2898 25 4 v 30 w(EMAIL)p 1756 2898 V 30 w(HOST)34 b Fw(and)27 b Fq(DEF)-10 b(A)l(UL)n(T)p -2525 2226 V 30 w(URL)p 2712 2226 V 30 w(HOST)34 b Fw(in)28 +2525 2898 V 30 w(URL)p 2712 2898 V 30 w(HOST)34 b Fw(in)28 b(`)p Fv(Def)n(aults)o(.p)n(y)p Fw('.)45 b(Mak)o(e)27 -b(an)o(y)0 2325 y(necessary)19 b(changes)f(in)i(the)f(`)p -Fv(mm)p 992 2325 23 4 v 27 w(cfg.p)n(y)p Fw(')g(\002le,)h +b(an)o(y)0 2998 y(necessary)19 b(changes)f(in)i(the)f(`)p +Fv(mm)p 992 2998 23 4 v 27 w(cfg.p)n(y)p Fw(')g(\002le,)h Fr(not)f Fw(in)h(the)f(`)p Fv(Def)n(aults)o(.p)n(y)p Fw(')e(\002le.)25 b(If)19 b(you)g(change)f(either)h(of)g(these)h(tw)o -(o)g(v)n(alues,)e(you')o(ll)0 2425 y(w)o(ant)i(to)h(add)e(the)i(follo)n -(wing)d(afterw)o(ards)h(in)i(the)f(`)p Fv(mm)p 1605 2425 -V 27 w(cfg.p)n(y)p Fw(')f(\002le:)416 2663 y Fk +(o)g(v)n(alues,)e(you')o(ll)0 3097 y(w)o(ant)i(to)h(add)e(the)i(follo)n +(wing)d(afterw)o(ards)h(in)i(the)f(`)p Fv(mm)p 1605 3097 +V 27 w(cfg.p)n(y)p Fw(')f(\002le:)416 3335 y Fk (add_virtualhost\(DEFAULT_URL_HOST,)39 b(DEFAULT_EMAIL_HOST\))0 -2950 y Fw(Y)-9 b(ou)20 b(will)h(w)o(ant)f(to)g(run)g(the)g -Fr(bin/\002x)p 1056 2950 25 4 v 30 w(url.py)g Fw(to)g(change)f(the)i -(domain)d(of)i(an)o(y)g(e)o(xisting)f(lists.)0 3278 y +3622 y Fw(Y)-9 b(ou)20 b(will)h(w)o(ant)f(to)g(run)g(the)g +Fr(bin/\002x)p 1056 3622 25 4 v 30 w(url.py)g Fw(to)g(change)f(the)i +(domain)d(of)i(an)o(y)g(e)o(xisting)f(lists.)0 3950 y Fx(12)120 b(Create)35 b(the)g(site)e(pass)l(w)o(ord)0 -3511 y Fw(There)20 b(are)h(tw)o(o)g(site-wide)f(passw)o(ords)h(that)g +4183 y Fw(There)20 b(are)h(tw)o(o)g(site-wide)f(passw)o(ords)h(that)g (you)f(can)g(create)h(from)e(the)i(command)e(line,)i(using)f(the)h -Fr(bin/mmsitepass)h Fw(script.)27 b(The)0 3610 y(\002rst)c(is)f(the)g +Fr(bin/mmsitepass)h Fw(script.)27 b(The)0 4282 y(\002rst)c(is)f(the)g (\223site)h(passw)o(ord\224)e(which)g(can)h(be)g(used)f(an)o(ywhere)f (a)i(passw)o(ord)g(is)g(required)e(in)i(the)g(system.)30 -b(The)22 b(site)h(passw)o(ord)e(will)0 3710 y(get)27 +b(The)22 b(site)h(passw)o(ord)e(will)0 4382 y(get)27 b(you)f(into)h(the)g(administration)e(page)i(for)f(an)o(y)g(list,)k (and)c(it)i(can)f(be)g(used)g(to)g(log)f(in)i(as)f(an)o(y)g(user)-5 -b(.)45 b(Think)26 b Fl(root)h Fw(for)g(a)g(Unix)0 3809 +b(.)45 b(Think)26 b Fl(root)h Fw(for)g(a)g(Unix)0 4482 y(system,)20 b(so)h(pick)e(this)i(passw)o(ord)f(wisely!)0 -3956 y(The)28 b(second)e(passw)o(ord)i(is)g(a)h(site-wide)e(\223list)i +4628 y(The)28 b(second)e(passw)o(ord)i(is)g(a)h(site-wide)e(\223list)i (creator\224)e(passw)o(ord.)47 b(Y)-9 b(ou)27 b(can)h(use)g(this)g(to)g (dele)o(gate)f(the)h(ability)f(to)h(create)g(ne)n(w)0 -4056 y(mailing)22 b(lists)j(without)e(pro)o(viding)d(all)k(the)f(pri)n +4728 y(mailing)22 b(lists)j(without)e(pro)o(viding)d(all)k(the)f(pri)n (vile)o(ges)f(of)h(the)g(site)h(passw)o(ord.)33 b(Of)24 b(course,)f(the)g(o)n(wner)f(of)h(the)g(site)h(passw)o(ord)f(can)0 -4156 y(also)e(create)e(ne)n(w)h(mailing)g(lists,)h(b)n(ut)f(the)h(list) +4828 y(also)e(create)e(ne)n(w)h(mailing)g(lists,)h(b)n(ut)f(the)h(list) g(creator)e(passw)o(ord)h(is)h(limited)f(to)g(just)h(that)f(special)g -(role.)0 4302 y(T)-7 b(o)20 b(set)h(the)g(site)g(passw)o(ord,)e(use)h -(this)h(command:)416 4541 y Fk(\045)44 b($prefix/bin/mmsitepass)d -(<your-site-password>)0 4827 y Fw(T)-7 b(o)20 b(set)h(the)g(list)g -(creator)e(passw)o(ord,)g(use)i(this)f(command:)416 5065 +(role.)0 4975 y(T)-7 b(o)20 b(set)h(the)g(site)g(passw)o(ord,)e(use)h +(this)h(command:)416 5213 y Fk(\045)44 b($prefix/bin/mmsitepass)d +(<your-site-password>)p 0 5549 3901 4 v 0 5649 a Fo(22)2718 +b(12)83 b(Create)23 b(the)h(site)f(pass)n(w)o(ord)p eop +end +%%Page: 23 23 +TeXDict begin 23 22 bop 0 83 a Fw(T)-7 b(o)20 b(set)h(the)g(list)g +(creator)e(passw)o(ord,)g(use)i(this)f(command:)416 321 y Fk(\045)44 b($prefix/bin/mmsitepass)d(-c)k(<list-creator-password>)0 -5352 y Fw(It)20 b(is)i(okay)d(not)h(to)g(set)h(a)g(list)g(creator)e +608 y Fw(It)20 b(is)i(okay)d(not)h(to)g(set)h(a)g(list)g(creator)e (passw)o(ord,)g(b)n(ut)i(you)e(probably)f(do)h(w)o(ant)i(a)f(site)h -(passw)o(ord.)p 0 5549 3901 4 v 0 5649 a Fo(22)2718 b(12)83 -b(Create)23 b(the)h(site)f(pass)n(w)o(ord)p eop end -%%Page: 23 23 -TeXDict begin 23 22 bop 0 88 a Fx(13)120 b(Create)35 -b(y)n(our)f(\002rst)f(mailing)g(list)0 321 y Fw(F)o(or)17 -b(more)g(detailed)h(information)d(about)i(using)g(Mailman,)g(including) -f(creating)h(and)g(con\002guring)f(mailing)h(lists,)i(see)f(the)g -(Mailman)0 421 y(List)26 b(Adminstration)e(Manual.)41 -b(These)26 b(instructions)e(pro)o(vide)g(a)i(quick)f(guide)g(to)h -(creating)e(your)h(\002rst)h(mailing)f(list)i(via)f(the)g(web)0 -520 y(interf)o(ace:)125 748 y Fd(\017)41 b Fw(Start)20 -b(by)g(visiting)g(the)g(url)g Fl(http://my.dom.ain/mailman/create)p -Fw(.)125 913 y Fd(\017)41 b Fw(Fill)23 b(out)g(the)g(form)f(as)h -(described)f(in)h(the)g(on-screen)e(instructions,)h(and)h(in)g(the)g -(\223List)g(creator')-5 b(s)23 b(passw)o(ord\224)f(\002eld,)h(type)g -(the)208 1013 y(passw)o(ord)d(you)h(entered)f(in)h(section)h(7.)28 +(passw)o(ord.)0 935 y Fx(13)120 b(Create)35 b(y)n(our)f(\002rst)f +(mailing)g(list)0 1168 y Fw(F)o(or)17 b(more)g(detailed)h(information)d +(about)i(using)g(Mailman,)g(including)f(creating)h(and)g(con\002guring) +f(mailing)h(lists,)i(see)f(the)g(Mailman)0 1268 y(List)26 +b(Adminstration)e(Manual.)41 b(These)26 b(instructions)e(pro)o(vide)g +(a)i(quick)f(guide)g(to)h(creating)e(your)h(\002rst)h(mailing)f(list)i +(via)f(the)g(web)0 1367 y(interf)o(ace:)125 1597 y Fd(\017)41 +b Fw(Start)20 b(by)g(visiting)g(the)g(url)g Fl +(http://my.dom.ain/mailman/create)p Fw(.)125 1763 y Fd(\017)41 +b Fw(Fill)23 b(out)g(the)g(form)f(as)h(described)f(in)h(the)g +(on-screen)e(instructions,)h(and)h(in)g(the)g(\223List)g(creator')-5 +b(s)23 b(passw)o(ord\224)f(\002eld,)h(type)g(the)208 +1863 y(passw)o(ord)d(you)h(entered)f(in)h(section)h(7.)28 b(T)-7 b(ype)21 b(your)f(o)n(wn)h(email)g(address)g(for)g(the)g (\223Initial)h(list)g(o)n(wner)e(address\224,)h(and)g(select)208 -1113 y(\223Y)-8 b(es\224)20 b(to)g(notify)f(the)h(list)i(administrator) --5 b(.)125 1278 y Fd(\017)41 b Fw(Click)20 b(on)g(the)g(\223Create)h -(List\224)f(b)n(utton.)125 1443 y Fd(\017)41 b Fw(Check)19 +1962 y(\223Y)-8 b(es\224)20 b(to)g(notify)f(the)h(list)i(administrator) +-5 b(.)125 2128 y Fd(\017)41 b Fw(Click)20 b(on)g(the)g(\223Create)h +(List\224)f(b)n(utton.)125 2294 y Fd(\017)41 b Fw(Check)19 b(your)g(email)i(for)e(a)i(message)f(from)f(Mailman)g(informing)f(you)i (that)g(your)f(ne)n(w)h(mailing)f(list)j(w)o(as)f(created.)125 -1609 y Fd(\017)41 b Fw(No)n(w)g(visit)h(the)g(list')-5 +2461 y Fd(\017)41 b Fw(No)n(w)g(visit)h(the)g(list')-5 b(s)42 b(administration)e(page,)46 b(either)41 b(by)g(follo)n(wing)f (the)i(link)f(on)g(the)g(con\002rmation)f(web)h(page)g(or)208 -1708 y(clicking)g(on)h(the)h(link)f(from)g(the)g(email)h(Mailman)f +2560 y(clicking)g(on)h(the)h(link)f(from)g(the)g(email)h(Mailman)f (just)h(sent)g(you.)91 b(T)-7 b(ypically)42 b(the)g(url)g(will)i(be)e -(something)f(lik)o(e)208 1808 y Fl(http://my.dom.ain/mailman/admin/m)o -(ylist)o Fw(.)125 1973 y Fd(\017)g Fw(T)-7 b(ype)19 b(in)i(the)f(list') +(something)f(lik)o(e)208 2660 y Fl(http://my.dom.ain/mailman/admin/m)o +(ylist)o Fw(.)125 2826 y Fd(\017)g Fw(T)-7 b(ype)19 b(in)i(the)f(list') -5 b(s)21 b(passw)o(ord)f(and)g(click)g(on)g(\223Let)g(me)g(in...)-6 -b(\224)125 2138 y Fd(\017)41 b Fw(Click)20 b(on)g(\223Membership)e +b(\224)125 2992 y Fd(\017)41 b Fw(Click)20 b(on)g(\223Membership)e (Management\224)g(and)i(then)g(on)f(\223Mass)i(Subscription\224.)125 -2304 y Fd(\017)41 b Fw(Enter)19 b(your)g(email)h(address)g(in)g(the)h +3158 y Fd(\017)41 b Fw(Enter)19 b(your)g(email)h(address)g(in)g(the)h (big)e(te)o(xt)h(\002eld,)h(and)e(click)h(on)g(\223Submit)g(Y)-9 -b(our)19 b(Changes\224.)125 2469 y Fd(\017)41 b Fw(No)n(w)20 +b(our)19 b(Changes\224.)125 3324 y Fd(\017)41 b Fw(No)n(w)20 b(go)g(to)h(your)e(email)i(and)f(send)g(a)h(message)g(to)g Fl(mylist@my.dom.ain)p Fw(.)i(W)m(ithin)e(a)g(minute)e(or)i(tw)o(o)g -(you)e(should)h(see)208 2569 y(your)e(message)j(re\003ected)e(back)h -(to)g(you)f(via)h(Mailman.)0 2797 y(Congratulations!)i(Y)-9 +(you)e(should)h(see)208 3424 y(your)e(message)j(re\003ected)e(back)h +(to)g(you)f(via)h(Mailman.)0 3653 y(Congratulations!)i(Y)-9 b(ou')l(v)o(e)17 b(just)i(set)g(up)f(and)g(tested)h(your)f(\002rst)h (Mailman)f(mailing)g(list.)25 b(If)18 b(you)g(had)g(an)o(y)g(problems)f -(along)h(the)g(w)o(ay)-5 b(,)0 2896 y(please)20 b(see)h(the)f(14)g -(section.)0 3223 y Fx(14)120 b(T)-14 b(roub)n(leshooting)0 -3456 y Fw(If)20 b(you)g(encounter)e(problems)h(with)h(running)f +(along)h(the)g(w)o(ay)-5 b(,)0 3753 y(please)20 b(see)h(the)f(14)g +(section.)0 4081 y Fx(14)120 b(T)-14 b(roub)n(leshooting)0 +4313 y Fw(If)20 b(you)g(encounter)e(problems)h(with)h(running)f (Mailman,)g(\002rst)i(check)f(the)g(question)g(and)f(answer)h(section)h -(belo)n(w)-5 b(.)24 b(If)c(your)f(problem)0 3556 y(is)i(not)f(co)o(v)o +(belo)n(w)-5 b(.)24 b(If)c(your)f(problem)0 4413 y(is)i(not)f(co)o(v)o (ered)e(there,)h(check)h(the)g(online)f(help,)h(including)e(the)i(F)-6 b(A)h(Q)22 b(and)d(the)h(community)e(F)-6 b(A)h(Q)21 -b(wiki.)0 3703 y(Also)26 b(check)f(for)f(errors)h(in)h(your)e(syslog)h +b(wiki.)0 4560 y(Also)26 b(check)f(for)f(errors)h(in)h(your)e(syslog)h (\002les,)j(your)c(mail)i(and)f(web)g(serv)o(er)g(log)g(\002les)h(and)f (in)h(Mailman')-5 b(s)25 b(`)p Fj($)p Fq(pr)m(e\002x)p -Fo(/logs/error)p Fw(')0 3802 y(\002le.)37 b(If)24 b(you')l(re)e(still)k +Fo(/logs/error)p Fw(')0 4659 y(\002le.)37 b(If)24 b(you')l(re)e(still)k (ha)n(ving)d(problems,)g(you)g(should)g(send)h(a)h(message)f(to)g(the)g Fv(mailman-users@p)n(ython.org)19 b Fw(mailing)24 b(list)3711 -3772 y Fm(6)3744 3802 y Fw(;)j(see)0 3902 y Fv(http://mail.p)n +4629 y Fm(6)3744 4659 y Fw(;)j(see)0 4759 y Fv(http://mail.p)n (ython.org)o(/mail)o(man/)o(li)o(stinf)m(o/ma)o(ilma)o(n-u)o(sers)15 -b Fw(for)20 b(more)f(information.)0 4049 y(Be)j(sure)f(to)g(including)f +b Fw(for)20 b(more)f(information.)0 4906 y(Be)j(sure)f(to)g(including)f (information)e(on)j(your)f(operating)f(system,)j(which)e(v)o(ersion)g (of)h(Python)f(you')l(re)f(using,)i(and)f(which)h(v)o(ersion)0 -4149 y(of)f(Mailman)f(you')l(re)g(installing.)0 4295 +5006 y(of)f(Mailman)f(you')l(re)g(installing.)0 5152 y(Here)h(is)h(a)g(list)g(of)f(some)g(common)e(questions)i(and)f -(answers:)125 4523 y Fd(\017)41 b Fr(Pr)o(oblem:)24 b -Fw(All)d(Mailman)e(web)h(pages)g(gi)n(v)o(e)f(a)i(404)e(File)i(not)f -(found)f(error)-5 b(.)208 4656 y Fr(Solution:)25 b Fw(Y)-9 +(answers:)p 0 5224 1560 4 v 90 5279 a Fi(6)120 5303 y +Fp(Y)-7 b(ou)16 b(must)h(subscribe)h(to)g(this)f(mailing)i(list)f(in)f +(order)h(to)f(post)g(to)h(it,)f(b)o(ut)g(the)h(mailing)g(list')l(s)g +(archi)n(v)o(es)i(are)d(publicly)j(visible.)p 0 5549 +3901 4 v 3808 5649 a Fo(23)p eop end +%%Page: 24 24 +TeXDict begin 24 23 bop 125 83 a Fd(\017)41 b Fr(Pr)o(oblem:)24 +b Fw(All)d(Mailman)e(web)h(pages)g(gi)n(v)o(e)f(a)i(404)e(File)i(not)f +(found)f(error)-5 b(.)208 216 y Fr(Solution:)25 b Fw(Y)-9 b(our)19 b(web)h(serv)o(er)g(has)h(not)f(been)f(set)j(up)e(properly)e (for)i(handling)e(Mailman')-5 b(s)20 b(CGI)h(programs.)j(Mak)o(e)c -(sure)g(you)208 4755 y(ha)n(v)o(e:)286 4937 y(1.)41 b(con\002gured)18 +(sure)g(you)208 315 y(ha)n(v)o(e:)286 498 y(1.)41 b(con\002gured)18 b(the)i(web)g(serv)o(er)g(to)g(gi)n(v)o(e)f(permissions)h(to)g(`)p -Fj($)p Fq(pr)m(e\002x)p Fo(/cgi-bin)p Fw(')286 5069 y(2.)41 +Fj($)p Fq(pr)m(e\002x)p Fo(/cgi-bin)p Fw(')286 631 y(2.)41 b(restarted)20 b(the)g(web)g(serv)o(er)f(properly)-5 -b(.)208 5251 y(Consult)20 b(your)f(web)h(serv)o(er')-5 +b(.)208 814 y(Consult)20 b(your)f(web)h(serv)o(er')-5 b(s)19 b(documentation)f(for)h(instructions)g(on)h(ho)n(w)g(to)g(do)g -(check)f(these)i(issues.)p 0 5321 1560 4 v 90 5377 a -Fi(6)120 5400 y Fp(Y)-7 b(ou)16 b(must)h(subscribe)h(to)g(this)f -(mailing)i(list)f(in)f(order)h(to)f(post)g(to)h(it,)f(b)o(ut)g(the)h -(mailing)g(list')l(s)g(archi)n(v)o(es)i(are)d(publicly)j(visible.)p -0 5549 3901 4 v 3808 5649 a Fo(23)p eop end -%%Page: 24 24 -TeXDict begin 24 23 bop 125 83 a Fd(\017)41 b Fr(Pr)o(oblem:)24 +(check)f(these)i(issues.)125 980 y Fd(\017)41 b Fr(Pr)o(oblem:)24 b Fw(All)d(Mailman)e(web)h(pages)g(gi)n(v)o(e)f(an)i(\224Internal)d -(Serv)o(er)i(Error\224.)208 216 y Fr(Solution:)j Fw(The)c(lik)o(ely)f +(Serv)o(er)i(Error\224.)208 1112 y Fr(Solution:)j Fw(The)c(lik)o(ely)f (problem)f(is)i(that)g(you)e(are)i(using)f(the)g(wrong)g(user)g(or)g (group)f(for)h(the)g(CGI)i(scripts.)k(Check)18 b(your)g(web)208 -315 y(serv)o(er')-5 b(s)19 b(log)h(\002les.)26 b(If)20 -b(you)f(see)i(a)g(line)f(lik)o(e)982 540 y Fk(Attempt)43 +1212 y(serv)o(er')-5 b(s)19 b(log)h(\002les.)26 b(If)20 +b(you)f(see)i(a)g(line)f(lik)o(e)982 1436 y Fk(Attempt)43 b(to)i(exec)f(script)g(with)g(invalid)g(gid)g(51,)g(expected)g(99)208 -903 y Fw(you)19 b(will)i(need)e(to)i(reinstall)f(Mailman,)f(specifying) -g(the)h(proper)e(CGI)j(group)e(id,)h(as)h(described)e(in)h(the)g -(section.)125 1069 y Fd(\017)41 b Fr(Pr)o(oblem:)24 b -Fw(I)c(send)g(mail)h(to)f(the)g(list,)h(and)f(get)g(back)f(mail)i -(saying)e(the)i(list)g(is)g(not)f(found!)208 1202 y Fr(Solution:)37 +1800 y Fw(you)19 b(will)i(need)e(to)i(reinstall)f(Mailman,)f +(specifying)g(the)h(proper)e(CGI)j(group)e(id,)h(as)h(described)e(in)h +(the)g(section.)125 1966 y Fd(\017)41 b Fr(Pr)o(oblem:)24 +b Fw(I)c(send)g(mail)h(to)f(the)g(list,)h(and)f(get)g(back)f(mail)i +(saying)e(the)i(list)g(is)g(not)f(found!)208 2099 y Fr(Solution:)37 b Fw(Y)-9 b(ou)27 b(probably)d(didn')o(t)h(add)i(the)f(necessary)g (aliases)i(to)f(the)g(system)g(alias)g(database,)h(or)f(you)f(didn')o -(t)f(properly)208 1302 y(inte)o(grate)19 b(Mailman)i(with)g(your)f +(t)f(properly)208 2199 y(inte)o(grate)19 b(Mailman)i(with)g(your)f (mail)h(serv)o(er)-5 b(.)27 b(Perhaps)21 b(you)f(didn')o(t)f(update)h (the)h(alias)h(database,)f(or)g(your)e(system)j(requires)208 -1402 y(you)d(to)h(run)g Fr(newaliases)g Fw(e)o(xplicitly)-5 +2298 y(you)d(to)h(run)g Fr(newaliases)g Fw(e)o(xplicitly)-5 b(.)23 b(Refer)e(to)f(your)f(serv)o(er)g(speci\002c)i(instructions)e -(in)h(the)g(6)h(section.)125 1568 y Fd(\017)41 b Fr(Pr)o(oblem:)24 +(in)h(the)g(6)h(section.)125 2464 y Fd(\017)41 b Fr(Pr)o(oblem:)24 b Fw(I)c(send)g(mail)h(to)f(the)g(list,)h(and)f(get)g(back)f(mail)i -(saying,)e(\223unkno)n(wn)f(mailer)i(error\224.)208 1700 +(saying,)e(\223unkno)n(wn)f(mailer)i(error\224.)208 2597 y Fr(Solution:)35 b Fw(The)26 b(lik)o(ely)g(problem)e(is)i(that)g(you)f (are)h(using)f(the)h(wrong)e(user)i(or)f(group)f(id)i(for)g(the)f(mail) -h(wrappers.)41 b(Check)208 1800 y(your)18 b(mail)j(serv)o(er')-5 +h(wrappers.)41 b(Check)208 2697 y(your)18 b(mail)j(serv)o(er')-5 b(s)20 b(log)f(\002les;)j(if)e(you)f(see)i(a)g(line)f(lik)o(e)982 -2024 y Fk(Attempt)43 b(to)i(exec)f(script)g(with)g(invalid)g(gid)g(51,) -g(expected)g(99)208 2388 y Fw(you)19 b(will)i(need)e(to)i(reinstall)f +2921 y Fk(Attempt)43 b(to)i(exec)f(script)g(with)g(invalid)g(gid)g(51,) +g(expected)g(99)208 3285 y Fw(you)19 b(will)i(need)e(to)i(reinstall)f (Mailman,)f(specifying)g(the)h(proper)e(mail)j(group)d(id)j(as)g -(described)d(in)j(the)f(section.)125 2554 y Fd(\017)41 +(described)d(in)j(the)f(section.)125 3451 y Fd(\017)41 b Fr(Pr)o(oblem:)g Fw(I)28 b(use)h(Post\002x)g(as)g(my)f(mail)h(serv)o (er)f(and)g(the)h(mail)f(wrapper)f(programs)g(are)i(logging)d -(complaints)i(about)g(the)208 2654 y(wrong)18 b(GID.)208 -2787 y Fr(Solution:)40 b Fw(Mak)o(e)27 b(sure)h(the)g(`)p +(complaints)i(about)g(the)208 3550 y(wrong)18 b(GID.)208 +3683 y Fr(Solution:)40 b Fw(Mak)o(e)27 b(sure)h(the)g(`)p Fj($)p Fq(pr)m(e\002x)p Fo(/data/aliases)o(.db)p Fw(')g(\002le)h(is)f (user)g(o)n(wned)f(by)g Fl(mailman)h Fw(\(or)f(whate)n(v)o(er)f(user)i -(name)208 2886 y(you)21 b(used)h(in)g(the)g Fr(con\002gur)o(e)g +(name)208 3783 y(you)21 b(used)h(in)g(the)g Fr(con\002gur)o(e)g Fw(command\).)28 b(If)22 b(this)h(\002le)g(is)g(not)f(user)g(o)n(wned)f (by)h Fl(mailman)p Fw(,)f(Post\002x)i(will)g(not)f(run)f(the)h(mail)208 -2986 y(programs)c(as)j(the)f(correct)f(user)-5 b(.)125 -3152 y Fd(\017)41 b Fr(Pr)o(oblem:)h Fw(I)29 b(use)h(Sendmail)f(as)h +3882 y(programs)c(as)j(the)f(correct)f(user)-5 b(.)125 +4048 y Fd(\017)41 b Fr(Pr)o(oblem:)h Fw(I)29 b(use)h(Sendmail)f(as)h (my)f(mail)g(serv)o(er)m(,)h(and)f(when)g(I)g(send)g(mail)h(to)f(the)g (list,)k(I)c(get)h(back)e(mail)i(saying,)g(\223sh:)208 -3251 y(mailman)19 b(not)h(a)n(v)n(ailable)f(for)h(sendmail)g -(programs\224.)208 3384 y Fr(Solution:)33 b Fw(Y)-9 b(our)24 +4148 y(mailman)19 b(not)h(a)n(v)n(ailable)f(for)h(sendmail)g +(programs\224.)208 4281 y Fr(Solution:)33 b Fw(Y)-9 b(our)24 b(system)g(uses)h(the)g(Sendmail)f(restricted)g(shell)h(\(smrsh\).)37 b(Y)-9 b(ou)24 b(need)g(to)g(con\002gure)f(smrsh)h(by)h(creating)e(a) -208 3484 y(symbolic)c(link)h(from)f(the)h(mail)h(wrapper)e(\(`)p +208 4381 y(symbolic)c(link)h(from)f(the)h(mail)h(wrapper)e(\(`)p Fj($)p Fq(pr)m(e\002x)p Fo(/mail/mailman)p Fw('\))i(to)f(the)h (directory)d(identifying)h(e)o(x)o(ecutables)f(allo)n(wed)208 -3584 y(to)i(run)f(under)g(smrsh.)208 3716 y(Some)g(common)g(names)h +4480 y(to)i(run)f(under)g(smrsh.)208 4613 y(Some)g(common)g(names)h (for)f(this)i(directory)d(are)j(`)p Fv(/v)n(ar/admin/sm.bin)p Fw(',)16 b(`)p Fv(/usr/admin/sm.bin)p Fw(')h(or)j(`)p -Fv(/etc/smrsh)p Fw('.)208 3849 y(Note)29 b(that)h(on)f(Debian)g(Linux,) +Fv(/etc/smrsh)p Fw('.)208 4746 y(Note)29 b(that)h(on)f(Debian)g(Linux,) h(the)g(system)f(mak)o(es)h(`)p Fv(/usr/lib/sm.bin)p Fw(',)e(which)h(is)i(wrong,)f(you)f(will)h(need)f(to)g(create)h(the)208 -3949 y(directory)20 b(`)p Fv(/usr/admin/sm.bin)p Fw(')g(and)i(add)g +4845 y(directory)20 b(`)p Fv(/usr/admin/sm.bin)p Fw(')g(and)i(add)g (the)g(link)h(there.)32 b(Note)22 b(further)f(an)o(y)h(aliases)i Fr(newaliases)e Fw(spits)i(out)e(will)h(need)f(to)208 -4048 y(be)e(adjusted)f(to)h(point)g(to)g(the)g(secure)g(link)g(to)h -(the)f(wrapper)-5 b(.)125 4215 y Fd(\017)41 b Fr(Pr)o(oblem:)24 +4945 y(be)e(adjusted)f(to)h(point)g(to)g(the)g(secure)g(link)g(to)h +(the)f(wrapper)-5 b(.)125 5111 y Fd(\017)41 b Fr(Pr)o(oblem:)24 b Fw(I)c(messed)g(up)g(when)g(I)g(called)g Fr(con\002gur)o(e)p Fw(.)k(Ho)n(w)c(do)g(I)g(clean)g(things)g(up)g(and)g(re-install?)208 -4347 y Fr(Solution:)802 4480 y Fk(\045)45 b(make)f(clean)802 -4572 y(\045)h(./configure)e(--with-the-right-options)802 -4663 y(\045)i(make)f(install)p 0 5549 3901 4 v 0 5649 -a Fo(24)3049 b(14)83 b(T)-10 b(roub)n(leshooting)p eop -end +5244 y Fr(Solution:)p 0 5549 3901 4 v 0 5649 a Fo(24)3049 +b(14)83 b(T)-10 b(roub)n(leshooting)p eop end %%Page: 25 25 -TeXDict begin 25 24 bop 0 87 a Fx(15)120 b(Platf)l(or)s(m)34 -b(and)h(oper)o(ating)g(system)e(notes)0 320 y Fw(Generally)-5 +TeXDict begin 25 24 bop 802 83 a Fk(\045)45 b(make)f(clean)802 +174 y(\045)h(./configure)e(--with-the-right-options)802 +266 y(\045)i(make)f(install)0 805 y Fx(15)120 b(Platf)l(or)s(m)34 +b(and)h(oper)o(ating)g(system)e(notes)0 1038 y Fw(Generally)-5 b(,)30 b(Mailman)f(runs)h(on)f(an)o(y)g(POSIX-based)g(system,)j(such)d (as)h(Solaris,)j(the)c(v)n(arious)g(BSD)i(v)n(ariants,)g(Linux)d -(systems,)0 420 y(MacOSX,)d(and)g(other)f(generic)j(U)t +(systems,)0 1137 y(MacOSX,)d(and)g(other)f(generic)j(U)t Fp(N)t(I)t(X)h Fw(systems.)41 b(It)25 b(doesn')o(t)f(run)h(on)g(W)m (indo)n(ws.)39 b(F)o(or)25 b(the)h(most)f(part,)h(the)f(generic)g -(instructions)0 519 y(gi)n(v)o(en)k(in)i(this)f(document)f(should)g(be) -h(suf)n(\002cient)g(to)h(get)f(Mailman)g(w)o(orking)f(on)h(an)o(y)f -(supported)f(platform.)54 b(Some)30 b(operating)0 619 +(instructions)0 1237 y(gi)n(v)o(en)k(in)i(this)f(document)f(should)g +(be)h(suf)n(\002cient)g(to)h(get)f(Mailman)g(w)o(orking)f(on)h(an)o(y)f +(supported)f(platform.)54 b(Some)30 b(operating)0 1337 y(systems)21 b(ha)n(v)o(e)e(additional)g(recommended)e(installation)j -(or)g(con\002guration)d(instructions.)0 904 y Fn(15.1)100 -b(GNU/Lin)o(ux)28 b(issues)0 1107 y Fw(Linux)18 b(seems)i(to)g(be)f +(or)g(con\002guration)d(instructions.)0 1622 y Fn(15.1)100 +b(GNU/Lin)o(ux)28 b(issues)0 1824 y Fw(Linux)18 b(seems)i(to)g(be)f (the)h(most)f(popular)f(platform)g(for)h(running)e(Mailman.)24 b(Here)c(are)f(some)g(hints)h(on)f(getting)g(Mailman)g(to)g(run)g(on)0 -1206 y(Linux:)125 1436 y Fd(\017)41 b Fw(If)f(you)f(are)h(getting)f +1924 y(Linux:)125 2154 y Fd(\017)41 b Fw(If)f(you)f(are)h(getting)f (errors)g(with)i(hard)e(link)h(creations)f(and/or)g(you)g(are)h(using)g -(a)g(special)h(secure)e(k)o(ernel)h(\(secure-)208 1536 +(a)g(special)h(secure)e(k)o(ernel)h(\(secure-)208 2254 y(linux/openw)o(all/grsecurity\),)23 b(see)28 b(the)f(\002le)g(`)p -Fv(contr)q(ib/README.chec)o(k)p 2348 1536 23 4 v 24 w(per)r(ms)p -2582 1536 V 26 w(g)o(rsecur)q(ity)p Fw(')f(in)h(the)g(Mailman)f(source) -g(dis-)208 1636 y(trib)n(ution.)208 1768 y(Note)20 b(that)g(if)g(you)g +Fv(contr)q(ib/README.chec)o(k)p 2348 2254 23 4 v 24 w(per)r(ms)p +2582 2254 V 26 w(g)o(rsecur)q(ity)p Fw(')f(in)h(the)g(Mailman)f(source) +g(dis-)208 2353 y(trib)n(ution.)208 2486 y(Note)20 b(that)g(if)g(you)g (are)g(using)g(Linux)f(Mandrak)o(e)f(in)i(secure)g(mode,)f(you)h(are)g -(probably)e(concerned)f(by)j(this.)125 1934 y Fd(\017)41 +(probably)e(concerned)f(by)j(this.)125 2652 y Fd(\017)41 b Fw(Apparently)16 b(Mandrak)o(e)i(9.0)g(changed)f(the)h(permissions)g (on)h(gcc,)f(so)i(if)f(you)f(b)n(uild)g(as)h(the)g Fl(mailman)f -Fw(user)m(,)h(you)f(need)g(to)h(be)208 2034 y(sure)h +Fw(user)m(,)h(you)f(need)g(to)h(be)208 2752 y(sure)h Fl(mailman)f Fw(is)i(in)g(the)f Fl(cctools)f Fw(group.)125 -2200 y Fd(\017)41 b Fw(If)19 b(you)g(installed)g(Python)f(from)h(your)f +2918 y Fd(\017)41 b Fw(If)19 b(you)g(installed)g(Python)f(from)h(your)f (Linux)h(distrib)n(ution')-5 b(s)18 b(package)h(manager)f(\(e.g.)24 b(.rpms)19 b(for)f(Redhat-deri)n(v)o(ed)f(systems)208 -2300 y(or)j(.deb)h(for)f(Debian\),)g(you)g(must)h(install)h(the)f +3017 y(or)j(.deb)h(for)f(Debian\),)g(you)g(must)h(install)h(the)f (\223de)n(v)o(elopment\224)d(package)i(of)h(Python,)f(or)g(you)h(may)f -(not)h(get)g(e)n(v)o(erything)d(you)208 2399 y(need.)208 -2532 y(F)o(or)h(e)o(xample,)g(using)h(Python)f(2.2)g(on)h(Debian,)g +(not)h(get)g(e)n(v)o(erything)d(you)208 3117 y(need.)208 +3250 y(F)o(or)h(e)o(xample,)g(using)h(Python)f(2.2)g(on)h(Debian,)g (you)f(will)i(need)e(to)i(install)g(the)f Fl(python2.2-dev)e -Fw(package.)24 b(On)c(Redhat,)208 2632 y(you)f(probably)f(need)h(the)h -Fl(python2-devel)f Fw(package.)208 2765 y(If)h(you)f(install)i(Python)e -(from)g(source,)g(you)g(should)g(be)i(\002ne.)208 2898 +Fw(package.)24 b(On)c(Redhat,)208 3349 y(you)f(probably)f(need)h(the)h +Fl(python2-devel)f Fw(package.)208 3482 y(If)h(you)f(install)i(Python)e +(from)g(source,)g(you)g(should)g(be)i(\002ne.)208 3615 y(One)f(symptom)f(of)h(this)h(problem,)d(although)g(for)i(unkno)n(wn)e (reasons,)i(is)h(that)f(you)g(might)f(get)i(an)f(error)f(such)h(as)h -(this)g(during)208 2997 y(your)d(install:)892 3221 y +(this)g(during)208 3715 y(your)d(install:)892 3939 y Fk(Traceback)43 b(\(most)h(recent)g(call)g(last\):)982 -3313 y(File)g("bin/update",)f(line)h(44,)g(in)h(?)1071 -3404 y(import)f(paths)892 3495 y(ImportError:)f(No)h(module)g(named)g -(paths)892 3587 y(make:)1161 3600 y(***)1340 3587 y([update])g(Error)g -(1)208 3951 y Fw(If)24 b(this)i(happens,)e(install)i(the)f(Python)f(de) +4030 y(File)g("bin/update",)f(line)h(44,)g(in)h(?)1071 +4122 y(import)f(paths)892 4213 y(ImportError:)f(No)h(module)g(named)g +(paths)892 4304 y(make:)1161 4317 y(***)1340 4304 y([update])g(Error)g +(1)208 4669 y Fw(If)24 b(this)i(happens,)e(install)i(the)f(Python)f(de) n(v)o(elopment)e(package)h(and)i(try)f Fr(con\002gur)o(e)h Fw(and)f Fr(mak)o(e)h(install)h Fw(again.)38 b(Or)25 -b(install)208 4051 y(the)20 b(latest)h(v)o(ersion)e(of)h(Python)f(from) +b(install)208 4768 y(the)20 b(latest)h(v)o(ersion)e(of)h(Python)f(from) g(source,)g(a)n(v)n(ailable)h(from)f Fv(http://www)l(.p)n(ython.org)-6 -b Fw(.)208 4183 y(This)25 b(problem)f(can)h(manifest)g(itself)h(in)f +b Fw(.)208 4901 y(This)25 b(problem)f(can)h(manifest)g(itself)h(in)f (other)g(Linux)f(distrib)n(utions)g(in)i(dif)n(ferent)d(w)o(ays,)k -(although)d(usually)g(it)i(appears)f(as)208 4283 y Fl(ImportErrors)p -Fw(.)0 4568 y Fn(15.2)100 b(BSD)29 b(issues)0 4771 y -Fw(V)-5 b(i)n(v)o(ek)26 b(Khera)h(writes)h(that)f(some)h(BSDs)g(do)f -(nightly)f(security)h(scans)h(for)e(setuid)i(\002le)g(changes.)45 -b(setgid)27 b(directories)g(also)g(come)0 4871 y(up)c(on)g(the)h(scan)g +(although)d(usually)g(it)i(appears)f(as)208 5001 y Fl(ImportErrors)p +Fw(.)p 0 5549 3901 4 v 3808 5649 a Fo(25)p eop end +%%Page: 26 26 +TeXDict begin 26 25 bop 0 83 a Fn(15.2)100 b(BSD)29 b(issues)0 +286 y Fw(V)-5 b(i)n(v)o(ek)26 b(Khera)h(writes)h(that)f(some)h(BSDs)g +(do)f(nightly)f(security)h(scans)h(for)e(setuid)i(\002le)g(changes.)45 +b(setgid)27 b(directories)g(also)g(come)0 386 y(up)c(on)g(the)h(scan)g (when)f(the)o(y)f(change.)34 b(Also,)25 b(the)e(setgid)h(bit)g(is)g (not)f(necessary)g(on)g(BSD)i(systems)f(because)f(group)f(o)n(wnership) -g(is)0 4970 y(automatically)d(inherited)h(on)g(\002les)h(created)f(in)h +g(is)0 485 y(automatically)d(inherited)h(on)g(\002les)h(created)f(in)h (directories.)k(On)c(other)h(U)t Fp(N)t(I)t(X)r Fw(es,)g(this)f(only)f -(happens)f(when)h(the)h(directory)e(has)i(the)0 5070 -y(setgid)f(bit)h(turned)d(on.)0 5217 y(T)-7 b(o)29 b(install)h(without) -e(turning)g(on)g(the)i(setgid)f(bit)g(on)g(directories,)h(simply)e -(pass)i(in)f(the)g Fq(DIRSETGID)f Fw(v)n(ariable)g(to)h -Fr(mak)o(e)p Fw(,)j(after)0 5316 y(you')l(v)o(e)18 b(run)h -Fr(con\002gur)o(e)p Fw(:)p 0 5549 3901 4 v 3808 5649 -a Fo(25)p eop end -%%Page: 26 26 -TeXDict begin 26 25 bop 416 174 a Fk(\045)44 b(make)g(DIRSETGID=:)f -(install)0 461 y Fw(This)20 b(disables)h(the)f Fr(chmod)g(g+s)h -Fw(command)e(on)g(installed)h(directories.)0 745 y Fn(15.3)100 -b(MacOSX)29 b(issues)0 948 y Fw(Man)o(y)22 b(people)g(run)h(Mailman)g -(on)g(MacOSX.)g(Here)g(are)g(some)g(pointers)g(that)g(ha)n(v)o(e)g -(been)f(collected)h(on)g(getting)f(Mailman)h(to)g(run)0 -1047 y(on)d(MacOSX.)125 1271 y Fd(\017)41 b Fw(Jaguar)17 -b(\(MacOSX)i(10.2\))e(comes)i(with)f(Python)g(2.2.)24 -b(While)19 b(this)g(isn')o(t)f(the)h(v)o(ery)f(latest)h(stable)g(v)o -(ersion)e(of)i(Python,)e(it)j(ought)208 1370 y(to)g(be)g(suf)n -(\002cient)g(to)g(run)f(Mailman)h(2.1.)125 1534 y Fd(\017)41 -b Fw(Da)n(vid)24 b(B.)i(O'Donnell)e(has)h(a)g(web)g(page)f(describing)g -(his)h(con\002guration)d(of)j(Mailman)f(2.0.13)f(and)i(Post\002x)g(on)f -(MacOSX)208 1633 y(Serv)o(er)-5 b(.)208 1765 y Fv(http://www)l +(happens)f(when)h(the)h(directory)e(has)i(the)0 585 y(setgid)f(bit)h +(turned)d(on.)0 732 y(T)-7 b(o)29 b(install)h(without)e(turning)g(on)g +(the)i(setgid)f(bit)g(on)g(directories,)h(simply)e(pass)i(in)f(the)g +Fq(DIRSETGID)f Fw(v)n(ariable)g(to)h Fr(mak)o(e)p Fw(,)j(after)0 +831 y(you')l(v)o(e)18 b(run)h Fr(con\002gur)o(e)p Fw(:)416 +1070 y Fk(\045)44 b(make)g(DIRSETGID=:)f(install)0 1356 +y Fw(This)20 b(disables)h(the)f Fr(chmod)g(g+s)h Fw(command)e(on)g +(installed)h(directories.)0 1641 y Fn(15.3)100 b(MacOSX)29 +b(issues)0 1844 y Fw(Man)o(y)22 b(people)g(run)h(Mailman)g(on)g +(MacOSX.)g(Here)g(are)g(some)g(pointers)g(that)g(ha)n(v)o(e)g(been)f +(collected)h(on)g(getting)f(Mailman)h(to)g(run)0 1943 +y(on)d(MacOSX.)125 2173 y Fd(\017)41 b Fw(Jaguar)17 b(\(MacOSX)i +(10.2\))e(comes)i(with)f(Python)g(2.2.)24 b(While)19 +b(this)g(isn')o(t)f(the)h(v)o(ery)f(latest)h(stable)g(v)o(ersion)e(of)i +(Python,)e(it)j(ought)208 2273 y(to)g(be)g(suf)n(\002cient)g(to)g(run)f +(Mailman)h(2.1.)125 2439 y Fd(\017)41 b Fw(Da)n(vid)24 +b(B.)i(O'Donnell)e(has)h(a)g(web)g(page)f(describing)g(his)h +(con\002guration)d(of)j(Mailman)f(2.0.13)f(and)i(Post\002x)g(on)f +(MacOSX)208 2539 y(Serv)o(er)-5 b(.)208 2671 y Fv(http://www)l (.afp548.com/Ar)s(t)o(icle)o(s/mail)o(/p)n(yth)o(on)o(-mail)o(man)o -(.html)125 1928 y Fd(\017)41 b Fw(Kathleen)19 b(W)-7 +(.html)125 2838 y Fd(\017)41 b Fw(Kathleen)19 b(W)-7 b(ebb)20 b(posted)g(her)g(e)o(xperiences)e(in)i(getting)g(Mailman)f -(running)f(on)i(Jaguar)g(using)f(Sendmail.)208 2060 y +(running)f(on)i(Jaguar)g(using)f(Sendmail.)208 2970 y Fv(http://mail.p)n(ython.or)o(g/p)o(ip)o(er)r(mai)o(l/ma)o(il)o(man-u)o (sers/20)o(02)o(-Octobe)o(r/0)o(22)o(94)o(4.h)o(tml)125 -2224 y Fd(\017)41 b Fw(P)o(anther)17 b(serv)o(er)h(\(MacOSX)h(10.3\))e +3136 y Fd(\017)41 b Fw(P)o(anther)17 b(serv)o(er)h(\(MacOSX)h(10.3\))e (comes)i(with)g(Mailman;)f(Y)-9 b(our)18 b(operating)f(system)i(should) -f(contain)g(documentation)d(that)208 2323 y(will)22 b(help)g(you,)f +f(contain)g(documentation)d(that)208 3236 y(will)22 b(help)g(you,)f (and)h(Apple)f(has)h(a)h(tech)f(document)e(about)h(a)h(problem)e(you)h (might)h(encounter)e(running)g(Mailman)h(on)g(Mac)208 -2423 y(OS)f(X)h(Serv)o(er)e(10.3:)208 2554 y Fv(http://docs)o(.inf)n(o) +3336 y(OS)f(X)h(Serv)o(er)e(10.3:)208 3468 y Fv(http://docs)o(.inf)n(o) m(.appl)o(e)o(.)o(com/ar)s(t)o(icle)n(.html)o(?a)o(r)s(tn)o(u)o(m=10)o -(78)o(89)0 2778 y Fw(T)-6 b(erry)27 b(Allen)h(pro)o(vides)e(the)h +(78)o(89)0 3698 y Fw(T)-6 b(erry)27 b(Allen)h(pro)o(vides)e(the)h (follo)n(wing)g(detailed)g(instructions)g(on)g(running)f(Mailman)h(on)g (the)h('client')f(v)o(ersion)f(of)i(OSX,)g(or)f(in)0 -2878 y(earlier)20 b(v)o(ersions)f(of)h(OSX:)0 3024 y(Mac)26 +3798 y(earlier)20 b(v)o(ersions)f(of)h(OSX:)0 3945 y(Mac)26 b(OSX)h(10.3)e(and)h(onw)o(ards)f(has)i(the)f(basics)g(for)g(a)h (successful)f(Mailman)f(installation.)43 b(Users)27 b(of)e(earlier)h(v) -o(ersions)g(of)f(Mac)0 3124 y(OSX)f(contains)f(Sendmail)g(and)g(those)g +o(ersions)g(of)f(Mac)0 4044 y(OSX)f(contains)f(Sendmail)g(and)g(those)g (users)h(should)f(look)f(at)i(the)g(Sendmail)f(installation)g(section)g (for)g(tips.)36 b(Y)-9 b(ou)23 b(should)f(follo)n(w)0 -3224 y(the)27 b(basic)f(installation)g(steps)i(as)f(described)e +4144 y(the)27 b(basic)f(installation)g(steps)i(as)f(described)e (earlier)h(in)h(this)g(manual,)g(substituting)f(as)h(appropriate,)e -(the)i(steps)g(outlined)e(in)i(this)0 3323 y(section.)0 -3470 y(By)d(def)o(ault,)g(Mac)g(OSX)g(10.3)e('client')h(v)o(ersion)g +(the)i(steps)g(outlined)e(in)i(this)0 4244 y(section.)0 +4391 y(By)d(def)o(ault,)g(Mac)g(OSX)g(10.3)e('client')h(v)o(ersion)g (does)g(not)h(ha)n(v)o(e)f(a)h(fully)f(functional)f(v)o(ersion)g(of)i -(Post\002x.)35 b(Setting)24 b(up)f(a)h(w)o(orking)0 3570 +(Post\002x.)35 b(Setting)24 b(up)f(a)h(w)o(orking)0 4490 y(MT)-8 b(A)19 b(such)f(as)h(Post\002x)g(is)h(be)o(yond)c(the)i(scope)g (of)h(this)g(guide)e(and)h(you)g(should)f(refer)h(to)h Fv(http://www)l(.post\002x.org)14 b Fw(for)k(tips)h(on)f(getting)0 -3669 y(Post\002x)k(running.)k(An)21 b(easy)g(w)o(ay)h(to)f(set)h +4590 y(Post\002x)k(running.)k(An)21 b(easy)g(w)o(ay)h(to)f(set)h (Post\002x)g(up)f(is)h(to)g(install)f(and)g(run)g(Post\002x)g(Enabler)m -(,)f(a)i(stand-alone)d(tool)j(for)e(con\002guring)0 3769 +(,)f(a)i(stand-alone)d(tool)j(for)e(con\002guring)0 4689 y(Post\002x)g(on)g(Mac)h(OSX,)f(a)n(v)n(ailable)g(from)f Fv(http://www)l(.roadstead.com/w)o(eb)n(l)o(og)o(/T)-9 b(u)o(tor)q(i)o(als/P)k(ost\002xEnab)n(le)o(r)l(.ht)o(ml)f -Fw(.)0 3916 y(Lik)o(e)n(wise,)25 b(Mac)g(OSX)g('client')e(v)o(ersion)h +Fw(.)0 4836 y(Lik)o(e)n(wise,)25 b(Mac)g(OSX)g('client')e(v)o(ersion)h (from)f(10.1)g(onw)o(ards)h(includes)f(a)i(w)o(orking)e(Apache)g (webserv)o(er)-5 b(.)37 b(This)25 b(is)g(switched)f(on)0 -4016 y(using)c(the)h(System)g(Preferences)e(control)h(panel)g(under)f +4936 y(using)c(the)h(System)g(Preferences)e(control)h(panel)g(under)f (the)i('Sharing)e(tab'.)26 b(A)21 b(useful)f(tool)h(for)f -(con\002guring)e(the)i(Apache)g(on)g(Mac)0 4115 y(OSX)h(is)g(W)-7 +(con\002guring)e(the)i(Apache)g(on)g(Mac)0 5036 y(OSX)h(is)g(W)-7 b(ebmin,)20 b(which)f(can)h(be)g(obtained)f(from)g Fv(http://www)l(.w)o -(ebmin.com)l Fw(.)0 4262 y(W)-7 b(ebmin)20 b(can)g(also)h(perform)d +(ebmin.com)l Fw(.)0 5182 y(W)-7 b(ebmin)20 b(can)g(also)h(perform)d (con\002guration)g(for)i(other)f(system)i(tasks,)g(including)d (Post\002x,)j(adding)d(jobs)j(to)f(your)f(crontab,)g(adding)0 -4362 y(user)h(and)g(groups,)e(plus)i(adding)f(startup)h(and)f(shutdo)n -(wn)g(jobs.)0 4509 y(In)26 b(a)g(stock)g(installation)g(of)f(OSX,)i -(the)f(requirement)e(for)h(Mailman)h(is)h(to)f(ha)n(v)o(e)f(Python)g -(installed.)42 b(Python)25 b(is)i(not)f(installed)g(by)0 -4608 y(def)o(ault,)17 b(so)g(it)g(is)h(advised)e(that)h(you)f(install)h +5282 y(user)h(and)g(groups,)e(plus)i(adding)f(startup)h(and)f(shutdo)n +(wn)g(jobs.)p 0 5549 3901 4 v 0 5649 a Fo(26)2282 b(15)83 +b(Platf)n(or)r(m)24 b(and)g(oper)o(ating)g(system)e(notes)p +eop end +%%Page: 27 27 +TeXDict begin 27 26 bop 0 83 a Fw(In)26 b(a)g(stock)g(installation)g +(of)f(OSX,)i(the)f(requirement)e(for)h(Mailman)h(is)h(to)f(ha)n(v)o(e)f +(Python)g(installed.)42 b(Python)25 b(is)i(not)f(installed)g(by)0 +183 y(def)o(ault,)17 b(so)g(it)g(is)h(advised)e(that)h(you)f(install)h (the)g(de)n(v)o(eloper')-5 b(s)15 b(tools)i(package,)f(which)g(may)g (ha)n(v)o(e)h(been)f(pro)o(vided)e(with)j(your)f(system.)0 -4708 y(It)23 b(can)f(also)h(be)g(do)n(wnloaded)d(from)i(the)g(Apple)g +282 y(It)23 b(can)f(also)h(be)g(do)n(wnloaded)d(from)i(the)g(Apple)g (de)n(v)o(eloper)f(site)i(at)g Fv(http://connect.apple)o(.com)-6 b Fw(.)33 b(Not)23 b(only)f(is)i(the)e(de)n(v)o(eloper)f(tools)0 -4807 y(package)k(an)i(essential)h(requirement)c(for)j(installing)f +382 y(package)k(an)i(essential)h(requirement)c(for)j(installing)f (Mailman,)i(b)n(ut)f(it)g(will)h(come)e(in)h(handy)f(at)h(a)h(later)f -(date)f(should)g(you)g(need)0 4907 y(other)19 b(tools.)25 +(date)f(should)g(you)g(need)0 482 y(other)19 b(tools.)25 b(The)20 b(de)n(v)o(eloper')-5 b(s)18 b(tools)j(are)f(also)g(kno)n(w)f -(by)h(the)g(name)g(XCode)g(tools.)0 5054 y(As)h(a)g(minimum,)d(the)i +(by)h(the)g(name)g(XCode)g(tools.)0 628 y(As)h(a)g(minimum,)d(the)i (Python)f(v)o(ersion)g(should)g(be)i(2.2,)e(b)n(ut)h(2.3)g(is)h -(recommended.)0 5201 y(If)f(you)g(wish)h(to)g(add)f(a)h(user)f(and)g +(recommended.)0 775 y(If)f(you)g(wish)h(to)g(add)f(a)h(user)f(and)g (group)f(using)h(the)h(command)d(line)j(in)g(OSX)g(instead)f(of)h(via)f (W)-7 b(ebmin)21 b(or)f(another)f(GUI)i(interf)o(ace,)0 -5300 y(open)d(your)f(terminal)h(application)f(and)h(follo)n(w)g(the)h +875 y(open)d(your)f(terminal)h(application)f(and)h(follo)n(w)g(the)h (commands)e(as)i(indicated)f(belo)n(w)g(-)h(do)f(not)g(type)g(the)h -(comments)f(follo)n(wing)f(the)0 5400 y(`)p Fl(#)p Fw(')j(since)g(the)o -(y)g(are)g(just)h(notes:)p 0 5549 3901 4 v 0 5649 a Fo(26)2282 -b(15)83 b(Platf)n(or)r(m)24 b(and)g(oper)o(ating)g(system)e(notes)p -eop end -%%Page: 27 27 -TeXDict begin 27 26 bop 236 174 a Fk(sudo)44 b(tcsh)236 -266 y(niutil)g(-create)g(/)g(/users/mailman)236 357 y(niutil)g -(-createprop)f(/)i(/users/mailman)d(name)i(mailman)236 -448 y(#)h(Note)f(that)g(xxx)h(is)f(a)h(free)f(user)g(ID)h(number)e(on)i -(your)f(system)236 540 y(niutil)g(-createprop)f(/)i(/users/mailman)d -(uid)i(xxx)236 631 y(niutil)g(-createprop)f(/)i(/users/mailman)d(home)i -(/usr/local/mailman)236 722 y(mkdir)g(-p)h(/usr/local/mailman)236 -814 y(niutil)f(-createprop)f(/)i(/users/mailman)d(shell)i(/bin/tcsh)236 -905 y(passwd)g(mailman)236 996 y(#)h(To)f(prevent)g(malicious)f +(comments)f(follo)n(wing)f(the)0 975 y(`)p Fl(#)p Fw(')j(since)g(the)o +(y)g(are)g(just)h(notes:)236 1213 y Fk(sudo)44 b(tcsh)236 +1304 y(niutil)g(-create)g(/)g(/users/mailman)236 1395 +y(niutil)g(-createprop)f(/)i(/users/mailman)d(name)i(mailman)236 +1487 y(#)h(Note)f(that)g(xxx)h(is)f(a)h(free)f(user)g(ID)h(number)e(on) +i(your)f(system)236 1578 y(niutil)g(-createprop)f(/)i(/users/mailman)d +(uid)i(xxx)236 1669 y(niutil)g(-createprop)f(/)i(/users/mailman)d(home) +i(/usr/local/mailman)236 1761 y(mkdir)g(-p)h(/usr/local/mailman)236 +1852 y(niutil)f(-createprop)f(/)i(/users/mailman)d(shell)i(/bin/tcsh) +236 1943 y(passwd)g(mailman)236 2035 y(#)h(To)f(prevent)g(malicious)f (hacking,)h(supply)g(a)g(secure)g(password)g(here)236 -1088 y(niutil)g(-create)g(/)g(/groups/mailman)236 1179 +2126 y(niutil)g(-create)g(/)g(/groups/mailman)236 2217 y(niutil)g(-createprop)f(/)i(/groups/mailman)d(name)i(mailman)236 -1270 y(#)h(Note)f(that)g(xxx)h(is)f(a)h(free)f(group)g(ID)g(number)g -(on)h(your)f(system)236 1362 y(niutil)g(-createprop)f(/)i -(/groups/mailman)d(gid)i(xxx)236 1453 y(niutil)g(-createprop)f(/)i -(/groups/mailman)d(passwd)i(')2254 1466 y(*)2299 1453 -y(')236 1544 y(niutil)g(-createprop)f(/)i(/groups/mailman)d(users)i -('mailman')236 1636 y(chown)g(mailman:mailman)f(/usr/local/mailman)236 -1727 y(cd)i(/usr/local/mailman)236 1818 y(chmod)f(a+rx,g+ws)g(.)236 -1910 y(exit)236 2001 y(su)h(mailman)0 2287 y Fw(F)o(or)21 +2309 y(#)h(Note)f(that)g(xxx)h(is)f(a)h(free)f(group)g(ID)g(number)g +(on)h(your)f(system)236 2400 y(niutil)g(-createprop)f(/)i +(/groups/mailman)d(gid)i(xxx)236 2491 y(niutil)g(-createprop)f(/)i +(/groups/mailman)d(passwd)i(')2254 2504 y(*)2299 2491 +y(')236 2583 y(niutil)g(-createprop)f(/)i(/groups/mailman)d(users)i +('mailman')236 2674 y(chown)g(mailman:mailman)f(/usr/local/mailman)236 +2765 y(cd)i(/usr/local/mailman)236 2857 y(chmod)f(a+rx,g+ws)g(.)236 +2948 y(exit)236 3039 y(su)h(mailman)0 3326 y Fw(F)o(or)21 b(setting)g(up)f(Apache)g(on)h(OSX)g(to)g(handle)f(Mailman,)h(the)g (steps)g(are)g(almost)g(identical)f(and)h(the)g(con\002guration)d -(\002le)k(on)e(a)i(stock)0 2387 y(Mac)e(OSX)h(Client)g(v)o(ersion)e(is) +(\002le)k(on)e(a)i(stock)0 3425 y(Mac)e(OSX)h(Client)g(v)o(ersion)e(is) i(stored)f(in)g(the)g(nearly)f(standard)g(location)h(of)g(`)p -Fv(/etc/httpd/httpd.conf)o Fw('.)0 2534 y(The)40 b(AFP548.com)e(site)k +Fv(/etc/httpd/httpd.conf)o Fw('.)0 3572 y(The)40 b(AFP548.com)e(site)k (has)e(a)h(time-sa)n(ving)e(automated)g(startup)h(item)h(creator)e(for) -h(Mailman,)k(which)c(can)g(be)g(found)f(at)0 2633 y Fv(http://www)l +h(Mailman,)k(which)c(can)g(be)g(found)f(at)0 3672 y Fv(http://www)l (.afp548.com/Sof)o(tw)o(ar)o(e/Mai)o(lma)o(nSta)o(r)s(tu)o(p)m(.ta)o(r) -l(.gz)0 2780 y Fw(T)-7 b(o)23 b(install)g(it,)h(cop)o(y)d(it)j(into)e +l(.gz)0 3819 y Fw(T)-7 b(o)23 b(install)g(it,)h(cop)o(y)d(it)j(into)e (your)f(`)p Fv(/Libr)o(ar)r(y/Star)s(tupItems)p Fw(')e(directory)-5 b(.)30 b(As)23 b(the)g(root)e(or)i(superuser)m(,)e(from)h(the)g -(terminal,)g(enter)h(the)0 2880 y(follo)n(wing:)236 3118 -y Fk(gunzip)44 b(MailmanStartup.tar.gz)236 3209 y(tar)h(xvf)f -(MailmanStartup.tar)0 3496 y Fw(It)20 b(will)h(create)f(the)h(startup)e +(terminal,)g(enter)h(the)0 3918 y(follo)n(wing:)236 4157 +y Fk(gunzip)44 b(MailmanStartup.tar.gz)236 4248 y(tar)h(xvf)f +(MailmanStartup.tar)0 4534 y Fw(It)20 b(will)h(create)f(the)h(startup)e (item)i(for)e(you)g(so)i(that)f(when)g(you)f(reboot,)g(Mailman)g(will)i (start)g(up.)p 0 5549 3901 4 v 0 5649 a Fo(15.3)84 b(MacOSX)23 b(issues)2972 b(27)p eop end |