summaryrefslogtreecommitdiffstats
path: root/doc/wiki/Migration.Online.txt
blob: 83d8bb8e50c765db641476f4ef2327eca3a05df8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
Online Mailbox Format Conversion
--------------------------------

This page aims to help with the tasks around planned mailbox migrations to e.g.
mdbox. To perform this exercise with minimum service interruption a Postfix
check can be implemented to put mail for the accounts to be migrated on HOLD:

Postfix main.cf
---------------

---%<-------------------------------------------------------------------------
smtpd_recipient_restrictions =
 [...]
 check_recipient_access hash:/etc/postfix/recipient_maintenance,
 permit_mynetworks,
 reject_unauth_destination
---%<-------------------------------------------------------------------------

/etc/postfix/recipient_maintenance
----------------------------------

---%<-------------------------------------------------------------------------
user@domain.tld HOLD Planned maintenance
user1@domain.tld HOLD Planned maintenance
user2@domain.tld HOLD Planned maintenance
[...]
---%<-------------------------------------------------------------------------

Virtual Domain Aliases in Postfix can be easily used to populate the *List of
Recipients* to be converted (and to be queued on HOLD). The following basic
script helps populating the database and needs to be adapted to the actual
alias location:

---%<-------------------------------------------------------------------------
#!/bin/bash
set -e
ALIASES="/etc/postfix/virtual"
MAINTALIASES="/etc/postfix/recipient_maintenance"

doveadm user $1 || { echo 'user query failed.'; exit 1; }

sed -e "s/\(.*\)$1/\1/;s/[ \t]*$//; s/$/ HOLD Planned maintenance: account=$1/"
$ALIASES >>$MAINTALIASES
grep $1 $MAINTALIASES
postmap $MAINTALIASES
echo '[ Complete ]'
---%<-------------------------------------------------------------------------

Usage:

---%<-------------------------------------------------------------------------
$ maintalias.sh user@domain.tld
---%<-------------------------------------------------------------------------

Finally running *postmap recipient_maintenance* will create the database (in
case this part is not scripted).

Actual Migration
----------------

Disable new logins for the users by adding 'allow_nets=' to their userdb
records, effectively disallowing ALL nets. Close open sessions if any:

---%<-------------------------------------------------------------------------
$ doveadm who <user>
$ doveadm kick <user>
---%<-------------------------------------------------------------------------

Convert the mailbox using the backup option:

---%<-------------------------------------------------------------------------
$ dsync -u user@domain.tld backup mdbox:~/mdbox
---%<-------------------------------------------------------------------------

Adjust userdb entries (if required) to reflect new 'mail_location'. Clear the
'recipient_maintenance' DB and undo 'allow_nets=' entries for the migrated
users.

Finally release and requeue all mail previously held:

---%<-------------------------------------------------------------------------
$ postsuper -r [ALL]
$ postqueue -f
---%<-------------------------------------------------------------------------

(This file was created from the wiki on 2019-06-19 12:42)