OpenEBS Upgrades
important
The upgrade from OpenEBS 3.x to OpenEBS 4.x is supported only for the following storages installed from OpenEBS 3.x.
- Local PV Hostpath
- Local PV LVM
- Local PV ZFS
- Replicated PV Mayastor
Refer to the Migration documentation for other storages.
#
OverviewThis upgrade process allows you to upgrade to the latest OpenEBS version 4.3 which is a unified installer for three Local Storages (a.k.a Local Engines):
- Local PV HostPath
- Local PV LVM
- Local PV ZFS
and one Replicated Storage (a.k.a Replicated Engine):
- Replicated PV Mayastor
As a part of the upgrade to OpenEBS 4.3, the Helm chart will install all four engines regardless of the engine you used before the upgrade.
info
During the upgrade, if you are only interested in Local PV Storage, you can disable Replicated PV Mayastor by using the below option:
note
Downgrades are not supported.
#
Upgrade from 3.x to 4.3Follow these steps to upgrade OpenEBS from version 3.x to 4.3:
- Update the helm repository: The OpenEBS Helm chart repository URL has changed. The repository target URL needs to be updated.
Download the
kubectl openebs
binary from the OpenEBS Release repository on GitHub.Execute
kubectl openebs upgrade -n <namespace>
to upgrade OpenEBS.Monitor the upgrade status using
kubectl openebs get upgrade-status -n <namespace>
.Verify that the CRDs, Volumes, Snapshots, and StoragePools are not affected by the upgrade process.
caution
For upgrades from 3.x to 4.x, include the following option in the kubectl openebs upgrade command to ensure data consistency during the upgrade:
This option is not required for upgrades from 4.x to newer versions.
Add the option
--set mayastor.agents.core.rebuild.partial.enabled=false
if the source version is a 3.x release.
- Start the Replicated Storage upgrade process by using the kubectl mayastor plugin v2.8.0.
Re-enable the partial-rebuild feature after upgrade completes.
#
Upgrade from 4.x to 4.3Follow these steps to upgrade OpenEBS from version 4.x to 4.3:
Download the
kubectl openebs
binary from the OpenEBS Release repository on GitHub.Execute
kubectl openebs upgrade -n <namespace>
to upgrade OpenEBS.Monitor the upgrade status using
kubectl openebs get upgrade-status -n <namespace>
.Verify that the CRDs, Volumes, Snapshots, and StoragePools are not affected by the upgrade process.