OS Specific Platform Upgrades

Admin Article

Article Information

This article applies to the following ZCS versions.

ZCS 7.0 Article ZCS 7.0


This article is a guide on how to handle the installed ZCS when performing operating system platform upgrades on a server. Examples are moving from RHEL4_64 to RHEL5_64 or Ubuntu6_64 to Ubuntu10_64. This article assumes the server architecture (64-bit or 32-bit) remains unchanged; i.e., an in-place upgrade of the OS is being performed. If migrating systems from a 32-bit to 64-bit architecture, please review Network_Edition:_Moving_from_32-bit_to_64-bit_Server.


ZCS will only run on the designated platform version used during installation. Therefore, it is critical to carefully plan operating system release upgrades. When performing OS upgrades, it is important to start with a ZCS release version that is supported on both the existing and upgraded systems. This is necessary to ensure the ZCS upgrade installer will execute correctly after the OS upgrade is complete. Here are some examples of ZCS release versions supported on more than one operating system versions:

ZCS 5.0.19_64

  • RHEL 4 and RHEL 5
  • Ubuntu 6.06 LTS and Ubuntu 8.04 LTS

ZCS 6.0.12_64

  • RHEL 4 and RHEL 5
  • Ubuntu 6.06 LTS, Ubuntu 8.04 LTS and Ubuntu 10.04 LTS
  • SLES10 and SLES11

ZCS 7.1.0_64

  • RHEL 4 and RHEL 5
  • Ubuntu 8.04 LTS and Ubuntu 10.04 LTS
  • SLES10 and SLES11

Upgrade Steps

  • Stop the ZCS.
  • Prevent ZCS from launching at system start.
  • Upgrade ZCS to a platform version if necessary.
  • Upgrade the operating system.
  • Install the appropriate ZCS of equal or current version for the platform as an upgrade.

Example: ZCS 5.0.26 on Ubuntu 6.06 LTS to ZCS 7.1.0 on Ubuntu 10.04 LTS

This example assumes the server is Ubuntu 6.06 LTS 64-bit with ZCS 5.0.26_GA_3365.UBUNTU6_64 installed. The operating system is being upgraded to Ubuntu 10.04 LTS and will run ZCS 7.1.0_GA_3140.UBUNTU10_64. ZCS 5.0.26 is supported on Ubuntu 6 and Ubuntu 8, but not Ubuntu 10. The operating system can be upgraded to Ubuntu 8 with ZCS 5.0.26 installed. However, the ZCS will need to be upgraded prior to upgrading the OS to Ubuntu 10.

Start 5.0.26_GA_3365.UBUNTU6_64 on Ubuntu 6.06.

  1. Stop ZCS.
  2. Move aside /etc/init.d/zimbra to prevent zimbra from launching at system start.
  3. Perform the in-place upgrade to Ubuntu 8.04 LTS.

5.0.26_GA_3365.UBUNTU6_64 will not run on Ubuntu 8.04 LTS. 7.1.0 is supported on both Ubuntu 8 and Ubuntu 10, so ZCS can now be upgraded. Upgrading to Ubuntu 10 at this point is not supported by the ZCS installer since 5.0.26 is not supported on Ubuntu 10.

Start 5.0.26_GA_3365.UBUNTU6_64 on Ubuntu 8.04 LTS.

  1. Execute the upgrade installer for ZCS 7.1.0_GA_3140_UBUNTU8_64.
  2. Start ZCS 7.1.0 and verify operation.
  3. Stop ZCS.
  4. Move aside /etc/init.d/zimbra to prevent Zimbra from launching at system start.
  5. Upgrade the operating system to Ubuntu 10.04 LTS.
  6. Execute the upgrade installer for ZCS 7.1.0_GA_3140_UBUNTU10_64.
  7. Start ZCS 7.1.0 on Ubuntu 10 and verify operation.

One thing to note. The ZCS installer modifies some resident operating system files such as /etc/sudoers and /etc/security/imits.conf. Do not be concerned with preserving the contents of these files during the OS upgrades. The Zimbra installer will correct the files during the installation process.

Verified Against: Zimbra Collaboration Suite 7.1.0 Date Created: 4/15/2011
Article ID: https://wiki.zimbra.com/index.php?title=OS_Specific_Platform_Upgrades Date Modified: 2015-03-25

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