Difference between revisions of "Pre-Upgrade Steps"

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:
  
'''0. Prepare'''
+
= 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  
  
'''1. Check your database integrity'''
+
= 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
  
'''2. Backup your system'''
+
= 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:
  
'''a. zmbackup your entire system'''
+
== 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'''
+
== 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'''
+
== 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
  
'''3. Confirm that your SSL certs are all valid and not-expired'''
+
= 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 =
== Summary ==
 
  
 
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

Admin Article

Article Information

This article applies to the following ZCS versions.

ZCS 8.0 Article ZCS 8.0 ZCS 7.0 Article ZCS 7.0


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.


Verified Against: ZCS 8.0 ZCS 7.0 Date Created: 01/15/2014
Article ID: https://wiki.zimbra.com/index.php?title=Pre-Upgrade_Steps Date Modified: 2014-01-16



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search