From f554e55812e53711d2774e24cae19ca420f4e7ac Mon Sep 17 00:00:00 2001 From: Shwetha Acharya Date: Fri, 26 Mar 2021 13:44:12 +0530 Subject: [PATCH] Geo-rep: Version upgrade to version 8 and above (#670) Add information about the upgrade script that is to executed for the update for geo-replication Signed-off-by: Shwetha K Acharya --- docs/Upgrade-Guide/upgrade-to-8.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/Upgrade-Guide/upgrade-to-8.md b/docs/Upgrade-Guide/upgrade-to-8.md index 6e45e0a..7ccba69 100644 --- a/docs/Upgrade-Guide/upgrade-to-8.md +++ b/docs/Upgrade-Guide/upgrade-to-8.md @@ -5,6 +5,14 @@ aware of the features and fixes provided with the release. > **NOTE:** Before following the generic upgrade procedure checkout the "**Major Issues**" section given below. +> With version 8, there are certain changes introduced to the directory structure of changelog files in gluster geo-replication. +> Thus, before the upgrade of geo-rep packages, we need to execute the [upgrade script](https://github.com/gluster/glusterfs/commit/2857fe3fad4d2b30894847088a54b847b88a23b9) with the brick path as argument, as described below: +>1. Stop the geo-rep session +>2. Run the upgrade script with the brick path as the argument. Script can be used in loop for multiple bricks. +>3. Start the upgradation process. +>This script will update the existing changelog directory structure and the paths inside the htime files to a new format introduced in version 8. +>If the above mentioned script is not executed, the search algorithm, used during the history crawl will fail with the wrong result for upgradation from version 7 and below to version 8 and above. + Refer, to the [generic upgrade procedure](./generic-upgrade-procedure.md) guide and follow documented instructions. ## Major issues