How to Migrate Zimbra Mailboxes to a New Server with Zextras Backup or imapsync

For a full Zimbra-to-Zimbra move, use a supported Zextras Backup migration workflow when you need mailbox data beyond email. Use imapsync when both servers expose the accounts over IMAP and your scope is messages, folders, and flags. Zextras says its older Zextras Migration Tool is no longer available. Its Zimbra migration guidance points administrators to Zextras Backup. Imapsync is a separate command-line option for copying IMAP mailboxes; it does not replace a Zimbra-aware migration for calendars, contacts, shares, or account settings.

That distinction determines how much you must provision and test on the new server. Before changing MX records or letting users work on the destination, confirm the source and destination versions, licensing, authentication, storage, and the exact data you must retain.

Documentation checked October 6, 2026. The official imapsync site lists release 2.314. Zextras’s migration article says the legacy Migration Tool is unavailable and describes a Zextras Backup route. Zextras pages and examples are version-dependent; validate them against your installed Zextras and Zimbra releases before a production run.

1. Choose the route that matches the data you need

Zextras’s published Zimbra migration guide lists email and folders, contacts, calendars, tasks, shares, preferences, signatures, identities, and some domain or class-of-service data among the items its Backup workflow can migrate. It also says the workflow does not migrate server configuration, LDAP configuration, MTA or proxy configuration, or custom branding. Exact coverage depends on product versions and settings, so treat that list as a scope checklist and verify each required item in the current documentation.

Imapsync works through IMAP. It copies mailbox folders and messages and can synchronize message flags that the destination supports. It does not transfer a Zimbra server’s LDAP directory, account preferences, calendars, address books, shared resources, or server configuration. If any of those matter, plan another supported export/import method or select the Zextras route.

Do not build a new plan around the old Zextras Migration Tool: the Zextras migration guide says it is no longer available. Also avoid copying obsolete IMAP advice from archived Zimbra pages without checking it against the current imapsync Zimbra FAQ; that FAQ specifically warns that an older Zimbra imapsync guide is obsolete.

2. Prepare both servers before copying data

Make an inventory before provisioning the destination: domains, accounts, aliases, quotas, mailbox sizes, user passwords or reset plan, shared folders, calendars, contacts, distribution lists, retention needs, and the server features users depend on. Identify which host receives new mail during each phase. Keep this inventory as your post-migration checklist.

• Confirm platform support. Verify the destination is installed, operating, and on a Zimbra/Zextras combination supported for your migration path. For Zextras Backup, the vendor’s Zimbra workflow requires a Zextras Backup destination and a source running Zextras Backup or Zimbra Suite Plus. Confirm entitlement with the vendor before relying on the feature.
• Check capacity. Estimate space for the destination’s live mail store, staged source backup or export, and destination backup. The Zextras migration guide warns that the destination can need room for all three; do not size it only from users’ visible mailbox totals.
• Back up and test restores. Keep a separate recoverable backup of the source. For a Zextras migration, follow the installed version’s checks and backup procedure. For imapsync, use a test mailbox on the destination first; imapsync’s tutorial emphasizes that the source is read while the destination is modified.
• Test connectivity and authentication. Confirm that an administrator or test user can reach both IMAP endpoints using the intended secure connection. Do not enable clear-text authentication merely because an old guide says to; use the supported TLS/SSL and authentication settings for your Zimbra release.
• Plan DNS and mail flow. If the MX record will change, lower its TTL in advance if your DNS provider permits it, then retain the old server during the transition so delayed or cached delivery can be monitored and reconciled.

3. Use Zextras Backup for a Zimbra-aware migration

เส้นทางนี้ออกแบบมาสำหรับผู้ดูแลระบบที่ย้ายระหว่างระบบ Zimbra และต้องการมากกว่าอีเมล IMAP นี่ไม่ใช่คำสั่งเดียวที่ใช้ได้กับทุกระบบ: เวอร์ชันของผลิตภัณฑ์ต้นทางและปลายทาง โครงสร้างของเส้นทางการสำรองข้อมูล สิทธิ์การเข้าถึง พื้นที่จัดเก็บ และลำดับการย้ายข้อมูลล้วนมีความสำคัญ คู่มือของ Zextras ระบุว่าควรเรียกใช้คำสั่ง CLI ในฐานะzimbraผู้ใช้ เว้นแต่จะระบุไว้เป็นอย่างอื่นอย่างชัดเจน

สร้างและถ่ายโอนข้อมูลสำรองต้นทาง

