Difference between revisions of "Template:PatchInstallation-8815V2"

(Patch Installation)
 
(12 intermediate revisions by the same user not shown)
Line 10: Line 10:
 
* Switch to <code>zimbra</code> user before using ZCS CLI commands.
 
* 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!''' You cannot revert to the previous ZCS release after you upgrade to the patch.
 +
* '''Important!''' Please note that the install process has changed. Additional steps to install '''zimbra-common-core-jar, zimbra-common-core-libs, zimbra-mbox-store-libs''' packages have been included for this patch release. Please refer to the '''[[#Patch Installation|Patch Installation]]''' section to install the packages in its order.
  
 
=={{{Version}}} Packages==
 
=={{{Version}}} Packages==
Line 22: Line 23:
 
  yum clean metadata
 
  yum clean metadata
 
  yum check-update
 
  yum check-update
 +
* On mailstore node, install the following packages:
 +
yum install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
 
* Then ask yum to update available packages:
 
* Then ask yum to update available packages:
 
  yum update
 
  yum update
Line 32: Line 35:
 
'''Upgrade OpenLDAP on LDAP node'''
 
'''Upgrade OpenLDAP on LDAP node'''
 
* As <code>root</code>, install the package:
 
* As <code>root</code>, install the package:
  yum install zimbra-ldap-components
+
  yum install zimbra-ldap-patch
* Restart <code>ldap</code> as <code>zimbra</code> user:
+
* Restart <code>ZCS</code> as <code>zimbra</code> user:
 
  su - zimbra
 
  su - zimbra
  ldap restart
+
  zmcontrol restart
  
 
'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node'''
 
'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node'''
* As <code>root</code>, install the package:
+
* 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
 
  yum install zimbra-proxy-patch
 
  yum install zimbra-proxy-patch
 
* Restart proxy as <code>zimbra</code> user:
 
* Restart proxy as <code>zimbra</code> user:
Line 45: Line 50:
 
  zmmemcachedctl restart
 
  zmmemcachedctl restart
  
'''Install/Upgrade <code>zimbra-proxy-components</code> on Proxy node'''
+
'''Install/Upgrade <code>snmp</code> if it is installed 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-components
 
* If <code>snmp</code> is installed, upgrade the package before restarting the services:
 
 
  yum install zimbra-snmp-components
 
  yum install zimbra-snmp-components
 
* Restart proxy as <code>zimbra</code> user:
 
* Restart proxy as <code>zimbra</code> user:
Line 80: Line 79:
 
'''Install/Upgrade <code>zimbra-patch</code> on mailstore node'''
 
'''Install/Upgrade <code>zimbra-patch</code> on mailstore node'''
 
* As <code>root</code>, install the package:
 
* As <code>root</code>, install the package:
 +
yum install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
 
  yum install zimbra-patch
 
  yum install zimbra-patch
 
* If <code>apache</code> is installed, upgrade the package before restarting the services:
 
* If <code>apache</code> is installed, upgrade the package before restarting the services:
Line 123: Line 123:
 
* As <code>root</code>, check for updates so the server checks there is a new <code>zimbra-patch</code> package in the patch repository:
 
* 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
 
  apt-get update
 +
* On mailstore node, install the following packages:
 +
apt-get install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
 
* Then update available packages:
 
* Then update available packages:
 
  apt-get upgrade
 
  apt-get upgrade
Line 134: Line 136:
 
'''Upgrade OpenLDAP on LDAP node'''
 
'''Upgrade OpenLDAP on LDAP node'''
 
* As <code>root</code>, install the package:
 
* As <code>root</code>, install the package:
  apt-get install zimbra-ldap-components
+
  apt-get install zimbra-ldap-patch
* Restart <code>ldap</code> as <code>zimbra</code> user:
+
* Restart <code>ZCS</code> as <code>zimbra</code> user:
 
  su - zimbra
 
  su - zimbra
  ldap restart
+
  zmcontrol restart
  
 
'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node'''
 
'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node'''
Line 147: Line 149:
 
  zmmemcachedctl restart
 
  zmmemcachedctl restart
  
'''Install/Upgrade <code>zimbra-proxy-components</code> on Proxy node'''
+
'''Install/Upgrade <code>snmp</code> if it is installed on Proxy node'''
* As <code>root</code>, install package
 
apt-get install zimbra-proxy-components
 
* If <code>snmp</code> is installed, upgrade the package before restarting the services:
 
 
  apt-get install zimbra-snmp-components
 
  apt-get install zimbra-snmp-components
 
* Restart proxy as <code>zimbra</code> user:
 
* Restart proxy as <code>zimbra</code> user:
Line 177: Line 176:
 
* As <code>root</code>, check for updates and install package:
 
* As <code>root</code>, check for updates and install package:
 
  apt-get update
 
  apt-get update
 +
apt-get install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
 
  apt-get install zimbra-patch
 
  apt-get install zimbra-patch
 
* If <code>apache</code> is installed, upgrade the package before restarting the services:
 
* If <code>apache</code> is installed, upgrade the package before restarting the services:

Latest revision as of 18:50, 17 June 2022

Patch Installation

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

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 zimbra user before using ZCS CLI commands.
  • Important! You cannot revert to the previous ZCS release after you upgrade to the patch.
  • Important! Please note that the install process has changed. Additional steps to install zimbra-common-core-jar, zimbra-common-core-libs, zimbra-mbox-store-libs packages have been included for this patch release. Please refer to the Patch Installation section to install the packages in its order.

{{{Version}}} Packages

The package lineup for this release is:

{{{Packages}}}

Redhat

Installing Zimbra packages with system package upgrades

  • As root, first clear the yum cache and check for updates so the server sees there is a new zimbra-patch package in the patch repository:
yum clean metadata
yum check-update
  • On mailstore node, install the following packages:
yum install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
  • Then ask yum to update available packages:
yum update
  • Restart ZCS as zimbra user:
su - zimbra
zmcontrol restart

Installing Zimbra packages individually for NETWORK and FOSS

Upgrade OpenLDAP on LDAP node

  • As root, install the package:
yum install zimbra-ldap-patch
  • Restart ZCS as zimbra user:
su - zimbra
zmcontrol restart

Install/Upgrade zimbra-proxy-patch on Proxy node

  • As root, 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
yum install zimbra-proxy-patch
  • Restart proxy as zimbra user:
su - zimbra
zmproxyctl restart
zmmemcachedctl restart

Install/Upgrade snmp if it is installed on Proxy node

yum install zimbra-snmp-components
  • Restart proxy as zimbra user:
su - zimbra
zmproxyctl restart

Install/Upgrade zimbra-mta-components on MTA node

  • As root, 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
  • If dnscache is installed, upgrade the package before restarting the services:
yum install zimbra-dnscache-components
  • If snmp is installed, upgrade the package before restarting the services:
yum install zimbra-snmp-components
  • Restart amavisd as zimbra user:
su - zimbra
zmamavisdctl restart

Install/Upgrade zimbra-mta-patch on MTA node

  • As root, install the package:
yum install zimbra-mta-patch
  • Restart amavisd as zimbra user:
su - zimbra
zmamavisdctl restart

Install/Upgrade zimbra-patch on mailstore node

  • As root, install the package:
yum install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
yum install zimbra-patch
  • If apache is installed, upgrade the package before restarting the services:
yum install zimbra-apache-components
  • If spell is installed, upgrade the package before restarting the services:
yum install zimbra-spell-components
  • If snmp is installed, upgrade the package before restarting the services:
yum install zimbra-snmp-components
  • Restart ZCS as zimbra user:
su - zimbra
zmcontrol restart


Installing NG packages (NETWORK Only)

Uninstall zimbra-talk on mailstore node

Starting Zimbra 8.8.15 GA, zimbra-connect replaces zimbra-talk. Hence, it is important to remove zimbra-talk before installing zimbra-connect.

  • As root, uninstall the package zimbra-talk:
yum remove zimbra-talk

Install/Upgrade zimbra-network-modules-ng, zimbra-connect, zimbra-zimlet-auth, zimbra-docs and zimbra-drive-ng on mailstore node

yum install zimbra-network-modules-ng
yum install zimbra-connect
yum install zimbra-zimlet-auth
yum install zimbra-docs
yum install zimbra-drive-ng
  • Restart Zimbra mailbox service as zimbra user:
su - zimbra
zmmailboxdctl restart

Install/Upgrade zimbra-chat for FOSS

  • As root, install the package:
yum install zimbra-chat
  • Restart Zimbra mailbox service as zimbra user:
su - zimbra
zmmailboxdctl restart

Ubuntu

Installing zimbra packages with system package upgrades

  • As root, check for updates so the server checks there is a new zimbra-patch package in the patch repository:
apt-get update
  • On mailstore node, install the following packages:
apt-get install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
  • Then update available packages:
apt-get upgrade
  • Restart ZCS as zimbra user:
su - zimbra
zmcontrol restart

Installing zimbra packages individually for NETWORK and FOSS

Upgrade OpenLDAP on LDAP node

  • As root, install the package:
apt-get install zimbra-ldap-patch
  • Restart ZCS as zimbra user:
su - zimbra
zmcontrol restart

Install/Upgrade zimbra-proxy-patch on Proxy node

  • As root, install package
apt-get install zimbra-proxy-patch
  • Restart proxy as zimbra user:
su - zimbra
zmproxyctl restart
zmmemcachedctl restart

Install/Upgrade snmp if it is installed on Proxy node

apt-get install zimbra-snmp-components
  • Restart proxy as zimbra user:
su - zimbra
zmproxyctl restart

Install/Upgrade zimbra-mta-components on MTA node

  • As root, install package
apt-get install zimbra-mta-components
  • If snmp is installed, upgrade the package before restarting the services:
apt-get install zimbra-snmp-components
  • Restart amavisd as zimbra user:
su - zimbra
zmamavisdctl restart

Install/Upgrade zimbra-mta-patch on MTA node

  • As root, install package
apt-get install zimbra-mta-patch
  • If dnscache is installed, upgrade the package before restarting the services:
apt-get install zimbra-dnscache-components
  • Restart amavisd as zimbra user:
su - zimbra
zmamavisdctl restart

Install/Upgrade zimbra-patch on mailstore node

  • As root, check for updates and install package:
apt-get update
apt-get install zimbra-common-core-jar zimbra-common-core-libs zimbra-mbox-store-libs
apt-get install zimbra-patch
  • If apache is installed, upgrade the package before restarting the services:
apt-get install zimbra-apache-components
  • If spell is installed, upgrade the package before restarting the services:
apt-get install zimbra-spell-components
  • If snmp is installed, upgrade the package before restarting the services:
apt-get install zimbra-snmp-components
  • Restart ZCS as zimbra user:
su - zimbra
zmcontrol restart


Installing NG packages (NETWORK Only)

Uninstall zimbra-talk on mailstore node

Starting Zimbra 8.8.15 GA, zimbra-connect replaces zimbra-talk. Hence, it is important to remove zimbra-talk before installing zimbra-connect.

  • As root, uninstall the package zimbra-talk:
apt-get remove zimbra-talk

Install/Upgrade zimbra-network-modules-ng, zimbra-connect, zimbra-zimlet-auth, zimbra-docs, zimbra-drive-ng on mailstore node

  • As root, 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
apt-get install zimbra-docs
apt-get install zimbra-drive-ng
  • Restart Zimbra mailbox service as zimbra user:
su - zimbra
zmmailboxdctl restart

Install/Upgrade zimbra-chat for FOSS

  • As root, install package:
apt-get install zimbra-chat
  • Restart Zimbra mailbox service as zimbra user:
su - zimbra
zmmailboxdctl restart
Jump to: navigation, search