doveadm-sync - Online in de cloud

PROGRAMMA:

NAAM

doveadm-sync - Dovecot's hulpprogramma voor tweerichtingsmailboxsynchronisatie
doveadm-backup - Dovecot's eenrichtingshulpprogramma voor mailboxsynchronisatie

KORTE INHOUD

duifadm [-Dv] sync [-u gebruiker|-A|-F filet] [-S socket_pad] [-1fPRU] [-l secs] [-r
rawlog_pad] [-m postbus] [-g mailbox_gui] [-n namespace|-N] [-x uitsluiten] [-s staat] [-T
secs] -d|bestemming

duifadm [-Dv] backup [-u gebruiker|-A|-F filet] [-S socket_pad] [-fPRU] [-l secs] [-r
rawlog_pad] [-m postbus] [-g mailbox_gui] [-n namespace|-N] [-x uitsluiten] [-s staat] [-T
secs] -d|bestemming

PRODUCTBESCHRIJVING

dsync is het hulpprogramma voor mailboxsynchronisatie van Dovecot. Het kan voor verschillende worden gebruikt
use cases: Tweerichtingssynchronisatie van mailboxen, back-ups van mails maken en converteren
mailboxen van/naar verschillende mailboxformaten. Al deze kunnen binnen hetzelfde worden gebruikt
server of tussen verschillende servers (via ssh(1) of tcp-verbindingen). Externe mailboxen kunnen dat wel
ook toegankelijk via het IMAP-protocol, waarmee dsync kan worden gebruikt voor mailboxmigratie
praktische doeleinden.

U kunt dsync in een van de volgende drie modi uitvoeren:

· duifadm backup voert eenrichtingssynchronisatie uit. Als er veranderingen zijn
in de bestemming worden ze verwijderd, zodat de bestemming eruitziet
precies zoals de bron.

· duifadm sync voert tweerichtingssynchronisatie uit. Het voegt alle wijzigingen samen
zonder iets te verliezen. Beide mailboxen zien er uiteindelijk identiek uit
nadat de synchronisatie is voltooid.

· duifadm sync -1 voert eenrichtingssynchronisatie uit, maar voegt de wijzigingen samen
in bestemming zonder iets te wissen. Dit werkt momenteel niet
perfect, dus het gebruik ervan moet beperkt zijn. Het belangrijkste doel is dat tijdens
mailboxmigratie die u kunt uitvoeren duifadm backup meerdere keren en dan wisselen
e-mails die in de nieuwe mailbox moeten worden afgeleverd en uitgevoerd duifadm sync -1 nog een keer
om eventuele laatste nieuwe mails uit de oude mailbox over te zetten.

Er zijn ook drie verschillende synchronisatie-algoritmen:

· Volledige synchronisatie (-f parameter) scant alle berichten in totaal
de brievenbussen. Dit garandeert dat alles wordt gesynchroniseerd, maar
het is onnodig traag voor incrementele synchronisatie.

· Snelle synchronisatie (standaard) probeert eerst mailboxen te vinden die dat wel hebben
gewijzigd en synchroniseer alleen die. Dit doet u door de
metadata van mailboxen (NEXTUID en HIGHESTMODSEQ). Meestal werkt dit prima,
vooral met eenrichtingssynchronisatie, maar als beide kanten precies hetzelfde doen
hetzelfde aantal wijzigingen, kunnen de metadata uiteindelijk dezelfde waarden bevatten
ook al waren de veranderingen anders.

· Stateful synchronisatie (-s parameter) is de meest efficiënte manier
mailboxen synchroniseren. Het is afhankelijk van de status van de eerdere dsync-run
ergens opgeslagen en doorgegeven aan de volgende dsync-run. Op basis van deze staat
dsync kan alleen de wijzigingen verzenden die zijn aangebracht na de vorige dsync-uitvoering.
Zolang de status of de mailboxen niet beschadigd zijn, zou dit algoritme dat moeten doen
perfect werken. Het replicatorproces gebruikt dit intern om het meest te presteren
van de synchronisatie.

De synchronisatie gebeurt zo perfect mogelijk: een IMAP- of een POP3-client zou dat niet moeten kunnen
om eventuele verschillen tussen de twee mailboxen op te merken. Synchronisatie in twee richtingen betekent dat het veilig is
om enige vorm van wijziging aan beide kanten uit te voeren, en dsync zal de wijzigingen samenvoegen zonder
wijzigingen die aan beide kanten zijn aangebracht, verliezen. Dit is mogelijk omdat dsync toegang heeft
Dovecot's indexlogboeken die wijzigingen bijhouden. Het is natuurlijk mogelijk om te hebben
conflicten tijdens het samenvoegen worden deze op een veilige manier opgelost. Zie de gesynchroniseerd Design document
voor meer informatie.

