doveadm-sync - En ligne dans le Cloud

PROGRAMME:

Nom

doveadm-sync - utilitaire de synchronisation de boîte aux lettres bidirectionnelle de Dovecot
doveadm-backup - utilitaire de synchronisation de boîte aux lettres unidirectionnelle de Dovecot

SYNOPSIS

colombeadm [-Dv] synchroniser [-u utilisateur|-A|-F filet] [-S chemin_socket] [-1fPRU] [-l secondes] [-r
chemin_rawlog] [-m boîte à lettres] [-g boîte aux lettres_guid] [-n namespace|-N] [-x exclure] [-s Etat] [-T
secondes] -d|destination

colombeadm [-Dv] sauvegarde [-u utilisateur|-A|-F filet] [-S chemin_socket] [-fPRU] [-l secondes] [-r
chemin_rawlog] [-m boîte à lettres] [-g boîte aux lettres_guid] [-n namespace|-N] [-x exclure] [-s Etat] [-T
secondes] -d|destination

DESCRIPTION

dsync est l'utilitaire de synchronisation de boîte aux lettres de Dovecot. Il peut être utilisé pour plusieurs
cas d'utilisation : synchronisation bidirectionnelle des boîtes aux lettres, création de sauvegardes de courriers et conversion
boîtes aux lettres de/vers différents formats de boîtes aux lettres. Tous ces éléments peuvent être utilisés dans le même
serveur ou entre différents serveurs (via ssh(1) ou connexions tcp). Les boîtes aux lettres distantes peuvent
être accessible également via le protocole IMAP, qui permet d'utiliser dsync pour la migration des boîtes aux lettres
fins pratiques.

Vous pouvez exécuter dsync dans l'un des trois modes suivants :

· colombeadm sauvegarde effectue une synchronisation unidirectionnelle. S'il y a des changements
dans la destination, ils seront supprimés, donc la destination apparaîtra
exactement comme la source.

· colombeadm synchroniser effectue une synchronisation bidirectionnelle. Il fusionne tous les changements
sans rien perdre. Les deux boîtes aux lettres finiront par avoir l'air identiques
une fois la synchronisation terminée.

· colombeadm synchroniser -1 effectue une synchronisation unidirectionnelle, mais fusionne les modifications
dans la destination sans rien supprimer. Cela ne fonctionne pas actuellement
parfaitement, donc son utilisation doit être limitée. Son objectif principal est que pendant
migration de boîte aux lettres que vous pouvez exécuter colombeadm sauvegarde plusieurs fois, puis changez
e-mails à remettre dans la nouvelle boîte aux lettres et à exécuter colombeadm synchroniser -1 une fois de plus
pour transférer les derniers nouveaux e-mails de l'ancienne boîte aux lettres.

Il existe également trois algorithmes de synchronisation différents :

· La synchronisation complète (paramètre -f) parcourt tous les messages dans tous
les boîtes aux lettres. Cela garantit que tout sera synchronisé, mais
il est inutilement lent pour la synchronisation incrémentielle.

· La synchronisation rapide (par défaut) tente d'abord de trouver les boîtes aux lettres qui ont
modifiés et ne synchronisez que ceux-ci. Cela se fait en vérifiant le
métadonnées des boîtes aux lettres (NEXTUID et HIGHESTMODSEQ). Habituellement, cela fonctionne bien,
surtout avec la synchronisation unidirectionnelle, mais si les deux côtés font exactement le
même nombre de changements, les métadonnées peuvent finir par contenir les mêmes valeurs
même si les changements étaient différents.

· La synchronisation avec état (paramètre -s) est le moyen le plus efficace de
synchroniser les boîtes aux lettres. Il repose sur l'état de l'exécution de dsync précédente
enregistré quelque part et transmis à la prochaine exécution de dsync. Sur la base de cet état
dsync ne peut envoyer que les modifications qui se sont produites après l'exécution précédente de dsync.
Tant que l'état ou les boîtes aux lettres ne sont pas corrompus, cet algorithme devrait
fonctionnent parfaitement. Le processus de réplication l'utilise en interne pour effectuer la plupart des
de la synchronisation.

La synchronisation se fait le plus parfaitement possible : un client IMAP ou POP3 ne devrait pas pouvoir
pour remarquer les différences entre les deux boîtes aux lettres. La synchronisation bidirectionnelle signifie que c'est sûr
pour faire n'importe quel type de modifications des deux côtés, et dsync fusionnera les modifications sans
perdre toutes les modifications apportées de chaque côté. Ceci est possible car dsync peut accéder
Les journaux d'indexation de Dovecot qui gardent une trace des modifications. Il est bien entendu possible d'avoir
conflits lors de la fusion, ceux-ci sont résolus de manière sûre. Voir le dsync DESIGN document
pour plus d'information.

