doveadm-sync - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

doveadm-sync - Dovecots Dienstprogramm zur bidirektionalen Postfachsynchronisierung
doveadm-backup - Dovecots Dienstprogramm zur unidirektionalen Postfachsynchronisierung

ZUSAMMENFASSUNG

Doveadm [-Dv] synchronisieren [-u Benutzer|-A|-F Datei] [-S Socket_Pfad] [-1fPRU] [-l Sekunden] [-r
rawlog_path] [-m Briefkasten] [-g mailbox_guid] [-n Namensraum|-N] [-x ausschließen] [-s Zustand] [-T
Sekunden] -d|Reiseziel

Doveadm [-Dv] Sicherungskopie [-u Benutzer|-A|-F Datei] [-S Socket_Pfad] [-fPRU] [-l Sekunden] [-r
rawlog_path] [-m Briefkasten] [-g mailbox_guid] [-n Namensraum|-N] [-x ausschließen] [-s Zustand] [-T
Sekunden] -d|Reiseziel

BESCHREIBUNG

dsync ist das Dienstprogramm zur Postfachsynchronisierung von Dovecot. Es kann für mehrere verschiedene verwendet werden
Anwendungsfälle: Zwei-Wege-Synchronisierung von Postfächern, Erstellen von Backups von E-Mails und Konvertieren
Postfächer von/zu verschiedenen Postfachformaten. All dies kann innerhalb desselben verwendet werden
Server oder zwischen verschiedenen Servern (über ssh(1) oder TCP-Verbindungen). Remote-Mailboxen können
Zugriff auch über das IMAP-Protokoll, das die Verwendung von dsync für die Mailbox-Migration ermöglicht
Zwecke.

Sie können dsync in einem von drei Modi ausführen:

· Doveadm Sicherungskopie führt eine unidirektionale Synchronisierung durch. Wenn es Änderungen gibt
im Ziel werden sie gelöscht, damit das Ziel aussieht
genau wie die Quelle.

· Doveadm synchronisieren führt eine bidirektionale Synchronisierung durch. Es führt alle Änderungen zusammen
ohne etwas zu verlieren. Beide Postfächer werden am Ende identisch aussehen
nachdem die Synchronisierung abgeschlossen ist.

· Doveadm synchronisieren -1 führt eine unidirektionale Synchronisierung durch, führt jedoch die Änderungen zusammen
im Ziel, ohne etwas zu löschen. Das funktioniert derzeit nicht
perfekt, daher sollte seine Verwendung eingeschränkt werden. Sein Hauptzweck ist, dass während
Postfach-Migration, die Sie ausführen können Doveadm Sicherungskopie mehrmals, dann wechseln
Mails an das neue Postfach zuzustellen und auszuführen Doveadm synchronisieren -1 noch einmal
um letzte neue Mails aus dem alten Postfach zu übertragen.

Außerdem gibt es drei verschiedene Synchronisationsalgorithmen:

· Vollständige Synchronisation (-f Parameter) durchsucht alle Nachrichten in allen
die Postfächer. Dies garantiert, dass alles synchronisiert wird, aber
es ist unnötig langsam für die inkrementelle Synchronisierung.

· Schnelle Synchronisation (Standard) versucht zuerst, Postfächer zu finden, die über
geändert, und synchronisieren Sie nur diese. Dies geschieht durch die Überprüfung der
Metadaten der Postfächer (NEXTUID und HIGHESTMODSEQ). Normalerweise funktioniert das gut,
besonders bei Einwegsynchronisation, aber wenn beide Seiten genau das tun
die gleiche Anzahl von Änderungen, die Metadaten können am Ende die gleichen Werte enthalten
auch wenn die Änderungen anders waren.

· Stateful Synchronisation (-s Parameter) ist der effizienteste Weg, um
Postfächer synchronisieren. Es hängt davon ab, dass der Status des früheren dsync-Laufs vorliegt
irgendwo gespeichert und an den nächsten dsync-Lauf übergeben. Basierend auf diesem Zustand
dsync kann nur die Änderungen senden, die nach dem vorherigen dsync-Lauf aufgetreten sind.
Solange der Zustand oder die Postfächer nicht beschädigt sind, sollte dieser Algorithmus
funktionieren einwandfrei. Der Replikatorprozess verwendet dies intern, um die meisten
der Synchronisation.