dsync gebruikt dezelfde configuratiebestanden als de rest van Dovecot (via duifconf(1) binair).
De hele configuratie kan worden gewijzigd door parameter -c aan een andere configuratie te geven
bestand, of gebruik de parameter -o om specifieke instellingen te overschrijven. Bij het uitvoeren van een externe dsync
programma werkt het op dezelfde manier: het gebruikt zijn eigen lokale configuratie.

dsync kan volledig zelfstandig worden uitgevoerd. Het vereist geen Dovecot-serverprocessen
moet worden uitgevoerd, behalve wanneer de parameter -u wordt gebruikt om a gebruikerdb opzoeken van authentificatieproces.

dsync kan een of meerdere gebruikers synchroniseren met behulp van de parameters -u of -A. Voor continu
replicatie kunt u het Dovecot-replicatorproces gebruiken, dat dsync automatisch uitvoert
wanneer berichten zijn gewijzigd.

OPTIES

Globaal duifadm(1) opties:

-D Schakelt breedsprakigheid en foutopsporingsberichten in.

-o het instellen van=waarde
Overschrijft de configuratie het instellen van oppompen van /etc/dovecot/dovecot.conf en van de
userdb met de gegeven waarde. Om meerdere instellingen te overschrijven, -o optie
kan meerdere keren worden opgegeven.

-v Maakt breedsprakigheid mogelijk, inclusief voortgangsteller.

Opdracht specifiek opties:

-1 Voer synchronisatie in één richting uit in plaats van synchronisatie in twee richtingen.

-A Indien de -A optie aanwezig is, de commando wordt uitgevoerd voor alle gebruikers. Gebruik makend van
deze optie in combinatie met systeemgebruikers van gebruikerdb { bestuurder = passwd } is niet
aanbevolen, omdat het ook gebruikers bevat met een lagere UID dan die
geconfigureerd met de eerste_geldige_uid instellen.

Wanneer de SQL userdb-module wordt gebruikt, zorg er dan voor dat de itereer_query in te zetten
/etc/dovecot/dovecot-sql.conf.ext overeenkomt met uw databaselay-out. Bij gebruik van de
LDAP userdb module, zorg ervoor dat de itereren_attrs en herhalen_filter instellingen in
/etc/dovecot/dovecot-ldap.conf.ext overeenkomen met uw LDAP-schema. Anders duifadm(1)
zal niet in staat zijn om alle gebruikers te herhalen.

-F filet
Voer de commando voor alle gebruikers in de filet. Dit is vergelijkbaar met de -A
optie, maar in plaats van de lijst met gebruikers uit de userdb te halen, worden ze gelezen
van het gegeven filet. De filet bevat één gebruikersnaam per regel.

-N Synchroniseer alle beschikbare naamruimten. Standaard alleen naamruimten die dat niet doen
expliciete locatie-instellingen zijn gesynchroniseerd.

-P Voer een uit duif-purge(1) voor de bestemming (externe) opslag na synchronisatie.

-R Voer een omgekeerde synchronisatie uit. Normaal gesproken worden berichten van het lokale systeem naar het
bestemming (op afstand). Deze optie keert de stroom om en haalt in plaats daarvan berichten op
van de afstandsbediening naar de lokale opslag.

-S socket_pad
Het argument van de optie is ofwel een absoluut pad naar een lokale UNIX-domeinsocket, of
een hostnaam en poort (hostname:port), om een ​​externe host te verbinden via een TCP
stopcontact.

Hierdoor kan een beheerder uitvoeren: duifadm(1) mail commando's via de gegeven
stopcontact.

-T secs
Specificeer de tijd in seconden, hoe lang duifadm(1) moet wachten op vastgelopen I/O
activiteiten. De standaard time-out is 600 seconden.

-U Dit wordt intern door replicator gebruikt om dsync te laten weten wanneer het
synchronisatie is voltooid.

-d Gebruik de standaardbestemming, die wordt opgezocht in de mail_replica gebruikerdb extra
veld.

-g mailbox_gui
Hetzelfde als -m, maar zoek het postvak dat moet worden gesynchroniseerd op basis van de GUID in plaats van op naam.

-l secs
Vergrendel de dsync voor deze gebruiker. Wacht maximaal secs voor het opgeven. Dit
parameter moet worden gebruikt om verbroken synchronisatie te voorkomen als dat mogelijk is
dsync wordt gelijktijdig uitgevoerd voor dezelfde gebruiker.

-m postbus
Synchroniseer alleen deze mailboxnaam.

-n namespace
Synchroniseer alleen de opgegeven naamruimte. Deze parameter kan meervoudig worden gebruikt
tijden.

-r rawlog_pad
Als u dsync op afstand uitvoert, schrijft u het externe invoer-/uitvoerverkeer naar het opgegeven logboek
bestand.

-s vorige_staat
Gebruik stateful synchronisatie. Als de vorige status onbekend is, gebruik dan een lege
snaar. De nieuwe status wordt altijd afgedrukt naar standaarduitvoer.

