Template:PatchInstallation-900: Difference between revisions
(Created page with "=Patch Installation= Please refer to the steps below to install {{{Version}}} on Redhat and Ubuntu platforms: <span class="h2">Before Installing the...") |
No edit summary |
||
(21 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 | * '''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 24: | 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 33: | ||
<span class="h2">'''Installing Zimbra packages individually'''</span> | <span class="h2">'''Installing Zimbra packages individually'''</span> | ||
'''Install/Upgrade <code>zimbra-proxy- | '''Upgrade OpenLDAP on LDAP node''' | ||
* 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-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: | * 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 clean metadata | ||
yum check-update | yum check-update | ||
* Then install the package: | * Then install the package: | ||
yum install zimbra-proxy- | yum install zimbra-proxy-patch | ||
* Restart proxy as <code>zimbra</code> user: | * Restart proxy as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
zmproxyctl restart | zmproxyctl restart | ||
zmmemcachedctl restart | |||
'''Install/Upgrade <code> | '''Install/Upgrade <code>snmp</code> if it is installed on Proxy node''' | ||
yum install zimbra-snmp-components | |||
yum install zimbra- | |||
* Restart proxy as <code>zimbra</code> user: | * Restart proxy as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
zmproxyctl restart | zmproxyctl restart | ||
'''Install/Upgrade <code>zimbra-mta-components</code> on MTA node''' | '''Install/Upgrade <code>zimbra-mta-components</code> on MTA node''' | ||
Line 56: | Line 63: | ||
* Then install the package: | * Then install the package: | ||
yum install zimbra-mta-components | yum install zimbra-mta-components | ||
* If <code>dnscache</code> is installed, upgrade the package before restarting the services: | |||
yum install zimbra-dnscache-components | |||
* 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: | * Restart <code>amavisd</code> as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
Line 69: | Line 80: | ||
'''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: | |||
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: | * Restart ZCS as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
zmcontrol restart | zmcontrol restart | ||
<span class="h2">'''Installing NG packages'''</span> | <span class="h2">'''Installing NG packages'''</span> | ||
Line 106: | Line 117: | ||
Note: - You can install the packages of your choice from the below list. | 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> on mailstore node | 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> on mailstore node | ||
yum install zimbra-zimlet-slack | yum install zimbra-zimlet-slack | ||
Line 118: | Line 129: | ||
yum install zimbra-zimlet-voice-message | yum install zimbra-zimlet-voice-message | ||
yum install zimbra-zimlet-sideloader | yum install zimbra-zimlet-sideloader | ||
yum install zimbra-zimlet-user-sessions-management | |||
* Restart Zimbra mailbox service as <code>zimbra</code> user: | * Restart Zimbra mailbox service as <code>zimbra</code> user: | ||
Line 127: | Line 139: | ||
* 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 136: | Line 150: | ||
<span class="h2">'''Installing zimbra packages individually'''</span> | <span class="h2">'''Installing zimbra packages individually'''</span> | ||
''' | '''Upgrade OpenLDAP on LDAP node''' | ||
* As <code>root</code>, install package | * As <code>root</code>, install the package: | ||
apt-get install zimbra- | apt-get install zimbra-ldap-patch | ||
* Restart | * Restart <code>ZCS</code> as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
zmcontrol restart | |||
'''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node''' | '''Install/Upgrade <code>zimbra-proxy-patch</code> on Proxy node''' | ||
Line 150: | Line 164: | ||
zmproxyctl restart | zmproxyctl restart | ||
zmmemcachedctl 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-mta-components</code> on MTA node''' | '''Install/Upgrade <code>zimbra-mta-components</code> on MTA node''' | ||
* As <code>root</code>, install package | * As <code>root</code>, install package | ||
apt-get install zimbra-mta-components | apt-get install zimbra-mta-components | ||
* If <code>dnscache</code> is installed, upgrade the package before restarting the services: | |||
apt-get install zimbra-dnscache-components | |||
* 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: | * Restart <code>amavisd</code> as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
Line 168: | Line 192: | ||
* 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: | |||
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: | * Restart ZCS as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
zmcontrol restart | zmcontrol restart | ||
<span class="h2">'''Installing NG packages'''</span> | <span class="h2">'''Installing NG packages'''</span> | ||
Line 208: | Line 233: | ||
Note: - You can install the packages of your choice from the below list. | 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> on mailstore node | 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> on mailstore node | ||
apt-get install zimbra-zimlet-slack | apt-get install zimbra-zimlet-slack | ||
Line 220: | Line 245: | ||
apt-get install zimbra-zimlet-voice-message | apt-get install zimbra-zimlet-voice-message | ||
apt-get install zimbra-zimlet-sideloader | apt-get install zimbra-zimlet-sideloader | ||
apt-get install zimbra-zimlet-user-sessions-management | |||
* Restart Zimbra mailbox service as <code>zimbra</code> user: | * Restart Zimbra mailbox service as <code>zimbra</code> user: | ||
su - zimbra | su - zimbra | ||
zmmailboxdctl restart | zmmailboxdctl restart |
Latest revision as of 18:48, 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 newzimbra-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
Upgrade OpenLDAP on LDAP node
- As
root
, install the package:
yum install zimbra-ldap-patch
- Restart
ZCS
aszimbra
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
- Then install the package:
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
aszimbra
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
aszimbra
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
Uninstall zimbra-talk
on mailstore node
In case of upgrade from version 8.8.15, uninstall zimbra-talk from mailstore node since it replaces with zimbra-connect. Hence, it is important to remove zimbra-talk
before installing zimbra-connect
.
- As
root
, uninstall the packagezimbra-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
Zimbra Additional Zimlets
Note: - You can install the packages of your choice from the below list.
Install/Upgrade zimbra-zimlet-slack
, zimbra-zimlet-zoom
, zimbra-zimlet-dropbox
, zimbra-zimlet-google-drive
, zimbra-zimlet-onedrive
, zimbra-zimlet-jitsi
, zimbra-zimlet-video-call-preferences
, zimbra-zimlet-nextcloud
, zimbra-zimlet-voice-message
, zimbra-zimlet-sideloader
, zimbra-zimlet-user-sessions-management
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
- 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 newzimbra-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
Upgrade OpenLDAP on LDAP node
- As
root
, install the package:
apt-get install zimbra-ldap-patch
- Restart
ZCS
aszimbra
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
dnscache
is installed, upgrade the package before restarting the services:
apt-get install zimbra-dnscache-components
- If
snmp
is installed, upgrade the package before restarting the services:
apt-get install zimbra-snmp-components
- Restart
amavisd
aszimbra
user:
su - zimbra zmamavisdctl restart
Install/Upgrade zimbra-mta-patch
on MTA node
- As
root
, install package
apt-get install zimbra-mta-patch
- Restart
amavisd
aszimbra
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
Uninstall zimbra-talk
on mailstore node
In case of upgrade from version 8.8.15, uninstall zimbra-talk from mailstore node since it replaces with zimbra-connect. Hence, it is important to remove zimbra-talk
before installing zimbra-connect
.
- As
root
, uninstall the packagezimbra-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
Zimbra Additional Zimlets
Note: - You can install the packages of your choice from the below list.
Install/Upgrade zimbra-zimlet-slack
, zimbra-zimlet-zoom
, zimbra-zimlet-dropbox
, zimbra-zimlet-google-drive
, zimbra-zimlet-onedrive
, zimbra-zimlet-jitsi
, zimbra-zimlet-video-call-preferences
, zimbra-zimlet-nextcloud
, zimbra-zimlet-voice-message
, zimbra-zimlet-sideloader
, zimbra-zimlet-user-sessions-management
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
- Restart Zimbra mailbox service as
zimbra
user:
su - zimbra zmmailboxdctl restart