doveadm-sync - Онлайн в облаке

ПРОГРАММА:

ИМЯ

doveadm-sync - утилита двусторонней синхронизации почтовых ящиков Dovecot
doveadm-backup - утилита для односторонней синхронизации почтовых ящиков Dovecot

СИНТАКСИС

Doveadm [-Дв] синхронизировать [-u пользователь|-A|-F файл] [-S путь_сокета] [-1fПРУ] [-l сек] [-r
rawlog_path] [-m почтовый ящик] [-g mailbox_guid] [-n Пространство имен|-N] [-x исключать] [-s состояние] [-T
сек] -d|назначение

Doveadm [-Дв] резервная копия [-u пользователь|-A|-F файл] [-S путь_сокета] [-фПРУ] [-l сек] [-r
rawlog_path] [-m почтовый ящик] [-g mailbox_guid] [-n Пространство имен|-N] [-x исключать] [-s состояние] [-T
сек] -d|назначение

ОПИСАНИЕ

dsync - это утилита синхронизации почтовых ящиков Dovecot. Его можно использовать для нескольких разных
варианты использования: двусторонняя синхронизация почтовых ящиков, создание резервных копий писем и преобразование
почтовые ящики из / в разные форматы почтовых ящиков. Все это можно использовать в одном
сервер или между разными серверами (через SSH(1) или TCP-соединения). Удаленные почтовые ящики могут
доступ также через протокол IMAP, что позволяет использовать dsync для переноса почтовых ящиков
целей.

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

· Doveadm резервная копия выполняет одностороннюю синхронизацию. Если есть изменения
в пункте назначения они будут удалены, поэтому пункт назначения будет выглядеть
в точности как источник.

· Doveadm синхронизировать выполняет двустороннюю синхронизацию. Он объединяет все изменения
ничего не теряя. Оба почтовых ящика будут выглядеть одинаково.
после завершения синхронизации.

· Doveadm синхронизировать -1 выполняет одностороннюю синхронизацию, но объединяет изменения
в пункте назначения, ничего не удаляя. В настоящее время это не работает
идеально, поэтому его использование следует ограничить. Его основное предназначение состоит в том, чтобы во время
перенос почтового ящика, который вы можете запустить Doveadm резервная копия несколько раз, затем переключите
письма будут доставлены в новый почтовый ящик и запущены Doveadm синхронизировать -1 еще раз
для переноса последних новых писем из старого почтового ящика.

Также существует три разных алгоритма синхронизации:

· Полная синхронизация (параметр -f) просматривает все сообщения во всех
почтовые ящики. Это гарантирует, что все будет синхронизировано, но
это излишне медленно для дополнительной синхронизации.

· Быстрая синхронизация (по умолчанию) сначала пытается найти почтовые ящики,
поменял, и синхронизировать только те. Это делается путем проверки
метаданные почтовых ящиков (NEXTUID и HIGHESTMODSEQ). Обычно это работает нормально,
особенно с односторонней синхронизацией, но если обе стороны выполняют точно
одинаковое количество изменений, метаданные могут в конечном итоге содержать те же значения
даже если бы изменения были другими.

· Синхронизация с отслеживанием состояния (параметр -s) - самый эффективный способ
синхронизировать почтовые ящики. Он зависит от состояния предыдущего запуска dsync.
где-то сохраняется и передается при следующем запуске dsync. Исходя из этого состояния
dsync может отправлять только те изменения, которые произошли после предыдущего запуска dsync.
Пока состояние или почтовые ящики не повреждены, этот алгоритм должен
работают отлично. Процесс репликатора использует это внутренне для выполнения большей части
синхронизации.

Синхронизация выполняется максимально качественно: клиент IMAP или POP3 не может
чтобы заметить различия между двумя почтовыми ящиками. Двусторонняя синхронизация означает, что это безопасно
для внесения любых изменений в обе стороны, и dsync объединит изменения без
потеря любых изменений, сделанных с обеих сторон. Это возможно, потому что dsync может получить доступ
Журналы индекса Dovecot, отслеживающие изменения. Конечно, можно
конфликты во время слияния разрешаются безопасным способом. Увидеть синхронизация дизайн документ
чтобы получить больше информации.

dsync использует те же файлы конфигурации, что и остальная часть Dovecot (через голубь(1) двоичный).
Всю конфигурацию можно изменить, задав параметр -c другой конфигурации.
файл или используя параметр -o, чтобы переопределить определенные настройки. При выполнении удаленного dsync
программа работает так же: использует свою локальную конфигурацию.

dsync можно запускать полностью автономно. Не требует никаких серверных процессов Dovecot.
быть запущенным, кроме случаев использования параметра -u для выполнения пользовательская база данных поиск из процесса авторизации.

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

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Глобальный Doveadm(1) кредита:

-D Включает подробные сообщения и отладочные сообщения.

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

-v Включает многословие, включая счетчик прогресса.

Специфическая команда кредита:

-1 Сделайте одностороннюю синхронизацию вместо двусторонней.

