From 45adef1ff4bcc3ca4cc8b01c4b979e55e5c9bab3 Mon Sep 17 00:00:00 2001 From: Rinku Kothiya Date: Wed, 13 Jan 2021 09:22:10 +0000 Subject: [PATCH] Added release notes and upgrade guide for 9.0 Signed-off-by: Rinku Kothiya --- docs/Upgrade-Guide/README.md | 6 + docs/Upgrade-Guide/upgrade-to-9.md | 50 ++++++ docs/release-notes/9.0.md | 263 +++++++++++++++++++++++++++++ docs/release-notes/index.md | 4 + mkdocs.yml | 3 + 5 files changed, 326 insertions(+) create mode 100644 docs/Upgrade-Guide/upgrade-to-9.md create mode 100644 docs/release-notes/9.0.md diff --git a/docs/Upgrade-Guide/README.md b/docs/Upgrade-Guide/README.md index daf09c1..bd4cdb6 100644 --- a/docs/Upgrade-Guide/README.md +++ b/docs/Upgrade-Guide/README.md @@ -2,6 +2,12 @@ Upgrading GlusterFS ------------------- - [About op-version](./op-version.md) +If you are using GlusterFS version 6.x or above, you can upgrade it to the following: + +- [Upgrading to 9](./upgrade-to-9.md) +- [Upgrading to 8](./upgrade-to-8.md) +- [Upgrading to 7](./upgrade-to-7.md) + If you are using GlusterFS version 5.x or above, you can upgrade it to the following: - [Upgrading to 8](./upgrade-to-8.md) diff --git a/docs/Upgrade-Guide/upgrade-to-9.md b/docs/Upgrade-Guide/upgrade-to-9.md new file mode 100644 index 0000000..8fc3198 --- /dev/null +++ b/docs/Upgrade-Guide/upgrade-to-9.md @@ -0,0 +1,50 @@ +# Upgrade procedure to Gluster 9, from Gluster 8.x, 7.x and 6.x + +We recommend reading the [release notes for 9.0](../release-notes/9.0.md) to be +aware of the features and fixes provided with the release. + +> **NOTE:** Before following the generic upgrade procedure checkout the "**Major Issues**" section given below. + +Refer, to the [generic upgrade procedure](./generic-upgrade-procedure.md) guide and follow documented instructions. + +## Major issues + +### The following options are removed from the code base and require to be unset +before an upgrade from releases older than release 4.1.0, + + - features.lock-heal + - features.grace-timeout + +To check if these options are set use, + +```console +# gluster volume info +``` + +and ensure that the above options are not part of the `Options Reconfigured:` +section in the output of all volumes in the cluster. + +If these are set, then unset them using the following commands, + +```console +# gluster volume reset