mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
55 lines
2.4 KiB
Plaintext
55 lines
2.4 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * storage/persistent_storage/persistent-storage-csi-aws-efs.adoc
|
|
// * storage/container_storage_interface/persistent-storage-csi-aws-efs.adoc
|
|
|
|
:_mod-docs-content-type: REFERENCE
|
|
[id="efs-troubleshooting_{context}"]
|
|
= Amazon Elastic File Storage troubleshooting
|
|
|
|
The following information provides guidance on how to troubleshoot issues with Amazon Elastic File Storage (Amazon EFS):
|
|
|
|
* The AWS EFS Operator and CSI driver run in namespace `openshift-cluster-csi-drivers`.
|
|
|
|
* To initiate gathering of logs of the AWS EFS Operator and CSI driver, run the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc adm must-gather
|
|
[must-gather ] OUT Using must-gather plugin-in image: quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:125f183d13601537ff15b3239df95d47f0a604da2847b561151fedd699f5e3a5
|
|
[must-gather ] OUT namespace/openshift-must-gather-xm4wq created
|
|
[must-gather ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-2bd8x created
|
|
[must-gather ] OUT pod for plug-in image quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:125f183d13601537ff15b3239df95d47f0a604da2847b561151fedd699f5e3a5 created
|
|
----
|
|
|
|
* To show AWS EFS Operator errors, view the `ClusterCSIDriver` status:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get clustercsidriver efs.csi.aws.com -o yaml
|
|
----
|
|
|
|
* If a volume cannot be mounted to a pod (as shown in the output of the following command):
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc describe pod
|
|
...
|
|
Type Reason Age From Message
|
|
---- ------ ---- ---- -------
|
|
Normal Scheduled 2m13s default-scheduler Successfully assigned default/efs-app to ip-10-0-135-94.ec2.internal
|
|
Warning FailedMount 13s kubelet MountVolume.SetUp failed for volume "pvc-d7c097e6-67ec-4fae-b968-7e7056796449" : rpc error: code = DeadlineExceeded desc = context deadline exceeded <1>
|
|
Warning FailedMount 10s kubelet Unable to attach or mount volumes: unmounted volumes=[persistent-storage], unattached volumes=[persistent-storage kube-api-access-9j477]: timed out waiting for the condition
|
|
----
|
|
<1> Warning message indicating volume not mounted.
|
|
+
|
|
This error is frequently caused by AWS dropping packets between an {product-title} node and Amazon EFS.
|
|
+
|
|
Check that the following are correct:
|
|
+
|
|
--
|
|
* AWS firewall and Security Groups
|
|
|
|
* Networking: port number and IP addresses
|
|
--
|