OpenEBS Replicated PV Mayastor Upgrades
This is the documentation for the development version of OpenEBS.
See the latest version (4.3.x) to view the latest documentation.
#
Upgrading Replicated PV MayastorReplicated PV Mayastor supports seamless upgrades starting with target version 2.1.0 and later, and source versions 2.0.0 and later. To upgrade from a previous version (1.0.5 or prior) to 2.1.0 or later, visit Legacy Upgrade Support.
#
Supported Upgrade Paths- From 2.0.x and newer (2.0.x, 2.1.x, 2.2.x, etc.)
- To 2.1.0 and newer (2.1.x, 2.2.x, 2.3.x, etc.)
- It is possible to upgrade to the same version with different configuration (using
--set
options, etc.) in 2.7.2 and newer versions.
info
- Only upgrades are supported.Downgrading to earlier versions is not supported.
- The upgrade operation utilises the Kubectl mayastor Plugin. Ensure you have the appropriate Kubectl Plugin installed, Use the kubectl plugin version that matches your target Mayastor version.
- If Replicated PV Mayastor was installed using the
mayastor/mayastor
Helm chart, use thekubectl mayastor
plugin for upgrades. - If Replicated PV Mayastor was installed using the
openebs/openebs
Helm chart, refer to the OpenEBS upgrade documentation. - Volumes with single replica will be unavailable temporarily during upgrade.
- The upgrade process is generally non-disruptive for volumes with a replication factor greater than one however verify that all replicas are healthy prior to upgrade
To upgrade Replicated PV Mayastor deployment on the Kubernetes cluster, execute:
Command
To view all the available options and sub-commands that can be used with the upgrade command, execute:
Command
Expected Output
To view the status of upgrade, execute:
Command
Expected Output
To view the logs of upgrade job, execute:
Command
info
- The time taken to upgrade is directly proportional to the number of IO engine nodes and storage volumes.
- To upgrade to a particular Replicated PV Mayastor version, ensure you are using the same version of kubectl plugin.
- The above process of upgrade creates one Job in the namespace where Replicated PV Mayastor is installed, one ClusterRole, one ClusterRoleBinding and one ServiceAccount.