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
+
'''0. 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. Backup your system
+
'''1. Check your database integrity'''
 +
 
 +
http://wiki.zimbra.com/wiki/Zmdbintegrityreport
 +
 
 +
/opt/zimbra/libexec/zmdbintegrityreport -v
 +
 
 +
'''2. 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:
+
'''a. 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 20: Line 26:
  
 
  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 37: 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  

Revision as of 01:15, 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:

0. 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

1. Check your database integrity

http://wiki.zimbra.com/wiki/Zmdbintegrityreport

/opt/zimbra/libexec/zmdbintegrityreport -v

2. 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:

a. 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

Main database:

/opt/zimbra/libexec/zmslapcat /var/tmp

Config database:

/opt/zimbra/libexec/zmslapcat -c /tmp

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



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