-A Если же линия индикатора -A вариант присутствует, команду будет выполняться для всех пользователей. С использованием
эта опция в сочетании с системными пользователями из пользовательская база данных { водитель = ПАРОЛЬ } Не
рекомендуется, потому что он также содержит пользователей с более низким UID, чем тот
настроен с first_valid_uid установка.

При использовании модуля SQL userdb убедитесь, что итерация_запрос установка в
/etc/dovecot/dovecot-sql.conf.ext соответствует макету вашей базы данных. При использовании
Модуль LDAP userdb, убедитесь, что iterate_attrs и iterate_filter Настройки в
/etc/dovecot/dovecot-ldap.conf.ext соответствовать вашей схеме LDAP. Иначе Doveadm(1)
не сможет перебрать всех пользователей.

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

-N Синхронизируйте все доступные пространства имен. По умолчанию только те пространства имен, которые не
имеют явную настройку местоположения, синхронизируются.

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

-R Сделайте обратную синхронизацию. Обычно сообщения отправляются из локальной системы в
пункт назначения (удаленный). Эта опция меняет направление потока и вместо этого будет извлекать сообщения.
с пульта на локальное хранилище.

-S путь_сокета
Аргумент опции - это либо абсолютный путь к локальному сокету домена UNIX, либо
имя хоста и порт (хоста:порт), чтобы подключить удаленный хост через TCP
разъем.

Это позволяет администратору выполнить Doveadm(1) отправляйте команды по электронной почте через указанный
разъем.

-T сек
Укажите время в секундах, сколько времени Doveadm(1) следует дождаться остановки ввода / вывода
операции. Тайм-аут по умолчанию составляет 600 секунд.

-U Это используется внутри репликатора, чтобы dsync уведомлял его, когда
синхронизация завершена.

-d Используйте место назначения по умолчанию, которое ищется из почтовая_реплика пользовательская база данных дополнительно
поле.

-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

удаленный:логин @ хост
Пользы dsync_remote_cmd настройка подключения к удаленному хосту (обычно через
сш)

удаленный префикс: логин @ хост
Это то же самое, что и удаленное, за исключением того, что "user @ domain \ n" отправляется перед dsync.
протокол запускается. Это позволяет реализовать сценарий доверенной оболочки, который
запускает doveadm dsync-server, считывая имя пользователя из первой строки.

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

TCP:хост [: порт]
Это то же самое, что и tcp, но с SSL.

ВЫХОД статус

синхронизация выйдет с одним из следующих значений:

0 Синхронизация прошла отлично.

2 Синхронизация прошла без ошибок, но некоторые изменения сделать не удалось, поэтому
почтовые ящики не полностью синхронизированы. Обычно это исправляет повторный запуск dsync.
Обычно это происходит для последовательностей изменения сообщений с вновь созданными почтовыми ящиками.
Это также может произойти, если один из почтовых ящиков изменится во время синхронизации.

1, >2
Ошибка синхронизации.

ПРИМЕР

СИНХРОНИЗАЦИЯ
Синхронизируйте почтовые ящики с удаленным сервером. Любые ошибки записываются в stderr.

Doveadm синхронизировать -u [электронная почта защищена] удаленный: server-replica.example.com

Если вам нужны более сложные параметры для ssh, вы можете использовать, например:

Doveadm синхронизировать -u [электронная почта защищена] SSH -i id_dsa.dovecot \
[электронная почта защищена] Doveadm dsync-сервер -u [электронная почта защищена]

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

Doveadm синхронизировать почтовый каталог:~ / Maildir

Если вы хотите сделать это без простоев, вы можете выполнять преобразование по одному пользователю за раз.
Изначально:

· Конфигурация использует mail_location = почтовый каталог:~ / Maildir

· Настроить возможность определения местоположения почты для каждого пользователя с помощью пользовательская база данных дополнительные поля.

Затем для каждого пользователя:

1. Работать Doveadm синхронизировать один раз, чтобы выполнить первоначальное преобразование.

2. Работать Doveadm синхронизировать опять же, потому что первоначальное преобразование могло занять некоторое время
и при этом могли произойти новые изменения. Этот второй раз применяется только
изменения, так что это должно быть быстро.

3. Обновите дополнительное поле почты в userdb на мдбокс:~ / mdbox. Если вы используете кеш аутентификации,
вам нужно его промыть, например Doveadm авт кэш промывать.

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

5. Работать Doveadm синхронизировать еще раз, чтобы применить окончательные изменения, которые, возможно, были сделаны. После
при этом не должно быть никаких изменений в Maildir, потому что почтовый адрес пользователя имеет
был изменен, и все существующие процессы, использующие его, были убиты.

Как только все пользователи будут преобразованы, вы можете установить значение по умолчанию mail_location в mdbox и
удалить почтовые ящики для каждого пользователя из пользовательская база данных.

СОСТАВЛЕНИЕ ОТЧЕТОВ ОШИБКИ

Сообщайте об ошибках, в том числе голубь -n вывод в список рассылки Dovecot
<[электронная почта защищена]>. Информация о сообщениях об ошибках доступна по адресу:
http://dovecot.org/bugreport.html

Используйте doveadm-sync онлайн с помощью сервисов onworks.net