Skip to content

Commit

Permalink
resolve comments
Browse files Browse the repository at this point in the history
  • Loading branch information
christinaausley committed Jul 26, 2024
1 parent 851c92d commit 387ef7c
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 14 deletions.
10 changes: 3 additions & 7 deletions docs/self-managed/zeebe-deployment/operations/update-zeebe.md
Original file line number Diff line number Diff line change
Expand Up @@ -160,11 +160,11 @@ Because the update is no longer rolling and all brokers are shut down at the sam
If updated brokers log the error message `Failed to install partition` and do not become healthy, look for more details to understand if this is caused by the rolling update.

If the error is caused by `Cannot upgrade to or from a pre-release version`, Zeebe detected that either the version you started from or the version you updated to is a pre-release version.

This is not permitted because pre-release versions such as alpha releases are considered unstable and do not guarantee compatibility with any other version.
If you attempted to update from a normal version to a pre-release version, you can roll back to the previous normal version.

:::note
While in most instances version rollbacks are not supported, in this particular use case a version rollback is possible.
If you attempted to update from a minor release to a pre-release or alpha version, it is possible to roll back to the previous version of Zeebe. Note that version rollbacks are not supported in most other instances.
:::

If the log message includes `Snapshot is not compatible with current version`, the rolling update failed and manual recovery is required.
Expand Down Expand Up @@ -196,11 +196,7 @@ In that case, it is caused by updated brokers sharing snapshots with not yet upd
This should resolve automatically once the broker is updated.
:::

If this persists, you may want to [force the update](#rolling-update-is-not-completing).

:::note
In this specific case, a rollback is possible because users may restart Zeebe with the "skipped" minor version. [Backup and restore](/self-managed/operational-guides/backup-restore/backup-and-restore.md) is possible, but results in partial data loss of everything following the backup. Therefore, a rollback is preferable in this use case.
:::
If this persists, you can [force the update](#rolling-update-is-not-completing). Alternatively, it is possible to restart Zeebe with the "skipped" minor version. Note that version rollbacks are not supported in most other instances.

## Offline update

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -160,11 +160,11 @@ Because the update is no longer rolling and all brokers are shut down at the sam
If updated brokers log the error message `Failed to install partition` and do not become healthy, look for more details to understand if this is caused by the rolling update.

If the error is caused by `Cannot upgrade to or from a pre-release version`, Zeebe detected that either the version you started from or the version you updated to is a pre-release version.

This is not permitted because pre-release versions such as alpha releases are considered unstable and do not guarantee compatibility with any other version.
If you attempted to update from a normal version to a pre-release version, you can roll back to the previous normal version.

:::note
While in most instances version rollbacks are not supported, in this particular use case a version rollback is possible.
If you attempted to update from a minor release to a pre-release or alpha version, it is possible to roll back to the previous version of Zeebe. Note that version rollbacks are not supported in most other instances.
:::

If the log message includes `Snapshot is not compatible with current version`, the rolling update failed and manual recovery is required.
Expand Down Expand Up @@ -196,11 +196,7 @@ In that case, it is caused by updated brokers sharing snapshots with not yet upd
This should resolve automatically once the broker is updated.
:::

If this persists, you may want to [force the update](#rolling-update-is-not-completing).

:::note
In this specific case, a rollback is possible because users may restart Zeebe with the "skipped" minor version. [Backup and restore](/self-managed/operational-guides/backup-restore/backup-and-restore.md) is possible, but results in partial data loss of everything following the backup. Therefore, a rollback is preferable in this use case.
:::
If this persists, you can [force the update](#rolling-update-is-not-completing). Alternatively, it is possible to restart Zeebe with the "skipped" minor version. Note that version rollbacks are not supported in most other instances.

## Offline update

Expand Down

0 comments on commit 387ef7c

Please sign in to comment.