doveadm-sync - Online na nuvem

PROGRAMA:

NOME

doveadm-sync - utilitário de sincronização de caixa de correio bidirecional da Dovecot
doveadm-backup - utilitário de sincronização de caixa de correio unilateral da Dovecot

SINOPSE

pomba [-Dv] sincronizar [-u usuário|-A|-F lima] [-S caminho_soquete] [-1fPRU] [-l seg] [-r
rawlog_path] [-m caixa de correio] [-g guia_de_caixa] [-n namespace|-N] [-x excluir] [-s estado] [-T
seg] -d|destino

pomba [-Dv] backup [-u usuário|-A|-F lima] [-S caminho_soquete] [-fPRU] [-l seg] [-r
rawlog_path] [-m caixa de correio] [-g guia_de_caixa] [-n namespace|-N] [-x excluir] [-s estado] [-T
seg] -d|destino

DESCRIÇÃO

dsync é o utilitário de sincronização de caixa de correio da Dovecot. Pode ser usado para vários diferentes
casos de uso: sincronização bidirecional de caixas de correio, criação de backups de e-mails e conversão
caixas de correio de / para diferentes formatos de caixa de correio. Todos eles podem ser usados ​​dentro do mesmo
servidor ou entre servidores diferentes (via ssh(1) ou conexões tcp). Caixas de correio remotas podem
ser acessado também via protocolo IMAP, que permite o uso de dsync para migração de caixa de correio
finalidades.

Você pode executar o dsync em um dos três modos:

· pomba backup executa sincronização unilateral. Se houver alguma mudança
no destino, eles serão excluídos, para que o destino pareça
exatamente como a fonte.

· pomba sincronizar executa sincronização bidirecional. Ele mescla todas as alterações
sem perder nada. Ambas as caixas de correio acabarão parecendo idênticas
após o término da sincronização.

· pomba sincronizar -1 executa a sincronização unilateral, mas mescla as alterações
no destino sem excluir nada. Isso não funciona atualmente
perfeitamente, então seu uso deve ser limitado. Seu principal objetivo é que durante
migração de caixa de correio que você pode executar pomba backup várias vezes, depois mude
e-mails a serem entregues na nova caixa de correio e executados pomba sincronizar -1 mais oz dezembro
para transferir os últimos novos e-mails da caixa de correio antiga.

Existem também três algoritmos de sincronização diferentes:

· A sincronização completa (parâmetro -f) verifica todas as mensagens em todos
as caixas de correio. Isso garante que tudo estará sincronizado, mas
é desnecessariamente lento para sincronização incremental.

· A sincronização rápida (padrão) primeiro tenta encontrar caixas de correio que tenham
alterado e sincronizar apenas aqueles. Isso é feito verificando o
metadados das caixas de correio (NEXTUID e HIGHESTMODSEQ). Normalmente isso funciona bem,
especialmente com a sincronização unilateral, mas se ambos os lados fizerem exatamente o
mesmo número de alterações, os metadados podem acabar contendo os mesmos valores
mesmo que as mudanças fossem diferentes.

· A sincronização stateful (parâmetro -s) é a maneira mais eficiente de
sincronizar caixas de correio. Ele depende de ter o estado de execução dsync anterior
salvo em algum lugar e sendo passado para a próxima execução dsync. Com base neste estado
O dsync pode enviar apenas as mudanças que aconteceram após a execução anterior do dsync.
Enquanto o estado ou as caixas de correio não estiverem corrompidos, este algoritmo deve
funcionam perfeitamente. O processo do replicador usa isso internamente para realizar a maioria
da sincronização.

A sincronização é feita da forma mais perfeita possível: um cliente IMAP ou POP3 não deve ser capaz
para notar quaisquer diferenças entre as duas caixas de correio. A sincronização bidirecional significa que é seguro
fazer qualquer tipo de modificação em ambos os lados, e dsync irá mesclar as mudanças sem
perder todas as alterações feitas em qualquer um dos lados. Isso é possível porque o dsync pode acessar
Registros de índice do Dovecot que rastreiam as mudanças. Claro que é possível ter
conflitos durante a fusão, eles são resolvidos de forma segura. Veja o dsync design documento
para obter mais informações.

