summaryrefslogtreecommitdiff
path: root/admin/www/install-config.html
blob: 8357962a818014e9ccd7cfca254b24ff39cd4745 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
<!-- Mon Dec  9 08:32:58 2002 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
Title: Running configure

-->

<head>
<title>Running configure</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="generator" content="HT2HTML/2.0">
<style type="text/css">
body { margin: 0px; }
</style>
</head>
<body bgcolor="#ffffff" text="#000000"
      marginwidth="0" marginheight="0"
      link="#0000bb"  vlink="#551a8b"
      alink="#ff0000">
<!-- start of page table -->
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<!-- start of banner row -->
<tr>
<!-- start of corner cells -->
<td width="150" valign="middle" bgcolor="white" class="corner">

<center>
    <a href="./index.html">
    <img border=0 src="./images/logo-70.jpg"></a></center> </td>
<td width="15" bgcolor="#caa08f">&nbsp;&nbsp;</td><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<td width="90%" bgcolor="#caa08f" class="banner">
<!-- start of site links table -->
<table width="100%" border="0"
CELLSPACING=0 CELLPADDING=0
       bgcolor="#ffffff">
<tr>
    <td bgcolor="#caa08f">
<a href="./index.html">Home</a>
    </td>
    <td bgcolor="#caa08f">
<a href="./users.html">Users</a>
    </td>
    <td bgcolor="#caa08f">
<a href="http://www.list.org/">List.Org</a>
    </td>
</tr><tr>
    <td bgcolor="#caa08f">
<a href="./install-start.html">Installation</a>
    </td>
    <td bgcolor="#caa08f">
<a href="./mgrs.html">List Managers</a>
    </td>
    <td bgcolor="#caa08f">
<a href="http://www.gnu.org/software/mailman/mailman.html">Mailman at GNU</a>
    </td>
</tr><tr>
    <td bgcolor="#caa08f">
<a href="./faq.html">FAQ</a>
    </td>
    <td bgcolor="#caa08f">
<a href="./admins.html">Site Administrators</a>
    </td>
    <td bgcolor="#caa08f">
<a href="http://www.python.org/">Python.Org</a>
    </td>
</tr><tr>
    <td bgcolor="#caa08f">
<a href="./lists.html">Discussion Lists</a>
    </td>
    <td bgcolor="#caa08f">
<a href="./devs.html">Developers</a>
    </td>
    <td bgcolor="#caa08f">
<a href="http://www.gnu.org/">Gnu.Org</a>
    </td>
</tr>
</table><!-- end of site links table -->

</td><!-- end of banner -->
</tr><!-- end of banner row -->
<tr><!-- start of sidebar/body row -->
<!-- start of sidebar cells -->
<td width="150" valign="top" bgcolor="#caa08f" class="sidebar">
<!-- start of sidebar table -->
<table width="100%" border="0" cellspacing="0" cellpadding="3"
       bgcolor="#ffffff">
<tr><td bgcolor="#545454"><b><font color="#ffffff">
Overview
</font></b></td></tr>
<tr><td bgcolor="#caa08f">
<a href="index.html">Home</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="features.html">Features</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="download.html">Requirements, Download</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-start.html">Installation</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="lists.html">Discussion Lists</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="bugs.html">Bugs and Patches</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="faq.html">Frequently Asked Questions</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="inthenews.html">Mailman in Use</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="todo.html">Wishlist!</a>
</td></tr>
<tr><td bgcolor="#caa08f">&nbsp;
<tr><td bgcolor="#545454"><b><font color="#ffffff">
Exits
</font></b></td></tr>
<tr><td bgcolor="#caa08f">
<a href="http://listowners.org">Listowners.Org</a>
</td></tr>
<tr><td bgcolor="#caa08f">&nbsp;
<tr><td bgcolor="#545454"><b><font color="#ffffff">
Installing Mailman
</font></b></td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-start.html">Start installing</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-system.html">System setup</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<b>Running configure</b>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-check.html">Check your installation</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-final.html">Final system setup</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-custom.html">Customize Mailman</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-test.html">Create a test list</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-trouble.html">Troubleshooting</a>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-faq.html">Common problems FAQ</a>
</td></tr>
<tr><td bgcolor="#caa08f">&nbsp;
<tr><td bgcolor="#545454"><b><font color="#ffffff">
Email Us
</font></b></td></tr>
<tr><td bgcolor="#caa08f">
<a href="mailto:mailman-users@python.org">mailman-users@python.org</a>
</td></tr>
<tr><td bgcolor="#caa08f">
&nbsp;
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="http://www.python.org/"><img border=0
                          src="./images/PythonPoweredSmall.png"
                          ></a>&nbsp;<a href="http://sourceforge.net"><img 
                          src="http://sourceforge.net/sflogo.php?group_id=103"
                          width="88" height="31" border="0"
                          alt="SourceForge Logo"></a>
