Blame SOURCES/0062-mdadm.8-add-note-information-for-raid0-growing-opera.patch

8e8941
From 2551061c253b8fd45ee93d1aab3e91d2c7ac9c20 Mon Sep 17 00:00:00 2001
8e8941
From: Coly Li <colyli@suse.de>
8e8941
Date: Mon, 24 Feb 2020 12:34:09 +0100
8e8941
Subject: [RHEL7.9 PATCH 62/77] mdadm.8: add note information for raid0 growing
8e8941
 operation
8e8941
8e8941
When growing a raid0 device, if the new component disk size is not
8e8941
big enough, the grow operation may fail due to lack of backup space.
8e8941
8e8941
The minimum backup space should be larger than:
8e8941
 LCM(old, new) * chunk-size * 2
8e8941
8e8941
where LCM() is the least common multiple of the old and new count of
8e8941
component disks, and "* 2" comes from the fact that mdadm refuses to
8e8941
use more than half of a spare device for backup space.
8e8941
8e8941
There are users reporting such failure when they grew a raid0 array
8e8941
with small component disk. Neil Brown points out this is not a bug
8e8941
and how the failure comes. This patch adds note information into
8e8941
mdadm(8) man page in the Notes part of GROW MODE section to explain
8e8941
the minimum size requirement of new component disk size or external
8e8941
backup size.
8e8941
8e8941
Reviewed-by: Petr Vorel <pvorel@suse.cz>
8e8941
Cc: NeilBrown <neilb@suse.de>
8e8941
Cc: Jes Sorensen <jsorensen@fb.com>
8e8941
Cc: Paul Menzel <pmenzel@molgen.mpg.de>
8e8941
Cc: Wols Lists <antlists@youngman.org.uk>
8e8941
Cc: Nix <nix@esperi.org.uk>
8e8941
Signed-off-by: Coly Li <colyli@suse.de>
8e8941
Signed-off-by: Jes Sorensen <jsorensen@fb.com>
8e8941
---
8e8941
 mdadm.8.in | 6 ++++++
8e8941
 1 file changed, 6 insertions(+)
8e8941
8e8941
diff --git a/mdadm.8.in b/mdadm.8.in
8e8941
index 5d00faf..a3494a1 100644
8e8941
--- a/mdadm.8.in
8e8941
+++ b/mdadm.8.in
8e8941
@@ -2768,6 +2768,12 @@ option and it is transparent for assembly feature.
8e8941
 .IP \(bu 4
8e8941
 Roaming between Windows(R) and Linux systems for IMSM metadata is not
8e8941
 supported during grow process.
8e8941
+.IP \(bu 4
8e8941
+When growing a raid0 device, the new component disk size (or external
8e8941
+backup size) should be larger than LCM(old, new) * chunk-size * 2,
8e8941
+where LCM() is the least common multiple of the old and new count of
8e8941
+component disks, and "* 2" comes from the fact that mdadm refuses to
8e8941
+use more than half of a spare device for backup space.
8e8941
 
8e8941
 .SS SIZE CHANGES
8e8941
 Normally when an array is built the "size" is taken from the smallest
8e8941
-- 
8e8941
2.7.5
8e8941