OS Specific Platform Upgrades

 - This is archive documentation, which means it is not supported or valid for recent versions of Zimbra Collaboration.

Article Information
This article applies to the following ZCS versions. ZCS 7.0

Summary

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.

Description

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.