Troubleshoot the WekaFS plug-in

Identify and resolve common WekaFS plug-in problems on the Manila server by symptom, cause, and resolution.

To collect the share service log for any issue, run:

sudo journalctl -u openstack-manila-share --since "1 hour ago"

WekaMountError: mount command failed

Cause: The WekaFS kernel module is not loaded on the Manila server.

Resolution: Load the module, and confirm that it is loaded:

sudo modprobe wekafsio
lsmod | grep wekafsio

WekaAuthError: Weka authentication failed

Cause: The weka_username, weka_password, or weka_organization value in manila.conf is incorrect.

Resolution: Confirm the credentials against the cluster:

curl -k -X POST https://<weka-ip>:14000/api/v2/login \
  -H 'Content-Type: application/json' \
  -d '{"username":"manila-driver","password":"<password>","org":"Root"}'

Access rule in the error state

Cause: The rule uses an unsupported access type. access_type=user and access_type=cert are not supported on either protocol.

Resolution: Delete the failed rule, and create an IP-based rule:

openstack share access delete <share> <rule-id>
openstack share access create <share> ip <cidr> --access-level rw

ShareShrinkingPossibleDataLoss

Cause: The filesystem holds more data than the target shrink size.

Resolution: Free space on the share, and then retry the shrink operation.

SSL certificate errors

Cause: The plug-in cannot verify the cluster TLS certificate.

Resolution: In test environments only, set weka_ssl_verify = false.

Do not disable certificate verification in production.

FileSystemNotFound in ensure_share

Cause: The filesystem backing the share was deleted outside Manila.

Resolution: Restore the filesystem, or remove the orphaned share from Manila:

openstack share delete <share-id>

Snapshot copy fails with an NFS mount error

Cause: When creating a share from a snapshot, the plug-in waits a short grace period for the NFS gateway to apply temporary permissions. On a heavily loaded cluster, that period can be too short.

Resolution: Retry the operation. If the error recurs, reduce the NFS gateway load during share creation.

Orphan manila-snap- resources on the cluster

Cause: A create-share-from-snapshot operation was interrupted after the plug-in created temporary NFS client groups and permissions, but before cleanup ran.

Resolution: Remove orphan client groups whose names start with manila-snap- and that do not belong to an in-progress operation:

weka nfs client-group list | grep manila-snap-
weka nfs client-group delete <group-name>

Related topics

Configure the WekaFS plug-in for Manila

WekaFS plug-in configuration options

Manage Manila shares on a WEKA cluster