Addition/Migrate.to.New.iRedMail.Server

From iRedMail

Revision as of 05:31, 23 November 2011

TO BE CONTINUED.

Please try it on a test server first, if it works well, then try it on product server.

Since new iRedMail server will install same components as old server, you can choose what data you want to migrate. The major data are mail accounts, roundcube webmail database, mailboxes.

Steps to migrate accounts, roundcube database, mailboxes:

• Setup a new server with the latest iRedMail, and make iRedAdmin-Pro-LDAP work as expected.
• Export mail accounts from LDAP on OLD mail server.

Normally, LDAP data can be exported into LDIF format. Here's backup/export script: http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Backup

After exported from old server, you will get a plain text file which has LDIF data. You should remove top some items, includes:

• dc=xxx,dc=xxx
• cn=vmail,dc=xxx,dc=xxx
• cn=vmailadmin,dc=xxx,dc=xxx
• o=domains,dc=xxx,dc=xxx

Because we will use these ldap objects on new server, so remove them from exported data.

Assume the exported backup data is saved in file /root/old.ldif

• Now, log into phpLDAPadmin with cn=Manager,dc=xxx,dc=xxx on NEW server, remove object of your mail domain. it should be:
  • domainName=your_domain.com,o=domains,dc=xxx,dc=xxx

• Remove all sub-objects under this object.
• Import /root/old.ldif with phpLDAPadmin.

You can find a button named "Import" in phpLDAPadmin left panel.

• There might be some changes to LDAP schema, please read all upgrade tutorials for your running iRedMail version, then apply LDAP data related upgradings. For example:
  • http://iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.5.1-0.6.0#Add_missing_values
  • http://iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.6.1-0.7.0#Add_missing_value_for_mail_users

Note: You can find all upgrade tutorials here: http://www.iredmail.org/doc.html#upgrade_tutorial

• Export/import roundcube webmail database, and upgrade database to work with new version of Roundcube.

http://trac.roundcube.net/wiki/Howto_Upgrade

• Simply copy all mailboxes to new mail server.

WARNING: please make sure maildir path which stored/configured in LDAP will match the real path on file system, so that mail clients can find them.

• IMPORTANT FOR MYSQL BACKEND: Force Dovecot to recalculate mailbox quota after you copied old mailboxes. Here's tutorial: How to force Dovecot to re-calculate mailbox quota
  • This step is REQUIRED if you migrated mailboxes with iRedMail MySQL backend. Otherwise Dovecot will delete records in table vmail.mailbox to re-calculate mailbox quota.