dsync usa os mesmos arquivos de configuração que o resto do Dovecot (via pombaconf(1) binário).
A configuração inteira pode ser alterada dando o parâmetro -c para outra configuração
ou usando o parâmetro -o para substituir configurações específicas. Ao executar um dsync remoto
programa funciona da mesma maneira: usa sua própria configuração local.

dsync pode ser executado completamente autônomo. Não requer nenhum processo de servidor Dovecot
estar em execução, exceto ao usar o parâmetro -u para fazer um usuáriodb consulta do processo de autenticação.

O dsync pode sincronizar um ou vários usuários usando os parâmetros -u ou -A. Para contínuo
replicação, você pode usar o processo de replicador Dovecot, que executa dsync automaticamente
sempre que as mensagens forem alteradas.

OPÇÕES

Global pomba(1) opções:

-D Permite verbosidade e mensagens de depuração.

-o contexto=valor
Substitui a configuração contexto da /etc/dovecot/dovecot.conf e a partir da
userdb com o dado valor. Para substituir várias configurações, o -o opção
pode ser especificado várias vezes.

-v Ativa a verbosidade, incluindo o contador de progresso.

Comando específico opções:

-1 Faça a sincronização unilateral em vez da sincronização bidirecional.

-A Se o -A opção está presente, o comando será executado para todos os usuários. Usando
esta opção em combinação com usuários do sistema de usuáriodb { motorista = passwd } não é
recomendado, porque também contém usuários com um UID inferior ao
configurado com o primeiro_válido_uid criação.

Quando o módulo userdb SQL é usado, certifique-se de que o iterar_query assentando em
/etc/dovecot/dovecot-sql.conf.ext corresponde ao layout do seu banco de dados. Ao usar o
Módulo userdb LDAP, certifique-se de que o iterar_attrs e iterar_filtro configurações em
/etc/dovecot/dovecot-ldap.conf.ext corresponder ao seu esquema LDAP. De outra forma pomba(1)
não será capaz de iterar em todos os usuários.

-F lima
Execute o comando para todos os usuários no lima. Isso é semelhante ao -A
opção, mas em vez de obter a lista de usuários do userdb, eles são lidos
do dado lima. O lima contém um nome de usuário por linha.

-N Sincronize todos os namespaces disponíveis. Por padrão, apenas namespaces que não
têm configuração de localização explícita são sincronizados.

-P Executar um doveadm-purgar(1) para o armazenamento de destino (remoto) após a sincronização.

-R Faça uma sincronização reversa. Normalmente, as mensagens seriam enviadas do sistema local para o
destino (remoto). Esta opção inverte o fluxo e, em vez disso, puxará as mensagens
do armazenamento remoto para o local.

-S caminho_soquete
O argumento da opção é um caminho absoluto para um soquete de domínio UNIX local ou
um nome de host e porta (hostname:porta), a fim de conectar um host remoto por meio de um TCP
tomada.

Isso permite que um administrador execute pomba(1) comandos de e-mail através do dado
tomada.

-T seg
Especifique o tempo em segundos, quanto tempo pomba(1) deve esperar por I / O paralisado
operações. O tempo limite padrão é 600 segundos.

-U Isso é usado internamente pelo replicador para que o dsync o notifique quando o
a sincronização foi concluída.

-d Use o destino padrão, que é consultado a partir do mail_réplica usuáriodb extra
campo.

-g guia_de_caixa
O mesmo que -m, mas localiza a caixa de correio a ser sincronizada por seu GUID em vez de pelo nome.

-l seg
Bloqueie o dsync para este usuário. Aguarde o máximo seg antes de desistir. Esse
parâmetro deve ser usado para evitar a sincronização interrompida se for possível que
dsync está sendo executado simultaneamente para o mesmo usuário.

-m caixa de correio
Sincronize apenas este nome de caixa de correio.

-n namespace
Sincroniza apenas o namespace especificado. Este parâmetro pode ser usado vários
vezes.

-r rawlog_path
Executando dsync remotamente, grave o tráfego de entrada / saída remota no log especificado
arquivo.

-s anterior_estado
Use a sincronização com monitoração de estado. Se o estado anterior for desconhecido, use um vazio
fragmento. O novo estado é sempre impresso na saída padrão.

