fsck.xfs: mount/umount xfs fs to replay log before running xfs_repair
PATCH v3 1/1 fsck.xfs: mount/umount xfs fs to replay log before running xfs_repair
After a recent data center crash, we had to recover root filesystems on several thousands of VMs via a boot time fsck. Since these machines are remotely manageable, support can inject the kernel command line with 'fsck.mode=force fsck.repair=yes' to kick off xfs_repair if the machine won't come up or if they suspect there might be deeper issues with latent errors in the fs metadata, which is what they did to try to get everyone running ASAP while anticipating any future problems. But, fsck.xfs does not address the journal replay in case of a crash.
fsck.xfs does xfs_repair -e if fsck.mode=force is set. It is possible that when the machine crashes, the fs is in inconsistent state with the journal log not yet replayed. This can drop the machine into the rescue shell because xfs_fsck.sh does not know how to clean the log. Since the administrator told us to force repairs, address the deficiency by cleaning the log and rerunning xfs_repair.
Run xfs_repair -e when fsck.mode=force and repair=auto or yes. Replay the logs only if fsck.mode=force and fsck.repair=yes. For other option -fa and -f drop to the rescue shell if repair detects any corruptions.
--- fsck/xfs_fsck.sh | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-)
fsck/xfs_fsck.sh +29 -2
@@ -31,10 +31,12 @@ repair2fsck_code() { AUTO=false FORCE=false +REPAIR=false while getopts ":aApyf" c do case $c in - a|A|p|y) AUTO=true;; + a|A|p) AUTO=true;; + y) REPAIR=true;; f) FORCE=true;; esac done
@@ -64,7 +66,32 @@ fi if $FORCE; then xfs_repair -e $DEV - repair2fsck_code $? + error=$? + if [ $error -eq 2 ] && [ $REPAIR = true ]; then + echo "Replaying log for $DEV" + mkdir -p /tmp/repair_mnt || exit 1 + for x in $(cat /proc/cmdline); do + case $x in + root=*) + ROOT="${x#root=}" + ;; + rootflags=*) + ROOTFLAGS="-o ${x#rootflags=}" + ;; + esac + done + test -b "$ROOT" || ROOT=$(blkid -t "$ROOT" -o device) + if [ $(basename $DEV) = $(basename $ROOT) ]; then + mount $DEV /tmp/repair_mnt $ROOTFLAGS || exit 1 + else + mount $DEV /tmp/repair_mnt || exit 1 + fi + umount /tmp/repair_mnt + xfs_repair -e $DEV + error=$? + rm -d /tmp/repair_mnt + fi + repair2fsck_code $error exit $? fi
Signature · 1 line
1.8.3.1
Hi folks,
Quoted 55 lines · Srikanth C S
After a recent data center crash, we had to recover root filesystems on several thousands of VMs via a boot time fsck. Since these machines are remotely manageable, support can inject the kernel command line with 'fsck.mode=force fsck.repair=yes' to kick off
xfs_repairif the machine won't come up or if they suspect there might be deeper issues with latent errors in the fs metadata, which is what they did to try to get everyone running ASAP while anticipating any future problems. But, fsck.xfs does not address the journal replay in case of a crash.fsck.xfs does
xfs_repair-e if fsck.mode=force is set. It is possible that when the machine crashes, the fs is in inconsistent state with the journal log not yet replayed. This can drop the machine into the rescue shell becausexfs_fsck.shdoes not know how to clean the log. Since the administrator told us to force repairs, address the deficiency by cleaning the log and rerunningxfs_repair.Run
xfs_repair-e when fsck.mode=force and repair=auto or yes. Replay the logs only if fsck.mode=force and fsck.repair=yes. For other option -fa and -f drop to the rescue shell if repair detects any corruptions.Signed-off-by Srikanth C S <[email protected]>--- fsck/xfs_fsck.sh | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-)fsck/xfs_fsck.sh +8
-2@@ -31,10 +31,12 @@ repair2fsck_code() { AUTO=false FORCE=false +REPAIR=false while getopts ":aApyf" c do case $c in - a|A|p|y) AUTO=true;; + a|A|p) AUTO=true;; + y) REPAIR=true;; f) FORCE=true;; esac done@@ -64,7 +66,32 @@ fi if $FORCE; then xfs_repair -e $DEV - repair2fsck_code $? + error=$? + if [ $error -eq 2 ] && [ $REPAIR = true ]; then + echo "Replaying log for $DEV" + mkdir -p /tmp/repair_mnt || exit 1 + for x in $(cat /proc/cmdline); do
fsck/xfs_fsck.sh fi · line 83
Quoted 10 lines
fsck/xfs_fsck.sh +10
-0+ case $x in + root=*) + ROOT="${x#root=}" + ;; + rootflags=*) + ROOTFLAGS="-o ${x#rootflags=}" + ;; + esac + done + test -b "$ROOT" || ROOT=$(blkid -t "$ROOT" -o device)
We'd also like to get a formal solution about this for our production so that xfs_repair can work properly with log recovery.
However, may I ask if it's the preferred way to implement this which just acts as another mount-unmount cycle, since I'm not sure if there are some customized initramfs-es which could get the fs busy so that it won't unmount properly.
Alternatively, do we consider another way like exporting the log recovery functionality with ioctl() so that log recovery can work without the actual fs mounting? Is it affordable?
Thanks,
Gao Xiang
Quoted 17 lines
fsck/xfs_fsck.sh +11
-0+ if [ $(basename $DEV) = $(basename $ROOT) ]; then + mount $DEV /tmp/repair_mnt $ROOTFLAGS || exit 1 + else + mount $DEV /tmp/repair_mnt || exit 1 + fi + umount /tmp/repair_mnt + xfs_repair -e $DEV + error=$? + rm -d /tmp/repair_mnt + fi + repair2fsck_code $error exit $? fiSignature · 1 line
1.8.3.1
Quoted 63 lines · Gao Xiang
Hi folks,
Quoted 60 lines · Srikanth C S
After a recent data center crash, we had to recover root filesystems on several thousands of VMs via a boot time fsck. Since these machines are remotely manageable, support can inject the kernel command line with 'fsck.mode=force fsck.repair=yes' to kick off
xfs_repairif the machine won't come up or if they suspect there might be deeper issues with latent errors in the fs metadata, which is what they did to try to get everyone running ASAP while anticipating any future problems. But, fsck.xfs does not address the journal replay in case of a crash.fsck.xfs does
xfs_repair-e if fsck.mode=force is set. It is possible that when the machine crashes, the fs is in inconsistent state with the journal log not yet replayed. This can drop the machine into the rescue shell becausexfs_fsck.shdoes not know how to clean the log. Since the administrator told us to force repairs, address the deficiency by cleaning the log and rerunningxfs_repair.Run
xfs_repair-e when fsck.mode=force and repair=auto or yes. Replay the logs only if fsck.mode=force and fsck.repair=yes. For other option -fa and -f drop to the rescue shell if repair detects any corruptions.Signed-off-by Srikanth C S <[email protected]>--- fsck/xfs_fsck.sh | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-)fsck/xfs_fsck.sh +13
-2@@ -31,10 +31,12 @@ repair2fsck_code() { AUTO=false FORCE=false +REPAIR=false while getopts ":aApyf" c do case $c in - a|A|p|y) AUTO=true;; + a|A|p) AUTO=true;; + y) REPAIR=true;; f) FORCE=true;; esac done@@ -64,7 +66,32 @@ fi if $FORCE; then xfs_repair -e $DEV - repair2fsck_code $? + error=$? + if [ $error -eq 2 ] && [ $REPAIR = true ]; then + echo "Replaying log for $DEV" + mkdir -p /tmp/repair_mnt || exit 1 + for x in $(cat /proc/cmdline); do + case $x in + root=*) + ROOT="${x#root=}" + ;; + rootflags=*)
Quoted 8 lines
fsck/xfs_fsck.sh fi · line 83
Quoted 5 lines
fsck/xfs_fsck.sh +5
-0+ ROOTFLAGS="-o ${x#rootflags=}" + ;; + esac + done + test -b "$ROOT" || ROOT=$(blkid -t "$ROOT" -o device)We'd also like to get a formal solution about this for our production so that
xfs_repaircan work properly with log recovery.
My preferred solution is to port the log recovery code to userspace, and then train xfs_repair to invoke it. Handling the trivial case where xfs_repair can recover logs created on the same platform as the support script wouldn't be that hard (I think?) because log recovery is fairly selfcontained nowadays.
But.
Inevitably someone will suggest fixing the kernel's inability to recover a log from a platform with a different endianness, which will lead to a discussion of making the ondisk log format endian safe. Someone else may also ask why not make userspace xfs_trans transactional, and... ;)
(All those extra asks are ok, but anyone taking on these task sets should make it /very/ clear where the scope of each set begins and ends, and in which order they'll be worked on.)
Quoted 4 lines
However, may I ask if it's the preferred way to implement this which just acts as another mount-unmount cycle, since I'm not sure if there are some customized initramfs-es which could get the fs busy so that it won't unmount properly.
Seeing as initramfses are only supposed to turn on enough hardware so that mount can find the root volume, I really hope there aren't *background services* running here.
Quoted 3 lines
Alternatively, do we consider another way like exporting the log recovery functionality with
ioctl()so that log recovery can work without the actual fs mounting? Is it affordable?
I guess you could create a 'recoveryonly' mount option that would abort the mount after recovering the log. I'm not really a fan of that approach.
--D
Quoted 20 lines
Thanks,
Gao XiangQuoted 17 lines
fsck/xfs_fsck.sh +11
-0+ if [ $(basename $DEV) = $(basename $ROOT) ]; then + mount $DEV /tmp/repair_mnt $ROOTFLAGS || exit 1 + else + mount $DEV /tmp/repair_mnt || exit 1 + fi + umount /tmp/repair_mnt + xfs_repair -e $DEV + error=$? + rm -d /tmp/repair_mnt + fi + repair2fsck_code $error exit $? fiSignature · 1 line
1.8.3.1
Hi Darrick,
Quoted 73 lines · Darrick J. Wong
Quoted 63 lines · Gao Xiang
Hi folks,
Quoted 60 lines · Srikanth C S
After a recent data center crash, we had to recover root filesystems on several thousands of VMs via a boot time fsck. Since these machines are remotely manageable, support can inject the kernel command line with 'fsck.mode=force fsck.repair=yes' to kick off
xfs_repairif the machine won't come up or if they suspect there might be deeper issues with latent errors in the fs metadata, which is what they did to try to get everyone running ASAP while anticipating any future problems. But, fsck.xfs does not address the journal replay in case of a crash.fsck.xfs does
xfs_repair-e if fsck.mode=force is set. It is possible that when the machine crashes, the fs is in inconsistent state with the journal log not yet replayed. This can drop the machine into the rescue shell becausexfs_fsck.shdoes not know how to clean the log. Since the administrator told us to force repairs, address the deficiency by cleaning the log and rerunningxfs_repair.Run
xfs_repair-e when fsck.mode=force and repair=auto or yes. Replay the logs only if fsck.mode=force and fsck.repair=yes. For other option -fa and -f drop to the rescue shell if repair detects any corruptions.Signed-off-by Srikanth C S <[email protected]>--- fsck/xfs_fsck.sh | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-)fsck/xfs_fsck.sh +13
-2@@ -31,10 +31,12 @@ repair2fsck_code() { AUTO=false FORCE=false +REPAIR=false while getopts ":aApyf" c do case $c in - a|A|p|y) AUTO=true;; + a|A|p) AUTO=true;; + y) REPAIR=true;; f) FORCE=true;; esac done@@ -64,7 +66,32 @@ fi if $FORCE; then xfs_repair -e $DEV - repair2fsck_code $? + error=$? + if [ $error -eq 2 ] && [ $REPAIR = true ]; then + echo "Replaying log for $DEV" + mkdir -p /tmp/repair_mnt || exit 1 + for x in $(cat /proc/cmdline); do + case $x in + root=*) + ROOT="${x#root=}" + ;; + rootflags=*)Quoted 8 lines
fsck/xfs_fsck.sh fi · line 83
Quoted 5 lines
fsck/xfs_fsck.sh +5
-0+ ROOTFLAGS="-o ${x#rootflags=}" + ;; + esac + done + test -b "$ROOT" || ROOT=$(blkid -t "$ROOT" -o device)We'd also like to get a formal solution about this for our production so that
xfs_repaircan work properly with log recovery.
Quoted 6 lines
My preferred solution is to port the log recovery code to userspace, and then train
xfs_repairto invoke it. Handling the trivial case wherexfs_repaircan recover logs created on the same platform as the support script wouldn't be that hard (I think?) because log recovery is fairly selfcontained nowadays.
Yeah, my preferred way is also that it could be done like this, but sadly in practice currently such ROI is low (considering only a small number of ECS uses XFS at Alibaba Cloud..)
So.. Hopefully I could promote XFS first so we could have more manpower and take more time on XFS ;)
Quoted 7 lines
But.
Inevitably someone will suggest fixing the kernel's inability to recover a log from a platform with a different endianness, which will lead to a discussion of making the ondisk log format endian safe. Someone else may also ask why not make userspace
xfs_transtransactional, and... ;)
Yeah, actually I talked with Eric two years ago about this. The log format endianness is still in a mess. Yeah... You're right.
Quoted 3 lines
(All those extra asks are ok, but anyone taking on these task sets should make it /very/ clear where the scope of each set begins and ends, and in which order they'll be worked on.)
Currently the part of my job is to aim at stablizing XFS first in order to promote XFS to our production. At least reflink with good performance is somewhat a killer combination for the Cloud providers like us ;)
Quoted 9 lines
Quoted 5 lines
However, may I ask if it's the preferred way to implement this which just acts as another mount-unmount cycle, since I'm not sure if there are some customized initramfs-es which could get the fs busy so that it won't unmount properly.
Seeing as initramfses are only supposed to turn on enough hardware so that mount can find the root volume, I really hope there aren't *background services* running here.
Although it's much like impossible, from stability POV, I'm not sure if some unusual users could behave like this. At least, it's currently one of our concerns if it just acts as a mount-unmount cycle as a public cloud provider.
Quoted 8 lines
Quoted 4 lines
Alternatively, do we consider another way like exporting the log recovery functionality with
ioctl()so that log recovery can work without the actual fs mounting? Is it affordable?I guess you could create a 'recoveryonly' mount option that would abort the mount after recovering the log. I'm not really a fan of that approach.
I'm not quite such fan to introduce a weird mount option too. We might evaluate such way internally as well, but if upstream prefers a full mount-unmount cycle, I guess we will finally follow it.
Thank a lot,
Gao Xiang
Quoted 3 lines
--D
Hi,
Quoted 60 lines · Srikanth C S
After a recent data center crash, we had to recover root filesystems on several thousands of VMs via a boot time fsck. Since these machines are remotely manageable, support can inject the kernel command line with 'fsck.mode=force fsck.repair=yes' to kick off
xfs_repairif the machine won't come up or if they suspect there might be deeper issues with latent errors in the fs metadata, which is what they did to try to get everyone running ASAP while anticipating any future problems. But, fsck.xfs does not address the journal replay in case of a crash.fsck.xfs does
xfs_repair-e if fsck.mode=force is set. It is possible that when the machine crashes, the fs is in inconsistent state with the journal log not yet replayed. This can drop the machine into the rescue shell becausexfs_fsck.shdoes not know how to clean the log. Since the administrator told us to force repairs, address the deficiency by cleaning the log and rerunningxfs_repair.Run
xfs_repair-e when fsck.mode=force and repair=auto or yes. Replay the logs only if fsck.mode=force and fsck.repair=yes. For other option -fa and -f drop to the rescue shell if repair detects any corruptions.Signed-off-by Srikanth C S <[email protected]>--- fsck/xfs_fsck.sh | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-)fsck/xfs_fsck.sh +13
-2@@ -31,10 +31,12 @@ repair2fsck_code() { AUTO=false FORCE=false +REPAIR=false while getopts ":aApyf" c do case $c in - a|A|p|y) AUTO=true;; + a|A|p) AUTO=true;; + y) REPAIR=true;; f) FORCE=true;; esac done@@ -64,7 +66,32 @@ fi if $FORCE; then xfs_repair -e $DEV - repair2fsck_code $? + error=$? + if [ $error -eq 2 ] && [ $REPAIR = true ]; then + echo "Replaying log for $DEV" + mkdir -p /tmp/repair_mnt || exit 1 + for x in $(cat /proc/cmdline); do + case $x in + root=*) + ROOT="${x#root=}" + ;; + rootflags=*)
fsck/xfs_fsck.sh fi · line 88
Quoted 10 lines
fsck/xfs_fsck.sh +10
-0+ ROOTFLAGS="-o ${x#rootflags=}" + ;; + esac + done + test -b "$ROOT" || ROOT=$(blkid -t "$ROOT" -o device) + if [ $(basename $DEV) = $(basename $ROOT) ]; then + mount $DEV /tmp/repair_mnt $ROOTFLAGS || exit 1 + else + mount $DEV /tmp/repair_mnt || exit 1 + fi
If do normal boot, it will try to mount according to fstab. So in the crash case you've described, it seems that it can't mount successfully? Or am I missing something?
Thanks,
Joseph
Quoted 9 lines
fsck/xfs_fsck.sh +6
-0+ umount /tmp/repair_mnt + xfs_repair -e $DEV + error=$? + rm -d /tmp/repair_mnt + fi + repair2fsck_code $error exit $? fi
Quoted 69 lines · Joseph Qi
Hi,
Quoted 66 lines · Srikanth C S
After a recent data center crash, we had to recover root filesystems on several thousands of VMs via a boot time fsck. Since these machines are remotely manageable, support can inject the kernel command line with 'fsck.mode=force fsck.repair=yes' to kick off
xfs_repairif the machine won't come up or if they suspect there might be deeper issues with latent errors in the fs metadata, which is what they did to try to get everyone running ASAP while anticipating any future problems. But, fsck.xfs does not address the journal replay in case of a crash.fsck.xfs does
xfs_repair-e if fsck.mode=force is set. It is possible that when the machine crashes, the fs is in inconsistent state with the journal log not yet replayed. This can drop the machine into the rescue shell becausexfs_fsck.shdoes not know how to clean the log. Since the administrator told us to force repairs, address the deficiency by cleaning the log and rerunningxfs_repair.Run
xfs_repair-e when fsck.mode=force and repair=auto or yes. Replay the logs only if fsck.mode=force and fsck.repair=yes. For other option -fa and -f drop to the rescue shell if repair detects any corruptions.Signed-off-by Srikanth C S <[email protected]>--- fsck/xfs_fsck.sh | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-)fsck/xfs_fsck.sh +19
-2@@ -31,10 +31,12 @@ repair2fsck_code() { AUTO=false FORCE=false +REPAIR=false while getopts ":aApyf" c do case $c in - a|A|p|y) AUTO=true;; + a|A|p) AUTO=true;; + y) REPAIR=true;; f) FORCE=true;; esac done@@ -64,7 +66,32 @@ fi if $FORCE; then xfs_repair -e $DEV - repair2fsck_code $? + error=$? + if [ $error -eq 2 ] && [ $REPAIR = true ]; then + echo "Replaying log for $DEV" + mkdir -p /tmp/repair_mnt || exit 1 + for x in $(cat /proc/cmdline); do + case $x in + root=*) + ROOT="${x#root=}" + ;; + rootflags=*) + ROOTFLAGS="-o ${x#rootflags=}" + ;; + esac + done + test -b "$ROOT" || ROOT=$(blkid -t "$ROOT" -o device) + if [ $(basename $DEV) = $(basename $ROOT) ]; then
Quoted 8 lines
fsck/xfs_fsck.sh fi · line 88
Quoted 4 lines
fsck/xfs_fsck.sh +4
-0+ mount $DEV /tmp/repair_mnt $ROOTFLAGS || exit 1 + else + mount $DEV /tmp/repair_mnt || exit 1 + fiIf do normal boot, it will try to mount according to fstab. So in the crash case you've described, it seems that it can't mount successfully? Or am I missing something?
Yes, we're assuming that support has injected the magic command lines into the bootloader to trigger xfs_repair after boot failed due to a bad/corrupt rootfs.
--D
Quoted 12 lines
Thanks,
JosephQuoted 9 lines
fsck/xfs_fsck.sh +6
-0+ umount /tmp/repair_mnt + xfs_repair -e $DEV + error=$? + rm -d /tmp/repair_mnt + fi + repair2fsck_code $error exit $? fi