doveadm-sync - Online nel cloud

PROGRAMMA:

NOME

doveadm-sync - utilità di sincronizzazione della casella di posta a due vie di Dovecot
doveadm-backup - utilità di sincronizzazione della casella di posta unidirezionale di Dovecot

SINOSSI

doveadm [-Dv] sync [-u Utente|-A|-F filetto] [-S percorso_socket] [-1fPRU] [-l secs] [-r
percorso_rawlog] [-m cassetta postale] [-g mail_guid] [-n namespace|-N] [-x escludere] [-s stato] [-T
secs] -d|destinazione

doveadm [-Dv] di riserva [-u Utente|-A|-F filetto] [-S percorso_socket] [-fPRU] [-l secs] [-r
percorso_rawlog] [-m cassetta postale] [-g mail_guid] [-n namespace|-N] [-x escludere] [-s stato] [-T
secs] -d|destinazione

DESCRIZIONE

dsync è l'utility di sincronizzazione della casella di posta di Dovecot. Può essere utilizzato per diversi
casi d'uso: sincronizzazione bidirezionale delle caselle di posta, creazione di backup delle e-mail e conversione
cassette postali da/verso diversi formati di cassette postali. Tutti questi possono essere utilizzati all'interno dello stesso
server o tra server diversi (tramite SSH(1) o connessioni TCP). Le caselle di posta remote possono
accessibile anche tramite protocollo IMAP, che consente di utilizzare dsync per la migrazione della casella di posta
scopi.

È possibile eseguire dsync in una delle tre modalità:

· doveadm di riserva esegue la sincronizzazione unidirezionale. Se ci sono cambiamenti
nella destinazione verranno eliminati, quindi la destinazione cercherà
esattamente come la fonte.

· doveadm sync esegue la sincronizzazione bidirezionale. Unisce tutte le modifiche
senza perdere nulla. Entrambe le cassette postali finiranno per sembrare identiche
al termine della sincronizzazione.

· doveadm sync -1 esegue la sincronizzazione unidirezionale, ma unisce le modifiche
in destinazione senza cancellare nulla. Al momento non funziona
perfettamente, quindi il suo utilizzo dovrebbe essere limitato. Il suo scopo principale è che durante
migrazione della casella di posta che puoi eseguire doveadm di riserva più volte, quindi cambia
messaggi da consegnare alla nuova casella di posta ed eseguire doveadm sync -1 ancora una volta
per trasferire gli ultimi nuovi messaggi dalla vecchia casella di posta.

Esistono anche tre diversi algoritmi di sincronizzazione:

· La sincronizzazione completa (parametro -f) esegue la scansione di tutti i messaggi in tutto
le cassette postali. Ciò garantisce che tutto sarà sincronizzato, ma
è inutilmente lento per la sincronizzazione incrementale.

· La sincronizzazione veloce (predefinita) tenta prima di trovare le caselle di posta che hanno
modificati e sincronizzare solo quelli. Questo viene fatto controllando il
metadati delle caselle di posta (NEXTUID e HIGHESTMODSEQ). Di solito funziona bene,
specialmente con la sincronizzazione unidirezionale, ma se entrambi i lati fanno esattamente lo stesso
stesso numero di modifiche, i metadati potrebbero finire per contenere gli stessi valori
anche se i cambiamenti sono stati diversi.

· La sincronizzazione stateful (parametro -s) è il modo più efficiente per
sincronizzare le caselle di posta. Si basa sullo stato dell'esecuzione di dsync precedente
salvato da qualche parte e passato alla successiva esecuzione di dsync. Sulla base di questo stato
dsync può inviare solo le modifiche avvenute dopo la precedente esecuzione di dsync.
Finché lo stato o le caselle di posta non sono danneggiate, questo algoritmo dovrebbe
funzionare perfettamente. Il processo di replica utilizza questo internamente per eseguire la maggior parte
della sincronizzazione.

La sincronizzazione viene eseguita nel modo più perfetto possibile: un client IMAP o POP3 non dovrebbe essere in grado
per notare eventuali differenze tra le due cassette postali. La sincronizzazione bidirezionale significa che è sicuro
fare qualsiasi tipo di modifica in entrambi i lati e dsync unirà le modifiche senza
perdere eventuali modifiche apportate su entrambi i lati. Questo è possibile perché dsync può accedere
Registri dell'indice di Dovecot che tengono traccia delle modifiche. Ovviamente è possibile avere
conflitti durante la fusione, questi vengono risolti in modo sicuro. Vedi il sincronia DESIGN documento
per maggiori informazioni.

