User Tools

Site Tools


internet:mail:zimbra:zimbra_migrate

Zimbra Migration

Method 1: https://community.zextras.com/migrate-zimbra-from-one-server-to-another-server-method-1/

Method 2: https://community.zextras.com/migrate-zimbra-from-one-server-to-another-server-method-2/

Method 3: https://community.zextras.com/migrate-zimbra-from-one-server-to-another-server-method-3/

See also Zimbra Collaboration Server OSE

Migration Howto: https://community.zextras.com/zimbra-migration-with-zextras-backup

:!: Set the maximum message size on the Zimbra server before proceeding with any inbound migration to avoid problems.

Import and export of large mailboxes will cause high CPU and, especially, disk IO. Try to perform import/export operations when users will be impacted the least.

Zextras Backup Migration

Read this entire page first: Migrate Using Zextras Backup

:!: If you are migrating from one Zimbra ZCS server to another, this is the way to go. It is fairly simple and very effective.

  • Accounts
  • CoS
  • Mail
  • Calendar Items
  • Briefcase Items
  • Drive Items
  • Preferences
  • Etc.

Overview

For Zextras notifications regarding command line backup actions, see Zimbra Admin → Zextras → Notifications.
For best performance, use a fast disk as the migration backup location, rather than an NFS share. The difference can be hours instead of days!
For best performance, use multiple accounts on your restore command to restore more than one user at a time. The difference can be hours instead of days!
  1. Ensure that Zextras Backup is installed on both the source and destination servers
    • You can configure Zextras Backup on the destination server permanently
  2. Disable Zextras Backup Realtime Scanner on both servers
  3. Disable scheduled SmartScans on both servers
  4. Mount the backup media on the source server
    • Set permissions to zimbra:zimbra
    • Usually /opt/zimbra/backup/zextras
  5. Run a Zextras Backup SmartScan backup on the old server
    • Initializing Zextras Backup will run a SmartScan
    • May take hours
    • Do not run another Zextras Baackup (SmartScan) on the source server until you are ready for the final cutover
  6. Dismount the backup media from the source server
  7. Mount the backup media on the destination server
    • Use a temporary mount point such as /mnt/tmp
    • Reset the permissions to zimbra:zimbra
  8. Start the restore
    • Use multiple threads for a quicker restore
    • May take days
  9. Dismount the backup media from the destination server
  10. Mount the migration backup media back on the source server
    • Use exactly the same mount point previously used
    • Reset the permissions to zimbra:zimbra
  11. When you want to do the actual migration, stop mail flow on port 25
    • Verify the mail has stopped flowing
    • Incoming mail will be delayed
  12. Run another (final) SmartScan on the source server
    • It won't take long as it's an incremental backup
  13. Dismount the migration backup media from the source server
  14. Mount the migration backup media on the destination server
    • Use a temporary mount point such as /mnt/tmp
    • Reset the permissions to zimbra:zimbra
  15. Start the restore
    • Use multiple threads for a quicker restore
    • This restore will be much quicker
    • May still take hours depending on how much mail has flowed since the first pass
  16. Dismount the migration backup media from the destination server
  17. Enable Zextras Backup Realtime Scanner on the destination server
  18. Enable scheduled SmartScans on the destination server

Restore

mkdir /mnt/tmp
chmod 777 /mnt/tmp/
mount -t nfs ip.of.nfs.svr:/path/to/backup /mnt/tmp/
chown -R zimbra:zimbra /mnt/tmp
su - zimbra
zxsuite backup doExternalRestore /mnt/tmp concurrent_accounts 5

Verify Proxy Settings

Check all domains:

for dom in $(zmprov gad); do zmprov gd $dom zimbraPublicServiceProtocol zimbraPublicServiceHostname zimbraPublicServicePort; done

Modify all domains:

for dom in $(zmprov gad); do zmprov md $dom zimbraPublicServiceProtocol https zimbraPublicServiceHostname zimbra.yourdomain.tld zimbraPublicServicePort 443; done


DELETEME Info below this point is old.

CLI

:!: Change to the zimbra user for all commands:

su - zimbra

List the mailboxes to be exported:

zmprov gqu localhost | grep yourdomain.tld|awk {'print $1'}

or, for two domains:

zmprov gqu localhost | egrep 'yourdomain1.tld|yourdomain2.tld' | awk {'print $1'}

Count of the number of mailboxes to be exported:

zmprov gqu localhost | grep yourdomain.tld|awk {'print $1'} |wc -l

The following is an example script to export all mailboxes for one domain to a temporary location. Modify before using!:

  • Host name
    • localhost is OK for single server installations
  • Domain name
    • The target domain you want to export all mailboxes for
  • Zimbra server URL
    • Omit -u and referenced URL for single server
  • Destination
    • /tmp shown
    • Check for free space first!
  • Uncomment lines after editing and testing to begin the export
vim /tmp/export-domain-all.sh
#!/bin/bash
for i in `zmprov gqu localhost | grep yourdomain.tld | awk {'print $1'}`; do
    echo $i
#    file=`echo $i | awk -F '@' '{print $1}'`
#    /opt/zimbra/bin/zmmailbox -z -t 0 -m "${i}" getRestURL -u "https://hoster.domain.tld" "//?fmt=tgz" > /tmp/${file}.tgz
done
chmod +x /tmp/export-domain-all.sh
/tmp/export-domain-all.sh

Zimbra Migration Wizard

:!: You can run this GUI tool as an administrator for Exchange server to Zimbra server migrations as well as PST imports.

:!: The PC you run it from must have Outlook and .NET Framework 4 installed. Windows 10 comes with .Net Framework installed.

:!: You will need to know the location of your PST file to use this tool.

As a Regular User

  1. Run the appropriate ZimbraMigration.exe to start the Wizard
    • 32-bit or 64-bit
    • Must match the Outlook installed
  2. Choose User Migration
    1. Next
  3. Click OK to select a .pst (Outlook data) file
  4. Browse to and select a .pst file
    1. Next
  5. Enter your Zimbra destination server and account details
    1. Hostname → zimbra.virtualarchitects.com
    2. Port → 443
    3. Use Secure Connection → Yes
    4. Username → Your e-mail address
    5. Password → Your Zimbra password
    6. Next
  6. Select the items and options for your migration
    1. Choose Skip previously migrated items
    2. Click Migrate
    3. Check Verbose Logging for detailed log of any errors

As an Administrator

Zimbra Admin → Tools and Migration → Download

Zimbra Migration Wizard #1 Zimbra Migration Wizard #2

Move Folders to Another Mailbox

Export

# Entire account
zmmailbox -z -m user1@domain.tld getRestURL "//?fmt=tgz" > /tmp/user1.tgz
# Folder and subfolders
zmmailbox -z -m user1@domain.tld getRestURL -o /tmp/user1.tgz '//?fmt=tgz&query=under:"Folder Name"'

Import

The resolve= parameter has several options:
  • skip ignores duplicates of old items, it’s also the default conflict-resolution.
  • modify changes old items.
  • reset will delete the old subfolder (or entire mailbox if /).
  • replace will delete and re-enter items

:!: Reset will be a bit faster on an empty destination mailbox because it skips most dupe checks.

If you get a timeout error, try changing this setting:
zmlocalconfig socket_so_timeout
zmlocalconfig -e socket_so_timeout=3000000

# change it back when you complete the import(s)
zmlocalconfig -e socket_so_timeout=30000
zmlocalconfig --reload

Merge with Existing

zmmailbox -z -t 0 -m user2@domain.tld postRestURL "//?fmt=tgz&resolve=modify" /tmp/user1.tgz

Overwrite Existing

zmmailbox -z -t 0 -m user2@domain.tld postRestURL "//?fmt=tgz&resolve=reset" /tmp/user1.tgz

Outlook Import Wizard

:!: This tool appears to require Outlook 2010 (or older?) installed on the machine you are using to run the Migration Wizard.

This tool allows for migration from Outlook (PST) to Zimbra.

Zimbra Admin → Tools and Migration → Download

Outlook Import Wizard

From IMAP to Zimbra

Migrate a Domain Off Your Server

http://www.mojocode.com/content/moving-domain-multi-domain-zimbra-server

Let's say you are migrating a domain off of your multi-domain Zimbra server, but you don't want to just delete the accounts immediately…

If you edit the domain status to closed, users can't log in and the server won't route mail for the domain…which is a problem. Users of other domains on that server will not be able to send mail to the 'closed' domain.

So, you can easily rename the domain and the server will then route mail normally to the migrated domain.

su - zimbra

zmprov --ldap rd mydomain.com mydomain-old.com
internet/mail/zimbra/zimbra_migrate.txt · Last modified: 2023/09/20 09:42 by gcooper