Difference between revisions of "Pre-Upgrade Steps"

Line 1: Line 1:
{{Article Infobox|{{admin}}||{{ZCS 8.0}}|{{ZCS 7.0}}|{{ZCS 6.0}}|{{ZCS 5.0}}|}}
+
{{Article Infobox|{{admin}}||{{ZCS 8.0}}|{{ZCS 7.0}}|}}
  
 
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. Always read (in full) the Release Notes for the version to which you are upgrading. The Release Notes are available for every release:
+
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  
 
http://www.zimbra.com/downloads/ne-downloads.html  
  
1. Backup your system:
+
1. 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:
Line 19: Line 21:
 
  zmbackup -f
 
  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:
  
=== Header3 ===
+
$ /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
  
Text
+
If not using binary logging, the dump is run like the following:
  
=== Header3 ===
+
$ /opt/zimbra/mysql/bin/mysqldump --user=root --password=$mysql_root_password --socket=$mysql_socket \
 +
  --all-databases --single-transaction --flush-logs > {dump-file}.sql
  
Text
 
  
 
----------------------------------------------------------------------------------------------------------------------------
 
----------------------------------------------------------------------------------------------------------------------------
{{Article Footer|ZCS 8.0 ZCS 7.0 |9/12/2013}}
+
{{Article Footer|ZCS 8.0 ZCS 7.0 |01/15/2014}}
  
  

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