dsync utilise les mêmes fichiers de configuration que le reste de Dovecot (via colombeconf(1) binaire).
Toute la configuration peut être modifiée en donnant le paramètre -c à une autre configuration
ou en utilisant le paramètre -o pour remplacer des paramètres spécifiques. Lors de l'exécution d'une dsync à distance
programme, il fonctionne de la même manière : il utilise sa propre configuration locale.

dsync peut être exécuté de manière totalement autonome. Il ne nécessite aucun processus serveur Dovecot
être en cours d'exécution, sauf lors de l'utilisation du paramètre -u pour faire un base de données utilisateur recherche à partir du processus d'authentification.

dsync peut synchroniser un ou plusieurs utilisateurs à l'aide des paramètres -u ou -A. Pour continu
réplication, vous pouvez utiliser le processus de réplication Dovecot, qui exécute automatiquement dsync
chaque fois que les messages ont changé.

OPTIONS

Global colombeadm(1) Options:

-D Active la verbosité et les messages de débogage.

-o mise=Plus-value
Remplace la configuration mise de /etc/dovecot/dovecot.conf et de la
userdb avec le donné Plus-value. Afin de remplacer plusieurs paramètres, le -o option
peut être spécifié plusieurs fois.

-v Active la verbosité, y compris le compteur de progression.

Spécifique à la commande Options:

-1 Effectuez une synchronisation unidirectionnelle au lieu d'une synchronisation bidirectionnelle.

-A Si la -A l'option est présente, le commander sera effectuée pour tous les utilisateurs. À l'aide de
cette option en combinaison avec les utilisateurs du système de base de données utilisateur { driver = passwd } n'est pas
recommandé, car il contient également des utilisateurs avec un UID inférieur à celui
configuré avec le first_valid_uid réglage.

Lorsque le module SQL userdb est utilisé, assurez-vous que le itérer_requête mise en
/etc/dovecot/dovecot-sql.conf.ext correspond à la disposition de votre base de données. Lors de l'utilisation du
module userdb LDAP, assurez-vous que le itérer_attrs ainsi que itérer_filtre paramètres dans
/etc/dovecot/dovecot-ldap.conf.ext correspondent à votre schéma LDAP. Autrement colombeadm(1)
sera incapable d'itérer sur tous les utilisateurs.

-F filet
Exécutez le commander pour tous les utilisateurs du filet. Ceci est similaire au -A
option, mais au lieu d'obtenir la liste des utilisateurs de la base de données userdb, ils sont lus
du donné filetL’ filet contient un nom d'utilisateur par ligne.

-N Synchronisez tous les espaces de noms disponibles. Par défaut, seuls les espaces de noms qui ne
ont un paramètre d'emplacement explicite sont synchronisés.

-P Exécuter un doveadm-purge(1) pour le stockage de destination (distant) après synchronisation.

-R Faites une synchronisation inversée. Normalement, les messages seraient poussés du système local vers le
destination (à distance). Cette option inverse le flux et récupère les messages à la place
du stockage distant au stockage local.

-S chemin_socket
L'argument de l'option est soit un chemin absolu vers un socket de domaine UNIX local, soit
un nom d'hôte et un port (nom d'hôte:port), afin de connecter un hôte distant via un TCP
prise.

Cela permet à un administrateur d'exécuter colombeadm(1) mail commandes via le donné
prise.

-T secondes
Spécifiez le temps en secondes, combien de temps colombeadm(1) doit attendre les E/S bloquées
opérations. Le délai d'attente par défaut est de 600 secondes.

-U Ceci est utilisé en interne par le réplicateur pour que dsync le notifie lorsque le
la synchronisation est terminée.

-d Utilisez la destination par défaut, qui est recherchée à partir du mail_replica base de données utilisateur supplémentaire
champ.

-g boîte aux lettres_guid
Identique à -m, mais recherche la boîte aux lettres à synchroniser par son GUID au lieu de par son nom.

-l secondes
Verrouillez le dsync pour cet utilisateur. Attendre au maximum secondes avant d'abandonner. Cette
doit être utilisé pour éviter une synchronisation interrompue s'il est possible que
dsync est exécuté simultanément pour le même utilisateur.

-m boîte à lettres
Synchronisez uniquement ce nom de boîte aux lettres.

-n namespace
Synchronisez uniquement l'espace de noms spécifié. Ce paramètre peut être utilisé plusieurs
fois.

-r chemin_rawlog
Exécuter dsync à distance, écrire le trafic d'entrée/sortie distant dans le journal spécifié
fichier.

-s état_précédent
Utilisez la synchronisation avec état. Si l'état précédent est inconnu, utilisez une valeur vide
chaîne de caractères. Le nouvel état est toujours imprimé sur la sortie standard.

