~ubuntu-branches/ubuntu/wily/dovecot/wily

« back to all changes in this revision

Viewing changes to doc/wiki/Migration.txt

  • Committer: Bazaar Package Importer
  • Author(s): CHuck Short, Chuck Short
  • Date: 2009-11-06 00:47:29 UTC
  • mfrom: (4.1.9 squeeze)
  • Revision ID: james.westby@ubuntu.com-20091106004729-i39n7v9e7d4h51f6
Tags: 1:1.2.6-1ubuntu1
* 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 restrictions
    - 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 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
   + debian/patches/dovecot-postfix.conf.diff:
     + 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.
   + debian/rules:
     - Create emtpy stamp.h.in files in dovecot-sieve/ and dovecot-managesieve/
       if they're not there since empty files are not included in the diff.gz 
       file.
   + Add SMTP-AUTH support for Outlook (login auth mechanism)
   + Dropped:
     - debian/patches/security-CVE-2009-3235: Applied upstream.
     - debian/patches/fix-pop3-assertion.dpatch: Applied upstream.
     - dovecot-sieve and dovecot-managesieve: Use the debian patches instead.

  [Chuck Short]
  - Updated dovecot-sieve to 0.1.13.
  - Updated dovecot-managesieve to 0.11.9.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Migration to Dovecot
2
2
====================
3
3
 
 
4
*WARNING: Badly done migration will cause your IMAP and/or POP3 clients to
 
5
re-download all mails. Read this page carefully.*
 
6
 
4
7
This page contains generic information related to migrating from another IMAP
5
8
or POP3 server to Dovecot. You should read this page, and then look at the
6
9
server-specific instructions:
55
58
old UIDLs. If POP3 client is configured to keep mails in the server and the
56
59
messages' UIDLs change, all the messages are downloaded again as new messages.
57
60
 
 
61
*Don't trust the migration scripts or anything you see in this wiki. Verify
 
62
manually that the UIDLs are correct before exposing real clients to Dovecot.*
 
63
You can do this by logging in using your old POP3 server, issuing UIDL command
 
64
and saving the output. Then log in using Dovecot and save its UIDL output as
 
65
well. Use e.g.'diff' command to verify that the lists are identical. Some
 
66
(many?) POP3 clients also require that the message ordering is preserved. Note
 
67
that *if a client already saw changed UIDLs and decided to start re-downloading
 
68
mails, it's unlikely there is anything you can do to stop it. Even going back
 
69
to your old server is unlikely to help at that point.*
 
70
 
58
71
Some servers (UW, Cyrus) implementing both IMAP and POP3 protocols use the IMAP
59
72
UID and UIDVALIDITY values for generating the POP3 UIDL values. To preserve the
60
73
POP3 UIDL from such servers you'll need to preserve the IMAP UIDs and set
90
103
      in hex)
91
104
    * mbox: MD5 sum of the message without the following lines:
92
105
      Status,X-Status,Lines and Content-Length.
 
106
 * Cucipop mbox: v1.31 uses its own homebrew checksum based on headers and
 
107
   body. Injection of X-UIDL: headers and pop3_reuse_xuidl=yes is the way to
 
108
   go.
93
109
 
94
110
IMAP <-> IMAP copying
95
111
---------------------
100
116
uploading them to Dovecot via IMAP.
101
117
 
102
118
There are several different tools for this, for example UW-IMAP
103
 
[http://www.washington.edu/imap/]'s mailutil and imapsync
104
 
[http://freshmeat.net/projects/imapsync].
 
119
[http://www.washington.edu/imap/]'s mailutil, imapsync
 
120
[http://freshmeat.net/projects/imapsync] and YippieMove
 
121
[http://www.yippiemove.com].
105
122
 
106
123
imapsync
107
124
--------
121
138
user that has the ability to copy message for sub users, and a variety of other
122
139
authentication options.
123
140
 
124
 
(This file was created from the wiki on 2009-01-05 04:42)
 
141
(This file was created from the wiki on 2009-07-10 04:42)