ZCA Migration: Difference between revisions
No edit summary |
|||
Line 35: | Line 35: | ||
== Download the latest ZCS version == | == Download the latest ZCS version == | ||
# Download ZCS version from | # Download ZCS version from Zimbra. For example: | ||
#: wget http://files2.zimbra.com/downloads/7.1.4_GA/zcs-NETWORK-7.1.4_GA_2555.UBUNTU8_64.20120105094735.tgz | #: wget http://files2.zimbra.com/downloads/7.1.4_GA/zcs-NETWORK-7.1.4_GA_2555.UBUNTU8_64.20120105094735.tgz | ||
Line 116: | Line 116: | ||
== Prepare the new ZCS server == | == Prepare the new ZCS server == | ||
Before you begin, make sure that the new server is correctly configured with the IP address and hostname and that ZCS is installed and configured with the same domain, hostname, passwords, etc. as the previous server. See the | Before you begin, make sure that the new server is correctly configured with the IP address and hostname and that ZCS is installed and configured with the same domain, hostname, passwords, etc. as the previous server. See the Zimbra Collaboration Server installation guide for more information about preparing the server. Before you begin to install ZCS, note the information you need from the old server including: admin account name and password, LDAP, Amavis, and Postfix passwords, spam training and non-spam training user account names, exact domain name, and the global document account name. | ||
# Login to the console of the new server | # Login to the console of the new server | ||
# Set the hostname | # Set the hostname |
Revision as of 10:46, 17 October 2013
Zimbra Migration from ZCA 6 to ZCS 7 or 8
Overview
There are two choices when upgrading from Zimbra Collaboration Appliance Version 6 to Zimbra Collaboration Server Version 7.
- One option is to maintain your existing virtual machine and upgrade the Zimbra software in place.
- The other option is to migrate your data from ZCA to a new server and then perform a ZCS upgrade.
Upgrade in-place Summary
Migration Summary
Upgrade in-place steps
Prepare ZCA for upgrade
- Enable CLI access to ZCA
- Log into the console as the vmware user
- sudo ufw disable
- Update the firewall rules
- Open the firewall rules in an editor
- sudo vi /var/lib/ufw/user.rules
- Add a line under "### RULES ###"
- -A ufw-user-input -p tcp --dport 22 -j ACCEPT
- Save the file and re-enable the firewall
- sudo ufw enable
- Log into the console as the vmware user
Download the latest ZCS version
- Download ZCS version from Zimbra. For example:
Remove Unnecessary File
- Log into the virtual appliance console as the vmware user.
- Switch to the zimbra user
- sudo su - zimbra
- Stop the Zimbra Appliance
- zmcontrol stop
- Change directories to /opt/zimbra/conf/rights/
- Delete the following file:
- rm zimbra-rights-appliance-admin.xml
- To return to root, type
- exit
Upgrade your ZCA software.
- Upgrade your software via the Zimbra Collaboration Installation and Upgrade Guide
- tar xzvf zcs-NETWORK-7.1.4_GA_2555.UBUNTU8_64.20120105094735.tgz
- cd zcs-NETWORK-7.1.4_GA_2555
- ./install.sh
Migration Steps
In the event that you need to migrate from a virtualized Zimbra Collaboration Appliance to a native installation of Zimbra Collaboration Server this document will guide you through the steps. The migration steps include advanced linux administration skills including access to the command line interface (cli), network ip address configuration, firewall configuration, and transferring data between servers. These steps utilize the application level backup and restore functionality built into Network Edition of ZCS because of this migration from ZCA to the Community Edition of ZCS is not supported.
Prepare ZCA for migration.
The migration from the Zimbra Collaboration Appliance (ZCA) utilizes the built-in application backup and restore functionality. This functionally is not exposed in the Administration Console for ZCA and requires access to the command line interface (cli).
- Gather migration data
- Log into the virtual appliance console as the vmware user
- Switch to the zimbra user
- sudo su - zimbra
- Obtain and save password information for later use.
- zmlocalconfig -s ldap_postfix_password
- zmlocalconfig -s ldap_amavis_password
- zmlocalconfig -s ldap_root_password
- zmlocalconfig -s zimbra_ldap_password
- Exit the zimbra user shell
- exit
- Enable CLI access to ZCA
- Log into the console as the vmware user
- sudo ufw disable
- Update the firewall rules
- Open the firewall rules in an editor
- sudo vi /var/lib/ufw/user.rules
- Add a line under "### RULES ###"
- -A ufw-user-input -p tcp --dport 22 -j ACCEPT
- Enable firewall rules to block end-user access to ZCA.
- Comment out all other ufw-user-input rules
- Save the file and reenable the firewall
- sudo ufw enable
- Log into the console as the vmware user
- Switch back to the zimbra user
- sudo su - zimbra
- Verify the mail queue is empty.
- postqueue -p
- Mail queue is empty
- In the event there are deferred messages in the mail queue you can attempt to flush the queue
- postqueue -f
- Any remaining messages will be lost.
- Perform a full backup of ZCA.
- zmbackup -a all -f
- full-20120224.231618.575
- Stop all ZCA services.
- zmcontrol stop
- Log out of the console
- exit
Copy existing data to the new server
- Copy backup files from ZCA to /opt/zimbra/backup on the new server.
- scp -r root@{zca server}:/opt/zimbra/backup /opt/zimbra/backup
- Copy your existing license file to the new server.
- scp -r root@{zca_server}:/opt/zimbra/conf/ZCSLicense.xml .
Shutdown the existing Zimbra Collaboration Appliance
- Power off the VM via vSphere or other management console.
Prepare the new ZCS server
Before you begin, make sure that the new server is correctly configured with the IP address and hostname and that ZCS is installed and configured with the same domain, hostname, passwords, etc. as the previous server. See the Zimbra Collaboration Server installation guide for more information about preparing the server. Before you begin to install ZCS, note the information you need from the old server including: admin account name and password, LDAP, Amavis, and Postfix passwords, spam training and non-spam training user account names, exact domain name, and the global document account name.
- Login to the console of the new server
- Set the hostname
- sudo vi /etc/hostname
- hostname {zca_hostname}
- Configuration the IP address
- sudo vi /etc/network/interfaces
- Restart networking
- /etc/init.d/networking restart
- Install software per the ZCS Installation Guide
- ./install.sh -l ../ZCSLicense.xml
- Run ./install.sh and follow the directions in the installation guide to install ZCS. Make sure that you configure the same domain, hostname, passwords as on the original server. During ZCS install, the following settings must be changed to match the original server settings:
- Zimbra LDAP Server. For Domain to create, identify the same default domain as on the old server.
- Zimbra Mailbox Server. An administrator’s account is automatically created.
- Make sure that the account name for Admin user to create is the same name as on the original server.
- Set the admin password to be the same as on the old server.
- Set the LDAP password to be the same as on the old server.
- Set the Postfix user and Amavis user passwords to be the same as on the old server
- Change the Spam training user and the Non-spam (HAM) training user account names to be the same as the spam account names on the old server.
- Global Document Account – This account name is automatically generated and is usually named wiki. If you changed this, change the Global Document Account name to be the same account name as on the original server.
- Change any other settings on the new server to match the configuration on the original server.
- In the main menu, set the default backup schedule and the automatic starting of servers after the configuration is complete to NO.
Restore system configuration and account data.
- Switch to the zimbra user
- sudo su - zimbra
- Stop ZCS
- zmcontrol stop
- Delete the MySQL data and re-initialize an empty data directory. If you do not do this, zmrestoreoffline will have errors.
- rm -rf /opt/zimbra/db/data/*
- /opt/zimbra/libexec/zmmyinit
- The MySQL service is now running.
- Restore the Directory and configuration data
- zmrestoreldap -lb <latest_label>.
- Note: To find the LDAP session label to restore, type zmrestoreldap –lbs.
- Because some ZCS services are running at this point, type zmconvertctl start. This is required before running zmrestoreoffline.
- Restore your original LDAP password
- zmlocalconfig -f -e zimbra_ldap_password=<password>.
- To start the offline restore, type
- zmrestoreoffline -sys -a all -c -br.
- You may want to run a command such as nohup here also. To watch the progress, tail /opt/zimbra/log/mailbox.log.
- Note: Use –c on the command line so that accounts will be restored even if some accounts encounter errors during the offline restore process.
- Stop all ZCS services that have been started.
- zmcontrol stop
- Remove any old backup sessions because these sessions are no longer valid.
- rm -rf /opt/zimbra/redolog/* /opt/zimbra/backup/*
- ZCS is now ready to start.
- zmcontrol start.
- Now run a full backup
- zmbackup -f -a all.