Network Edition Moving from Open Source to Network Edition ZCS: Difference between revisions

(No difference)

Revision as of 16:39, 10 August 2007

This article describes the steps to move from Open Source ZCS to Network Edition ZCS.

  • Important: The ZCS release you install on the network edition server must be the same release as installed on the open source edition server. The server can have a different operating system.

The new server hardware must meet the requirements described in the Installation Prerequisites section of the ZCS Single Server Installation Guide. Install the new operating systems, making any necessary OS configuration modifications as described in the installation guide.

Migrating from Open Source ZCS to Network Edition ZCS

On the open source server, you perform the following steps:

  • Block client access to the old server's IP address with firewall rules
  • Create an LDAP dump directory
  • Backup the LDAP data
  • Export the MySQL data

For the network edition server, you do the following:

  • Prepare the new server
  • Copy the backup files from the open source server to the network edition server
  • Restore the LDAP data
  • Import the MySQL data
  • Edit the localconfig.xml file to update the MySQL password values to be the same as those on the old server.
  • Copy various files from the open source server to the network edition server
  • Prepare and run a new backup on the network edition server

Preparing the Open Source Server

  1. Block client access to the server IP address with firewall rules.
  2. Create an LDAP dump directory. As root, type
    a. mkdir /backup
    b. chown zimbra:zimbra /backup
  3. Backup the LDAP data, as zimbra, type
    /opt/zimbra/libexec/zmslapcat /backup
  4. Export MySQL data. Before you start, make sure that /backup is large enough to hold all the data. Depending on the original database size, this can be very large. If you have large configuration, you may want to run this command with nohup so that the session does not terminate. Type
    mysqldump -f -S /opt/zimbra/db/mysql.sock \
    -u zimbra --password=`zmlocalconfig -s -m nokey \
    zimbra_mysql_password` --all-databases --single-transaction \
    > /backup/mysql.sql
  5. Stop the open source server, type zmcontrol stop .
  6. Change the hostname and IP address on the old server to something else. Do not turn off the server.

Preparing the Network Edition Server

The ZCS installation on the network edition server must be configured exactly as the ZCS configuration on the open source server. You go through the complete menu driven installation process, making changes to the configuration setting to match the settings on the original server. Before you begin to install ZCS, note the information you need from the old server including: admin account name and password, spam training and non-spam training user account names, exact domain name, and the global document account name.

Note: The following commands are run as zimbra user.

  1. Make sure that you configure the same domain, hostname, passwords as on the old server. During ZCS install, the following settings must be changed to match the original server settings.
    Important: Before you start, make sure that your ZCSLicense.xml file is copied to a directory on the new server. You will not be able to complete the ZCS installation if the license is not on the new server.
    a. Zimbra LDAP Server - For Domain to create - identify the same default domain as on the original server.
    b. 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.
    • 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 original server.
    • Global Document Account - This account name is automatically generated. Change the Global Document Account name to be the same account name as on the original server.
    c. Change any other settings on the new server to match the configuration on the original server.
  2. Stop the ZCS services, type zmcontrol stop .
  3. Copy over /backup/* from the open source server to the network edition server. The files should be readable as zimbra user.
  4. Restore the LDAP data to the network edition server.
    a. Type rm -rf /opt/zimbra/openldap-data/*
    b. Type /opt/zimbra/openldap/sbin/slapadd \
    -f /opt/zimbra/conf/slapd.conf -cv \
    < /backup/ldap.bak
  5. Start MySQL, import the MySQL data, and stop the mySQL service. Type
    a. mysql.server start
    b. mysql -f zimbra < /backup/mysql.sql
    If you have large configuration, you may want to run this command with nohup so that the session does not terminate.
    c. mysql.server stop
  6. Edit /opt/zimbra/conf/localconfig.xml to update the zimbra_mysql_password and the mysql_root_password values to the values from the localconfig.xml file on the open source server.
  7. Copy the following files from the open source server to the network edition server. Make sure that you preserve file ownership and permissions on the copied files.
    • /opt/zimbra/store/*
    • /opt/zimbra/index/*
    • Any other volumes that were set up on the open source server.
  8. For a clean backup, remove the redologs. Type
    rm -rf /opt/zimbra/redolog/*
  9. Start ZCS, type zmcontrol start .
  10. Now run a full backup, type zmbackup -f -a all .
  11. Remove the firewall rules and allow client access to the new server.

Rev 1 411/2007

Jump to: navigation, search