summaryrefslogtreecommitdiff
path: root/admin/www/install-system.html
blob: 070aade8de18698409ac7f6a99b18c0668d5ba27 (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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
<!-- Mon Dec  9 08:32:59 2002 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
Title: System setup

-->

<head>
<title>System setup</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">
<b>System setup</b>
</td></tr>
<tr><td bgcolor="#caa08f">
<a href="install-config.html">Running configure</a>
</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>System setup</h3>

    <p><em>You will need to be <b>root</b> to perform the steps in this
    section.</em>

    <p>Before installing the Mailman software, you need to prepare your
    system by adding certain users and groups.

    <ul>

    <li>Add a new user called <tt>mailman</tt>.  Typically this is added to
      your <tt>/etc/passwd</tt> file.  If username <tt>mailman</tt>'is
      already in use, choose something else unique and see the
      <tt>--with-ownername</tt> flag below.

    <p><li>Add a new group called <tt>mailman</tt>.  Typically this is added to
      your <tt>/etc/group</tt> file.  The Mailman files will be
      installed under the <tt>mailman</tt> group, with the
      <em>set-group-id</em> bit.  Mailman's security is based on
      group-ownership permissions, so it is important to get this step
      right.  If groupname <tt>mailman</tt> is already in use, choose
      something else unique and see the <tt>--with-ownergroup</tt> below.

    <p><li>Create an installation directory (called <em>$prefix</em> in the
      documentation that follows).  All of the Mailman files will be
      installed under $prefix.  Run <tt>configure --help</tt> for ways
      to split the installation up based on read-only vs. read/write
      files.

      <p>The default installation directory for Mailman 2.1 is
      <tt>/usr/local/mailman</tt>.  It used to be
      <tt>/home/mailman</tt> for all versions prior to Mailman
      2.1alpha2.  You can override the default by using the
      <tt>--prefix</tt> option to configure (see below).  If you're
      upgrading from a version previous to Mailman2.1alpha2, you will
      need to use <tt>--prefix</tt> unless you move your mailing lists.

      <p>Watch out if your site does something like mount
      <tt>/usr/local</tt> with the nosuid option.  This will break
      Mailman, which relies on set-gid programs for its security.  If
      this describes your environment, simply install Mailman in a
      location that allows setgid programs.

      <p>Make sure the install directory is set to group
      <tt>mailman</tt> (or whatever you're going to specify as
      <tt>--with-ownergroup</tt>) and has the setgid bit set (but see
      <em>README.BSD</em> if you're on a BSD system).  You probably
      also want to guarantee that this directory is readable and
      executable by everyone.  For example, these shell commands will
      accomplish this:

<blockquote>
<pre>
% cd $prefix
% chgrp mailman .
% chmod a+rx,g+ws .
</pre>
</blockquote>

      You are now ready to configure and install the Mailman software.
    </ul>


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