doveadm-sync — online w chmurze

PROGRAM:

IMIĘ

doveadm-sync — narzędzie do dwukierunkowej synchronizacji skrzynki pocztowej firmy Dovecot
doveadm-backup — narzędzie do jednokierunkowej synchronizacji skrzynki pocztowej firmy Dovecot

STRESZCZENIE

gołąb [-Dw] synchronizować [-u użytkownik|-A|-F filet] [-S ścieżka_gniazda] [-1fPRU] [-l suchy] [-r
ścieżka_rawloga] [-m skrzynka pocztowa] [-g mailbox_guide] [-n przestrzeń nazw|-N] [-x wykluczać] [-s były] [-T
suchy] -d|miejsce przeznaczenia

gołąb [-Dw] backup [-u użytkownik|-A|-F filet] [-S ścieżka_gniazda] [-fPRU] [-l suchy] [-r
ścieżka_rawloga] [-m skrzynka pocztowa] [-g mailbox_guide] [-n przestrzeń nazw|-N] [-x wykluczać] [-s były] [-T
suchy] -d|miejsce przeznaczenia

OPIS

dssync to narzędzie do synchronizacji skrzynek pocztowych firmy Dovecot. Może być używany do kilku różnych
przypadki użycia: Dwukierunkowa synchronizacja skrzynek pocztowych, tworzenie kopii zapasowych wiadomości i konwertowanie
skrzynki pocztowe z/do różnych formatów skrzynek pocztowych. Wszystkie te mogą być używane w tym samym
serwer lub między różnymi serwerami (przez ssh(1) lub połączenia TCP). Zdalne skrzynki pocztowe mogą
być dostępne również za pośrednictwem protokołu IMAP, co pozwala na użycie programu dsync do migracji skrzynek pocztowych
celów.

Program dsync można uruchomić w jednym z trzech trybów:

· gołąb backup wykonuje synchronizację jednokierunkową. Jeśli są jakieś zmiany
w miejscu docelowym zostaną usunięte, więc miejsce docelowe będzie wyglądać
dokładnie tak jak źródło.

· gołąb synchronizować wykonuje synchronizację dwukierunkową. Łączy wszystkie zmiany
bez utraty niczego. Obie skrzynki pocztowe będą wyglądać identycznie
po zakończeniu synchronizacji.

· gołąb synchronizować -1 wykonuje synchronizację jednokierunkową, ale scala zmiany
w miejscu docelowym bez usuwania czegokolwiek. To obecnie nie działa
doskonale, więc jego użycie powinno być ograniczone. Jego głównym celem jest to, że podczas
migracja skrzynek pocztowych, którą możesz uruchomić gołąb backup wiele razy, a następnie przełącz
e-maile do dostarczenia do nowej skrzynki i uruchomienia gołąb synchronizować -1 jeszcze raz
przenieść wszystkie ostatnie nowe wiadomości e-mail ze starej skrzynki pocztowej.

Istnieją również trzy różne algorytmy synchronizacji:

· Pełna synchronizacja (parametr -f) skanuje wszystkie wiadomości we wszystkich
skrzynki pocztowe. Gwarantuje to, że wszystko będzie zsynchronizowane, ale
jest niepotrzebnie powolny w przypadku synchronizacji przyrostowej.

· Szybka synchronizacja (domyślnie) pierwsze próby znalezienia skrzynek, które mają
zmienione i synchronizuj tylko te. Odbywa się to poprzez sprawdzenie
metadane skrzynek pocztowych (NEXTUID i HIGHESTMODSEQ). Zwykle działa to dobrze,
zwłaszcza z synchronizacją jednokierunkową, ale jeśli obie strony robią dokładnie to
tyle samo zmian, metadane mogą zawierać te same wartości
nawet jeśli zmiany były inne.

