← Back to branch summary

~xav0989/ubuntu/vivid/mailman/ubuntu-logo

« back to all changes in this revision

Viewing changes to admin/www/mailman-install/node10.html

  • Committer: Bazaar Package Importer
  • Author(s): Thijs Kinkhorst
  • Date: 2008-04-24 19:30:49 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20080424193049-jy5fa9tus40tjbmn
Tags: 1:2.1.10-2
Apply upstream patch to fix regression in cmd_subscribe
so that email subscribe to the -subscribe or -join address or the
-request address with a bare 'subscribe' command results in the message
being shunted.

Show diffs side-by-side

added added

removed removed

Lines of Context:
admin/www/mailman-install/node10.html
1
 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
 
<html>
3
 
<head>
4
 
<link rel="STYLESHEET" href="mailman-install.css" type='text/css' />
5
 
<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' />
6
 
<link rel='last' href='about.html' title='About this document...' />
7
 
<link rel='help' href='about.html' title='About this document...' />
8
 
<link rel="next" href="mail-server.html" />
9
 
<link rel="prev" href="node9.html" />
10
 
<link rel="parent" href="front.html" />
11
 
<link rel="next" href="mail-server.html" />
12
 
<meta name='aesop' content='information' />
13
 
<title>5 Set up your web server</title>
14
 
</head>
15
 
<body>
16
 
<DIV CLASS="navigation">
17
 
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
18
 
<table align="center" width="100%" cellpadding="0" cellspacing="2">
19
 
<tr>
20
 
<td class='online-navigation'><a rel="prev" title="4 Check your installation"
21
 
  href="node9.html"><img src='previous.png'
22
 
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
23
 
<td class='online-navigation'><a rel="parent" title="Front Matter"
24
 
  href="front.html"><img src='up.png'
25
 
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
26
 
<td class='online-navigation'><a rel="next" title="6 Set up your"
27
 
  href="mail-server.html"><img src='next.png'
28
 
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
29
 
<td align="center" width="100%">GNU Mailman - Installation Manual</td>
30
 
<td class='online-navigation'><img src='blank.png'
31
 
  border='0' height='32'  alt='' width='32' /></td>
32
 
<td class='online-navigation'><img src='blank.png'
33
 
  border='0' height='32'  alt='' width='32' /></td>
34
 
<td class='online-navigation'><img src='blank.png'
35
 
  border='0' height='32'  alt='' width='32' /></td>
36
 
</tr></table>
37
 
<div class='online-navigation'>
38
 
<b class="navlabel">Previous:</b>
39
 
<a class="sectref" rel="prev" href="node9.html">4 Check your installation</A>
40
 
<b class="navlabel">Up:</b>
41
 
<a class="sectref" rel="parent" href="front.html">Front Matter</A>
42
 
<b class="navlabel">Next:</b>
43
 
<a class="sectref" rel="next" href="mail-server.html">6 Set up your</A>
44
 
</div>
45
 
<hr /></div>
46
 
</DIV>
47
 
<!--End of Navigation Panel-->
48
 
 
49
 
<H1><A NAME="SECTION001500000000000000000">
50
 
5 Set up your web server</A>
51
 
</H1>
52
 
 
53
 
<P>
54
 
Congratulations!  You've installed the Mailman software.  To get everything
55
 
running you need to hook Mailman up to both your web server and your mail
56
 
system.
57
 
 
58
 
<P>
59
 
If you plan on running your mail and web servers on different machines,
60
 
sharing Mailman installations via NFS, be sure that the clocks on those two
61
 
machines are synchronized closely.  You might take a look at the file
62
 
<span class="file">Mailman/LockFile.py</span>; the constant <var>CLOCK_SLOP</var> helps the locking
63
 
mechanism compensate for clock skew in this type of environment.
64
 
 
65
 
<P>
66
 
This section describes some of the things you need to do to connect Mailman's
67
 
web interface to your web server.  The instructions here are somewhat geared
68
 
toward the Apache web server, so you should consult your web server
69
 
documentation for details.
70
 
 
71
 
<P>
72
 
You must configure your web server to enable CGI script permission in the
73
 
<span class="file"><var>$prefix</var>/cgi-bin</span> to run CGI scripts.  The line you should add
74
 
might look something like the following, with the real absolute directory
75
 
substituted for <var>$prefix</var>, of course:
76
 
 
77
 
<P>
78
 
