~launchpad-pqm/mailman/2.1

« back to all changes in this revision

Viewing changes to doc/mailman-install/create-install-dir.html

  • Committer: Launchpad Patch Queue Manager
  • Date: 2009-10-21 01:06:17 UTC
  • mfrom: (975.1.1 mailman.2112)
  • Revision ID: launchpad@pqm.canonical.com-20091021010617-prbs2ay6nhxx515v
[rs=flacoste] Upgrade Mailman to upstream 2.1.12

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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="prev" href="node4.html" />
 
9
<link rel="parent" href="node3.html" />
 
10
<link rel="next" href="node6.html" />
 
11
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
12
<meta name='aesop' content='information' />
 
13
<title>2.2 Create the installation directory</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="2.1 add the group"
 
21
  href="node4.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="2 set up your"
 
24
  href="node3.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="3 build and install"
 
27
  href="node6.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="node4.html">2.1 Add the group</a>
 
40
<b class="navlabel">Up:</b>
 
41
<a class="sectref" rel="parent" href="node3.html">2 Set up your</a>
 
42
<b class="navlabel">Next:</b>
 
43
<a class="sectref" rel="next" href="node6.html">3 Build and install</a>
 
44
</div>
 
45
<hr /></div>
 
46
</div>
 
47
<!--End of Navigation Panel-->
 
48
 
 
49
<h2><a name="SECTION001220000000000000000"></a><a name="create-install-dir"></a>
 
50
<br>
 
51
2.2 Create the installation directory
 
52
</h2>
 
53
Typically, Mailman is installed into a single directory, which includes both
 
54
the Mailman source code and the run-time list and archive data.  It is
 
55
possible to split the static program files from the variable data files and
 
56
install them in separate directories.  This section will describe the
 
57
available options.
 
58
 
 
59
<p>
 
60
The default is to install all of Mailman to
 
61
<span class="file">/usr/local/mailman</span><a name="tex2html2"
 
62
  href="#foot706"><sup>2</sup></a>.  You can change this base installation directory (referred to here
 
63
as <var>$prefix</var>) by specifying the directory with the
 
64
<b class="programopt">--prefix</b> <b class="program">configure</b> option.  If you're upgrading from
 
65
a previous version of Mailman, you may want to use the <b class="programopt">--prefix</b>
 
66
option unless you move your mailing lists.
 
67
 
 
68
<p>
 
69
<div class="warning"><b class="label">Warning:</b>
 
70
 
 
71
You cannot install Mailman on a filesystem that is mounted with the
 
72
<code>nosuid</code> option.  This will break Mailman, which relies on setgid
 
73
programs for its security.  If this describes your environment, simply install
 
74
Mailman in a location that allows setgid programs.
 
75
</div>
 
76
 
 
77
<p>
 
78
Make sure the installation directory is set to group <code>mailman</code> (or
 
79
whatever you're going to specify with <b class="programopt">--with-groupname</b>) and has
 
80
the setgid bit set<a name="tex2html3"
 
81
  href="#foot707"><sup>3</sup></a>.  You probably also want to guarantee that this
 
82
directory is readable and executable by everyone.  For example, these shell
 
83
commands will accomplish this:
 
84
 
 
85
<p>
 
86
<div class="verbatim"><pre>
 
87
    % cd $prefix
 
88
    % chgrp mailman .
 
89
    % chmod a+rx,g+ws .
 
90
</pre></div>
 
91
 
 
92
<p>
 
93
You are now ready to configure and install the Mailman software.
 
94
 
 
95
<p>
 
96
<br><hr><h4>Footnotes</h4>
 
97
<dl>
 
98
<dt><a name="foot706">.../usr/local/mailman</a><A
 
99
 href="create-install-dir.html#tex2html2"><sup>2</sup></a></dt>
 
100
<dd>This is the default for Mailman 2.1.
 
101
Earlier versions of Mailman installed everything under <span class="file">/home/mailman</span> by
 
102
default.
 
103
 
 
104
</dd>
 
105
<dt><a name="foot707">... set</a><A
 
106
 href="create-install-dir.html#tex2html3"><sup>3</sup></a></dt>
 
107
<dd>BSD users should see the <a href="bsd-issues.html#bsd-issues">15.2</a> section
 
108
for additional information.
 
109
 
 
110
</dd>
 
111
</dl>
 
112
<div class="navigation">
 
113
<div class='online-navigation'>
 
114
<p></p><hr />
 
115
<table align="center" width="100%" cellpadding="0" cellspacing="2">
 
116
<tr>
 
117
<td class='online-navigation'><a rel="prev" title="2.1 add the group"
 
118
  href="node4.html"><img src='previous.png'
 
119
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
 
120
<td class='online-navigation'><a rel="parent" title="2 set up your"
 
121
  href="node3.html"><img src='up.png'
 
122
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
 
123
<td class='online-navigation'><a rel="next" title="3 build and install"
 
124
  href="node6.html"><img src='next.png'
 
125
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
 
126
<td align="center" width="100%">GNU Mailman - Installation Manual</td>
 
127
<td class='online-navigation'><img src='blank.png'
 
128
  border='0' height='32'  alt='' width='32' /></td>
 
129
<td class='online-navigation'><img src='blank.png'
 
130
  border='0' height='32'  alt='' width='32' /></td>
 
131
<td class='online-navigation'><img src='blank.png'
 
132
  border='0' height='32'  alt='' width='32' /></td>
 
133
</tr></table>
 
134
<div class='online-navigation'>
 
135
<b class="navlabel">Previous:</b>
 
136
<a class="sectref" rel="prev" href="node4.html">2.1 Add the group</a>
 
137
<b class="navlabel">Up:</b>
 
138
<a class="sectref" rel="parent" href="node3.html">2 Set up your</a>
 
139
<b class="navlabel">Next:</b>
 
140
<a class="sectref" rel="next" href="node6.html">3 Build and install</a>
 
141
</div>
 
142
</div>
 
143
<hr />
 
144
<span class="release-info">Release 2.1, documentation updated on January 11, 2009.</span>
 
145
</div>
 
146
<!--End of Navigation Panel-->
 
147
 
 
148
</body>
 
149
</html>