Common Issues

Solutions to common issues that may be encountered

Installation

AttachVolume.Attach failed for volume…

When describing a pod that fails to deploy, the message “AttachVolume.Attach failed for volume … is not ready for workloads” may appear in the event log.

This means that the Persistent Volume Claim was created but unable to be successfully mounted in the pod. This is typically caused by a network issue, as Longhorn requires both iSCSI and NFS to work.

Also ensure that Longhorn is healthy and that the correct storage class is configured for your Persistent Volume Claims.

Check the firewall to ensure that the proper ports have been opened. See the Networking Guide for details.