summaryrefslogtreecommitdiff
path: root/admin/www/install-system.html
blob: 671ecc72622011c667d493ff1b87066356df2a8a (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
<HTML>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
<!-- Wed Nov  8 13:38:29 2000 -->
<!-- USING HT2HTML 1.1 -->
<!-- SEE http://www.python.org/~bwarsaw/software/pyware.html -->
<!-- User-specified headers:
Title: System setup

-->

<HEAD>
<TITLE>System setup</TITLE>

</HEAD>
<BODY BGCOLOR="#ffffff" TEXT="#000000"
      TOPMARGIN="0" LEFTMARGIN="0" 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=CENTER BGCOLOR="black">

<center>
    <a href="./index.html">
    <img border=0 src="./images/logo-70.jpg"></a></center> </TD>
<TD WIDTH=15 BGCOLOR="#99997c">&nbsp;&nbsp;</TD><!--spacer-->
<!-- end of corner cells -->
<!-- start of banner -->
<TD WIDTH="90%" BGCOLOR="#99997c">
<!-- start of site links table -->
<TABLE WIDTH="100%" BORDER=0
CELLSPACING=0 CELLPADDING=0
       COLS=3 ROWS=4 BGCOLOR="#ffffff">
<TR>
    <TD BGCOLOR="#99997c">
<a href="./index.html">Home</a>
    </TD>
    <TD BGCOLOR="#99997c">
<a href="./users.html">Users</a>
    </TD>
    <TD BGCOLOR="#99997c">
<a href="http://www.list.org/">List.Org</a>
    </TD>
</TR><TR>
    <TD BGCOLOR="#99997c">
<a href="./install-start.html">Installation</a>
    </TD>
    <TD BGCOLOR="#99997c">
<a href="./mgrs.html">List Managers</a>
    </TD>
    <TD BGCOLOR="#99997c">
<a href="http://www.gnu.org/software/mailman/mailman.html">Mailman at GNU</a>
    </TD>
</TR><TR>
    <TD BGCOLOR="#99997c">
<a href="./faq.html">FAQ</a>
    </TD>
    <TD BGCOLOR="#99997c">
<a href="./admins.html">Site Administrators</a>
    </TD>
    <TD BGCOLOR="#99997c">
<a href="http://www.python.org/">Python.Org</a>
    </TD>
</TR><TR>
    <TD BGCOLOR="#99997c">
<a href="./lists.html">Discussion Lists</a>
    </TD>
    <TD BGCOLOR="#99997c">
<a href="./devs.html">Developers</a>
    </TD>
    <TD BGCOLOR="#99997c">
<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="#99997c">
<!-- start of sidebar table -->
<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=3
       BGCOLOR="#ffffff">
<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff">
Overview
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="index.html">Home</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="features.html">Features</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="download.html">Requirements, Download</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-start.html">Installation</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="lists.html">Discussion Lists</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="bugs.html">Bugs and Patches</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="faq.html">Frequently Asked Questions</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="inthenews.html">Mailman in Use</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="todo.html">Wishlist!</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">&nbsp;
<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff">
Installing Mailman
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-start.html">Start installing</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<b>System setup</b>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-config.html">Running configure</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-check.html">Check your installation</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-final.html">Final system setup</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-custom.html">Customize Mailman</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-test.html">Create a test list</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-trouble.html">Troubleshooting</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="install-faq.html">Common problems FAQ</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">&nbsp;
<TR><TD BGCOLOR="#663300"><B><FONT COLOR="#ffffff">
Email Us
</FONT></B></TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="mailto:mailman-cabal@python.org">mailman-cabal@python.org</A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
&nbsp;
</TD></TR>
<TR><TD BGCOLOR="#99997c">
<A HREF="http://www.python.org/">
<center>
    <img border=0 src="./images/PythonPoweredSmall.png"></center></A>
</TD></TR>
<TR><TD BGCOLOR="#99997c">
&nbsp;
</TD></TR>
<TR><TD BGCOLOR="#99997c">
&copy; 1998,1999,2000
</TD></TR>
<TR><TD BGCOLOR="#99997c">
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%"><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 <code>mailman</code>.  Typically
        this is added to your <code>/etc/passwd</code> file.  If
        username <code>mailman</code> is already in use, choose
        something else unique and see the
        <code>--with-ownername</code> flag below.

    <p><li>Add a new group called <code>mailman</code>.  Typically this
        is added to your <code>/etc/group</code> file.  The Mailman
        files will be installed under the <code>mailman</code> group,
        with the <em>set-group-id</em> bit.  This is so both the web
        based and mail based programs will have the proper write
        permissions.  If groupname <code>mailman</code> is already in
        use, choose something else unique and see the
        <code>--with-ownergroup</code> below.

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

        <p>The default directory for installing is
        <code>/home/mailman</code>, but some sites do things like
        mount <code>/home</code> with the <em>nosuid</em> option.
        This will break Mailman, which relies on setgid programs for
        its security.  If this describes your environment, simply
        install Mailman in a location that allows setgid programs.

        <p>Make sure this directory is set to group <code>mailman</code>
        (or whatever you're going to specify as
        <code>--with-ownergroup</code>) and has the setgid bit set
        (but see the README.BSD file in the source distribution 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>