System Upgrade

{"URL":["/*.*/awa/administration_zdu"],"heroDescriptionIdentifier":"ice_zdu_intro","customCards":[{"id":"ice_tls_considerations","title":"TLS/SSL Considerations for ZDU","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_toc_toplevel.htm","languages":["en-us"]},{"id":"ice_considerations_zdu","title":"Other Considerations for ZDU","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_toc_toplevel.htm","languages":["en-us"]},{"id":"ice_distributed_installation","title":"Distributed Installation for ZDU","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_toc_toplevel.htm","languages":["en-us"]},{"id":"ice_zdu_overview","title":"Overview of the ZDU Process","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_upgrade_proc.htm","languages":["en-us"]},{"id":"ice_prerequisites_zdu","title":"Prerequisites for ZDU","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_upgrade_proc.htm","languages":["en-us"]},{"id":"ice_upgrade_rollback","title":" ZDU Upgrade and Rollback","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_upgrade_proc.htm","languages":["en-us"]},{"id":"ice_upgradesteps_zdu","title":"Upgrade Steps","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_upgrade_proc.htm","languages":["en-us"]},{"id":"ice_rollbacksteps_zdu","title":"Rollback Steps","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_upgrade_proc.htm","languages":["en-us"]},{"id":"ice_faq_zdu","title":"ZDU FAQ","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_faq.htm","languages":["en-us"]},{"id":"ice_zduvideo","title":"Watch the Video","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Installation_Upgrade/install_zdu_Video.htm","languages":["en-us"]},{"id":"ice_administration_perspective","title":"Understanding the Administration Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Admin/AdministrationPerspective.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

As a system administrator, you use the Zero Downtime Upgrade (ZDU) wizard to upgrade your on-premises system from the Automic Web Interface. There is no need for scripting or use of AE internal components. It is available only in Client 0.

You can also use the Zero Downtime Upgrade when the alternative MS SQL Server schema is already in use. However, you cannot use it to switch to this schema. For more information, see Integrating an Alternative MS SQL Server Schema.

It is recommended to use a test environment before installing upgrades on your production system.

The Zero Downtime Upgrade allows you to carry out an upgrade between major or minor versions without shutting down the AE system. You can use this function to upgrade between almost all maintained versions.

Important!

ZDU is not supported for a first upgrade to an Automic Automation version that supports Unicode / UTF-8.

There are significant DB schema and AE message changes that cannot be supported in compatibility or rollback mode. Furthermore, the AE database UTF-8 migration process requires a downtime so that all data is migrated correctly. This step is relevant to avoid an encoding misalignment resulting in corrupted data.

ZDU for AAKE

As of version 24.3, it is also possible to perform a Zero Downtime Upgrade for AAKE instances. To do so, you need to explicitly set the ZDU option in the values.yaml file as follows:

labels:
  features.aa-install-operator/upgrade-mode: zdu

In that case, the install operator handles the Helm upgrade without any downtime. AWI displays the message "System upgrade is in progress." while the ZDU Helm upgrade is in progress, thus signalizing all Users that a system upgrade is ongoing.

For more information, see Container-Based System Upgrade - Automic Automation Kubernetes Edition.