1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2
"http://www.w3.org/TR/html4/loose.dtd">
5
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6
<meta name="MSSmartTagsPreventParsing" content="TRUE">
7
<meta name="Author" content="Sam Varshavchik">
8
<!-- $Id: rpm.html,v 1.1 2004/08/07 16:18:11 mrsam Exp $ -->
9
<title>Courier - Building RPMs</title>
10
<link rel="icon" href="icon.gif" type="image/gif">
14
<!-- Copyright 2000-2004 Double Precision, Inc. See COPYING for -->
15
<!-- distribution information. -->
16
<h1>Building Courier RPMs</h1>
18
<p>You can build binary Courier RPMs directly from the tarball, using RPM
19
version 4.0.2 or higher. For example:</p>
20
<pre>rpmbuild -ta courier-<em>version</em>.tar.bz2</pre>
22
<p>Because the RPMs can be built directly from the tarball, binary RPMs will
23
not be distributed separately.</p>
26
<p><strong>NOTE:</strong></p>
28
<p>The first attempt to build binary RPMs will likely result in an error
29
message requesting additional RPMs to be installed first, such as the LDAP
30
server, MySQL and PostgreSQL databases, and various other development
33
<p><span style="color: #ff4040">Do not blow off these requirements, and
34
attempt to hack your way around them.</span> Install the required RPMs,
35
and try again. These RPMs are required to build the full complement of
36
Courier packages, and they may be removed after building Courier.</p>
38
<p>Parts of Courier that use these optional RPMs will be built into
39
separate, optional subpackages, and will not be required to run Courier.
40
The optional RPMs must be installed only for the duration of the build
44
<p>Note that Courier does not allow itself to be built as root. A single
45
mistake -- especially when trying to build a system-level utility -- can have
46
serious consequences. Therefore the configuration script won't let you.
47
There's an undocumented flag to disable the check, for folks who don't make
48
mistakes :-) See the <a href="FAQ.html">FAQ</a> for instructions on how to
49
configure RPM to build packages as non-root.</p>
51
<p>Building the RPM packages yourself will also result in the packages being
52
customized for your system. This procedure builds the following packages:</p>
54
<li><code>courier.rpm</code> - the base mail server.</li>
55
<li><code>courier-smtpauth.rpm</code> - install this package to enable
56
authenticated ESMTP, in the ESMTP server.</li>
57
<li><code>courier-ldap.rpm</code> - module to authenticate against an LDAP
58
directory. Install this module if you would like to use an LDAP directory
59
to authenticate and manage mail accounts. LDAP support requires the
60
OpenLDAP library to be installed. If OpenLDAP development libraries are
61
not installed, this package will be empty.</li>
62
<li><code>courier-mysql.rpm</code> - module to authenticate using a MySQL
63
database. Install this module if you would like to use a MySQL database
64
to authenticate and manage mail accounts. If MySQL development libraries
65
are not installed, this package will be empty.</li>
66
<li><code>courier-pgsql.rpm</code> - module to authenticate using a
67
PostgreSQL database. Install this module if you would like to use a
68
PostgreSQL database to authenticate and manage mail accounts. If
69
PostgreSQL development libraries are not installed, this package will be
71
<li><code>courier-fax-<em>version</em>--1.%{_arch}.rpm</code> - several
72
supporting scripts for sending E-mails by fax.</li>
73
<li><code>courier-pop3d.rpm</code> - the POP3 server.</li>
74
<li><code>courier-imapd.rpm</code> - the IMAP server.</li>
75
<li><code>courier-webmail.rpm</code> - the webmail server.</li>
76
<li><code>courier-webadmin.rpm</code> - the web-based administration tool
77
(just the <code>cgi-bin</code> wrapper, actually, the remaining files are
78
installed by other packages).</li>
79
<li><code>courier-maildrop.rpm</code> - <i>maildrop</i> mail filter
80
(required if you want to implement mail filtering).</li>
81
<li><code>courier-mlm.rpm</code> - the <i>couriermlm</i> mailing list
83
<li><code>courier-sendmail-wrapper.rpm</code> - install this package to
84
create soft links from <code>/usr/bin/sendmail</code>,
85
<code>/usr/lib/sendmail</code>, and several other popular places, to
86
Courier's sendmail wrapper. This package will not be created on Red Hat
87
7.3 and later, which uses the Debian-derived alternatives mechanism. The
88
alternatives mechanism will be incorporated into the main Courier
90
<li><code>courier-maildrop-wrapper.rpm</code> - install this package to
91
create soft links in the <code>/usr/local/bin</code> subdirectory, for
92
applications which expect to find <code>maildrop</code> in the
93
<code>/usr/local/bin</code> directory. <code>maildrop</code> is also
94
available as a standalone package, which normally installs in the
95
<code>/usr/local/bin</code> subdirectory. Courier includes an integrated
96
version of <code>maildrop</code>, and you can install this package to
97
allow applications that are configured for the standalone
98
<code>maildrop</code> version to use Courier's integrated version
102
<p><strong>NOTE:</strong> these packages are built with certain directories
103
in a non-default location. Specifically, the configuration files are
104
installed in <code>/etc/courier</code>, the mail spool is installed in
105
<code>/var/spool/courier</code>, and the manual pages are installed directly
106
in <code>/usr/man</code>. Other configuration settings are left at their
107
defaults. If you need to change the defaults, you will have to build your own
110
<p><strong>NOTE:</strong> the first time the system boots after installing
111
the Courier RPM, the system may pause for several minutes at the "Starting
112
Courier" prompt. That's because the startup script automatically creates test
113
SSL certificates the first time the script is executed (provided that SSL
114
support is available). This can take as much as 5-6 minutes on a slow
115
machine. Subsequent starts should take only a few seconds. Have patience.
116
Also note that the main Courier RPM has the ESMTP server turned off. You must
117
manually enable receiving mail via ESMTP by editing the <code>esmtpd</code>
118
configuration file.</p>