· Synchronizacja stanowa (parametr -s) jest najskuteczniejszym sposobem
synchronizować skrzynki pocztowe. Polega na posiadaniu wcześniejszego stanu dsync run
gdzieś zapisane i przekazywane do następnego uruchomienia programu dsync. Na podstawie tego stanu
Program dsync może wysyłać tylko zmiany, które nastąpiły po poprzednim uruchomieniu programu dsync.
Dopóki stan lub skrzynki pocztowe nie są uszkodzone, ten algorytm powinien
działają idealnie. Proces replikatora wykorzystuje to wewnętrznie do wykonywania większości
synchronizacji.

Synchronizacja odbywa się tak perfekcyjnie, jak to możliwe: klient IMAP lub POP3 nie powinien być w stanie
aby zauważyć różnice między dwiema skrzynkami pocztowymi. Synchronizacja dwukierunkowa oznacza, że ​​jest bezpieczna
dokonać jakichkolwiek modyfikacji po obu stronach, a program dsync połączy zmiany bez
tracąc wszelkie zmiany dokonane po obu stronach. Jest to możliwe, ponieważ program dsync ma dostęp
Dzienniki indeksów Dovecot, które śledzą zmiany. Oczywiście można mieć
konflikty podczas łączenia są rozwiązywane w bezpieczny sposób. Zobacz synchronizacja design dokument
po więcej informacji.

dssync używa tych samych plików konfiguracyjnych, co reszta Dovecota (poprzez gołębica(1) binarny).
Całą konfigurację można zmienić, podając parametr -c innej konfiguracji
pliku lub za pomocą parametru -o, aby nadpisać określone ustawienia. Podczas wykonywania zdalnego programu dsync
program działa w ten sam sposób: używa własnej konfiguracji lokalnej.

program dsync może działać całkowicie samodzielnie. Nie wymaga żadnych procesów serwerowych Dovecot
być uruchomionym, z wyjątkiem sytuacji, gdy używamy parametru -u do wykonania a baza użytkowników wyszukiwanie z procesu uwierzytelniania.

Program dsync może synchronizować jednego lub wielu użytkowników za pomocą parametrów -u lub -A. Do ciągłego
replikacja możesz użyć procesu replikatora Dovecot, który automatycznie uruchamia dsync
za każdym razem, gdy zmieniły się wiadomości.

OPCJE

Globalne gołąb(1) Opcje:

-D Włącza szczegółowość i komunikaty debugowania.

-o ustawienie=wartość
Zastępuje konfigurację ustawienie od /etc/dovecot/dovecot.conf i od
userdb z podanym wartość. Aby zastąpić wiele ustawień, -o opcja
można podać wielokrotnie.

-v Włącza szczegółowość, w tym licznik postępu.

Specyficzne polecenia Opcje:

-1 Wykonaj synchronizację jednokierunkową zamiast synchronizacji dwukierunkowej.

-A Jeśli -A opcja jest obecna, komenda zostanie wykonana dla wszystkich użytkowników. Za pomocą
ta opcja w połączeniu z użytkownikami systemu z baza użytkowników { kierowca = passwd } nie jest
zalecane, ponieważ zawiera również użytkowników o niższym UID niż ten
skonfigurowany z pierwszy_ważny_uid ustawienie.

W przypadku korzystania z modułu bazy danych SQL upewnij się, że: iteracyjne_zapytanie ustawienie w
/etc/dovecot/dovecot-sql.conf.ext pasuje do układu Twojej bazy danych. Podczas korzystania z
modułu bazy danych użytkownika LDAP, upewnij się, że iteracja_attrs i filtr iteracyjny ustawienia w
/etc/dovecot/dovecot-ldap.conf.ext zgodny ze schematem LDAP. Inaczej gołąb(1)
nie będzie w stanie wykonać iteracji na wszystkich użytkownikach.

-F filet
Wykonaj komenda dla wszystkich użytkowników w filet. To jest podobne do -A
opcja, ale zamiast pobierać listę użytkowników z bazy użytkowników, są oni odczytywani
z danego filet, filet zawiera jedną nazwę użytkownika w wierszu.

