From 53baba98dc8caf7146d5731055da177663e821fd Mon Sep 17 00:00:00 2001 From: Pavel Tcholakov Date: Fri, 6 Sep 2024 15:51:25 +0200 Subject: [PATCH] Update docs/operate/upgrading.mdx Co-authored-by: Jack Kleeman --- docs/operate/upgrading.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/operate/upgrading.mdx b/docs/operate/upgrading.mdx index e6d70474..79392441 100644 --- a/docs/operate/upgrading.mdx +++ b/docs/operate/upgrading.mdx @@ -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