Troubleshooting: Failed Replicas with Backing Images Remain On Evicted Nodes
| June 5, 2025
v1.9.0 and earlier.
After evicting a node, some volume replicas created from a backing image may enter an error state. Despite this, the associated volumes remain healthy.
The issue occurs due to the unconditional deletion of backing image copies. If a backing image copy still in use is removed, its associated replica is forcibly shut down and marked as broken. This prevents the replica from being cleaned up during node eviction process.
To resolve this issue and maintain cluster stability, perform the following steps:
The processes tied to these replicas have already terminated. Data is safely synchronized to new replicas, and no orphaned backing images will remain.
Longhorn v1.8.2+, v1.9.1+
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.