View source for Zimbra Releases/10.0.0/patch installation

= Zimbra Collaboration Daffodil 10.0.x Patch Installation =

Please refer to the steps below to install Daffodil 10.0.x on [[#Redhat|Redhat]] and [[#Ubuntu|Ubuntu]] platforms:

<span class="h2">Before Installing the Patch, consider the following:</span>
* 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.
* Any third-party configuration changes like SAML will get overwritten during the patch upgrade and should be backed up before starting the patch upgrade process. 
* '''Important!''' You cannot revert to the previous ZCS release after you upgrade to the patch.


==Redhat==

<span class="h2">'''Installing Zimbra packages with system package upgrades'''</span>
* Please follow the below steps on all ZCS servers with the following server sequence: LDAP server(s), MTA server(s), Proxy server(s), and Mailbox server(s).
* 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
* On mailstore node, install the following package (Skip this step if the mailstore server is already updated to Patch 10.0.6):
 yum install zimbra-core-components
* 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-ldap-patch</code> on LDAP node'''
* As <code>root</code>, first clear the yum cache and check for updates so the server sees there is a new <code>zimbra-ldap-patch</code> package in the patch repository:
 yum clean metadata
 yum check-update
* As <code>root</code>, install the package:
 yum install zimbra-ldap-patch
* Restart <code>ZCS</code> as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart


'''Install/Upgrade <code>zimbra-mta-patch</code> on MTA node'''
* As <code>root</code>, first clear the yum cache and check for updates so the server sees there is a new <code>zimbra-mta-patch</code> package in the patch repository:
 yum clean metadata
 yum check-update
* 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-dnscache-components</code> on MTA node'''
* If <code>dnscache</code> is installed, upgrade the package before restarting the services:
 yum install zimbra-dnscache-components

'''Install/Upgrade <code>zimbra-snmp-components</code> on MTA node'''
* If <code>snmp</code> is installed, upgrade the package before restarting the services:
 yum install zimbra-snmp-components
* Restart <code>amavisd</code> as <code>zimbra</code> user:
 su - zimbra
 zmamavisdctl restart


'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node'''
* 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-patch
* Restart proxy as <code>zimbra</code> user:
 su - zimbra
 zmproxyctl restart
 zmmemcachedctl restart

'''Install/Upgrade <code>snmp</code> if it is installed on Proxy node'''
 yum install zimbra-snmp-components
* Restart proxy as <code>zimbra</code> user:
 su - zimbra
 zmproxyctl restart


'''Install/Upgrade <code>zimbra-patch</code> on mailstore node'''
* 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
* As <code>root</code>, install the package:
 yum install zimbra-patch
* If <code>apache</code> is installed, upgrade the package before restarting the services:
 yum install zimbra-apache-components
* If <code>spell</code> is installed, upgrade the package before restarting the services:
 yum install zimbra-spell-components
* If <code>snmp</code> is installed, upgrade the package before restarting the services:
 yum install zimbra-snmp-components
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart


'''Install/Upgrade <code>zimbra-onlyoffice-patch</code> (if Onlyoffice is installed already)'''
* As <code>root</code>, install the package
 yum install zimbra-onlyoffice-patch
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart


<span class="h2">'''Zimbra Additional Zimlets'''</span>

Note: - You can install the packages of your choice from the below list.

Install/Upgrade <code>zimbra-zimlet-slack</code>, <code>zimbra-zimlet-zoom</code>, <code>zimbra-zimlet-dropbox</code>, <code>zimbra-zimlet-google-drive</code>, <code>zimbra-zimlet-onedrive</code>, <code>zimbra-zimlet-jitsi</code>, <code>zimbra-zimlet-video-call-preferences</code>, <code>zimbra-zimlet-nextcloud</code>, <code>zimbra-zimlet-voice-message</code>, <code>zimbra-zimlet-sideloader</code>, <code>zimbra-zimlet-user-sessions-management</code>, <code>zimbra-zimlet-org-chart</code>, <code>zimbra-zimlet-privacy-protector</code> on mailstore node

 yum install zimbra-zimlet-slack
 yum install zimbra-zimlet-zoom
 yum install zimbra-zimlet-dropbox
 yum install zimbra-zimlet-google-drive
 yum install zimbra-zimlet-onedrive
 yum install zimbra-zimlet-jitsi
 yum install zimbra-zimlet-video-call-preferences
 yum install zimbra-zimlet-nextcloud
 yum install zimbra-zimlet-voice-message
 yum install zimbra-zimlet-sideloader
 yum install zimbra-zimlet-user-sessions-management
 yum install zimbra-zimlet-org-chart
 yum install zimbra-zimlet-privacy-protector

* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart

== Ubuntu ==
<span class="h2">'''Installing zimbra packages with system package upgrades'''</span>
* Please follow the below steps on all ZCS servers with the following server sequence: LDAP server(s), MTA server(s), Proxy server(s), and Mailbox server(s).
* As <code>root</code>, check for updates so the server checks there is a new <code>zimbra-patch</code> package in the patch repository:
 apt-get update
* On mailstore node, install the following package (Skip this step if the mailstore server is already updated to Patch 10.0.6):
 apt-get install zimbra-core-components
* Then update available packages:
 apt-get upgrade
* Upgrade <code>zimbra-patch</code> on mailstore node if it is not upgraded with apt-get upgrade
 apt-get install zimbra-patch

* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart

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

'''Install/Upgrade <code>zimbra-ldap-patch</code> on LDAP node'''
* As <code>root</code>, install the package:
 apt-get install zimbra-ldap-patch
* Restart <code>ZCS</code> as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart


'''Install/Upgrade <code>zimbra-mta-patch</code> on MTA node'''
* 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-dnscache-components</code> on MTA node'''
* If <code>dnscache</code> is installed, upgrade the package before restarting the services:
 apt-get install zimbra-dnscache-components

'''Install/Upgrade <code>zimbra-snmp-components</code> on MTA node'''
* If <code>snmp</code> is installed, upgrade the package before restarting the services:
 apt-get install zimbra-snmp-components
* Restart <code>amavisd</code> as <code>zimbra</code> user:
 su - zimbra
 zmamavisdctl restart


'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node'''
* 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

'''Install/Upgrade <code>snmp</code> if it is installed on Proxy node'''
 apt-get install zimbra-snmp-components
* Restart proxy as <code>zimbra</code> user:
 su - zimbra
 zmproxyctl restart


'''Install/Upgrade <code>zimbra-patch</code> on mailstore node'''
* As <code>root</code>, check for updates and install package:
 apt-get update
 apt-get install zimbra-patch
* If <code>apache</code> is installed, upgrade the package before restarting the services:
 apt-get install zimbra-apache-components
* If <code>spell</code> is installed, upgrade the package before restarting the services:
 apt-get install zimbra-spell-components
* If <code>snmp</code> is installed, upgrade the package before restarting the services:
 apt-get install zimbra-snmp-components
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart


'''Upgrade <code>zimbra-onlyoffice-patch</code> (if Onlyoffice is installed already)'''
* As <code>root</code>, install the package
 apt-get install zimbra-onlyoffice-patch
* Restart ZCS as <code>zimbra</code> user:
 su - zimbra
 zmcontrol restart

<span class="h2">'''Zimbra Additional Zimlets'''</span>

Note: - You can install the packages of your choice from the below list.

Install/Upgrade <code>zimbra-zimlet-slack</code>, <code>zimbra-zimlet-zoom</code>, <code>zimbra-zimlet-dropbox</code>, <code>zimbra-zimlet-google-drive</code>, <code>zimbra-zimlet-onedrive</code>, <code>zimbra-zimlet-jitsi</code>, <code>zimbra-zimlet-video-call-preferences</code>, <code>zimbra-zimlet-nextcloud</code>, <code>zimbra-zimlet-voice-message</code>, <code>zimbra-zimlet-sideloader</code>, <code>zimbra-zimlet-user-sessions-management</code>, <code>zimbra-zimlet-org-chart</code>, <code>zimbra-zimlet-privacy-protector</code> on mailstore node

 apt-get install zimbra-zimlet-slack
 apt-get install zimbra-zimlet-zoom
 apt-get install zimbra-zimlet-dropbox
 apt-get install zimbra-zimlet-google-drive
 apt-get install zimbra-zimlet-onedrive
 apt-get install zimbra-zimlet-jitsi
 apt-get install zimbra-zimlet-video-call-preferences
 apt-get install zimbra-zimlet-nextcloud
 apt-get install zimbra-zimlet-voice-message
 apt-get install zimbra-zimlet-sideloader
 apt-get install zimbra-zimlet-user-sessions-management
 apt-get install zimbra-zimlet-org-chart
 apt-get install zimbra-zimlet-privacy-protector

* Restart Zimbra mailbox service as <code>zimbra</code> user:
 su - zimbra
 zmmailboxdctl restart