doveadm-sync - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

doveadm-sync - утиліта двосторонньої синхронізації поштової скриньки Dovecot
doveadm-backup - одностороння утиліта синхронізації поштової скриньки Dovecot

СИНТАКСИС

сорт [-Дв] синхронізувати [-u користувач|-A|-F файл] [-S socket_path] [-1fPRU] [-l сухий] [-r
rawlog_path] [-m поштова скринька] [-g mailbox_guid] [-n простору імен|-N] [-x виключати] [-s були] [-T
сухий] -d|призначення

сорт [-Дв] резервна копія [-u користувач|-A|-F файл] [-S socket_path] [-fPRU] [-l сухий] [-r
rawlog_path] [-m поштова скринька] [-g mailbox_guid] [-n простору імен|-N] [-x виключати] [-s були] [-T
сухий] -d|призначення

ОПИС

dsync — це утиліта синхронізації поштової скриньки Dovecot. Його можна використовувати для кількох різних
варіанти використання: двостороння синхронізація поштових скриньок, створення резервних копій листів і конвертація
поштові скриньки з/до різних форматів поштових скриньок. Все це можна використовувати в одному
сервер або між різними серверами (через SSH(1) або з'єднання tcp). Віддалені поштові скриньки можуть
доступ також через протокол IMAP, що дозволяє використовувати dsync для міграції поштової скриньки
цілей.

Ви можете запустити Dsync в одному з трьох режимів:

· сорт резервна копія виконує односторонню синхронізацію. Якщо є якісь зміни
у пункті призначення вони будуть видалені, тому місце призначення буде виглядати
точно як джерело.

· сорт синхронізувати виконує двосторонню синхронізацію. Він об’єднує всі зміни
нічого не втрачаючи. Обидві поштові скриньки виглядатимуть однаково
після завершення синхронізації.

· сорт синхронізувати -1 виконує односторонню синхронізацію, але об’єднує зміни
в місці призначення, нічого не видаляючи. Наразі це не працює
ідеально, тому його використання слід обмежити. Основне його призначення полягає в тому, щоб під час
можна запустити міграцію поштової скриньки сорт резервна копія кілька разів, потім перемикайтеся
листи, які будуть доставлені в нову поштову скриньку та запущені сорт синхронізувати -1 ще раз
для перенесення останніх нових листів зі старої поштової скриньки.

Також є три різні алгоритми синхронізації:

· Повна синхронізація (параметр -f) сканує всі повідомлення
поштові скриньки. Це гарантує, що все буде синхронізовано, але
це невиправдано повільно для поступової синхронізації.

· Швидка синхронізація (за замовчуванням) перші спроби знайти поштові скриньки, які мають
змінено та синхронізувати лише ті. Це робиться шляхом перевірки
метадані поштових скриньок (NEXTUID і HIGHESTMODSEQ). Зазвичай це добре працює,
особливо з односторонньою синхронізацією, але якщо обидві сторони роблять саме те
однакову кількість змін, метадані можуть містити однакові значення
навіть якщо зміни були різними.

· Синхронізація зі станом (параметр -s) є найефективнішим способом
синхронізувати поштові скриньки. Він покладається на наявність попереднього стану dsync
зберігається десь і передається до наступного запуску синхронізації. На основі цього стану
dsync може надсилати лише зміни, які відбулися після попереднього запуску dsync.
Поки стан або поштові скриньки не пошкоджені, цей алгоритм повинен
працюють ідеально. Процес реплікатора використовує це внутрішньо для виконання найбільше
синхронізації.

Синхронізація виконана максимально ідеально: клієнт IMAP або POP3 не повинен мати можливості
щоб помітити будь-які відмінності між двома поштовими скриньками. Двостороння синхронізація означає, що це безпечно
щоб зробити будь-які зміни з обох сторін, і dsync об’єднає зміни без
втратити будь-які зміни, внесені з будь-якої сторони. Це можливо, оскільки Dsync має доступ
Журнали індексів Dovecot, які відстежують зміни. Звісно, ​​можна мати
конфлікти під час злиття, вони вирішуються безпечним способом. Див dsync дизайн документ
для отримання додаткової інформації.

dsync використовує ті ж файли конфігурації, що й решта Dovecot (через doveconf(1) двійковий).
Усю конфігурацію можна змінити, надавши параметр -c іншій конфігурації
файл, або за допомогою параметра -o для заміни певних налаштувань. Під час виконання віддаленої синхронізації
Програма працює так само: вона використовує власну локальну конфігурацію.

dsync можна запустити повністю автономно. Для цього не потрібні серверні процеси Dovecot
для запуску, за винятком випадків використання параметра -u для виконання userdb пошук із процесу авторизації.

dsync може синхронізувати одного або кількох користувачів за допомогою параметрів -u або -A. Для безперервного
реплікації можна використовувати процес реплікатора Dovecot, який автоматично запускає dsync
щоразу, коли повідомлення змінилися.

ВАРІАНТИ

Глобальний сорт(1) опції:

-D Вмикає детальність і налагодження повідомлень.

-o установка=значення
Перевизначає конфігурацію установка від /etc/dovecot/dovecot.conf і від
userdb із заданим значення. Щоб змінити кілька налаштувань, -o варіант
може бути вказано кілька разів.

-v Вмикає детальність, включаючи лічильник прогресу.

Спеціальна команда опції:

-1 Виконайте односторонню синхронізацію замість двосторонньої синхронізації.

-A Якщо -A наявний варіант, команда буде виконано для всіх користувачів. Використання
цей параметр у поєднанні з користувачами системи з userdb { водій = passwd } НЕ
рекомендовано, оскільки він містить також користувачів із нижчим UID, ніж той
налаштовано за допомогою first_valid_uid установка.

Коли використовується модуль SQL userdb, переконайтеся, що itater_query встановлення в
/etc/dovecot/dovecot-sql.conf.ext відповідає макету вашої бази даних. При використанні
LDAP userdb модуль, переконайтеся, що itater_attrs та itater_filter налаштування в
/etc/dovecot/dovecot-ldap.conf.ext відповідати вашій схемі LDAP. Інакше сорт(1)
не зможе виконати ітерацію для всіх користувачів.

-F файл
Виконайте команда для всіх користувачів у файл. Це схоже на -A
опцію, але замість того, щоб отримати список користувачів із userdb, вони зчитуються
від даного файл, файл містить одне ім’я користувача на рядок.

-N Синхронізувати всі доступні простори імен. За замовчуванням лише простори імен, які цього не роблять
мають явні налаштування місцезнаходження, синхронізовані.

-P Запустіть a doveadm-чистка(1) для цільового (віддаленого) сховища після синхронізації.

-R Виконайте зворотну синхронізацію. Зазвичай повідомлення пересилаються з локальної системи в
пункт призначення (віддалений). Ця опція змінює потік і натомість витягуватиме повідомлення
з віддаленого до локального сховища.

-S socket_path
Аргументом параметра є або абсолютний шлях до локального сокета домену UNIX, або
ім'я хоста та порт (ім'я хоста:порт), щоб підключити віддалений хост через TCP
розетка.