Die Synchronisierung erfolgt so perfekt wie möglich: ein IMAP- oder ein POP3-Client sollte das nicht können
um Unterschiede zwischen den beiden Postfächern zu bemerken. Zwei-Wege-Synchronisierung bedeutet, dass es sicher ist
um auf beiden Seiten irgendwelche Änderungen vorzunehmen, und dsync wird die Änderungen ohne zusammenführen
alle Änderungen auf beiden Seiten verloren gehen. Dies ist möglich, weil dsync darauf zugreifen kann
Indexprotokolle von Dovecot, die Änderungen nachverfolgen. Das ist natürlich möglich
Konflikte beim Zusammenführen werden diese auf sichere Weise gelöst. Siehe die dsync Design Dokument
um mehr zu erfahren.

dsync verwendet dieselben Konfigurationsdateien wie der Rest von Dovecot (über Taubenkonferenz(1) binär).
Die gesamte Konfiguration kann geändert werden, indem der Parameter -c an eine andere Konfiguration übergeben wird
Datei, oder verwenden Sie den Parameter -o, um bestimmte Einstellungen zu überschreiben. Beim Ausführen einer Remote-Dsync
Programm funktioniert es auf die gleiche Weise: Es verwendet seine eigene lokale Konfiguration.

dsync kann komplett eigenständig ausgeführt werden. Es erfordert keine Dovecot-Serverprozesse
ausgeführt werden, außer wenn Sie den Parameter -u verwenden, um a zu tun Benutzerdatenbank Lookup aus dem Authentifizierungsprozess.

dsync kann mit den Parametern -u oder -A entweder einen oder mehrere Benutzer synchronisieren. Für kontinuierliche
Replikation können Sie den Dovecot-Replikator-Prozess verwenden, der automatisch dsync ausführt
wenn sich Nachrichten geändert haben.

OPTIONAL

Global Doveadm(1) Optionen:

-D Aktiviert Ausführlichkeit und Debug-Meldungen.

-o Einstellung=Wert
Überschreibt die Konfiguration Einstellung für /etc/dovecot/dovecot.conf und aus dem
userdb mit den gegebenen Wert. Um mehrere Einstellungen zu überschreiben, -o zu erhalten
kann mehrfach angegeben werden.

-v Aktiviert Ausführlichkeit, einschließlich Fortschrittszähler.

Befehlsspezifisch Optionen:

-1 Führen Sie eine unidirektionale Synchronisierung statt einer bidirektionalen Synchronisierung durch.

-A Besitzt das -A Option vorhanden ist, die Befehl wird für alle Benutzer durchgeführt. Verwenden von
diese Option in Kombination mit Systembenutzern von Benutzerdatenbank { Fahrer = passwd } ist nicht
empfohlen, da es auch Benutzer mit einer niedrigeren UID enthält als diese
konfiguriert mit dem first_valid_uid Einstellung.

Stellen Sie bei Verwendung des SQL-Moduls userdb sicher, dass die iterate_query Einstellung in
/etc/dovecot/dovecot-sql.conf.ext entspricht Ihrem Datenbanklayout. Bei Verwendung des
LDAP-Benutzerdatenbankmodul, stellen Sie sicher, dass die iterieren_attrs und iterieren_filter Einstellungen in
/etc/dovecot/dovecot-ldap.conf.ext mit Ihrem LDAP-Schema übereinstimmen. Andernfalls Doveadm(1)
kann nicht über alle Benutzer iterieren.

-F Datei
Führen Sie die aus Befehl für alle Benutzer in der Datei. Dies ist ähnlich wie bei -A
Option, aber anstatt die Liste der Benutzer aus der userdb abzurufen, werden sie gelesen
aus dem Gegebenen Dateidem „Vermischten Geschmack“. Seine Datei enthält einen Benutzernamen pro Zeile.

