View source for Template:PatchInstallation-8815

<!-- This is a TEMPLATE that requires parameters:
      - Version=<version-number>
      - Packages=<Block of text specifying the package version lineup. Mediawiki formatting is allowed.  -->

=Patch Installation=

Please refer to the steps below to install {{{Version}}} on [[#Redhat|Redhat]] and [[#Ubuntu|Ubuntu]] platforms:

<span class="h2">Before Installing the Patch</span>

Before installing the patch, consider the following:
* Patches are cumulative.
* A full backup should be performed before any patch is applied. There is no automated roll-back.
* Zimlet patches can include removing existing Zimlets and redeploying the patched Zimlet.
* Only files or Zimlets associated with installed packages will be installed from the patch.
* Switch to <code>zimbra</code> user before using ZCS CLI commands.
* '''Important!''' You cannot revert to the previous ZCS release after you upgrade to the patch.
* '''Important Note for ZCS Setup with Local ZCS repository:''' Customers who have set up local ZCS repository should first update the local repository by following instructions in [https://wiki.zimbra.com/wiki/Zimbra_Collaboration_repository#Keep_the_local_Repository_up_to_date wiki]
* Please make note that, installing the zimbra-patch package only updates the Zimbra core packages.

=={{{Version}}} Packages==
The package lineup for this release is:

{{{Packages}}}

===Redhat===

<span class="h2">Installing Zimbra packages with system package upgrades</span>
* As <code>root</code>, first clear the yum cache and check for updates so the server sees there is a new <code>zimbra-patch</code> package in the patch repository:
 yum clean metadata
 yum check-update
* Then ask yum to update available packages:
 yum update
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart

<span class="h2">Installing Zimbra packages individually</span>

'''Install/Upgrade <code>zimbra-proxy-components</code> on Proxy node for FOSS and NETWORK'''
* As <code>root</code>, first clear the yum cache and check for updates so the server sees all updated packages in the patch repository:
 yum clean metadata
 yum check-update
* Then install the package:
 yum install zimbra-proxy-components
* Restart proxy as <code>zimbra</code> user:
 su - zimbra
 zmproxyctl restart

'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node for FOSS and NETWORK'''
* As <code>root</code>, install the package:
 yum install zimbra-proxy-patch
* Restart proxy as <code>zimbra</code> user:
 su - zimbra
 zmproxyctl restart
 zmmemcachedctl restart

'''Install/Upgrade <code>zimbra-mta-components</code> on MTA node for FOSS and NETWORK'''
* As <code>root</code>, first clear the yum cache and check for updates so the server sees all updated packages in the patch repository:
 yum clean metadata
 yum check-update
* Then install the package:
 yum install zimbra-mta-components
* Restart <code>amavisd</code> as <code>zimbra</code> user:
 su - zimbra
 zmamavisdctl restart

'''Install/Upgrade <code>zimbra-mta-patch</code> on MTA node for FOSS and NETWORK'''
* As <code>root</code>, install the package:
 yum install zimbra-mta-patch
* Restart <code>amavisd</code> as <code>zimbra</code> user:
 su - zimbra
 zmamavisdctl restart

'''Install/Upgrade <code>zimbra-patch</code> on mailstore node for FOSS and NETWORK'''
* As <code>root</code>, install the package:
 yum install zimbra-patch
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart

'''Install/Upgrade <code>zimbra-chat</code> for FOSS'''
* As <code>root</code>, install the package:
 yum install zimbra-chat
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Uninstall <code>zimbra-talk</code> (NETWORK Only)'''

Starting Zimbra 8.8.15 GA, <code>zimbra-connect</code> replaces <code>zimbra-talk</code> hence it is important to remove <code>zimbra-talk</code> before installing <code>zimbra-connect</code>.
* As <code>root</code>, uninstall the package:
 yum remove zimbra-talk

'''Install/Upgrade <code>zimbra-network-modules-ng</code>, <code>zimbra-connect</code> and  <code>zimbra-zimlet-auth</code> (NETWORK Only)'''
* As <code>root</code>, first clear the yum cache and check for updates so the server sees all updated packages in the patch repository:
 yum clean metadata
 yum check-update
* Then install the packages:
 yum install zimbra-network-modules-ng
 yum install zimbra-connect
 yum install zimbra-zimlet-auth
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Install/Upgrade <code>zimbra-docs</code> (NETWORK Only)'''
* As <code>root</code>, install the package:
 yum install zimbra-docs
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Install/Upgrade <code>zimbra-drive-ng</code> (NETWORK Only)'''
* As <code>root</code>, install the package:
 yum install zimbra-drive-ng
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Upgrade OpenLDAP on LDAP node for FOSS and NETWORK'''
* As <code>root</code>, install the package:
 yum install zimbra-ldap-components
* Restart <code>ldap</code> as <code>zimbra</code> user:
 su - zimbra
 ldap restart

=== Ubuntu ===
<span class="h2">Installing zimbra packages with system package upgrades</span>
* As <code>root</code>, check for updates so the server sees there is a new <code>zimbra-patch</code> package in the patch repository:
 apt-get update
* Then update available packages:
 apt-get upgrade
'''OR'''
* Update all available packages plus any kernel updates:
 apt-get dist-upgrade
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart

<span class="h2">Installing zimbra packages individually</span>

'''Install/Upgrade <code>zimbra-proxy-components</code> on Proxy node for FOSS and NETWORK'''
* As <code>root</code>, install package
 apt-get install zimbra-proxy-components
* Restart proxy as <code>zimbra</code> user:
 su - zimbra
 zmproxyctl restart

'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node for FOSS and NETWORK'''
* As <code>root</code>, install package
 apt-get install zimbra-proxy-patch
* Restart proxy as <code>zimbra</code> user:
 su - zimbra
 zmproxyctl restart
 zmmemcachedctl restart

Ubuntu 18 zimbra-proxy-patch version
 zimbra-proxy-patch        ->  8.8.12.1554984827.p3-1

''The installation of this patch is mandatory for the proxy to function on Ubuntu 18 servers.''

'''Install/Upgrade <code>zimbra-mta-components</code> on MTA node for FOSS and NETWORK'''
* As <code>root</code>, install package
 apt-get install zimbra-mta-components
* Restart <code>amavisd</code> as <code>zimbra</code> user:
 su - zimbra
 zmamavisdctl restart

'''Install/Upgrade <code>zimbra-mta-patch</code> on MTA node for FOSS and NETWORK'''
* As <code>root</code>, install package
 apt-get install zimbra-mta-patch
* Restart <code>amavisd</code> as <code>zimbra</code> user:
 su - zimbra
 zmamavisdctl restart

'''Install/Upgrade <code>zimbra-patch</code> on mailstore node for FOSS and NETWORK'''
* As <code>root</code>, check for updates and install package:
 apt-get update
 apt-get install zimbra-patch
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart

'''Install/Upgrade zimbra-chat for FOSS'''
* As <code>root</code>, install package:
 apt-get install zimbra-chat
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Uninstall <code>zimbra-talk</code> (NETWORK Only)'''

Starting Zimbra 8.8.15 GA, <code>zimbra-connect</code> replaces <code>zimbra-talk</code> hence it is important to remove <code>zimbra-talk</code> before installing <code>zimbra-connect</code>.
* As <code>root</code>, uninstall the package:
 apt-get remove zimbra-talk

'''Install/Upgrade zimbra-network-modules-ng, zimbra-connect and  zimbra-zimlet-auth (NETWORK Only)'''
* As <code>root</code>, check for updates and install packages:
 apt-get update
 apt-get install zimbra-network-modules-ng
 apt-get install zimbra-connect
 apt-get install zimbra-zimlet-auth
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Install/Upgrade zimbra-docs (NETWORK Only)'''
* As <code>root</code>, install package:
 apt-get install zimbra-docs
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Install/Upgrade zimbra-drive-ng (NETWORK Only)'''
* As <code>root</code>, install package:
 apt-get install zimbra-drive-ng
* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

'''Upgrade OpenLDAP on LDAP node for FOSS and NETWORK'''
* As <code>root</code>, install the package:
 apt-get install zimbra-ldap-components
* Restart <code>ldap</code> as <code>zimbra</code> user:
 su - zimbra
 ldap restart