Article number
000004463
Affected Versions
All
Source Hypervisor
VMware
Target Hypervisor
VMware

Common Issues and Questions Encountered When Upgrading Zerto Virtual Replication (ZVR) VMware

Viewed 456 times

Summary

  The following article will include known issues when upgrading Zerto.

For Upgrade Prerequizts and Frequently asked Questions please review the following KB - ZVM Upgrade Best Practices.

Symptoms

  • After Upgrading ZVR To Version 8.0, Sites Become Disconnected
  • Upgrade fails with error
    1. ''Register vCenter plugin failed, failed to unregister plugin''
    2. "MSI error code 2147024546 - Zerto upgrade failed with Configuration Engine Failed to apply" 
    3. "You are trying to upgrade from version X to version Y but the following peer sites are running with a version that is not compatible with the new version"
    4. "ZVM peer API version checker - You cannot upgrade until ZVM has finished all his clean-up tasks. Upgrade canceled"
    5. "Not All VRAs are compatible"
    6. "You Are Trying To Upgrade To An Incompatible Product Type"

Solution

** Zerto has created a Zerto Quick Bit video series to assist users in preparing to upgrade Zerto Virtual Replication (ZVR) to version 8.0. ** 

Connectivity issues 

ZVM to ZVM communication changes in Zerto (ZVR) 8.0 from port 9081 to 9071. Should the sites become disconnected during the upgrade, follow article: After Upgrading ZVR To Version 8.0, Sites Become Disconnected

Insufficient user permissions

If the user which is configured in the ZVM does not have sufficient permission, or if the credentials are no longer valid, the following error will appear " ZVM Upgrade Fails with error - Register VCenter plug-in Failed to un register plug-in". In order to resolve the issue, simply navigate to the Zerto Diagnostic Utility and re-enter the credentials. For more information, review ZVM Upgrade Fails with error - Register VCenter plug-in Failed to un register plug-in.  

Stale / Stuck task in Vcenter 

At times there could be stuck/stale tasks in vCenter which will fail the upgrade. For more information please review the following KB -  ZVM upgrade in VMware fails with error configuration engine failed to apply.

Incompatible installer type

As Zerto supports multiple Hypervisor, there could be times when the newly downloaded installer is not the same as the one in use. For example, you are running Zerto 7.5 for VMware and you accidentally download Zerto 8.0 for Azure. For more information please review the following KB -  ZVM upgrade fails with error - "You Are Trying To Upgrade To An Incompatible Product Type.

Undo logs and Clean up tasks are preventing the upgrade 

If there are stale logs in the Zerto database that have not been cleared out, the upgrade will fail. For more information please review the following KB - ZVM Upgrade failed with error - You cannot upgrade until ZVM has finished all his clean up takes/ Upgrade canceledUndo logs show pending tasks.

Compatibility 

You can upgrade from version N to the following version (N+1) of Zerto Virtual Replication (including any update within the current version). One cannot do an N+2 upgrade directly. For example, the upgrade is supported for Zerto version 7.5Ux to 8.0Ux. 
  1. Using the above example, if you have two sites - Site A is running 7.5 and Site b is running 8.0, if you try to upgrade site B first, the upgrade will fail with the error "You are trying to upgrade from version X to version Y but the following peer sites are running with a version that is not compatible with the new version" as the sites can't be more than one major version apart. This also applies to CSPs and all of their paired sites. For more information about this, review the following KB - ZVM Upgrade Best Practices.
  2. This also applies for both the local and paired VRAs as they can't run more than one major version apart and the upgrade will fail with error Not All VRAs are compatible. Please review the following KB for more details - ZVM upgrade Failed with error - Not All VRAs are compatible.