Chapter 5. Troubleshooting NFS Issues
Ensure that the NFS server and shares are configured according to the OpenShift documentation for configuring NFS PersistentVolumes.
Consider the following when reviewing your NFS configuration:
Ensure the NFS mounts are accessible to the OpenShift nodes
Check this by manually mounting an NFS share to an OpenShift node. If the mount is unsuccessful, ensure that the correct ports are open on the NFS server. More information on the ports required for either NFSv3 or NFSv4 can be found in the NFS section of the OpenShift guide.
Ensure SELinux allows Pods to write to a remote NFS server
There are SELinux settings that must be configured to allow writing. For more information, see the NFS section of the OpenShift guide
Check the NFS export options
The NFS export options in the
/etc/exportsfile on the NFS server must be set torw,root_squash,no_wdelay. If this file is changed, the NFS server may need to be restarted.Ensure the exported directories are writable
The directories exported from the NFS server which are used by the Pods in OpenShift should be writable. The easiest way to achieve this is to use the
chmodcommand to set the directory permissions to777:chmod 777 /var/export/export1
The NFS Volume Security section of the NFS OpenShift guide has more information on other options.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.