2.7 KiB
| title | date | draft | tags | math | medium_enabled |
|---|---|---|---|---|---|
| Replacing a drive in Btrfs | 2024-10-23T10:37:54-04:00 | false | false | false |
The following are the steps that I take to replace a hard drive in Btrfs with a drive of equal capacity or larger. These instructions are mostly taken from Forza's Wiki which goes into much more depth.
Step 1: Setup a USB with a live image
It turns out that with a hard drive missing, my system would refuse to boot. To get around this, we'll need to use a live image to get to a terminal which will allow us to run the commands we need.
I did this by grabbing the latest version of Fedora Server.
Step 2 Get to a terminal
If we used the Fedora server image, we'll need to select "Rescue Fedora system". If it fails to boot normally, then it'll also fail at this step but will give us access to a terminal which is what we want.
Step 3: Mount the Btrfs file system as degraded
The Btrfs tooling expects that the filesystem is mounted. Assuming that /dev/sda1 is one of the partitions already in the Btrfs pool, we can do the following:
mkdir /mnt/btrfs
mount -o degraded /dev/sda1 /mnt/btrfs
Step 4: Prepare the new disk (Optional)
Let's assume that /dev/sdX is our new disk. We can set up a gpt partition table using parted.
Open up the parted tool: parted /dev/sdX
mklabel gpt
mkpart primary btrfs 4MiB 100%
quit
Step 5: Identify missing device ID
Since we're replacing a hard drive, this means that one of the device ids is missing in the pool. We can use the following command to see which one
btrfs filesystem show
Step 6: Start the replacement process
Let's say that the missing device id is Y. We can then replace that device with our new drive with the following command:
btrfs replace start Y /dev/sdX /mnt/btrfs
This will take some time. We can check the status with:
btrfs replace status /mnt/btrfs
Step 7: Resize the filesystem (Optional)
If we replaced the disk with a larger one, we'll need to tell Btrfs the new size to take advantage of it.
btrfs filesystem resize Y:max /mnt/btrfs
Don't forget to replace Y with your device id. Also, max is a special keyword that btrfs recognizes so we don't need to replace it.
Step 8: Rebalance the filesystem
In order to ensure that our data is evenly distributed across the available hard drives, we'll need to re balance the btrfs array. Warning, this will take a very long time. I think of this as an overnight task.
btrfs balance start /mnt/btrfs
That's it! Restart the computer and make sure that it boots properly. Then, enjoy.