-N Synchronisieren Sie alle verfügbaren Namespaces. Standardmäßig nur Namespaces, die dies nicht tun
explizite Standorteinstellungen haben, werden synchronisiert.

-P Führen Sie a doveadm-Säuberung(1) für den (entfernten) Zielspeicher nach der Synchronisation.

-R Führen Sie eine umgekehrte Synchronisierung durch. Normalerweise würden Nachrichten vom lokalen System an das
Ziel (entfernt). Diese Option kehrt den Fluss um und zieht stattdessen Nachrichten
von der Fernbedienung zum lokalen Speicher.

-S Socket_Pfad
Das Argument der Option ist entweder ein absoluter Pfad zu einem lokalen UNIX-Domain-Socket, oder
ein Hostname und Port (hostname:port ), um einen entfernten Host über ein TCP zu verbinden
Steckdose.

Dies ermöglicht einem Administrator die Ausführung Doveadm(1) Mail-Befehle durch die angegebenen
Steckdose.

-T Sekunden
Geben Sie die Zeit in Sekunden an, wie lange Doveadm(1) sollte auf blockierte E/A warten
Operationen. Das Standard-Timeout beträgt 600 Sekunden.

-U Dies wird intern vom Replikator verwendet, damit dsync ihn benachrichtigt, wenn der
Die Synchronisation ist beendet.

-d Verwenden Sie das Standardziel, das aus dem mail_replica Benutzerdatenbank extra
Feld.

-g mailbox_guid
Wie -m, aber suchen Sie das zu synchronisierende Postfach anhand seiner GUID statt anhand des Namens.

-l Sekunden
Sperren Sie die dsync für diesen Benutzer. Maximal warten Sekunden bevor Sie aufgeben. Dies
Parameter sollte verwendet werden, um eine Unterbrechung der Synchronisation zu vermeiden, wenn es möglich ist, dass
dsync wird gleichzeitig für denselben Benutzer ausgeführt.

-m Briefkasten
Synchronisieren Sie nur diesen Postfachnamen.

-n Namensraum
Synchronisieren Sie nur den angegebenen Namespace. Dieser Parameter kann mehrfach verwendet werden
Zeiten.

-r rawlog_path
Führen Sie dsync remote aus und schreiben Sie den Remote-Ein-/Ausgangsverkehr in das angegebene Protokoll
Datei.

-s vorheriger Status
Verwenden Sie die zustandsorientierte Synchronisierung. Wenn der vorherige Status unbekannt ist, verwenden Sie ein leeres
Schnur. Der neue Status wird immer auf der Standardausgabe ausgegeben.

-u Benutzer/Maske
Führen Sie die Befehl nur für das gegebene Benutzer. Es ist auch möglich, '*'Und'?'
Platzhalter (zB -u *@example.org).
Wenn weder die -A Option, noch die -F Datei Option, noch die -u Benutzer angegeben wurde,
Befehl wird mit der Umgebung des aktuell angemeldeten Benutzers ausgeführt.

-x Mailbox_Maske
Schließen Sie den angegebenen Mailbox-Namen/-Maske aus. Die Maske kann enthalten "?" und "*"
Platzhalter. Dieser Parameter kann mehrfach verwendet werden.

ARGUMENTE

Reiseziel
Dieses Argument gibt das synchronisierte Ziel an. Es kann eines sein:

Standorte
Das gleiche wie mail_location Einstellung, zB maildir:~/Maildir

Fernbedienung:login@host
Verwendung dsync_remote_cmd Einstellung zum Verbinden mit dem Remote-Host (normalerweise über
ssh)

remoteprefix:login@host
Dies ist dasselbe wie remote, außer dass "user@domain\n" vor dsync gesendet wird
Protokoll startet. Dies ermöglicht die Implementierung eines vertrauenswürdigen Wrapper-Skripts, das
führt doveadm dsync-server aus, indem es den Benutzernamen aus der ersten Zeile liest.

TCP:Host[:Port]
Verbindet sich über TCP mit dem Remote-Doveadm-Server. Der Standardport wird angegeben durch
doveadm_port Einstellung.