-u gebruiker/masker
Voer de ... uit commando alleen voor het gegeven gebruiker. Het is ook mogelijk om '*En '?'
jokertekens (bijv. -u *@example.org).
Wanneer geen van beide -A optie, noch de -F filet optie, noch de -u gebruiker werd opgegeven,
de commando wordt uitgevoerd met de omgeving van de momenteel ingelogde gebruiker.

-x mailbox_masker
Sluit de opgegeven mailboxnaam/-masker uit. Het masker kan "?"En"*"
wildcards. Deze parameter kan meerdere keren worden gebruikt.

ARGUMENTEN

bestemming
Dit argument specificeert de gesynchroniseerde bestemming. Het kan een van zijn:

plaats
Hetzelfde als mail_locatie instelling, bijv. maildir:~/Maildir

afstandsbediening:inloggen@host
u gebruikt dsync_remote_cmd instelling om verbinding te maken met de externe host (meestal via
ssh)

voorvoegsel op afstand: login@host
Dit is hetzelfde als op afstand, behalve dat "gebruiker@domein\n" vóór dsync wordt verzonden
protocol start. Hierdoor kan een vertrouwd wrapper-script worden geïmplementeerd dat
voert doveadm dsync-server uit door de gebruikersnaam van de eerste regel te lezen.

tcp:host[:poort]
Maakt verbinding met externe doveadm-server via TCP. De standaardpoort wordt opgegeven door
doveadm_poort instellen.

tcps:host[:poort]
Dit is hetzelfde als tcp, maar dan met SSL.

EXIT STATUS

gesynchroniseerd wordt afgesloten met een van de volgende waarden:

0 Synchronisatie is perfect gedaan.

2 De synchronisatie verliep zonder fouten, maar sommige wijzigingen konden niet worden doorgevoerd, dus het
mailboxen zijn niet perfect gesynchroniseerd. Door dsync opnieuw uit te voeren, wordt dit meestal opgelost.
Dit gebeurt meestal voor berichtwijzigingsreeksen met nieuw aangemaakte mailboxen.
Het kan ook voorkomen als een van de mailboxen verandert tijdens de synchronisatie.

1, >2
Synchronisatie mislukt.

VOORBEELD

SYNCHRONISATIE
Synchroniseer mailboxen met een externe server. Eventuele fouten worden naar stderr geschreven.

duifadm sync -u [e-mail beveiligd] extern:server-replica.voorbeeld.com

Als je meer complexe parameters nodig hebt voor ssh, kun je bijvoorbeeld het volgende gebruiken:

duifadm sync -u [e-mail beveiligd] ssh -i id_dsa.duiventil \
[e-mail beveiligd] duifadm dsync-server -u [e-mail beveiligd]

OMZETTEN
Ervan uitgaande dat de mail_locatie in te zetten /etc/dovecot/conf.d/10-mail.conf staat op:
mail_locatie = mdbox:~/mdbox, kan een ingelogde systeemgebruiker haar/zijn mails converteren van its
Maildir in haar/zijn home directory naar het mdbox mailbox formaat. De gebruiker moet uitvoeren
het bevel:

duifadm sync mailmap:~/Maildir

Als u dit zonder downtime wilt doen, kunt u de conversie één gebruiker tegelijk uitvoeren.
Aanvankelijk:

· Configuratiegebruik mail_locatie = mailmap:~/Maildir

· Stel de mogelijkheid in om per gebruiker e-maillocatie te gebruiken gebruikerdb extra velden.

Vervolgens voor elke gebruiker:

1. Lopen duifadm sync eenmaal om de eerste conversie uit te voeren.

2. Lopen duifadm sync nogmaals, omdat de eerste conversie even kan hebben geduurd
en nieuwe veranderingen zouden kunnen hebben plaatsgevonden tijdens het. Alleen deze tweede keer geldt
veranderingen, dus het moet snel zijn.

3. Update mail extra veld in userdb naar mdbox:~/mdbox. Als u authenticatiecache gebruikt,
je moet het doorspoelen, bijv duifadm auth cache doorspoelen.

4. Wacht een paar seconden en dood (doveadm kick) dan alle bestaande imap van de gebruiker
en pop3-sessies (die nog steeds maildir gebruiken).

5. Lopen duifadm sync nog een keer om de laatste wijzigingen toe te passen die mogelijk zijn aangebracht. Na
hiervoor mogen er geen wijzigingen zijn in Maildir, omdat de e-maillocatie van de gebruiker dat wel heeft
gewijzigd en alle bestaande processen die het gebruiken zijn gedood.

Zodra alle gebruikers zijn geconverteerd, kunt u de standaard instellen mail_locatie naar mdbox en
verwijder de e-maillocaties per gebruiker gebruikerdb.

RAPPORTAGE BUGS

Rapporteer bugs, inclusief duifconf -n output, naar de Dovecot Mailing List
<[e-mail beveiligd]>. Informatie over het melden van bugs is beschikbaar op:
http://dovecot.org/bugreport.html

Gebruik doveadm-sync online met behulp van onworks.net-services