Btrfs: Difference between revisions

Revision as of 15:55, 25 December 2024

Documentation how to use Btrfs on Alpine Linux.

Install

Installing Btrfs is relatively straight forward. Install the package and tell Alpine to load the module on startup:

# apk add btrfs-progs # echo btrfs >> /etc/modules

To load the module immediately, you can use the following command:

# modprobe btrfs

If using btrfs as your root filesystem, you should ensure that the initramfs is generated with the btrfs module, otherwise your system may fail to boot. To do so edit (as root) /etc/mkinitfs/mkinitfs.conf and ensure that "btrfs" is in the list of features; then (again as root) run the mkinitfs command.

|+ نص التسمية التوضيحية
|-
! نص العنوان
|-
| مثال
|}
=

Insert non-formatted text here|} == تركيب وحدة تخزين == لتركيب وحدة تخزين عند التمهيد، أضف إدخالا جديدا إلى fstab الخاص بك:

Contents of /etc/fstab

... UUID=abcdef-0055-4958-990f-1413ed1186ec /var/data btrfs defaults,nofail,subvol=@ 0 0 

إذا كنت تستخدم خيارات تركيب أكثر تحديدا مثل على سبيل المثال:

Contents of /etc/fstab

... UUID=005f5994-f51c-4360-8c9b-589fa59ea6fc /mnt/hddext btrfs nofail,rw,noatime,commit=64,nossd,autodefrag,compress=zstd:10 0 2 

لا تنس تثبيت تبعيات إضافية. إذا قمت بتمكين ضغط الطيران، فأنت بحاجة إلى تثبيت zstd:

# apk add zstd

يمكن العثور على مزيد من المعلومات حول التركيب في الرسمي Btrfs wiki

Troubleshooting

Mount failed

If you try mounting a Btrfs volume via your /etc/fstab and it doesn't show up, it could be because Btrfs does not know about the drives during boot.

To work around this, you can enable the OpenRC service from the btrfs-progs package:

# rc-update add btrfs-scan boot

The volume should mount correctly after a reboot.

@@ Line 14: / Line 14: @@
 If using btrfs as your root filesystem, you should ensure that the initramfs is generated with the btrfs module, otherwise your system may fail to boot. To do so edit (as root) {{path|/etc/mkinitfs/mkinitfs.conf}} and ensure that "btrfs" is in the list of features; then (again as root) run the {{ic|mkinitfs}} command.
-== Mounting a volume ==
+{|
+# |+ نص التسمية التوضيحية
-To mount a volume on boot, add a new entry to your fstab:
+# |-
+# ! نص العنوان
-{{cat|/etc/fstab|<nowiki>...
+# |-
-UUID=abcdef-0055-4958-990f-1413ed1186ec  /var/data  btrfs   defaults,nofail,subvol=@  0  0
+# | مثال
-</nowiki>}}
+# |}
+# =
-If you use more specific mounting options like for example:
+<nowiki>Insert non-formatted text here</nowiki>|}
+== تركيب وحدة تخزين ==  لتركيب وحدة تخزين عند التمهيد، أضف إدخالا جديدا إلى fstab الخاص بك:  {{cat|/etc/fstab|<nowiki>... UUID=abcdef-0055-4958-990f-1413ed1186ec /var/data btrfs defaults,nofail,subvol=@ 0 0 </nowiki>}}  إذا كنت تستخدم خيارات تركيب أكثر تحديدا مثل على سبيل المثال:  {{cat|/etc/fstab|<nowiki>... UUID=005f5994-f51c-4360-8c9b-589fa59ea6fc /mnt/hddext btrfs nofail,rw,noatime,commit=64,nossd,autodefrag,compress=zstd:10 0 2 </nowiki>}}  لا تنس تثبيت تبعيات إضافية. إذا قمت بتمكين ضغط الطيران، فأنت بحاجة إلى تثبيت zstd:  {{cmd|# apk add {{pkg|zstd}}}}  يمكن العثور على مزيد من المعلومات حول التركيب في الرسمي [https://btrfs.readthedocs.io Btrfs wiki]
-{{cat|/etc/fstab|<nowiki>...
-UUID=005f5994-f51c-4360-8c9b-589fa59ea6fc  /mnt/hddext  btrfs  nofail,rw,noatime,commit=64,nossd,autodefrag,compress=zstd:10  0 2
-</nowiki>}}
-do not forget to install additional dependencies. If you enabled on the fly compression you need to install zstd:
-{{cmd|# apk add {{pkg|zstd}}}}
-More information about mounting can be found in the official [https://btrfs.readthedocs.io Btrfs wiki]
 == Troubleshooting ==

Revision as of 15:55, 25 December 2024

Install

Troubleshooting

Mount failed

See also