<div class="verbatim"><pre>
79
 
    Exec        /mailman/*      $prefix/cgi-bin/*
80
 
</pre></div>
81
 
 
82
 
<P>
83
 
or:
84
 
 
85
 
<P>
86
 
<div class="verbatim"><pre>
87
 
    ScriptAlias /mailman/       $prefix/cgi-bin/
88
 
</pre></div>
89
 
 
90
 
<P>
91
 
<div class="warning"><b class="label">Warning:</b>
92
 
 
93
 
You want to be very sure that the user id under which your CGI scripts run is
94
 
<strong>not</strong> in the <code>mailman</code> group you created above, otherwise private
95
 
archives will be accessible to anyone.
96
 
</div>
97
 
 
98
 
<P>
99
 
Copy the Mailman, Python, and GNU logos to a location accessible to your web
100
 
server.  E.g. with Apache, you've usually got an <span class="file">icons</span> directory that
101
 
you can drop the images into.  For example:
102
 
 
103
 
<P>
104
 
<div class="verbatim"><pre>
105
 
    % cp $prefix/icons/*.{jpg,png} /path/to/apache/icons
106
 
</pre></div>
107
 
 
108
 
<P>
109
 
You then want to add a line to your <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>
110
 
file which sets the base URL for the logos.  For example:
111
 
 
112
 
<P>
113
 
<div class="verbatim"><pre>
114
 
  IMAGE_LOGOS = '/images/'
115
 
</pre></div>
116
 
 
117
 
<P>
118
 
The default value for <var>IMAGE_LOGOS</var> is <span class="file">/icons/</span>.  Read the comment
119
 
in <span class="file">Defaults.py.in</span> for details.
120
 
 
121
 
<P>
122
 
Configure your web server to point to the Pipermail public mailing list
123
 
archives.  For example, in Apache:
124
 
 
125
 
<P>
126
 
<div class="verbatim"><pre>
127
 
    Alias   /pipermail/     $varprefix/archives/public/
128
 
</pre></div>
129
 
 
130
 
<P>
131
 
where <var>$varprefix</var> is usually <var>$prefix</var> unless you've used the
132
 
<b class="programopt">--with-var-prefix</b> option to <b class="program">configure</b>.  Also be
133
 
sure to configure your web server to follow symbolic links in this directory,
134
 
otherwise public Pipermail archives won't be accessible.  For Apache users,
135
 
consult the <var>FollowSymLinks</var> option.
136
 
 
137
 
<P>
138
 
If you're going to be supporting internationalized public archives, you will
139
 
probably want to turn off any default charset directive for the Pipermail
140
 
directory, otherwise your multilingual archive pages won't show up correctly.
141
 
Here's an example for Apache, based on the standard installation directories:
142
 
 
143
 
<P>
144
 
<div class="verbatim"><pre>
145
 
    &lt;Directory "/usr/local/mailman/archives/public/"&gt;
146
 
        AddDefaultCharset Off
147
 
    &lt;/Directory&gt;
148
 
</pre></div>
149
 
 
150
 
<P>
151
 
Now restart your web server.
152
 
 
153
 
<P>
154
 
 
155
 
<DIV CLASS="navigation">
156
 
<div class='online-navigation'>
157
 
<p></p><hr />
158
 
<table align="center" width="100%" cellpadding="0" cellspacing="2">
159
 
<tr>
160
 
<td class='online-navigation'><a rel="prev" title="4 Check your installation"
161
 
  href="node9.html"><img src='previous.png'
162
 
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
163
 
<td class='online-navigation'><a rel="parent" title="Front Matter"
164
 
  href="front.html"><img src='up.png'
165
 
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
166
 
<td class='online-navigation'><a rel="next" title="6 Set up your"
167
 
  href="mail-server.html"><img src='next.png'
168
 
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
169
 
<td align="center" width="100%">GNU Mailman - Installation Manual</td>
170
 
<td class='online-navigation'><img src='blank.png'
171
 
  border='0' height='32'  alt='' width='32' /></td>
172
 
<td class='online-navigation'><img src='blank.png'
173
 
  border='0' height='32'  alt='' width='32' /></td>
174
 
<td class='online-navigation'><img src='blank.png'
175
 
  border='0' height='32'  alt='' width='32' /></td>
176
 
</tr></table>
177
 
<div class='online-navigation'>
178
 
<b class="navlabel">Previous:</b>
179
 
<a class="sectref" rel="prev" href="node9.html">4 Check your installation</A>
180
 
<b class="navlabel">Up:</b>
181
 
<a class="sectref" rel="parent" href="front.html">Front Matter</A>
182
 
<b class="navlabel">Next:</b>
183
 
<a class="sectref" rel="next" href="mail-server.html">6 Set up your</A>
184
 
</div>
185
 
</div>
186
 
<hr />
187
 
<span class="release-info">Release 2.1, documentation updated on December 13, 2005.</span>
188
 
</DIV>
189
 
<!--End of Navigation Panel-->
190
 
 
191
 
</BODY>
192
 
</HTML>