BtrFS
Links
- VmHost
- Scrub-Script: http://marc.merlins.org/perso/btrfs/post_2014-03-19_Btrfs-Tips_-Btrfs-Scrub-and-Btrfs-Filesystem-Repair.html
- Position einer Datei im Image: https://blogs.oracle.com/wim/btrfs-scrub-go-fix-corruptions-with-mirror-copies-please
Erstellen
- Paket: btrfs-progs
- Achtung: Immer Partitionsschema anlegen (fdisk...). Ohne geht auch, aber mit Einschränkungen (grub...)
mkfs.btrfs -L debian10 /dev/sdb1 btrfs filesystem label /dev/sdb1 debian10 # oder RAID1 für Daten (-d) und Metadaten (-m): mkfs.btrfs -m raid1 -d raid1 /dev/sdb1 /dev/sdc1 -f # Anzeigen: btrfs filesystem usage /media/work # Späteres Hinzufügen: # btrfs device NEWDEVICE OLDDEVICE btrfs device add -f /dev/sdd1 /media/work # Balance notwendig! # Nachträglich zu RAID wandeln: btrfs balance start -dconvert=raid1 -mconvert=raid1 /media/work
/etc/fstab
LABEL=fs.bullseye / btrfs defaults,noatime,nodiratime,compress=zstd,autodefrag,subvol=@rootfs 0 0 LABEL=fs.bullseye /media/fs.sys btrfs defaults,noatime,nodiratime,compress=zstd,autodefrag,subvolid=5 0 0
Kommandos
btrfs subvol create /media/work/root btrfs subvol list /media/work # z.B. 257 btrfs subvol set-default 257 /media/work # kein default mehr: 5 ist das Rootsystem btrfs subvol set-default 5 /media/work btrfs subvol get-default # Readonly für Snapshot entfernen: btrfs property set -ts /media/fs.system/snapshot ro false btrfs property set /usr compression lzo btrfs property get /usr compression btrfs scrub start / btrfs scrub status / # Für nodatacow: chattr -RV +C /var/lib/mysql/images lsattr -R /var/lib/mysql/images # Kompression anzeigen: compsize /media/work
Info
btrfs device scan [/dev/sda6] btrfs device usage /media/work # Fehlerstatistik: btrfs device stats /media/work btrfs filesystem df #Data, single: total=20.00GiB, used=11.97GiB #System, single: total=32.00MiB, used=16.00KiB #Metadata, single: total=1.50GiB, used=568.47MiB #GlobalReserve, single: total=38.27MiB, used=0.00B btrfs filesystem du -s /media/work/backup # Total Exclusive Set shared Filename # 18.80GiB 7.82GiB 4.15GiB /media/fs.system btrfs filesystem show /media/work # Total devices 1 FS bytes used 12.53GiB # devid 1 size 32.00GiB used 21.53GiB path /dev/sda6 btrfs subvol list /media/ # nur Snapshots: btrfs subvol list -s /media/work btrfs check --readonly -Q -E -p --force /dev/sda6 # Fehlerstatistik: btrfs device stats /media/work
- sehr selten:
# Extend-Status für Subvol 258 anzeigen: btrfs check --readonly -E 258 --force /dev/sda6
Quota
- Nachträglich einrichten:
btrfs quota enable /media/work btrfs subvolume list /media/work | cut -d' ' -f2 | xargs -I{} -n1 btrfs qgroup create 0/{} /media/work btrfs quota rescan /media/work btrfs quota limit <group> <size>G path btrfs qgroup limit 0/256 32G path # option -e: unshared limit -c: compressed limit btrfs btrfs qgroup show -reF path
- qgroups sind Nummern <level>/<id>
- Level 0 ist voreingestellt, wenn Subvolume erzeugt wird
- <id> ist für Level 0 die Subvolume-ID, z.B. 0/5 ist die qgroup des Toplevel-Volumes
- <id> für Level > 0 ist frei wählbar
- Erklärung: https://btrfs.wiki.kernel.org/index.php/Manpage/btrfs-quota
- Scripte, die Belegungen auflisten: https://btrfs.wiki.kernel.org/index.php/Quota_support
btrfs qgroup limit 21G 0/270 /media/work # Gruppe einrichten und nutzen (für 2 Subvolumes) btrfs qgroup create 1/100 /media/work btrfs qgroup assign 0/965 1/100 /media/work # subvolume a hat id 965 btrfs qgroup assign 0/966 1/100 /media/work # subvolume b hat id 966 btrfs qgroup show -reF /media/work
# qgroup total owned 0/5 4698025984 8192 0/257 52432896 4096 0/263 4405821440 12288 0/264 4698025984 8192
Einhängen
mount /dev/sdb /media/work
- In /etc/fstab:
UUID=xxx /media/work btrfs defaults,subvol=@,compress,autodefrag 0 1
Subvolumes
Verschachteltes Design
- Gesamtes FS wird gemountet
- Alle Subvolumes sind dann automatisch vorhanden. Nicht extra mounten!
- Aber nur Mounten gestattet Optionen wie Komprimieren oder nodatacow
Gemischtes Design
- Beispiel: ein Subvolume ist als / gemounted, das gesamte FS wird in /media/fs gemountet
- Bei Snapshots sind verschachtelte Subvolumes nicht enthalten (keine rekursiven Snapshots)
Flaches Design
- /etc/fstab:
LABEL=the-btrfs-fs-device / btrfs subvol=/root,defaults,noatime 0 0 LABEL=the-btrfs-fs-device /home btrfs subvol=/home,defaults,noatime 0 0
btrfs subvolume create /media/work/root btrfs subvolume create /media/work/home btrfs subvolume list /media/work btrfs subvolume delete /media/work/vm-store
Snapshots
- Wenn ein (schreibbarer) Schnappschuss erstellt wurde, gibt es keinen Unterschied zwischen Orginal und Schnappschuss.
- Bei Snapshots sind verschachtelte Subvolumes nicht enthalten (keine rekursiven Snapshots)
- Zurücksetzen (Rollback):
- Orginal unmounten
- mv zum Verschieben des alten Subvolumes an einen anderen Platz benutzen
- mv zum Verschieben des Schnappschusses zum Orginal benutzen
- Neu mounten
btrfs subvolume snapshot -r /media/work/backup /media/snapshots/dayly/backup.mon # Löschen: btrfs subvol delete /media/fs.sys/snapshots/@rootfs/monthly/02
Balance
btrfs balance /media/work # Verlauf testen btrfs balance status /media/work # Stoppen btrfs balance pause /media/work # Weitermachen btrfs balance resume /media/work # Info btrfs balance status /media/work
Balance bei "vollem" Laufwerk"
btrfs balance start -v -dusage=0 /mnt/btrfs
# wenn das durch ist:
btrfs balance start -v -dusage=10 /mnt/btrfs
Balance mit zusätzlicher Partition
#hier: die "volle" btrfs-Partition ist /dev/sdx1
mount /dev/sdx1 /media/trg
# Platz auf /dev/sdy2 dazufügen:
btrfs device add /dev/sdy2 /media/trg
btrfs balance start /media/trg
# Zusatzspeicher wieder entfernen:
btrfs device delete /dev/sdy2 /media/trg
Balance mit Image als Zusatzspeicher
#Anlegen eines Mountpoints
#mounten des "vollen" btrfs-Dateisystems
mount /dev/sdx2 /media/trg
mount /dev/sdy5 /media/tmp
#4GB-Image-Datei erstellen
dd if=/dev/zero of=externalfs/extend.img bs=1M count=4096
#Loop-Device loop10 über die Image-Datei erstellen
losetup /dev/loop10 /media/tmp/big_data.img
#Hinzufügen der Image-Datei zum "vollen" btrfs-Dateisystem
btrfs device add /dev/loop0 /media/trg
btrfs balance start /media/trg
#Image-Datei vom btrfs-Dateisystem wieder entfernen
btrfs device delete /dev/loop0 /media/trg
Umbau / Fehlerfall
btrfs balance start -v -mconvert=single -dconvert=single /media/work --force btrfs device delete /dev/sda /media/data # Bei einer defekten Festplatte kann das Dateisystem mit folgenden Befehl gemountet werden: mount -o degraded,rw /dev/sda /media/work # folgender Befehl ersetzt eine defekte Platte: btrfs replace start 6 /dev/sdf1 /media/work # mount nicht möglich "inactive unit": btrfs rescue zero-log /dev/sdc5 # Reaktivierung raid1: btrfs balance start -v -mconvert=raid1 -dconvert=raid1 /media/work
Info
btrfs device scan btrfs device scan /dev/sda
Send/Receive
- effiziente Möglichkeit, Subvolumes zu kopieren.
Komplette Kopie
btrfs send /home/BACKUP | btrfs receive /backup/home
Differenzielle Kopie
- Initialisierung:
btrfs subvolume snapshot -r /home /home/BACKUP btrfs send /home/BACKUP | btrfs receive /backup/home # Es entsteht dann ein Subvolume /backup/home/BACKUP
- Update:
btrfs subvolume snapshot -r /home /home/BACKUP-new sync btrfs send -p /home/BACKUP /home/BACKUP-new | btrfs receive /backup/home btrfs subvolume delete /home/BACKUP mv /home/BACKUP-new /home/BACKUP btrfs subvolume delete /backup/home/BACKUP mv /backup/home/BACKUP-new /backup/home/BACKUP
Notfall
btrfs device scan btrfs rescue btrfs rescue super-recover -v btrfs check --init-extent-tree # sichern von Daten nach <directory>: btrfs restore -i <device> <directory>
chattr und lsattr
chattr OPTION MODE FILE
Options:
- -R rekursiv
- -V verbose
- -f Fehler werden unterdrückt
- -v VERSION Setzt für Datei Version/Generationsnummer
- -p PROJ Setzt Projektnummer
Hat ein Verzeichnis das Attribut c (compressed), dann auch alle Unterverzeichnisse
Modes:
- a: append only (a)
- A: no atime updates (A)
- c: compressed (c)
- C: no copy on write (C)
- d: no dump (d)
- D: synchronous directory updates (D)
- e: extent format (e)
- i: immutable (i)
- j: data journalling (j)
- P: project hierarchy (P)
- s: secure deletion (s)
- S: synchronous updates (S)
- t: no tail-merging (t)
- T: top of directory hierarchy (T)
- u: undeletable (u)
lsattr OPT FILES
Optionen:
- -R Rekursiv
- -V Verbose
- -a auch verborgene (Beginn mit .)
- -l Lang Namen ausgeben
- -p Projektnummer ausgeben
- -v Versionsnummer ausgeben
Konvertierung zu RAID1
mount /dev/sdb1 /mnt btrfs device add /dev/sdc1 /mnt btrfs balance start -dconvert=raid1 -mconvert=raid1 /mnt