aboutsummaryrefslogtreecommitdiffstats
path: root/doc/mailman-install/create-install-dir.html
blob: 04af702cb4bdced2f872a43cefcb49bf696f2a52 (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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="mailman-install.css" type='text/css' />
<link rel="first" href="mailman-install.html" title='GNU mailman - installation Manual' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="prev" href="node4.html" />
<link rel="parent" href="node3.html" />
<link rel="next" href="node6.html" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>2.2 Create the installation directory</title>
</head>
<body>
<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="2.1 add the group"
  href="node4.html"><img src='previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="2 set up your"
  href="node3.html"><img src='up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="3 build and install"
  href="node6.html"><img src='next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">GNU Mailman - Installation Manual</td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node4.html">2.1 Add the group</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="node3.html">2 Set up your</a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node6.html">3 Build and install</a>
</div>
<hr /></div>
</div>
<!--End of Navigation Panel-->

<h2><a name="SECTION001220000000000000000"></a><a name="create-install-dir"></a>
<br>
2.2 Create the installation directory
</h2>
Typically, Mailman is installed into a single directory, which includes both
the Mailman source code and the run-time list and archive data.  It is
possible to split the static program files from the variable data files and
install them in separate directories.  This section will describe the
available options.

<p>
The default is to install all of Mailman to
<span class="file">/usr/local/mailman</span><a name="tex2html2"
  href="#foot726"><sup>2</sup></a>.  You can change this base installation directory (referred to here
as <var>$prefix</var>) by specifying the directory with the
<b class="programopt">--prefix</b> <b class="program">configure</b> option.  If you're upgrading from
a previous version of Mailman, you may want to use the <b class="programopt">--prefix</b>
option unless you move your mailing lists.

<p>
<div class="warning"><b class="label">Warning:</b>

You cannot install Mailman on a filesystem that is mounted with the
<code>nosuid</code> 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.
</div>

<p>
Make sure the installation directory is set to group <code>mailman</code> (or
whatever you're going to specify with <b class="programopt">--with-groupname</b>) and has
the setgid bit set<a name="tex2html3"
  href="#foot727"><sup>3</sup></a>.  You probably also want to guarantee that this
directory is readable and executable by everyone.  For example, these shell
commands will accomplish this:

<p>
<div class="verbatim"><pre>
    % cd $prefix
    % chgrp mailman .
    % chmod a+rx,g+ws .
</pre></div>

<p>
<div class="warning"><b class="label">Warning:</b>

The installation directory, <var>$prefix</var>, cannot be the same directory
that the source tarball has been unpacked to and in which you run
<b class="program">configure</b>, but it can, if you wish, be a subdirectory, e.g.,
<var>$prefix/src</var>.
</div>

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

<p>
<br><hr><h4>Footnotes</h4>
<dl>
<dt><a name="foot726">.../usr/local/mailman</a><A
 href="create-install-dir.html#tex2html2"><sup>2</sup></a></dt>
<dd>This is the default for Mailman 2.1.
Earlier versions of Mailman installed everything under <span class="file">/home/mailman</span> by
default.

</dd>
<dt><a name="foot727">... set</a><A
 href="create-install-dir.html#tex2html3"><sup>3</sup></a></dt>
<dd>BSD users should see the <a href="bsd-issues.html#bsd-issues">15.2</a> section
for additional information.

</dd>
</dl>
<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="2.1 add the group"
  href="node4.html"><img src='previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="2 set up your"
  href="node3.html"><img src='up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="3 build and install"
  href="node6.html"><img src='next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">GNU Mailman - Installation Manual</td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node4.html">2.1 Add the group</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="node3.html">2 Set up your</a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node6.html">3 Build and install</a>
</div>
</div>
<hr />
<span class="release-info">Release 2.1, documentation updated on September 9, 2010.</span>
</div>
<!--End of Navigation Panel-->

</body>
</html>