Це дозволяє адміністратору виконувати сорт(1) розсилати команди за допомогою даного
розетка.

-T сухий
Вкажіть час у секундах, скільки часу сорт(1) слід чекати зупинки введення-виведення
операції. Час очікування за замовчуванням становить 600 секунд.

-U Це використовується внутрішньо реплікатором, щоб dsync сповістив його, коли
синхронізація завершена.

-d Використовуйте призначення за замовчуванням, яке шукається з mail_replica userdb додатково
поле.

-g mailbox_guid
Те саме, що і -m, але знайдіть поштову скриньку для синхронізації за її GUID замість імені.

-l сухий
Заблокуйте Dsync для цього користувача. Дочекайтеся максимуму сухий перед тим як здатися. Це
Параметр слід використовувати, щоб уникнути порушеної синхронізації, якщо це можливо
dsync виконується одночасно для того самого користувача.

-m поштова скринька
Синхронізувати лише цю назву поштової скриньки.

-n простору імен
Синхронізувати лише вказаний простір імен. Цей параметр можна використовувати кілька разів
раз.

-r rawlog_path
Запустивши dsync віддалено, запишіть трафік віддаленого введення/виведення у вказаний журнал
файлу.

-s попередній_стан
Використовуйте синхронізацію з урахуванням стану. Якщо попередній стан невідомий, використовуйте пустий
рядок. Новий стан завжди виводиться на стандартний вихід.

-u користувач/маска
Запустіть команда тільки за дане користувач. Також можна використовувати '*'І'?'
символи підстановки (наприклад, -u *@example.org).
Коли ні -A варіант, ні -F файл варіант, ні -u користувач було зазначено,
команда буде виконуватися в середовищі поточного користувача, який увійшов у систему.

