Skip to content

Commit 18dcd2d

Browse files
csnoveradam900710
authored andcommitted
btrfs-procs: docs: add warning about balance to replace failing device
Since balance is copying the old good data/metadata into a new chunk (which can be on the same failed device), it's not a safe way to handle failed devices. Signed-off-by: Colin Snover <[email protected]> [ Add an SoB and simple commit message, remove the unnecessary explanation, and guide the user to use `btrfs dev replace` ] Signed-off-by: Qu Wenruo <[email protected]>
1 parent d832a32 commit 18dcd2d

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

Documentation/ch-volume-management-intro.rst

+10
Original file line numberDiff line numberDiff line change
@@ -116,3 +116,13 @@ In order to remove a device, you need to convert the profile in this case:
116116
117117
$ btrfs balance start -mconvert=dup -dconvert=single /mnt
118118
$ btrfs device remove /dev/sda /mnt
119+
120+
.. warning::
121+
Do not run balance to convert from a profile with more redundancy to one with
122+
less redundancy in order to remove a failing device from a filesystem.
123+
124+
Balance is done by reading out the good metadata/data and write them into into a
125+
new chunk.
126+
Thus it's possible the new chunk is written into the failing device.
127+
128+
Use `btrfs device replace` instead.

0 commit comments

Comments
 (0)