-u utilisateur/masque
Exécutez le commander seulement pour le donné utilisateur. Il est également possible d'utiliser '*»Et«?'
caractères génériques (par exemple -u *@example.org).
Quand ni le -A option, ni le -F filet option, ni le -u utilisateur a été précisé,
le commander sera exécuté avec l'environnement de l'utilisateur actuellement connecté.

-x masque_boîte
Exclure le nom/masque de boîte aux lettres spécifié. Le masque peut contenir "?" et "*"
caractères génériques. Ce paramètre peut être utilisé plusieurs fois.

ARGUMENTS

destination
Cet argument spécifie la destination synchronisée. Il peut s'agir de l'un des éléments suivants :

emplacement
Pareil que adresse_mail paramètre, par exemple maildir :~/Répertoire de messagerie

à distance:connexion@hôte
Les usages dsync_remote_cmd paramètre pour se connecter à l'hôte distant (généralement via
chut)

préfixe distant : login@host
C'est la même chose que distant, sauf que "user@domain\n" est envoyé avant dsync
le protocole démarre. Cela permet d'implémenter un script wrapper de confiance qui
lance doveadm dsync-server en lisant le nom d'utilisateur à partir de la première ligne.

TCP :port hôte]
Se connecte au serveur doveadm distant via TCP. Le port par défaut est spécifié par
doveadm_port réglage.

tcps :port hôte]
C'est la même chose que tcp, mais avec SSL.

EXIT STATUT

dsync sortira avec l'une des valeurs suivantes :

0 La synchronisation s'est parfaitement déroulée.

2 La synchronisation s'est faite sans erreur, mais certaines modifications n'ont pas pu être effectuées, donc le
les boîtes aux lettres ne sont pas parfaitement synchronisées. Exécuter à nouveau dsync résout généralement ce problème.
Cela se produit généralement pour les séquences de modification de message avec des boîtes aux lettres nouvellement créées.
Cela peut également se produire si l'une des boîtes aux lettres change pendant la synchronisation.

1, >2
La synchronisation a échoué.

EXEMPLE

SYNCHRONISATION
Synchronisez les boîtes aux lettres avec un serveur distant. Toutes les erreurs sont écrites dans stderr.

colombeadm synchroniser -u [email protected] distant:server-replica.example.com

Si vous avez besoin de paramètres plus complexes pour ssh, vous pouvez utiliser par exemple :

colombeadm synchroniser -u [email protected] ssh -i id_dsa.colombier \
[email protected] colombeadm dsync-serveur -u [email protected]

CONVERSION
En supposant que le adresse_mail mise en /etc/dovecot/conf.d/10-mail.conf est réglé sur:
adresse_mail = mdbox :~/boîte md, un utilisateur système connecté peut convertir ses e-mails à partir de son
Maildir dans son répertoire personnel au format de boîte aux lettres mdbox. L'utilisateur doit exécuter
la commande:

colombeadm synchroniser rép mail :~/Répertoire de messagerie

Si vous souhaitez le faire sans temps d'arrêt, vous pouvez effectuer la conversion un utilisateur à la fois.
Initialement:

· La configuration utilise adresse_mail = rép mail :~/Répertoire de messagerie

· Configurer la possibilité de faire une localisation de courrier par utilisateur en utilisant base de données utilisateur champs supplémentaires.

Ensuite pour chaque utilisateur :

1. course colombeadm synchroniser une fois pour faire la conversion initiale.

2. course colombeadm synchroniser encore une fois, car la conversion initiale aurait pu prendre un certain temps
et de nouveaux changements ont pu se produire au cours de celle-ci. Cette deuxième fois s'applique uniquement
change, donc ça devrait être rapide.

3. Mettez à jour le champ supplémentaire de courrier dans userdb pour mdbox :~/boîte md. Si vous utilisez le cache d'authentification,
vous devez le rincer, par exemple colombeadm auth cachette affleurer.

4. Attendez quelques secondes, puis tuez (doveadm kick) toutes les imap existantes de l'utilisateur
et les sessions pop3 (qui utilisent toujours maildir).

5. course colombeadm synchroniser une fois de plus pour appliquer les dernières modifications éventuellement apportées. Après
cela, il ne devrait y avoir aucun changement dans Maildir, car l'emplacement du courrier de l'utilisateur a
été modifié et tous les processus existants l'utilisant ont été tués.

Une fois que tous les utilisateurs ont été convertis, vous pouvez définir la valeur par défaut adresse_mail vers mdbox et
supprimer les emplacements de messagerie par utilisateur de base de données utilisateur.

DE LA LIGNE BOGUES

Signaler des bogues, y compris colombeconf -n sortie, à la liste de diffusion Dovecot
<[email protected]>. Des informations sur les rapports de bogues sont disponibles sur :
http://dovecot.org/bugreport.html

Utiliser doveadm-sync en ligne à l'aide des services onworks.net