TCP:Host[:Port]
Dies ist dasselbe wie tcp, jedoch mit SSL.

EXIT STATUS

dsync wird mit einem der folgenden Werte beendet:

0 Die Synchronisation wurde perfekt durchgeführt.

2 Die Synchronisierung wurde ohne Fehler durchgeführt, aber einige Änderungen konnten nicht durchgeführt werden, daher
Postfächer sind nicht perfekt synchronisiert. Das erneute Ausführen von dsync behebt dies normalerweise.
Dies tritt normalerweise bei Nachrichtenänderungssequenzen mit neu erstellten Postfächern auf.
Es kann auch auftreten, wenn sich eines der Postfächer während der Synchronisierung ändert.

1, >2
Synchronisierung fehlgeschlagen.

BEISPIEL

SYNCHRONISATION
Synchronisieren Sie Postfächer mit einem Remoteserver. Eventuelle Fehler werden nach stderr geschrieben.

Doveadm synchronisieren -u [E-Mail geschützt] remote:server-replica.example.com

Wenn Sie komplexere Parameter für ssh benötigen, können Sie z. B. Folgendes verwenden:

Doveadm synchronisieren -u [E-Mail geschützt] ssh -i id_dsa.dovecot \
[E-Mail geschützt] Doveadm dsync-Server -u [E-Mail geschützt]

KONVERTIEREN
Angenommen, die mail_location Einstellung in /etc/dovecot/conf.d/10-mail.conf ist eingestellt auf:
mail_location = mdbox:~/mdbox, kann ein eingeloggter Systembenutzer seine Mails von seinem
Maildir in ihrem/seinem Home-Verzeichnis in das mdbox-Mailbox-Format. Der Benutzer muss ausführen
der Befehl:

Doveadm synchronisieren Mailverzeichnis:~/Maildir

Wenn Sie dies ohne Ausfallzeiten tun möchten, können Sie die Konvertierung Benutzer für Benutzer durchführen.
Anfänglich:

· Konfiguration verwendet mail_location = Mailverzeichnis:~/Maildir

· Richten Sie die Möglichkeit ein, die E-Mail-Ortung pro Benutzer mithilfe von Benutzerdatenbank zusätzliche Felder.

Dann für jeden Benutzer:

1. Führen Doveadm synchronisieren einmal, um die erste Konvertierung durchzuführen.

2. Führen Doveadm synchronisieren wieder, denn die anfängliche Konvertierung hätte eine Weile dauern können
und währenddessen könnten neue Änderungen aufgetreten sein. Dieses zweite Mal gilt nur
Änderungen, also sollte es schnell gehen.

3. Aktualisieren Sie das zusätzliche E-Mail-Feld in der Benutzerdatenbank auf mdbox:~/mdbox. Wenn Sie den Authentifizierungs-Cache verwenden,
Sie müssen es spülen, z Doveadm auth Cache-Speicher spülen.

4. Warten Sie ein paar Sekunden und töten Sie dann (doveadm kick) alle vorhandenen Imap des Benutzers
und pop3-Sitzungen (die immer noch maildir verwenden).

5. Führen Doveadm synchronisieren noch einmal, um eventuell vorgenommene letzte Änderungen zu übernehmen. Nach
Dies sollte an Maildir nicht geändert werden, da der E-Mail-Speicherort des Benutzers
geändert und alle vorhandenen Prozesse, die es verwenden, wurden beendet.

Sobald alle Benutzer konvertiert wurden, können Sie die Standardeinstellung festlegen mail_location zu mdbox und
Entfernen Sie die E-Mail-Speicherorte pro Benutzer aus Benutzerdatenbank.

REPORTING Fehler

Fehler melden, einschließlich Taubenkonferenz -n Ausgabe an die Dovecot-Mailingliste
<[E-Mail geschützt] >. Informationen zum Melden von Fehlern finden Sie unter:
http://dovecot.org/bugreport.html

Verwenden Sie doveadm-sync online mit den onworks.net-Diensten