ปฏิบัติตามคู่มือการสำรองข้อมูล Zextras ฉบับปัจจุบันสำหรับเวอร์ชันที่คุณติดตั้ง คู่มือ Zextras Zimbra เริ่มต้นด้วยการตรวจสอบความสมบูรณ์ของซอร์สโค้ดและการสแกนอัจฉริยะแบบละเอียด ตัวอย่างคำสั่งแสดงอยู่ด้านล่าง โปรดตรวจสอบไวยากรณ์คำสั่งและขั้นตอนการบำรุงรักษาที่จำเป็นสำหรับเวอร์ชันของคุณก่อนเรียกใช้:

zxsuite backup doSmartScan start deep true

หลังจากส่งออกข้อมูลต้นทางแล้ว ให้ถ่ายโอนข้อมูลสำรองที่จำเป็นไปยังไดเร็กทอรีชั่วคราวบนปลายทาง Zextras ให้rsyncเส้นทางการขนส่งที่เป็นไปได้หนึ่งเส้นทางและแนะนำให้ทำการถ่ายโอนซ้ำในขณะที่แหล่งข้อมูลยังคงทำงานอยู่ เพื่อให้การถ่ายโอนในครั้งต่อๆ ไปย้ายเฉพาะข้อมูลที่เปลี่ยนแปลงเท่านั้น เส้นทางชั่วคราวปลายทางต้องสามารถอ่านได้โดยผู้ใช้ Zimbra และไม่ควรสับสนกับเส้นทางสำรองข้อมูล Zextras ที่ใช้งานอยู่ของปลายทาง ป้องกันช่องทางการถ่ายโอนและบันทึกการถ่ายโอนแต่ละครั้ง

จัดเตรียมและกู้คืนข้อมูล ณ ปลายทาง

เอกสารของ Zextras แสดงวิธีการนำเข้าเฉพาะการตั้งค่า ซึ่งจะสร้างโดเมน คลาสของบริการ และบัญชี โดยข้ามเนื้อหาในกล่องจดหมายไป นี่เป็นเพียงขั้นตอนการตั้งค่า ไม่ใช่การกู้คืนอีเมลอย่างสมบูรณ์:

zxsuite backup doExternalRestore /path/for/data/ provisioning_only TRUE

หลังจากจัดเตรียมระบบแล้ว ให้ทำการกู้คืนข้อมูลภายนอกแบบเต็มรูปแบบ โดยเลือกการตั้งค่าการทำงานพร้อมกันจากผลการทดสอบบนเซิร์ฟเวอร์ปลายทาง Zextras จะให้ค่านี้concurrent_accountsเป็นพารามิเตอร์ และแนะนำให้ทดสอบประสิทธิภาพแทนที่จะคิดว่าตัวเลขเดียวใช้ได้กับทุกเซิร์ฟเวอร์ ทำซ้ำการถ่ายโอนข้อมูลสำรองจากต้นทางและการกู้คืนแบบเพิ่มทีละส่วนตามความจำเป็น เพื่อรวบรวมการเปลี่ยนแปลงที่เกิดขึ้นระหว่างช่วงเวลาการย้ายข้อมูล เก็บรักษาแหล่งข้อมูลไว้ให้พร้อมใช้งานจนกว่าผู้ใช้และการรับส่งอีเมลจะได้รับการตรวจสอบแล้ว

ผู้จำหน่ายอธิบายถึงวิธีการแบบหลายขั้นตอนและแบบทำครั้งเดียว และลำดับของวิธีการอาจขึ้นอยู่กับแผนการเปลี่ยนระบบ ให้ใช้วิธีการสำหรับเวอร์ชันที่ติดตั้งไว้แทนที่จะผสมคำสั่งจากเวอร์ชันต่างๆ ห้ามแก้ไขหรือลบข้อมูลสำรองที่นำเข้าหรือไฟล์แผนที่ในขณะที่การกู้คืนกำลังดำเนินการอยู่

4. ใช้ imapsync เมื่อขอบเขตการใช้งานอีเมลของคุณเป็น IMAP

