~ubuntu-dev/ubuntu/lucid/dovecot/lucid-201002101901

« back to all changes in this revision

Viewing changes to doc/wiki/ManageSieve.Install.1.0.txt

  • Committer: Chuck Short
  • Date: 2010-01-21 20:21:25 UTC
  • mfrom: (4.1.11 squeeze)
  • Revision ID: zulcss@ubuntu.com-20100121202125-pme73o491kfwj5nc
* Merge from debian testing, remaining changes:
  + Add new binary pkg dovecot-postfix that integrates postfix and dovecot
    automatically: (LP: #164837)
  + debian/control:
    - add new binary with short description
    - set Architecture all for dovecot-postfix (LP: #329878)
  + debian/dovecot-postfix.postinst:
    - create initial certificate symlinks to snakeoil.
    - set up postfix with postconf to:
      - use Maildir/ as the default mailbox.
      - use dovecot as the sasl authentication server.
      - use dovecot LDA (deliver).
      - use tls for smtp{d} services.
    - fix certificates paths in postfix' main.cf
    - add reject_unauth_destination to postfix' recipient restrictions
    - add reject_unknown_sender_domain to postfix' sender restriction
    - rename configuration name on remove, delete on purge
    - restart dovecot after linking certificates
    - handle use case when postfix is unconfigurated
  + debian/dovecot-postfix.dirs: create backup directory for postfix's config
    configuration
  + restart postfix and dovecot.
  + debian/dovecot-postfix.postrm:
    - remove all dovecot related configuration from postfix.
    - restart postfix and dovecot.
  + debian/dovecot-common.init:
    - check if /etc/dovecot/dovecot-postfix.conf exists and use it
      as the configuration file if so.
  + debian/patches/warning-ubuntu-postfix.dpatch
    - add warning about dovecot-postfix.conf in dovecot default
      configuration file
  + debian/patches/dovecot-postfix.conf.diff:
    - Ubuntu server custom changes to the default dovecot configuration for
      better interfation with postfix.
    - enable sieve plugin.
    - Ubuntu server custom changes to the default dovecot configuration for
      better integration with postfix:
      - enable imap, pop3, imaps, pop3s and managesieve by default.
      - enable dovecot LDA (deliver).
      - enable SASL auth socket in postfix private directory
   + debian/rules:
     - copy, patch and install dovecot-postfix.conf in /etc/dovecot/.
     - build architecure independent packages too
   + Use Snakeoil SSL certificates by default.
     - debian/control: Depend on ssl-cert.
     - debian/patches/ssl-cert-snakeoil.dpatch: Change default SSL cert
       paths to snakeoil.
     - debian/dovecot-common.postinst: Relax grep for SSL_* a bit.
   + Add autopkgtest to debian/tests/*.
   + Fast TearDown: Update the lsb init header to not stop in level 6.
   + Add ufw integration:
     - Created debian/dovecot-common.ufw.profile.
     - debian/rules: install profile.
     - debian/control: suggest ufw.
   + debian/{control,rules}: enable PIE hardening.
   + dovecot-imapd, dovecot-pop3: Replaces dovecot-common (<< 1:1.1). (LP: #254721)
   + debian/control: Update Vcs-* headers.
   + Add SMTP-AUTH support for Outlook (login auth mechanism)
* New upstream release.
* debian/patches/gold-fix.patch: Removed. Fixed upstream.
* Moved libexec to lib corrections in dovecot-managesieve.patch and
  dovecot-managesieve-dist.patch to dovecot-example.patch
* debian/patches/dovecot-mboxlocking.patch: Regenerated to avoid FTBFS
  when quilt isn't installed.
* debian/patches/quota-mountpoint.patch: Removed. Not needed anymore.
* debian/patches/dovecot-quota.patch: Removed. Quotas aren't properly
  enabled unless mail_plugins = quota imap_quota.
* debian/patches/gold-fix.patch: Fixed configure script to build even
  with binutils-gold or --no-add-needed linker flag (Closes: #554306)
* debian/dovecot-common.init: fixed LSB headers. Thanks to Pascal Volk.
  (Closes: #558040)
* debian/changelog: added CVE references to previous changelog entry.
* debian/rules: checked up the build system. It's not fragile anymore.
  (Closes: 493803)
* debian/dovecot-common.postinst: Now invoking dpkg-reconfigure
  on dovecot-common is enough to generate new certificates
  if the previous ones were removed. (Closes: #545582)
* debian/rules: No longer install convert-tool in /usr/bin.
  It isn't an user utility and it should stay in /usr/lib/dovecot
  like all other similar tool.
* New upstream release. (Closes: #557601)
* [SECURITY] Fixes local information disclosure and denial of service.
  (see: http://www.dovecot.org/list/dovecot-news/2009-November/000143.html
  and CVE-2009-3897)
* Added myself to uploaders.
* Switched to the new source format "3.0 (quilt)":
  - removed dpatch from build-depends
  - removed debian/README.source because now we use only standard
    dpkg features
  - regenerated all patches
* Prepared to switch to multi-origin source:
  - recreated dovecot-libsieve.patch and dovecot-managesieve-dist.patch
    starting from the upstream tarball
  - removed all autotools related build-depends and build-conflict
  - renamed dovecot-libsieve and dovecot-managesieve directories
    to libsieve and managesieve.
* debian/rules: Moved the configuration of libsieve and managesieve from
  the build phase to the configuration phase
* Added dovecot-dbg package  with debugging symbols.  Thanks Stephan Bosch.
  (Closes: #554710)
* Fixed some stray libexec'isms in the default configuration.
* New upstream release.
* debian/dovecot-common.init:
  - use $CONF when starting the daemon. (Closes: #549944)
  - always output start/stop messages. (Closes: #523810)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
ManageSieve Installation for Dovecot v1.0
 
2
=========================================
 
3
 
 
4
Downloading
 
5
-----------
 
6
 
 
7
http://www.rename-it.nl/dovecot/1.0/
 
8
 
 
9
 * Patch filenames look as follows:
 
10
   *'dovecot-1.0.'*'X'*'-MANAGESIEVE-v'*'<version>'*'.diff.gz'*
 
11
 
 
12
The tarball releases are signed with public key 0x3DFBB4F4, which can be found
 
13
at wwwkeys.pgp.net.
 
14
 
 
15
Patching
 
16
--------
 
17
 
 
18
There is an important architectural difference between v1.0 and the later
 
19
implementations. The v1.0 version is a very large patch that includes another
 
20
copy of the CMU Sieve library as used by deliver's<Sieve plugin>
 
21
[LDA.Sieve.txt]. In contrast, the v1.1 and later versions are largely
 
22
implemented as an external package with a small patch to
 
23
enable<ManageSieve.txt> service support in Dovecot itself. This means that
 
24
these newer implementations no longer include another copy of the CMU Sieve
 
25
library: these use the Sieve plugin package for compilation against the Sieve
 
26
library.
 
27
 
 
28
You need to apply the downloaded '.diff.gz' patch to your 'dovecot-1.0' source
 
29
tree. This is achieved by executing the following command line inside the
 
30
source tree (''../patchfile.diff.gz'' must be substituted with the location of
 
31
the patch file you downloaded):
 
32
 
 
33
---%<-------------------------------------------------------------------------
 
34
gzip -dc ../pathfile.diff.gz | patch -p1
 
35
---%<-------------------------------------------------------------------------
 
36
 
 
37
Compiling the patched sources is described in the next section.
 
38
 
 
39
Compiling
 
40
---------
 
41
 
 
42
After applying the patch to the v1.0 Dovecot tree, the usual './configure',
 
43
'make', 'make install' sequence is not enough. First the 'automake'/'autoconf'
 
44
structure needs to be rebuilt to include the<ManageSieve.txt> sources in the
 
45
compilation process. This requires autotools to be installed on your system.
 
46
See<here> [CompilingSource.txt] for list of packages you need for that, and how
 
47
to install Dovecot from Mercurial. If you didn't download Dovecot from
 
48
Mercurial, you don't have the 'autogen.sh' script and you need to run instead:
 
49
 
 
50
---%<-------------------------------------------------------------------------
 
51
autoreconf -i
 
52
---%<-------------------------------------------------------------------------
 
53
 
 
54
Afterwards, you can continue the usual <build process> [CompilingSource.txt]. 
 
55
 
 
56
(This file was created from the wiki on 2009-10-16 04:42)