-u usuário / máscara
execute o comando apenas para o dado usuário. Também é possível usar '*'E'?'
curingas (por exemplo, -u *@example.org).
Quando nem o -A opção, nem o -F lima opção, nem o -u usuário foi especificado,
que o comando será executado com o ambiente do usuário atualmente conectado.

-x caixa de correio_mask
Exclua o nome / máscara da caixa de correio especificada. A máscara pode conter "?"E"*"
curingas. Este parâmetro pode ser usado várias vezes.

ARGUMENTOS

destino
Este argumento especifica o destino sincronizado. Pode ser um dos seguintes:

localização
Igual a mail_location configuração, por exemplo, maildir:~ / Maildir

controlo remoto:login @ host
Uso dsync_remote_cmd configuração para se conectar ao host remoto (geralmente via
ssh)

remoteprefix: login @ host
É o mesmo que remoto, exceto "usuário @ domínio \ n" é enviado antes de dsync
protocolo começa. Isso permite a implementação de um script de wrapper confiável que
executa doveadm dsync-server lendo o nome do usuário na primeira linha.

TCP:host [: porta]
Conecta-se ao servidor doveadm remoto via TCP. A porta padrão é especificada por
doveadm_port criação.

tcps:host [: porta]
É o mesmo que tcp, mas com SSL.

SAIR STATUS

dsync sairá com um dos seguintes valores:

0 A sincronização foi feita perfeitamente.

2 A sincronização foi feita sem erros, mas algumas alterações não puderam ser feitas, então o
as caixas de correio não estão perfeitamente sincronizadas. Executar dsync novamente geralmente corrige isso.
Normalmente, isso ocorre para sequências de modificação de mensagem com caixas de correio recém-criadas.
Também pode ocorrer se uma das caixas de correio for alterada durante a sincronização.

1, >2
A sincronização falhou.

EXEMPLO

SINCRONIZAÇÃO
Sincronize as caixas de correio com um servidor remoto. Todos os erros são gravados em stderr.

pomba sincronizar -u [email protegido] remoto: server-replica.example.com

Se precisar de parâmetros mais complexos para ssh, você pode usar, por exemplo:

pomba sincronizar -u [email protegido] ssh -i id_dsa.dovecot \
[email protegido] pomba servidor dsync -u [email protegido]

CONVERTER
Supondo que o mail_location assentando em /etc/dovecot/conf.d/10-mail.conf está configurado para:
mail_location = mdbox:~ / mdbox, um usuário do sistema logado pode converter seus e-mails de seu
Maildir em seu diretório pessoal para o formato de caixa de correio mdbox. O usuário deve executar
o comando:

pomba sincronizar maildir:~ / Maildir

Se quiser fazer isso sem nenhum tempo de inatividade, você pode fazer a conversão de um usuário por vez.
Inicialmente:

· Usos de configuração mail_location = maildir:~ / Maildir

· Configurar a possibilidade de fazer localização de e-mail por usuário usando usuáriodb campos extras.

Então, para cada usuário:

1. Correr pomba sincronizar uma vez para fazer a conversão inicial.

2. Correr pomba sincronizar novamente, porque a conversão inicial poderia ter demorado um pouco
e novas mudanças podem ter ocorrido durante ele. Esta segunda vez só se aplica
mudanças, por isso deve ser rápido.

3. Atualize o campo extra mail no userdb para mdbox:~ / mdbox. Se você estiver usando o cache de autenticação,
você precisa dar descarga, por exemplo pomba auth esconderijo rubor.

4. Aguarde alguns segundos e, em seguida, mate (chute doveadm) todos os imap existentes do usuário
e sessões pop3 (que ainda estão usando maildir).

5. Correr pomba sincronizar mais uma vez para aplicar as alterações finais que possivelmente foram feitas. Depois de
isso não deve haver alterações no Maildir, porque a localização do e-mail do usuário
foi alterado e todos os processos existentes que o utilizam foram eliminados.

Depois que todos os usuários forem convertidos, você pode definir o padrão mail_location para mdbox e
remover os locais de e-mail por usuário de usuáriodb.

RELATÓRIOS INSETOS

Reportar bugs, incluindo pombaconf -n saída, para a Lista de Correio Dovecot
<[email protegido]>. Informações sobre como relatar bugs estão disponíveis em:
http://dovecot.org/bugreport.html

Use doveadm-sync online usando serviços onworks.net