Skip to content

Commit

Permalink
Update docs/operate/upgrading.mdx
Browse files Browse the repository at this point in the history
Co-authored-by: Jack Kleeman <[email protected]>
  • Loading branch information
pcholakov and jackkleeman authored Sep 6, 2024
1 parent d1d0339 commit 53baba9
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion docs/operate/upgrading.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Upgrading to the latest patch version should always be possible and is recommend

Incremental minor version upgrades will retain functional compatibility with the immediate prior version. That is, for any minor version update, you will be able to upgrade from `x.y` to `x.(y+1)` while retaining all persisted data and metadata. You must not skip minor version upgrades, i.e. go directly from `x.y` to `x.(y+2)`, as it may bypass necessary data store migrations required for preserving forward compatibility.

We recognize that unexpected compatibility issues may arise. For this reason, you can also downgrade a Restate installation to the latest patch level of the previous minor version. For example, you can safely rollback the Restate server versionf rom `x.(y).0` to `x.(y-1).z` if you encounter compatibility issues. However, this rollback is only supported if you have not used any new opt-in features exclusive to the newer version. You cannot downgrade more than one minor version behind the most recent version used with the data store using this approach.
If you encounter any issues with a new version, you can downgrade a Restate installation to the latest patch level of the previous minor version. For example, you can safely rollback the Restate server version from `x.(y).0` to `x.(y-1).z` if you encounter compatibility issues. However, this rollback is only supported if you have not used any new opt-in features exclusive to the newer version. You cannot downgrade more than one minor version behind the most recent version used with the data store using this approach.

## Service compatibility

Expand Down

0 comments on commit 53baba9

Please sign in to comment.