-x маска_поштової скриньки
Виключити вказане ім’я/маску поштової скриньки. Маска може містити "?"І"*"
символи підстановки. Цей параметр можна використовувати кілька разів.

АРГУМЕНТИ

призначення
Цей аргумент визначає синхронізоване призначення. Це може бути одне з:

розташування
Такий же, як mail_location налаштування, наприклад maildir:~/Maildir

віддалений:login@host
Використовує dsync_remote_cmd налаштування для підключення до віддаленого хоста (зазвичай через
ssh)

віддалений префікс: логін@хост
Це те саме, що й віддалений, за винятком того, що «user@domain\n» надсилається перед синхронізацією
розпочинається протокол. Це дозволяє реалізувати надійний сценарій обгортки, який
запускає doveadm dsync-server, зчитуючи ім’я користувача з першого рядка.

tcp:хост[:порт]
Підключається до віддаленого сервера doveadm через TCP. Порт за замовчуванням визначається за допомогою
doveadm_port установка.

tcps:хост[:порт]
Це те саме, що tcp, але з SSL.

EXIT СТАТУС

dsync вийде з одним із таких значень:

0 Синхронізація пройшла ідеально.

2 Синхронізація була виконана без помилок, але деякі зміни не вдалося зробити, тому
поштові скриньки не повністю синхронізовані. Повторний запуск dsync зазвичай виправляє це.
Зазвичай це відбувається для послідовностей модифікації повідомлень із щойно створеними поштовими скриньками.
Це також може статися, якщо одна з поштових скриньок змінюється під час синхронізації.

1, >2
Помилка синхронізації.

приклад

СИНХРОНІЗАЦІЯ
Синхронізуйте поштові скриньки з віддаленим сервером. Будь-які помилки записуються в stderr.

сорт синхронізувати -u [захищено електронною поштою] віддалений:server-replica.example.com

Якщо вам потрібні більш складні параметри для ssh, ви можете використовувати, наприклад:

сорт синхронізувати -u [захищено електронною поштою] SSH -i id_dsa.dovecot \
[захищено електронною поштою] сорт dsync-сервер -u [захищено електронною поштою]

КОНВЕРТУВАННЯ
Припускаючи, що mail_location встановлення в /etc/dovecot/conf.d/10-mail.conf встановлено на:
mail_location = mdbox:~/mdbox, користувач, який увійшов у систему, може конвертувати свою/його пошту з її
Maildir у її/його домашній каталог у формат поштової скриньки mdbox. Користувач повинен виконати
команда:

сорт синхронізувати maildir:~/Maildir

Якщо ви хочете зробити це без простоїв, ви можете виконувати перетворення для одного користувача за раз.
Спочатку:

· Використання конфігурації mail_location = maildir:~/Maildir

· Налаштувати можливість визначення розташування пошти для кожного користувача за допомогою userdb додаткові поля.

Потім для кожного користувача:

1. прогін сорт синхронізувати один раз, щоб виконати початкове перетворення.

2. прогін сорт синхронізувати знову ж таки, тому що початкове перетворення могло зайняти деякий час
і під час цього могли відбутися нові зміни. Цей другий раз застосовується лише
змінюється, тому має бути швидким.

3. Оновіть додаткове поле пошти в userdb до mdbox:~/mdbox. Якщо ви використовуєте кеш авторизації,
вам потрібно промити його, напр сорт авт cache врівень.

4. Зачекайте кілька секунд, а потім вбийте (doveadm kick) усі наявні зображення користувача
і сеанси pop3 (які все ще використовують maildir).

5. прогін сорт синхронізувати ще раз застосувати остаточні зміни, які, можливо, були внесені. Після
це не повинно змінюватися в Maildir, оскільки місце розташування пошти користувача має
було змінено, і всі існуючі процеси, які його використовують, було знищено.

Після перетворення всіх користувачів ви можете встановити значення за замовчуванням mail_location до mdbox і
видалити адреси електронної пошти для кожного користувача userdb.

ЗВІТНІСТЬ БУГИ

Повідомляти про помилки, в т.ч doveconf -n вихід до списку розсилки Dovecot
<[захищено електронною поштою]>. Інформація про повідомлення про помилки доступна за адресою:
http://dovecot.org/bugreport.html

Використовуйте doveadm-sync онлайн за допомогою служб onworks.net