Pre-Upgrade Steps

Revision as of 01:15, 16 January 2014 by Thom (talk | contribs)
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