dsync usa gli stessi file di configurazione del resto di Dovecot (tramite dove conf(1) binario).
L'intera configurazione può essere modificata assegnando il parametro -c a un'altra configurazione
file o utilizzando il parametro -o per sovrascrivere impostazioni specifiche. Quando si esegue un dsync remoto
programma funziona allo stesso modo: utilizza la propria configurazione locale.

dsync può essere eseguito in modo completamente autonomo. Non richiede alcun processo server Dovecot
essere in esecuzione, tranne quando si usa il parametro -u per fare a utentedb ricerca dal processo di autenticazione.

dsync può sincronizzare uno o più utenti utilizzando i parametri -u o -A. Per continuo
replica è possibile utilizzare il processo del replicatore Dovecot, che esegue automaticamente dsync
ogni volta che i messaggi sono cambiati.

VERSIONI

globali doveadm(1) Opzioni:

-D Abilita la verbosità e il debug dei messaggi.

-o regolazione=APPREZZIAMO
Sostituisce la configurazione regolazione da /etc/dovecot/dovecot.conf e dal
userdb con il dato APPREZZIAMO. Per sovrascrivere più impostazioni, il -o opzione
può essere specificato più volte.

-v Abilita la verbosità, incluso il contatore di avanzamento.

Specifico del comando Opzioni:

-1 Eseguire la sincronizzazione unidirezionale anziché la sincronizzazione bidirezionale.

-A Se l' -A l'opzione è presente, il command verrà eseguito per tutti gli utenti. Usando
questa opzione in combinazione con gli utenti del sistema di utentedb { autista = passwd } non è
consigliato, perché contiene anche utenti con un UID inferiore a quello
configurato con il primo_valid_uid impostazione.

Quando viene utilizzato il modulo SQL userdb assicurarsi che iterare_query sistemarsi
/etc/dovecot/dovecot-sql.conf.ext corrisponde al layout del database. Quando si utilizza il
modulo LDAP userdb, assicurati che il iterare_attr ed itera_filtro impostazioni in
/etc/dovecot/dovecot-ldap.conf.ext corrisponda al tuo schema LDAP. Altrimenti doveadm(1)
non sarà in grado di eseguire l'iterazione su tutti gli utenti.

-F filetto
Eseguire il command per tutti gli utenti del filetto. Questo è simile al -A
opzione, ma invece di ottenere l'elenco degli utenti da userdb, vengono letti
dal dato filetto. filetto contiene un nome utente per riga.

-N Sincronizzare tutti gli spazi dei nomi disponibili. Per impostazione predefinita solo gli spazi dei nomi che non lo fanno
hanno un'impostazione di posizione esplicita sono sincronizzati.

-P Esegui a doveadm-purga(1) per l'archiviazione di destinazione (remota) dopo la sincronizzazione.

-R Fai una sincronizzazione inversa. Normalmente, i messaggi verrebbero inviati dal sistema locale al
destinazione (remota). Questa opzione inverte il flusso e estrarrà invece i messaggi
dalla memoria remota alla memoria locale.

-S percorso_socket
L'argomento dell'opzione è un percorso assoluto a un socket di dominio UNIX locale, oppure
un nome host e una porta (hostname:porto), per connettere un host remoto tramite un TCP
zoccolo.

Ciò consente a un amministratore di eseguire doveadm(1) comandi di posta tramite il dato
zoccolo.

-T secs
Specificare il tempo in secondi, quanto tempo doveadm(1) dovrebbe attendere I/O in stallo
operazioni. Il timeout predefinito è di 600 secondi.

-U Questo viene utilizzato internamente dal replicatore per fare in modo che dsync lo avvisi quando il
la sincronizzazione è terminata.

-d Usa la destinazione predefinita, che viene cercata dal mail_replica utentedb extra
campo.

-g mail_guid
Uguale a -m, ma trova la cassetta postale da sincronizzare in base al suo GUID anziché in base al nome.

-l secs
Blocca il dsync per questo utente. Aspetta il massimo secs prima di arrendersi. Questo
parametro dovrebbe essere utilizzato per evitare interruzioni di sincronizzazione se è possibile che
dsync viene eseguito contemporaneamente per lo stesso utente.

-m cassetta postale
Sincronizza solo il nome di questa casella di posta.

-n namespace
Sincronizza solo lo spazio dei nomi specificato. Questo parametro può essere utilizzato più volte
volte.

-r percorso_rawlog
Eseguendo dsync in remoto, scrivi il traffico di input/output remoto nel registro specificato
file.

-s stato_precedente
Usa la sincronizzazione con stato. Se lo stato precedente è sconosciuto, usa un vuoto
corda. Il nuovo stato viene sempre stampato sull'output standard.