Imapsync มีประโยชน์เมื่อทั้งกล่องจดหมายต้นทางและปลายทางสามารถเข้าถึงได้ผ่าน IMAP และคุณต้องการคัดลอกข้อความและโฟลเดอร์โดยไม่ต้องติดตั้งผลิตภัณฑ์การย้ายข้อมูลเฉพาะของ Zimbra สามารถใช้งานได้บน Linux, Windows และ macOS ตัวอย่างด้านล่างใช้ตัวแทน ไม่ใช่ชื่อเซิร์ฟเวอร์หรือข้อมูลประจำตัวจริง เก็บรหัสผ่านไว้ในสคริปต์ที่ได้รับการป้องกันหรือวิธีการจัดการความลับอื่น ๆ ที่ได้รับอนุมัติ อย่าเผยแพร่รหัสผ่านในตั๋ว ประวัติเชลล์ที่ใช้ร่วมกัน หรือบทความ

เริ่มต้นด้วยกล่องจดหมายต้นทางหนึ่งกล่องและกล่องจดหมายปลายทางสำหรับทดสอบ ใช้การทดสอบแบบจำลองเพื่อทดสอบการเข้าสู่ระบบและตรวจสอบการแมปโฟลเดอร์โดยไม่ต้องเขียนไปยังปลายทาง คู่มืออย่างเป็นทางการของ Imapsync แสดงตัวเลือกเหล่านี้สำหรับการตรวจสอบโฟลเดอร์เบื้องต้น:

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap --justfolders --dry

แทนที่ตัวยึดตำแหน่งโดยใช้เวิร์กโฟลว์การรับรองความปลอดภัยขององค์กรของคุณ ตรวจสอบให้แน่ใจว่าต้นทางและปลายทางเป็นโฮสต์ที่ต้องการ การเข้าสู่ระบบทั้งสองสำเร็จ และโฟลเดอร์ต่างๆ เช่น ส่งแล้ว ฉบับร่าง และถังขยะ ตรงกับชื่อปลายทางที่ถูกต้อง หากการแมปไม่ถูกต้อง ให้แก้ไขก่อนคัดลอกข้อความ

เมื่อการทดสอบถูกต้องแล้ว ให้ลบออก--justfoldersและ--dryดำเนินการคัดลอกกล่องจดหมายจริง เก็บ--automapเฉพาะกรณีที่การแมปที่เสนอถูกต้องสำหรับชื่อโฟลเดอร์ของคุณ:

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap

หากคุณมีผู้ใช้จำนวนมาก ให้รันคำสั่งที่ทดสอบแล้วสำหรับกล่องจดหมายแต่ละกล่องผ่านสคริปต์ที่ควบคุมได้ ตรวจสอบบทช่วยสอน imapsync อย่างเป็นทางการ และแนวทางปฏิบัติที่ดีสำหรับไวยากรณ์และตัวเลือกเฉพาะแพลตฟอร์ม หลีกเลี่ยงการใช้แฟล็กที่ทำลายข้อมูล เช่น--delete1หรือ--delete2เว้นแต่คุณต้องการลบข้อมูลในฝั่งนั้นโดยเจตนาและได้ทดสอบผลลัพธ์บนปลายทางที่ใช้แล้วทิ้งแล้ว การคัดลอกการย้ายข้อมูลไม่ควรลบอีเมลต้นทางหรือข้อมูลเฉพาะปลายทางโดยไม่คาดคิด

5. เรียกใช้การซิงค์เดลต้าครั้งสุดท้ายและสลับการไหลของอีเมล

ไม่ว่าจะใช้วิธีใด การซิงโครไนซ์รอบแรกอาจใช้เวลานานในขณะที่ผู้ใช้ยังคงทำงานอยู่ ควรกำหนดเวลาการซิงโครไนซ์ครั้งสุดท้ายให้ใกล้กับช่วงเวลาเปลี่ยนผ่าน สำหรับ imapsync ให้รันคำสั่งเดิมที่ทดสอบแล้วอีกครั้ง: เครื่องมือนี้ออกแบบมาสำหรับการทำงานแบบเพิ่มทีละน้อยและโดยปกติจะข้ามข้อความที่ซิงโครไนซ์ไปแล้ว ควรคงกล่องจดหมายต้นทางไว้เหมือนเดิมในระหว่างการซิงโครไนซ์ครั้งสุดท้ายหากเป็นไปได้ หากผู้ใช้เคยใช้เซิร์ฟเวอร์ทั้งสองอยู่แล้ว ให้แก้ไขการเปลี่ยนแปลงที่แตกต่างกันเหล่านั้นแยกต่างหาก imapsync ไม่ใช่เครื่องมือสำหรับการรวมข้อมูลแบบสองทาง