-N Zsynchronizuj wszystkie dostępne przestrzenie nazw. Domyślnie tylko przestrzenie nazw, które nie
mają określone ustawienia lokalizacji są synchronizowane.

-P Uruchom a doveadm-purge(1) dla pamięci docelowej (zdalnej) po synchronizacji.

-R Wykonaj odwrotną synchronizację. Normalnie wiadomości byłyby przesyłane z systemu lokalnego do
miejsce docelowe (zdalne). Ta opcja odwraca przepływ i zamiast tego ściąga wiadomości
ze zdalnego do lokalnego magazynu.

-S ścieżka_gniazda
Argumentem opcji jest albo bezwzględna ścieżka do lokalnego gniazda domeny UNIX, albo
nazwę hosta i port (hosta:Port), aby połączyć się ze zdalnym hostem przez TCP
gniazdo elektryczne.

Pozwala to administratorowi na wykonanie gołąb(1) polecenia e-mail przez podane
gniazdo elektryczne.

-T suchy
Określ czas w sekundach, jak długo gołąb(1) powinien czekać na zatrzymane I/O
operacje. Domyślny limit czasu to 600 sekund.

-U Jest to używane wewnętrznie przez replikator, aby program dsync powiadamiał go, gdy
synchronizacja została zakończona.

-d Użyj domyślnego miejsca docelowego, które jest wyszukiwane z mail_replika baza użytkowników dodatkowy
pole.

-g mailbox_guide
To samo co -m, ale znajdź skrzynkę pocztową do zsynchronizowania według jej identyfikatora GUID, a nie według nazwy.

-l suchy
Zablokuj dsync dla tego użytkownika. Poczekaj na maksimum suchy przed poddaniem się. Ten
parametr powinien być używany, aby uniknąć przerwania synchronizacji, jeśli jest to możliwe
program dsync jest uruchamiany jednocześnie dla tego samego użytkownika.

-m skrzynka pocztowa
Synchronizuj tylko tę nazwę skrzynki pocztowej.

-n przestrzeń nazw
Synchronizuj tylko określoną przestrzeń nazw. Ten parametr może być używany wielokrotnie
razy.

-r ścieżka_rawloga
Zdalnie uruchamiając dsync, zapisz zdalny ruch wejściowy/wyjściowy w określonym dzienniku
plik.

-s Poprzedni stan
Użyj synchronizacji stanowej. Jeśli poprzedni stan jest nieznany, użyj pustego
strunowy. Nowy stan jest zawsze wypisywany na standardowe wyjście.

-u użytkownik/maska
Uruchom komenda tylko dla danego użytkownik. Można również użyć '*'I'?'
symbole wieloznaczne (np. -u *@example.org).
Kiedy ani -A opcja, ani -F filet opcja, ani -u użytkownik został określony,
dotychczasowy komenda zostanie wykonany w środowisku aktualnie zalogowanego użytkownika.

-x mailbox_maska
Wyklucz określoną nazwę/maskę skrzynki pocztowej. Maska może zawierać „?"I"*"
symbole wieloznaczne. Ten parametr może być używany wielokrotnie.

ARGUMENTY

miejsce przeznaczenia
Ten argument określa zsynchronizowane miejsce docelowe. Może to być jeden z:

lokalizacja
Taki sam jak poczta_lokalizacja ustawienie, np. maildir:~/Kir

zdalny:login@host
Używa dssync_remote_cmd ustawienie połączenia ze zdalnym hostem (zwykle przez
cich)

prefiks zdalny:login@host
To to samo co zdalne, z wyjątkiem tego, że „użytkownik@domena\n” jest wysyłany przed dsync
rozpoczyna się protokół. Pozwala to zaimplementować zaufany skrypt opakowujący, który
uruchamia doveadm dsync-server, odczytując nazwę użytkownika z pierwszego wiersza.

