Semantic Versioning#
MSR uses semantic versioning (SemVer)
in the form MAJOR.MINOR.PATCH. Understanding the version scheme helps you plan
a safe upgrade path and avoid unsupported configurations.
Upgrade rules#
Downgrades are not supported. The following rules apply to upgrades:
| Version type | Rule |
|---|---|
| Patch | You can skip patch versions. No data migration takes place between patch versions of the same minor release. |
| Minor | You cannot skip minor releases. Upgrade sequentially through each minor version. You can start from any patch level of a given minor release. |
| Major | Upgrade one major version at a time. |
Supported upgrade paths#
| Scenario | Example | Supported | Notes |
|---|---|---|---|
| Patch upgrade (sequential) | 4.13.0 → 4.13.1 | Yes | No data migration between patches |
| Patch upgrade (skip) | 4.13.0 → 4.13.3 | Yes | Patch versions can be skipped |
| Minor upgrade (sequential) | 4.0.x → 4.13.x | Yes | Any patch of source to any patch of target |
| Patch downgrade | 4.13.2 → 4.13.0 | No | Downgrades are not supported |
| Minor downgrade | 4.13.x → 4.0.x | No | Downgrades are not supported |