สำหรับการสำรองข้อมูล Zextras ให้ทำตามขั้นตอนการนำเข้าแบบเป็นขั้นๆ ที่เฉพาะเจาะจงกับเวอร์ชัน และทำซ้ำขั้นตอนการถ่ายโอน/กู้คืนข้อมูลสำรองที่จำเป็นเพื่อให้ได้การเปลี่ยนแปลงตั้งแต่รอบก่อนหน้า อย่าคิดว่าการจัดเตรียมข้อมูลจะนำเข้าอีเมล ปฏิทิน หรือรายชื่อติดต่อเท่านั้น เพราะมันจะสร้างโครงสร้างบัญชีโดยข้ามเนื้อหาในกล่องจดหมายไป

เมื่อเซิร์ฟเวอร์ปลายทางพร้อมรับอีเมลแล้ว ให้เปลี่ยน MX และระเบียนเว็บเมลที่เกี่ยวข้องตามการออกแบบ DNS และพร็อกซีของคุณ คงเซิร์ฟเวอร์เก่าไว้และตรวจสอบทั้งสองระบบในระหว่างที่แคช DNS หมดอายุและอีเมลที่ล่าช้ามาถึง ใช้ช่วงเวลาการบำรุงรักษาที่กำหนดไว้และแจ้งให้ผู้ใช้ทราบว่าควรลงชื่อเข้าใช้เซิร์ฟเวอร์เก่าหรือเซิร์ฟเวอร์ใหม่ในช่วงแต่ละขั้นตอน

6. ตรวจสอบเซิร์ฟเวอร์ใหม่ให้เรียบร้อยก่อนยกเลิกการใช้งานเซิร์ฟเวอร์เก่า

ทดสอบกับกล่องจดหมายตัวอย่างหลากหลายขนาด ทั้งเล็ก ใหญ่ ใหม่ และเก่า เปรียบเทียบรายการโฟลเดอร์และจำนวนข้อความ เปิดข้อความที่มีไฟล์แนบ ตรวจสอบสถานะการอ่าน/ยังไม่ได้อ่าน และสถานะการติดธง และยืนยันว่าอีเมลที่ส่งแล้วปรากฏในโฟลเดอร์ที่ต้องการ ส่งอีเมลทั้งเข้าและออกจากปลายทาง จากนั้นยืนยันการค้นหา MX สาธารณะและบันทึกเซิร์ฟเวอร์ว่าส่งถึงโฮสต์ที่คาดหวังแล้ว

สำหรับการย้ายข้อมูลไปยัง Zextras ให้ทดสอบปฏิทิน รายชื่อติดต่อ งาน การแชร์ ข้อมูลประจำตัว ลายเซ็น การตั้งค่าผู้ใช้ และการตั้งค่าโดเมนหรือคลาสออฟเซอร์วิสใดๆ ที่รวมอยู่ในขอบเขตของคุณแยกกัน เอกสารของ Zextras มีzxsuite backup doCheckSharesวิธีการตรวจสอบความสอดคล้องของการแชร์ ให้ใช้ขั้นตอนการแก้ไขที่ตรงกันเฉพาะเมื่อจำเป็นและได้รับการสนับสนุนโดยเวอร์ชันที่ติดตั้งของคุณ ตรวจสอบการเข้าถึงของผู้ใช้และพฤติกรรมของรหัสผ่านอีกครั้ง

เก็บเซิร์ฟเวอร์ต้นทางและข้อมูลสำรองที่สามารถกู้คืนได้ไว้จนกว่าผู้มีส่วนได้ส่วนเสียจะอนุมัติผลลัพธ์และระยะเวลาการเก็บรักษาข้อมูลของคุณสิ้นสุดลง อย่าปิดโฮสต์เก่าเพียงเพราะปลายทางยอมรับการเข้าสู่ระบบ ปิดโครงการก็ต่อเมื่อได้รับการยืนยันการกำหนดเส้นทางอีเมล การเข้าถึงของผู้ใช้ ข้อมูลที่ไม่ใช่อีเมล และบันทึกการย้อนกลับทั้งหมดแล้วเท่านั้น

แหล่งที่มา

• Zextras: วิธีการย้ายเซิร์ฟเวอร์ Zimbra โดยใช้ Zextras Backup
• เอกสารประกอบการสำรองข้อมูล Zextras Suite
• เว็บไซต์อย่างเป็นทางการของ imapsync และข้อมูลการวางจำหน่าย
• คู่มือการใช้งาน imapsync อย่างเป็นทางการ
• คำถามที่พบบ่อยอย่างเป็นทางการเกี่ยวกับ imapsync Zimbra
• แนวทางปฏิบัติที่ดีอย่างเป็นทางการของ imapsync