-u utente/maschera
Corri il command solo per il dato Utente. È anche possibile utilizzare '*'E'?'
caratteri jolly (ad es. -u *@example.org).
Quando né il -A opzione, né il -F filetto opzione, né il -u Utente è stato specificato,
, il command verrà eseguito con l'ambiente dell'utente attualmente connesso.

-x casella di posta_maschera
Escludere il nome/maschera della casella di posta specificati. La maschera può contenere "?" e "*"
caratteri jolly. Questo parametro può essere utilizzato più volte.

ARGOMENTI

destinazione
Questo argomento specifica la destinazione sincronizzata. Può essere uno tra:

località
Uguale a posta_posizione impostazione, ad esempio maildir:~/indir

a distanza:login@host
si utilizza dsync_remote_cmd impostazione per connettersi all'host remoto (di solito tramite
ssh)

prefisso remoto: login@host
È uguale a remote, tranne che "user@domain\n" viene inviato prima di dsync
inizia il protocollo. Ciò consente di implementare uno script wrapper affidabile che
esegue doveadm dsync-server leggendo il nome utente dalla prima riga.

TCP:porta ospite]
Si connette al server doveadm remoto tramite TCP. La porta predefinita è specificata da
doveadm_port impostazione.

TCP:porta ospite]
Questo è lo stesso di tcp, ma con SSL.

EXIT STATUS

sincronia uscirà con uno dei seguenti valori:

0 La sincronizzazione è stata eseguita perfettamente.

2 La sincronizzazione è stata eseguita senza errori, ma non è stato possibile apportare alcune modifiche, quindi il
le caselle di posta non sono perfettamente sincronizzate. L'esecuzione di nuovo di dsync di solito risolve questo problema.
In genere ciò si verifica per le sequenze di modifica dei messaggi con cassette postali appena create.
Può anche verificarsi se una delle caselle di posta cambia durante la sincronizzazione.

1, >2
Sincronizzazione non riuscita.

ESEMPIO

SINCRONIZZAZIONE
Sincronizzare le caselle di posta con un server remoto. Eventuali errori vengono scritti su stderr.

doveadm sync -u [email protected] remoto:replica-server.esempio.com

Se hai bisogno di parametri più complessi per ssh, puoi usare ad esempio:

doveadm sync -u [email protected] SSH -i id_dsa.dovecot \
[email protected] doveadm server dsync -u [email protected]

CONVERSIONE
Supponendo che il posta_posizione sistemarsi /etc/dovecot/conf.d/10-mail.conf è impostato per:
posta_posizione = casella md:~/mdbox, un utente di sistema connesso può convertire i suoi messaggi dalla sua
Maildir nella sua home directory nel formato della casella di posta mdbox. L'utente deve eseguire
il comando:

doveadm sync indirizzo e-mail:~/indir

Se vuoi farlo senza tempi di inattività, puoi eseguire la conversione un utente alla volta.
Inizialmente:

· Usi di configurazione posta_posizione = indirizzo e-mail:~/indir

· Imposta la possibilità di eseguire la posizione della posta per utente utilizzando utentedb campi aggiuntivi.

Quindi per ogni utente:

1. Esegui doveadm sync una volta per eseguire la conversione iniziale.

2. Esegui doveadm sync di nuovo, perché la conversione iniziale avrebbe potuto richiedere un po' di tempo
e nuovi cambiamenti potrebbero essersi verificati durante esso. Questa seconda volta vale solo
cambia, quindi dovrebbe essere veloce.

3. Aggiorna il campo extra della posta in userdb a casella md:~/mdbox. Se stai utilizzando la cache di autenticazione,
devi sciacquarlo, ad es doveadm auth nascondiglio lavare.

4. Attendi qualche secondo e poi uccidi (doveadm kick) tutte le imap esistenti dell'utente
e pop3 (che stanno ancora usando maildir).

5. Esegui doveadm sync ancora una volta per applicare le modifiche finali eventualmente apportate. Dopo
questo non dovrebbero esserci modifiche a Maildir, perché la posizione della posta dell'utente ha
stato modificato e tutti i processi esistenti che lo utilizzano sono stati uccisi.

Una volta che tutti gli utenti sono stati convertiti, puoi impostare l'impostazione predefinita posta_posizione a mdbox e
rimuovere le posizioni di posta per utente da utentedb.

REPORTING BUG

Segnala bug, incluso dove conf -n output, alla mailing list di Dovecot
<[email protected]>. Le informazioni sulla segnalazione dei bug sono disponibili all'indirizzo:
http://dovecot.org/bugreport.html

Usa doveadm-sync online utilizzando i servizi onworks.net