</td></tr>
<tr><td bgcolor="#caa08f">
&nbsp;
</td></tr>
<tr><td bgcolor="#caa08f">
&copy; 1998-2002<br>Free Software Foundation, Inc.
</td></tr>
</table><!-- end of sidebar table -->

</td>
<td width="15">&nbsp;&nbsp;</td><!--spacer-->
<!-- end of sidebar cell -->
<!-- start of body cell -->
<td valign="top" width="90%" class="body"><br>
<h3>Running configure</h3>

    <strong>TAKE SPECIAL NOTE OF THE --with-mail-gid AND --with-cgi-gid
    OPTIONS BELOW.  YOU WILL PROBABLY NEED TO USE THESE!</strong>

    <p>You should not be root while performing the steps in this
    section.  Do them under your own login, or whatever account you
    typically install software as.  You do not need to do these steps
    as user <tt>mailman</tt>, but you could.

    <p>Make sure that you have write permissions to the target
    installation directory, and permission to create a setgid file in
    the file system where it resides (NFS and other mounts can be
    configured to inhibit setgid settings).

    <p>If you've installed other GNU software, you should be familiar
    with the configure script.  Usually you can just cd to the
    directory you unpacked Mailman into, and run configure with no
    arguments:

<blockquote>
<pre>
% cd mailman-<em>version</em>
% ./configure
% make install
</pre>
</blockquote>

    <p>The following options allow you to customize your Mailman
    installation.

    <dl>
      <p><dt>--prefix=<em>dir</em>
            <dd>Standard GNU configure option which changes the base
            directory that Mailman is installed into.  By default
            <em>$prefix</em> is <tt>/usr/local/mailman</tt>.  This
            directory must already exist, and be set up as described
            in section 1 above.

      <p><dt>--exec-prefix=<em>dir</em>
            <dd>Standard GNU configure option which lets you specify a
            different installation directory for architecture
            dependent binaries.

      <p><dt>--with-var-prefix=<em>dir</em>
            <dd>Store mutable data under <em>dir</em> instead of under
            the prefix or exec_prefix.

      <p><dt>--with-python=<em>/path/to/python</em>
            <dd>Specify an alternative Python interpreter to use for
            the wrapper programs.  The default is to use the
            interpreter found first on your shell's <tt>$PATH</tt>.
            Note that when running the scripts from the command line,
            the first Python interpreter found on <tt>$PATH</tt> is
            always used.

      <p><dt>--with-username=<em>username-or-uid</em>
            <dd>Specify a different username than <tt>mailman</tt> to use
            as a default.  Use this only if the username
            <tt>mailman</tt> is already in use by somebody (e.g. Mark
            Ailman's login name).  This switch can take an integer
            user id or a user name.  Be sure your <em>$prefix</em>
            directory is owned by this user.

      <p><dt>--with-groupname=<em>groupname-or-gid</em>
            <dd>Specify a different groupname than <tt>mailman</tt> to use
            as a default.  Use this only if the groupname
            <tt>mailman</tt> is already in use.  This switch can take
            an integer group id or a group name.  Be sure your
            <em>$prefix</em> directory is group-owned by this group.

      <p><dt>--with-mail-gid=<em>group-or-groups</em>
            <dd>Specify an alternative group for running scripts via the
            mail wrapper.  <em>group-or-groups</em> can be a list of one or
            more integer group ids or symbolic group names.  The first
            value in the list that resolves to an existing group is
            used.  By default, the value is the list <tt>other daemon</tt>.

            <p>This is highly system dependent and you must get this
            right, because the group id is compiled into the mail
            wrapper program for added security.  On systems using
            sendmail, the sendmail.cf configuration file designates
            the group id of sendmail processes using the "DefaultUser"
            option.  (If commented out, it still may be indicating the
            default...)

            <p>Check your MTA's documentation and configuration files to
            find the right value for this switch.

      <p><dt>--with-cgi-gid=<em>group-or-groups</em>
            <dd>Specify an alternative group for running scripts via the
            CGI wrapper.  <em>group-or-groups</em> can be a list of one or
            more integer group ids or symbolic group names.  The first
            value in the list that resolves to an existing group is
            used.  By default, the value is the the list <tt>www www-data
            nobody</tt>.

            <p>The proper value for this is dependent on your web server
            configuration.  You must get this right, because the group
            id is compiled into the CGI wrapper program for added
            security, and no Mailman CGI scripts will run if this is
            incorrect.

            <p>If you're using Apache, check the values for the `Group'
            option in your httpd.conf file.

      <p><dt>--with-cgi-ext=<em>extension</em>
            <dd>Specify an extension for cgi-bin programs.  The CGI
            wrappers placed in <em>$PREFIX/cgi-bin</em> will have this
            extension (some web servers require an extension).
            <em>extension</em> must include the dot.

      <p><dt>--with-gcc=no
            <dd>Don't use gcc, even if it is found.  `cc' must be found on
            your <em>$PATH</em>.
      </dl>

</td><!-- end of body cell -->
</tr><!-- end of sidebar/body row -->
</table><!-- end of page table -->
</body></html>