doveadm-sync - מקוון בענן

תָכְנִית:

שֵׁם

doveadm-sync - כלי הסנכרון הדו-כיווני של תיבות הדואר של Dovecot
doveadm-backup - כלי סנכרון תיבת דואר חד כיווני של Dovecot

תַקצִיר

doveadm [-Dv] לסנכרן [-u המשתמש|-A|-F פילה] [-S socket_path] [-1fPRU] [-l שניות] [-r
rawlog_path] [-m תא דואר] [-g mailbox_guide] [-n מרחב שמות|-N] [-x להוציא] [-s היו] [-T
שניות] -d|יעד

doveadm [-Dv] גיבוי [-u המשתמש|-A|-F פילה] [-S socket_path] [-fPRU] [-l שניות] [-r
rawlog_path] [-m תא דואר] [-g mailbox_guide] [-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 הקודמת.
כל עוד המדינה או תיבות הדואר אינן פגומות אלגוריתם זה צריך
לעבוד בצורה מושלמת. תהליך המשכפל משתמש בזה באופן פנימי כדי לבצע את המרבית
של הסנכרון.

הסנכרון נעשה בצורה מושלמת ככל האפשר: לקוח IMAP או POP3 לא אמור להיות מסוגל
כדי להבחין בהבדלים בין שתי תיבות הדואר. סנכרון דו-כיווני אומר שזה בטוח
לעשות כל סוג של שינויים בשני הצדדים, ו-dsync ימזג את השינויים בלי
לאבד את כל השינויים שנעשו משני הצדדים. זה אפשרי מכיוון ש-dsync יכול לגשת
יומני האינדקס של Dovecot שעוקבים אחר שינויים. זה כמובן אפשרי
קונפליקטים במהלך המיזוג, אלה נפתרים בצורה בטוחה. ראה את דיסנכרון עיצוב מסמך
לקבלת מידע נוסף.

dsync משתמש באותם קבצי תצורה כמו שאר ה-Dovecot (via doveconf(1) בינארי).
ניתן לשנות את כל התצורה על ידי מתן פרמטר -c לתצורה אחרת
קובץ, או שימוש בפרמטר -o כדי לעקוף הגדרות ספציפיות. בעת ביצוע סינכרון מרוחק
התוכנית היא פועלת באותו אופן: היא משתמשת בתצורה המקומית שלה.

ניתן להפעיל את dsync באופן עצמאי לחלוטין. זה לא דורש שום תהליכי שרת Dovecot
להיות פועל, למעט כאשר משתמשים בפרמטר -u כדי לבצע א userdb חיפוש מתהליך אישור.

dsync יכול לסנכרן משתמש אחד או מספר משתמשים באמצעות הפרמטרים -u או -A. לרציפות
שכפול אתה יכול להשתמש בתהליך המשכפל של Dovecot, אשר מריץ אוטומטית dsync
בכל פעם שההודעות השתנו.

אפשרויות

גלוֹבָּלִי doveadm(1) אפשרויות:

-D מאפשר מילוליות וניפוי באגים בהודעות.

-o הצבה=ערך
עוקף את התצורה הצבה החל מ- /etc/dovecot/dovecot.conf ומה-
userdb עם הנתון ערך. על מנת לעקוף מספר הגדרות, ה -o אוֹפְּצִיָה
ניתן לציין מספר פעמים.

-v מאפשר מילוליות, כולל מונה התקדמות.

פקודה ספציפית אפשרויות:

-1 בצע סנכרון חד כיווני במקום סנכרון דו כיווני.

-A אם -A אפשרות קיימת, ה הפקודה יבוצע עבור כל המשתמשים. באמצעות
אפשרות זו בשילוב עם משתמשי מערכת מ userdb { נהג = פסח } לא
מומלץ, מכיוון שהוא מכיל גם משתמשים עם UID נמוך מזה
מוגדר עם ה first_valid_uid הגדרה.

כאשר נעשה שימוש במודול SQL userdb, ודא כי iterate_query נכנסת פנימה
/etc/dovecot/dovecot-sql.conf.ext תואם את פריסת מסד הנתונים שלך. בעת שימוש ב
מודול LDAP userdb, ודא כי iterate_attrs ו iterate_filter הגדרות ב - Windows
/etc/dovecot/dovecot-ldap.conf.ext להתאים את סכימת ה-LDAP שלך. אחרת doveadm(1)
לא יוכל לחזור על כל המשתמשים.

-F פילה
בצע את הפקודה עבור כל המשתמשים ב- פילה. זה דומה ל -A
אפשרות, אבל במקום לקבל את רשימת המשתמשים מה-userdb, הם נקראים
מהנתון פילה. ה פילה מכיל שם משתמש אחד בכל שורה.

-N סנכרן את כל מרחבי השמות הזמינים. כברירת מחדל רק מרחבי שמות שלא
יש הגדרת מיקום מפורשת מסונכרנות.

-P הפעל a doveadm-purge(1) עבור היעד (מרוחק) אחסון לאחר סנכרון.

-R בצע סנכרון הפוך. בדרך כלל, הודעות יידחקו מהמערכת המקומית ל-
יעד (מרוחק). אפשרות זו הופכת את הזרימה, ובמקום זאת תמשוך הודעות
מהשלט לאחסון המקומי.

-S socket_path
הארגומנט של האפשרות הוא נתיב מוחלט לשקע תחום UNIX מקומי, או
שם מארח ויציאה (המארח:נמל), על מנת לחבר מארח מרוחק באמצעות TCP
שקע.

זה מאפשר למנהלן לבצע doveadm(1) פקודות דואר דרך הנתון
שקע.

-T שניות
ציין את הזמן בשניות, כמה זמן doveadm(1) צריך להמתין ל-I/O שנתקע
פעולות. פסק הזמן המוגדר כברירת מחדל הוא 600 שניות.

-U זה משמש באופן פנימי על ידי המשכפל כדי שה-dsync יודיע לו כאשר
הסנכרון הסתיים.

-d השתמש ביעד ברירת המחדל, שנראה למעלה מה- עותק_מייל userdb נוסף
שדה.

-g mailbox_guide
זהה ל-m, אבל מצא את תיבת הדואר שתסונכרן לפי ה-GUID שלה במקום לפי השם.

-l שניות
נעל את הדיסינכרון עבור משתמש זה. חכה למקסימום שניות לפני הוויתור. זֶה
יש להשתמש בפרמטר כדי למנוע סנכרון שבור אם זה אפשרי
dsync מופעל במקביל עבור אותו משתמש.

-m תא דואר
סנכרן רק את שם תיבת הדואר הזה.

-n מרחב שמות
סנכרן רק את מרחב השמות שצוין. ניתן להשתמש בפרמטר זה מרובים
פעמים.

-r rawlog_path
הפעלת dsync מרחוק, כתוב את תעבורת הקלט/פלט מרחוק ליומן שצוין
קובץ.

-s הקודם_מצב
השתמש בסנכרון מצבי. אם המצב הקודם אינו ידוע, השתמש במצב ריק
חוּט. המצב החדש מודפס תמיד לפלט סטנדרטי.

-u משתמש/מסכה
הפעל את הפקודה רק לנתון המשתמש. אפשר גם להשתמש ב'*'ו'?'
תווים כלליים (למשל -u *@example.org).
כאשר גם לא ה -A אפשרות, ולא ה -F פילה אפשרות, ולא ה -u המשתמש צוין,
מה היא הפקודה יבוצע עם הסביבה של המשתמש המחובר כעת.

-x mailbox_mask
אל תכלול את השם/מסיכה של תיבת הדואר שצוינו. המסכה עשויה להכיל "?"ו"*"
תווים כלליים. ניתן להשתמש בפרמטר זה מספר פעמים.

טיעונים

יעד
ארגומנט זה מציין את היעד המסונכרן. זה יכול להיות אחד מ:

מיקום
כמו mail_location הגדרה, למשל maildir:~/Maildir

מְרוּחָק:login@host
אתה משתמש dsync_remote_cmd הגדרה להתחבר למארח המרוחק (בדרך כלל באמצעות
ssh)

remoteprefix:login@host
זה זהה לרחוק, למעט "user@domain\n" נשלח לפני dsync
הפרוטוקול מתחיל. זה מאפשר ליישם סקריפט עטיפה מהימן
מריץ doveadm dsync-server על ידי קריאת שם המשתמש מהשורה הראשונה.

tcp:מארח[:port]
מתחבר לשרת doveadm מרוחק באמצעות TCP. יציאת ברירת המחדל מצוינת על ידי
doveadm_port הגדרה.

tcps:מארח[:port]
זה זהה ל-tcp, אבל עם SSL.

יְצִיאָה סטָטוּס

דיסנכרון ייצא עם אחד מהערכים הבאים:

0 הסנכרון נעשה בצורה מושלמת.

2 הסנכרון בוצע ללא שגיאות, אך לא ניתן היה לבצע שינויים מסוימים, ולכן
תיבות דואר אינן מסונכרנות בצורה מושלמת. הפעלת dsync שוב בדרך כלל מסדרת את זה.
בדרך כלל זה קורה עבור רצפי שינוי הודעות עם תיבות דואר חדשות שנוצרו.
זה יכול להתרחש גם אם אחת מתיבות הדואר משתנה במהלך הסנכרון.

1, >2
הסנכרון נכשל.

דוגמא

סִנכְּרוּן
סנכרון תיבות דואר עם שרת מרוחק. כל שגיאה נכתבת ל-stderr.

doveadm לסנכרן -u [מוגן בדוא"ל] remote: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:~/mdbox, משתמש במערכת המחובר עשוי להמיר את המיילים שלו/שלו
Maildir בספריית הבית שלה/שלו לפורמט תיבת הדואר mdbox. המשתמש צריך לבצע
הפקודה:

doveadm לסנכרן maildir:~/Maildir

אם אתה רוצה לעשות זאת ללא זמן השבתה, אתה יכול לבצע את ההמרה משתמש אחד בכל פעם.
בתחילה:

· שימושים בתצורה mail_location = maildir:~/Maildir

· הגדר את האפשרות לבצע מיקום דואר לכל משתמש באמצעות userdb שדות נוספים.

לאחר מכן עבור כל משתמש:

1. הפעלה doveadm לסנכרן פעם אחת כדי לבצע את ההמרה הראשונית.

2. הפעלה doveadm לסנכרן שוב, כי ההמרה הראשונית יכלה להימשך זמן מה
ושינויים חדשים יכלו להתרחש במהלכה. פעם שניה זו חלה רק
שינויים, אז זה צריך להיות מהיר.

3. עדכן את שדה המייל הנוסף ב-userdb ל mdbox:~/mdbox. אם אתה משתמש במטמון אישור,
אתה צריך לשטוף אותו, למשל doveadm auth מטמון סומק.

4. המתן מספר שניות ולאחר מכן הרוג (בעיטת doveadm) את כל ה-imap הקיים של המשתמש
ו-pop3 הפעלות (שעדיין משתמשות ב-maildir).

5. הפעלה doveadm לסנכרן פעם נוספת כדי להחיל שינויים אחרונים שאולי נעשו. לאחר
זה לא אמור להיות שינויים ב-Maildir, כי יש למיקום הדואר של המשתמש
שונה וכל התהליכים הקיימים המשתמשים בו נהרגו.

לאחר שכל המשתמשים הומרו, אתה יכול להגדיר את ברירת המחדל mail_location ל-mdbox ו
להסיר את מיקומי הדואר לכל משתמש userdb.

דיווח באגים

דווח על באגים, כולל doveconf -n פלט, לרשימת התפוצה של Dovecot
<[מוגן בדוא"ל]>. מידע על דיווח על באגים זמין ב:
http://dovecot.org/bugreport.html

השתמש ב-doveadm-sync באופן מקוון באמצעות שירותי onworks.net