haskal
/
vagrant
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Add NFSv4 warning and information

This commit is contained in:
Chris Roberts 2016-08-19 09:30:23 -07:00
parent c5438675ea
commit bbac718925
3 changed files with 44 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
plugins/synced_folders/nfs/synced_folder.rb
View File

@ -130,6 +130,11 @@ module VagrantPlugins
opts[:nfs_udp] = true if !opts.key?(:nfs_udp) opts[:nfs_udp] = true if !opts.key?(:nfs_udp)
opts[:nfs_version] ||= 3 opts[:nfs_version] ||= 3
if opts[:nfs_version].to_s.start_with?('4') && opts[:nfs_udp]
machine.ui.info I18n.t("vagrant.actions.vm.nfs.v4_with_udp_warning")
end
# We use a CRC32 to generate a 32-bit checksum so that the # We use a CRC32 to generate a 32-bit checksum so that the
# fsid is compatible with both old and new kernels. # fsid is compatible with both old and new kernels.
opts[:uuid] = Zlib.crc32(opts[:hostpath]).to_s opts[:uuid] = Zlib.crc32(opts[:hostpath]).to_s

13
templates/locales/en.yml
View File

@ -1845,6 +1845,19 @@ en:
exporting: Exporting NFS shared folders... exporting: Exporting NFS shared folders...
installing: "Installing NFS client..." installing: "Installing NFS client..."
mounting: Mounting NFS shared folders... mounting: Mounting NFS shared folders...
v4_with_udp_warning: |-
WARNING: Invalid NFS settings detected!
Detected UDP enabled with NFSv4. NFSv4 does not support UDP.
If folder mount fails disable UDP using the following option:
nfs_udp: false
For more information see:
RFC5661: https://tools.ietf.org/html/rfc5661#section-2.9.1
RFC7530: https://tools.ietf.org/html/rfc7530#section-3.1
provision: provision:
beginning: "Running provisioner: %{provisioner}..." beginning: "Running provisioner: %{provisioner}..."
disabled_by_config: |- disabled_by_config: |-

26
website/source/docs/synced-folders/nfs.html.md
View File

@ -188,3 +188,29 @@ will refuse to export the filesystem. The error message given by NFS is
often not clear. One error message seen is `<path> does not support NFS`. often not clear. One error message seen is `<path> does not support NFS`.
There is no workaround for this other than sharing a directory which is not There is no workaround for this other than sharing a directory which is not
encrypted. encrypted.
**Version 4:** UDP is generally not a valid transport protocol for NFSv4.
Early implementations of NFS 4.0 still allowed UDP which allows the UDP
transport protocol to be used in rare cases. RFC5661 explicitly states
UDP alone should not be used for the transport protocol in NFS 4.1. Errors
due to unsupported transport protocols for specific versions of NFS are
not always clear. A common error message when attempting to use UDP with
NFSv4:
```
mount.nfs: an incorrect mount option was specified
```
When using NFSv4, ensure the `nfs_udp` option is set to false. For example:
```
config.vm.synced_folder ".", "/vagrant",
:nfs => true,
:nfs_version => 4,
:nfs_udp => false
```
For more information about transport protocols and NFS version 4 see:
* NFSv4.0 - [RFC7530](https://tools.ietf.org/html/rfc7530#section-3.1)
* NFSv4.1 - [RFC5661](https://tools.ietf.org/html/rfc5661#section-2.9.1)