Pre-Upgrade Steps: Difference between revisions
No edit summary |
No edit summary |
||
Line 3: | Line 3: | ||
Before upgrading your Zimbra platform, we would strongly recommend the following pre-upgrade steps: | Before upgrading your Zimbra platform, we would strongly recommend the following pre-upgrade steps: | ||
= Prepare = | |||
Always read (in full) the Release Notes for the version to which you are upgrading. The Release Notes are available for every release: | Always read (in full) the Release Notes for the version to which you are upgrading. The Release Notes are available for every release: | ||
Line 9: | Line 9: | ||
http://www.zimbra.com/downloads/ne-downloads.html | http://www.zimbra.com/downloads/ne-downloads.html | ||
= Check your database integrity = | |||
http://wiki.zimbra.com/wiki/Zmdbintegrityreport | http://wiki.zimbra.com/wiki/Zmdbintegrityreport | ||
Line 15: | Line 15: | ||
/opt/zimbra/libexec/zmdbintegrityreport -v | /opt/zimbra/libexec/zmdbintegrityreport -v | ||
= Backup your system = | |||
There are multiple ways to perform backups. Since upgrading permanently alters your system, it is mandatory to backup your system before you upgrade. The only recovery from a failed upgrade may be to restore from backups: | There are multiple ways to perform backups. Since upgrading permanently alters your system, it is mandatory to backup your system before you upgrade. The only recovery from a failed upgrade may be to restore from backups: | ||
== zmbackup your entire system == | |||
https://wiki.zimbra.com/wiki/CLI_-_zmbackup_Network_Edition_Only | https://wiki.zimbra.com/wiki/CLI_-_zmbackup_Network_Edition_Only | ||
Line 27: | Line 27: | ||
zmbackup -f | zmbackup -f | ||
== b. Backup your LDAP data == | |||
http://wiki.zimbra.com/wiki/LDAP_data_import_export | http://wiki.zimbra.com/wiki/LDAP_data_import_export | ||
Line 43: | Line 43: | ||
/opt/zimbra/libexec/zmslapcat -a /tmp | /opt/zimbra/libexec/zmslapcat -a /tmp | ||
== c. Backup your MySQL data == | |||
https://wiki.zimbra.com/wiki/MySQL_Backup_and_Restore | https://wiki.zimbra.com/wiki/MySQL_Backup_and_Restore | ||
Line 61: | Line 61: | ||
--all-databases --single-transaction --flush-logs > {dump-file}.sql | --all-databases --single-transaction --flush-logs > {dump-file}.sql | ||
= Confirm that your SSL certs are all valid and not-expired = | |||
http://wiki.zimbra.com/wiki/Administration_Console_and_CLI_Certificate_Tools | http://wiki.zimbra.com/wiki/Administration_Console_and_CLI_Certificate_Tools | ||
Line 67: | Line 67: | ||
/opt/zimbra/bin/zmcertmgr viewdeployedcrt all | /opt/zimbra/bin/zmcertmgr viewdeployedcrt all | ||
= Conclusion = | |||
If any of the above steps fail in any way, DO NOT UPGRADE. They must all succeed before you continue. | If any of the above steps fail in any way, DO NOT UPGRADE. They must all succeed before you continue. |
Revision as of 01:22, 16 January 2014
Article Information |
---|
This article applies to the following ZCS versions. |
Before upgrading your Zimbra platform, we would strongly recommend the following pre-upgrade steps:
Prepare
Always read (in full) the Release Notes for the version to which you are upgrading. The Release Notes are available for every release:
http://www.zimbra.com/downloads/ne-downloads.html
Check your database integrity
http://wiki.zimbra.com/wiki/Zmdbintegrityreport
/opt/zimbra/libexec/zmdbintegrityreport -v
Backup your system
There are multiple ways to perform backups. Since upgrading permanently alters your system, it is mandatory to backup your system before you upgrade. The only recovery from a failed upgrade may be to restore from backups:
zmbackup your entire system
https://wiki.zimbra.com/wiki/CLI_-_zmbackup_Network_Edition_Only
Note: this may take multiple hours, be sure to plan in advance:
zmbackup -f
b. Backup your LDAP data
http://wiki.zimbra.com/wiki/LDAP_data_import_export
LDAP Main database:
/opt/zimbra/libexec/zmslapcat /var/tmp
LDAP Config database:
/opt/zimbra/libexec/zmslapcat -c /tmp
LDAP Accesslog database (on LDAP Master only):
/opt/zimbra/libexec/zmslapcat -a /tmp
c. Backup your MySQL data
https://wiki.zimbra.com/wiki/MySQL_Backup_and_Restore
# su - zimbra $ source ~/bin/zmshutil $ zmsetvars
If using binary logging, the dump is run like the following:
$ /opt/zimbra/mysql/bin/mysqldump --user=root --password=$mysql_root_password --socket=$mysql_socket \ --all-databases --single-transaction --master-data --flush-logs > {dump-file}.sql
If not using binary logging, the dump is run like the following:
$ /opt/zimbra/mysql/bin/mysqldump --user=root --password=$mysql_root_password --socket=$mysql_socket \ --all-databases --single-transaction --flush-logs > {dump-file}.sql
Confirm that your SSL certs are all valid and not-expired
http://wiki.zimbra.com/wiki/Administration_Console_and_CLI_Certificate_Tools
/opt/zimbra/bin/zmcertmgr viewdeployedcrt all
Conclusion
If any of the above steps fail in any way, DO NOT UPGRADE. They must all succeed before you continue.