Improvements to BTRFS documentation

Fantu

Active Member
Jan 23, 2024
113
44
28
Hi, I want to suggest some improvements to BTRFS documentation, to help its usage.

About create btrfs on single disk now there is:
Code:
mkfs.btrfs -m single -d single -L My-Storage /dev/sdb
I suggest adding something about suggest duplicate metadata (as optional), for example:
for better tolerance to disk errors (e.g. bad sectors) it may be useful to set double metadata "-m dup" instead -m single

About boot a degraded raid:
efi partitions are created at installation with "minimal" grub and therefore basically support booting from other disks different from the first but not having a good support and synchronization like zfs require further manual operations at the moment.
In /etc/ftab add nofail option to efi mount point to make possible boot with that disk missed, for example:
Code:
UUID=4E18-9780 /boot/efi vfat defaults,nofail 0 1
When raid is degraded to be able to boot easy and fast: from grub menu press "e" to edit, replace "quiet" with "rootflag=degraded" and press F10 or ctrl+x for boot.
It is recommended to replace the missing/defective disk as soon as possible.

On vm disks on btrfs don't use cache=none or will cause checksum error with cow not disabled on vm disk files.


I'm not good at explaining and in English so the suggestions given need to be improved but I hope they can be helpful to improve the documentation.
 
Last edited:
  • Like
Reactions: waltar