TCP:host[:port]
Łączy się ze zdalnym serwerem doveadm przez TCP. Domyślny port jest określony przez
port_doveadm ustawienie.

TCP:host[:port]
To to samo co tcp, ale z SSL.

EXIT STATUS

synchronizacja zakończy się z jedną z następujących wartości:

0 Synchronizacja została wykonana perfekcyjnie.

2 Synchronizacja przebiegła bez błędów, ale niektórych zmian nie udało się wykonać, więc
skrzynki pocztowe nie są idealnie zsynchronizowane. Ponowne uruchomienie programu dsync zwykle rozwiązuje ten problem.
Zwykle dzieje się tak w przypadku sekwencji modyfikacji wiadomości z nowo utworzonymi skrzynkami pocztowymi.
Może się to również zdarzyć, jeśli podczas synchronizacji zmieni się jedna ze skrzynek pocztowych.

1, >2
Synchronizacja nie powiodła się.

PRZYKŁAD

SYNCHRONIZACJA
Synchronizuj skrzynki pocztowe ze zdalnym serwerem. Wszelkie błędy są zapisywane na stderr.

gołąb synchronizować -u [email chroniony] zdalna:replika-serwerowa.przyklad.com

Jeśli potrzebujesz bardziej złożonych parametrów do ssh, możesz użyć np.:

gołąb synchronizować -u [email chroniony] ssh -i id_dsa.dovecot \
[email chroniony] gołąb serwer-dsync -u [email chroniony]

KONWERSJA
Zakładając, że poczta_lokalizacja ustawienie w /etc/dovecot/conf.d/10-mail.conf jest ustawione na:
poczta_lokalizacja = mdbox:~/mdbox, zalogowany użytkownik systemu może konwertować swoje e-maile z jego
Maildir w swoim katalogu domowym do formatu skrzynki pocztowej mdbox. Użytkownik musi wykonać
Komenda:

gołąb synchronizować adres pocztowy:~/Kir

Jeśli chcesz to zrobić bez przestojów, możesz przeprowadzić konwersję po jednym użytkowniku na raz.
Początkowo:

· Zastosowania konfiguracji poczta_lokalizacja = adres pocztowy:~/Kir

· Skonfiguruj możliwość lokalizacji poczty dla każdego użytkownika za pomocą baza użytkowników dodatkowe pola.

Następnie dla każdego użytkownika:

1. run gołąb synchronizować raz, aby wykonać początkową konwersję.

2. run gołąb synchronizować znowu, ponieważ początkowa konwersja mogła trochę potrwać
i w jego trakcie mogły nastąpić nowe zmiany. Ten drugi raz dotyczy tylko
zmiany, więc powinno być szybkie.

3. Zaktualizuj dodatkowe pole poczty w userdb do mdbox:~/mdbox. Jeśli używasz pamięci podręcznej uwierzytelniania,
trzeba go spłukać, np. gołąb auth Pamięć podręczna spłuczka.

4. Poczekaj kilka sekund, a następnie zabij (doveadm kick) wszystkie istniejące imapy użytkownika
i sesje pop3 (które nadal używają maildir).

5. run gołąb synchronizować jeszcze raz, aby zastosować ostateczne zmiany, które prawdopodobnie zostały wykonane. Później
to nie powinno być żadnych zmian w Maildir, ponieważ lokalizacja poczty użytkownika ma
został zmieniony, a wszystkie istniejące procesy, które go używają, zostały zabite.

Po przekonwertowaniu wszystkich użytkowników możesz ustawić wartość domyślną poczta_lokalizacja do mdbox i
usuń lokalizacje poczty poszczególnych użytkowników z baza użytkowników.

RAPORTOWANIE ROBAKI

Zgłoś błędy, w tym gołębica -n wyjście do listy mailingowej Dovecot
<[email chroniony]>. Informacje o zgłaszaniu błędów są dostępne pod adresem:
http://dovecot.org/bugreport.html

Korzystaj z usługi doveadm-sync online, korzystając z usług onworks.net