~ubuntu-branches/ubuntu/utopic/dovecot/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/wiki/Upgrading.2.2.txt

  • Committer: Package Import Robot
  • Author(s): James Page
  • Date: 2014-01-08 09:35:49 UTC
  • mfrom: (4.1.35 sid)
  • Revision ID: package-import@ubuntu.com-20140108093549-i72o93pux8p0dlaf
Tags: 1:2.2.9-1ubuntu1
* Merge from Debian unstable, remaining changes:
  + Add mail-stack-delivery package:
    - Update d/rules
    - d/control: convert existing dovecot-postfix package to a dummy
      package and add new mail-stack-delivery package.
    - Update maintainer scripts.
    - Rename d/dovecot-postfix.* to debian/mail-stack-delivery.*
    - d/mail-stack-delivery.preinst: Move previously installed backups and
      config files to a new package namespace.
    - d/mail-stack-delivery.prerm: Added to handle downgrades.
  + Use Snakeoil SSL certificates by default:
    - d/control: Depend on ssl-cert.
    - d/dovecot-core.postinst: Relax grep for SSL_* a bit.
  + Add autopkgtest to debian/tests/*.
  + Add ufw integration:
    - d/dovecot-core.ufw.profile: new ufw profile.
    - d/rules: install profile in dovecot-core.
    - d/control: dovecot-core - suggest ufw.
  + d/dovecot-core.dirs: Added usr/share/doc/dovecot-core
  + Add apport hook:
    - d/rules, d/source_dovecot.py
  + Add upstart job:
    - d/rules, d/dovecot-core.dovecot.upstart, d/control,
      d/dovecot-core.dirs, dovecot-imapd.{postrm, postinst, prerm},
      d/dovecot-pop3d.{postinst, postrm, prerm}.
      d/mail-stack-deliver.postinst: Convert init script to upstart.
  + Use the autotools-dev dh addon to update config.guess/config.sub for
    arm64.
* Dropped changes, included in Debian:
  - Update Dovecot name to reflect distribution in login greeting.
  - Update Drac plugin for >= 2.0.0 support.
* d/control: Drop dovecot-postfix package as its no longer required.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Upgrading Dovecot v2.1 to v2.2
 
2
==============================
 
3
 
 
4
v2.2 has a couple of changes to settings since v2.1:
 
5
 
 
6
 * doveadm_proxy_port setting renamed to doveadm_port (but the old exists still
 
7
   as an alias)
 
8
 * imapc_ssl_ca_dir and pop3c_ssl_ca_dir settings replaced by a common
 
9
   ssl_client_ca_dir
 
10
 
 
11
There are also some changes you should be aware of:
 
12
 
 
13
 * fts-solr no longer does "hard commits" to the Solr index for performance
 
14
   reasons. <You must do this manually once in a while> [Plugins.FTS.Solr.txt].
 
15
 
 
16
 * When creating home directories, the permissions are copied from the parent
 
17
   directory if it has setgid-bit set. For full details, see
 
18
   <SharedMailboxes.Permissions.txt>.
 
19
 * "doveadm auth" command was renamed to "doveadm auth test"
 
20
 * IMAP: ID command now advertises server name as Dovecot by default. It was
 
21
   already trivial to guess this from command replies.
 
22
 * LDA/LMTP: If saving a mail brings user from under quota to over quota, allow
 
23
   it based on quota_grace setting (default: 10% above quota limit).
 
24
 * pop3_lock_session=yes now uses a POP3-only dovecot-pop3-session.lock file
 
25
   instead of actually locking the mailbox (and causing IMAP/LDA/LMTP to wait
 
26
   for the POP3 session to close).
 
27
 * mail_shared_explicit_inbox setting's default switched to "no".
 
28
 * dsync isn't compatible with v2.1 protocol. (The new protocol will be
 
29
   compatible with future Dovecot versions.)
 
30
 * autocreate plugin is being deprecated and it will log warnings. Convert the
 
31
   configuration to <MailboxSettings.txt> instead.
 
32
 
 
33
Downgrading can be done fully safely to v2.1.16.
 
34
 
 
35
 * v2.1.16 adds support for "attribute changes", which are used by URLAUTH
 
36
   command and dsync with ACLs and/or Sieve scripts. If none of these features
 
37
   are used, you can downgrade safely to v2.1.11.
 
38
    * The error message for these attribute changes is: 'Log synchronization
 
39
      error at seq=..,offset=.. for .../dbox-Mails/dovecot.index: Unknown
 
40
      transaction record type 0x0'
 
41
 * v2.1.11 adds support for cache file changes. Older versions may think that
 
42
   the 'dovecot.index.cache' files are corrupted and complain about "Invalid
 
43
   magic in hole header".
 
44
 
 
45
(This file was created from the wiki on 2013-11-24 04:43)