1
<?xml version="1.0" encoding="iso-8859-1"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
3
"http://www.w3.org/TR/html4/loose.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml">
6
<meta name="MSSmartTagsPreventParsing" content="TRUE" />
7
<meta name="Author" content="Sam Varshavchik" />
8
<!-- $Id: status.html.in,v 1.36 2002/10/24 21:57:59 mrsam Exp $ -->
9
<title>Courier - Status/Download</title>
10
<link rel="icon" href="icon.gif" type="image/gif" />
13
<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B"
15
<!-- Copyright 2000 Double Precision, Inc. See COPYING for -->
16
<!-- distribution information. -->
20
<p>Now is the good time to mention that you MUST read the contents of INSTALL
21
after downloading and unpacking the source code. No exceptions. When
22
downloading via CVS, the install file in the <code>courier</code> module is
23
hidden in a subdirectory (it will be moved to <code>INSTALL</code> by
24
<code>make dist</code>), so please <a href="install.html">read the online
25
version</a>. Other modules have <code>INSTALL.html</code> at the top level,
26
which can be read with any browser.</p>
28
<p>Download the source code tarball from <code><a
29
href="http://www.courier-mta.org/download.php">http://www.courier-mta.org/download.php</a></code>.
30
This download page also contains the latest releases of the individual
31
Courier component packages: <a
32
href="http://www.inter7.com/courierimap/">Courier-IMAP</a>, <a
33
href="http://www.inter7.com/sqwebmail/">SqWebMail</a>, and <a
34
href="http://www.flounder.net/~mrsam/maildrop/">maildrop</a>. Ad</p>
36
<p>Additionally, more frequent, but less stable, builds are regularly
38
href="ftp://courier.sourceforge.net/pub/courier/courier/"><code>ftp://courier.sourceforge.net/pub/courier/courier/</code></a>.</p>
40
<h3>Download via CVS</h3>
42
<p>The following applies for the entire Courier source code distribution, and
43
sub-modules (Courier-IMAP, sqwebmail, maildrop).</p>
45
<p>In order to build from the CVS repository, you must the following
46
additional software installed:</p>
49
href="http://www.gnu.org/software/autoconf/autoconf.html"><code>autoconf
50
2.53</code></a>.<br />
54
href="http://www.gnu.org/software/automake/automake.html"><code>automake
55
1.6.3</code></a>.<br />
59
href="http://www.gnu.org/software/libtool/libtool.html"><code>libtool
60
1.4.2</code></a><br />
64
href="http://www.gnu.org/software/gettext/gettext.html"><code>gettext
65
0.11.4</code></a><br />
69
href="http://www.gnu.org/software/make/make.html"><code>gmake</code></a>,
73
<li><a href="http://www.courier-mta.org/sysconftool/">sysconftool</a> -
74
this is an extra autoconf macro used by Courier's
75
<code>configure.in</code><br />
78
<li>The following tools that convert Docbook SGML to HTML and man page
79
documentation: <a href="http://openjade.sourceforge.net/">OpenJade</a>,
80
<a href="http://docbook.sourceforge.net/projects/dsssl/">docbook DSSL
81
stylesheets</a>, and <a
82
href="http://sources.redhat.com/docbook-tools/"><code>sgml-common</code>,
83
<code>docbook</code> 3.0 and 3.1 DTDs, and
84
<code>docbook-utils</code>.</a></li>
86
<p>These additional dependencies are only required if building from CVS,
87
and not the packaged tarballs.</p>
89
<p>The source code can be checked out with the following commands:</p>
90
<pre> CVSROOT=:pserver:anonymous@cvs.courier.sourceforge.net:/cvsroot/courier
94
<p>Press ENTER when asked for a password (blank password).</p>
97
<p><code>cvs -z3 checkout -r courier-latest courier</code>
98
- get the entire Courier mail server source code, or:</p>
100
<p><code>cvs -z3 checkout -r courier-imap-latest courier-imap</code>
101
- get just the standalone IMAP server source code, or:</p>
103
<p><code>cvs -z3 checkout -r sqwebmail-latest sqwebmail</code>
104
- get just the standalone webmail server source code, or:</p>
106
<p><code>cvs -z3 checkout -r maildrop-latest maildrop</code>
107
- get just the standalone version of Courier's mail filter's source
111
<p>NOTE: Automatically-generated <code>configure</code> and
112
<code>Makefile</code>, <code>libtool</code>, and <code>sysconftool</code>
113
scripts are NOT stored in the repository, and you must build them yourself.
114
Fortunately, it's very easy to do this. Simply run the following command
115
after checking out any one of these modules:</p>
116
<pre> sh autobloat</pre>
118
<p>The <code>autobloat</code> script automatically runs
119
<code>automake</code>, <code>autoconf</code>, <code>libtool</code>,
120
<code>sysconftool</code>, from the current directory.</p>
122
<p>NOTE: The "courier" module is the entire mail server. The other modules
123
extract selected portions, with a different top-level makefile that builds
124
a standalone package. You only need to obtain the <code>courier</code>
125
module, to get the source code for Courier. See <a
126
href="intro.html">Introduction</a> for more information.</p>
128
<p>NOTE: the <code>HEAD</code>s of each module contain the latest
129
development versions, which may not be very stable. Use the tags specified
130
above to obtain the latest "semi" stable release. Usually the "latest" tags
131
will match the source code in the most recent tarball, but they may include
132
some additional patches for the next release.</p>
134
<h3>Debian packages</h3>
136
<p>Questions about the Debian port should be mailed to
137
<tt><courier</tt><tt>@packages.debian.org></tt>.</p>
139
<h3>Building RPMs</h3>
141
<p>You can build binary Courier RPMs directly from the tarball, using RPM
142
version 4.0.2 or higher. For example:</p>
143
<pre>rpm -ta courier-@version@.tar.bz2</pre>
145
<p>For RPM 4.1 and higher (Red Hat 8.0), use <tt>rpmbuild</tt> instead of
147
<pre>rpmbuild -ta courier-@version@.tar.bz2</pre>
149
<p>Because the RPMs can be built directly from the tarball, binary RPMs
150
will not be distributed separately.</p>
152
<p>Note that Courier does not allow itself to be built as root. A single
153
mistake -- especially when trying to build a system-level utility -- can
154
have serious consequences. Therefore the configuration script won't let
155
you. There's an undocumented flag to disable the check, for folks who don't
156
make mistakes :-) See the <a href="FAQ.html">FAQ</a> for instructions on
157
how to configure RPM to build packages as non-root.</p>
159
<p>Building the RPM packages yourself will also result in the packages
160
being customized for your system. This procedure builds the following
164
<li><code>courier-@version@-1.%{_arch}.rpm</code> - the base mail
168
<li><code>courier-smtpauth-@version@-1.%{_arch}.rpm</code> - install this
169
package to enable authenticated ESMTP, in the ESMTP server.<br />
172
<li><code>courier-ldap-@version@-1.%{_arch}.rpm</code> - module to
173
authenticate against an LDAP directory. Install this module if you would
174
like to use an LDAP directory to authenticate and manage mail accounts.
175
LDAP support requires the OpenLDAP library to be installed. If OpenLDAP
176
development libraries are not installed, this package will be empty.<br />
179
<li><code>courier-mysql-@version@-1.%{_arch}.rpm</code> - module to
180
authenticate using a MySQL database. Install this module if you would
181
like to use a MySQL database to authenticate and manage mail accounts. If
182
MySQL development libraries are not installed, this package will be
186
<li><code>courier-pgsql-@version@-1.%{_arch}.rpm</code> - module to
187
authenticate using a PostgreSQL database. Install this module if you
188
would like to use a PostgreSQL database to authenticate and manage mail
189
accounts. If PostgreSQL development libraries are not installed, this
190
package will be empty.<br />
193
<li><code>courier-fax-@version@--1.%{_arch}.rpm</code> - several supporting
194
scripts for sending E-mails by fax.<br />
197
<li><code>courier-pop3d-@version@-1.%{_arch}.rpm</code> - the POP3
201
<li><code>courier-imapd-@version@-1.%{_arch}.rpm</code> - the IMAP
205
<li><code>courier-webmail-@version@-1.%{_arch}.rpm</code> - the webmail
209
<li><code>courier-webadmin-@version@-1.%{_arch}.rpm</code> - the web-based
210
configuration tool.<br />
213
<li><code>courier-webadmin-@version@-1.%{_arch}.rpm</code> - the web-based
214
administration tool (just the <code>cgi-bin</code> wrapper, actually, the
215
remaining files are installed by other packages).<br />
218
<li><code>courier-maildrop-@version@-1.%{_arch}.rpm</code> -
219
<i>maildrop</i> mail filter (required if you want to implement mail
223
<li><code>courier-mlm-@version@-1.%{_arch}.rpm</code> - the
224
<i>couriermlm</i> mailing list manager.<br />
227
<li><code>courier-sendmail-wrapper-@version@-1.%{_arch}.rpm</code> -
228
install this package to create soft links from
229
<code>/usr/bin/sendmail</code>, <code>/usr/lib/sendmail</code>, and
230
several other popular places, to Courier's sendmail wrapper. This package
231
will not be created on Red Hat 7.3 and later, which uses the
232
Debian-derived alternatives mechanism. The alternatives mechanism will be
233
incorporated into the main Courier package.<br />
236
<li><code>courier-maildrop-wrapper-@version@-1.%{_arch}.rpm</code> -
237
install this package to create soft links in the
238
<code>/usr/local/bin</code> subdirectory, for applications which expect
239
to find <code>maildrop</code> in the <code>/usr/local/bin</code>
240
directory. <code>maildrop</code> is also available as a standalone
241
package, which normally installs in the <code>/usr/local/bin</code>
242
subdirectory. Courier includes an integrated version of
243
<code>maildrop</code>, and you can install this package to allow
244
applications that are configured for the standalone <code>maildrop</code>
245
version to use Courier's integrated version instead.</li>
248
<p>NOTE: these packages are built with certain directories in a non-default
249
location. Specifically, the configuration files are installed in
250
<code>/etc/courier</code>, the mail spool is installed in
251
<code>/var/spool/courier</code>, and the manual pages are installed directly
252
in <code>/usr/man</code>. Other configuration settings are left at their
253
defaults, which means, for example, that the IMAP server is not compiled to
254
include workarounds for bugs in several IMAP clients. If you need to change
255
the defaults, you will have to build your own packages. These RPM packages
256
are customized to work in my personal Linux distro (usually the latest
257
version of Red Hat+patches), and these configuration settings may need to be
258
adjusted for other distros. It's not that it's not possible to build a
259
generic RPM, it's just that these RPM packages are built for my convenience's
262
<p><strong>NOTE:</strong> the first time the system boots after installing
263
the Courier RPM, the system may pause for several minutes at the "Starting
264
Courier" prompt. That's because the startup script automatically creates test
265
SSL certificates the first time the script is executed (provided that SSL
266
support is available). This can take as much as 5-6 minutes on a slow
267
machine. Subsequent starts should take only a few seconds. Have patience.
268
Also note that the main Courier RPM has the ESMTP server turned off. You must
269
manually enable receiving mail via ESMTP by editing the <code>esmtpd</code>
270
configuration file.</p>
272
<h3>RPM customization</h3>
274
<p>If you want to customize your RPMs, you should extract the spec file from
275
the tarball, and edit it yourself. However, there is a hook that can be used
276
to pass additional flags to the configure script, from the RPM command line.
278
<pre>rpm -ta --define 'xflags --without-explicitsync --enable-https' \
279
courier-@version@.tar.gz</pre>
281
<p>You can use most of the <code>configure</code> script options, except for
282
directory location options. See <a href="install.html">INSTALL</a> for a list
283
of options to the <code>configure</code> script.</p>
286
<table border="0" width="100%">
289
<td><strong>PREV:</strong> <a href="intro.html">Introduction</a></td>
290
<td align="right"><strong>NEXT:</strong> <a
291
href="install.html">Installation</a></td>
added
removed
courier/doc/status.html.in
