Troubleshooting: Mount Failure with XFS Filesystem
| July 3, 2025
All Longhorn versions.
PersistentVolumeClaims (PVCs) using XFS-formatted Longhorn volumes may fail to mount, causing pods to remain stuck in the ContainerCreating
state. Attempting to manually mount the volume may result in errors such as:
wrong fs type, bad option, bad superblock on /dev/longhorn/<volume> missing codepage or helper program ...
Kernel logs (dmesg
) may also display messages like:
[766396.293089] XFS (sdf): Superblock has unknown read-only compatible features (0x6) enabled.
[766396.293546] XFS (sdf): Attempted to mount read-only compatible filesystem read-write.
[766396.293548] XFS (sdf): Filesystem can only be safely mounted read only.
These messages indicate that the filesystem cannot be safely mounted due to unsupported features.
The issue is caused by a compatibility mismatch between the xfsprogs
version inside the Longhorn manager pod (which is responsible for formatting volumes) and the Linux kernel version on the nodes where the volumes are mounted.
For example, Longhorn v1.7 and later includes a newer version of xfsprogs
in the longhorn-manager pod that enables features such as checksums (CRC) and reflink (copy-on-write) by default. These features are not supported by older kernels, such as those in RHEL 7.
The following kernel log entry:
[766396.293089] XFS (sdf): Superblock has unknown read-only compatible features (0x6) enabled.
It shows that feature flags 0x6
are enabled, which correspond to the unsupported CRC and reflink features, leading to the mount failure.
You can resolve or avoid this issue by either of the following:
parameters:
mkfsParams: "-m crc=0,finobt=0"
This disables the CRC and finobt features, allowing the volume to be mounted on older kernels.
Recent articles
© 2019-2025 Longhorn Authors | Documentation Distributed under CC-BY-4.0
© 2025 The Linux Foundation. All rights reserved. The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Usage page.