To use Cinder with the NFS driver, first set the
volume_driver
in
cinder.conf
:
volume_driver=cinder.volume.drivers.nfs.NfsDriver
The following table contains the options supported by the NFS driver.
Configuration option = Default value | Description |
---|---|
[DEFAULT] | |
nfs_mount_attempts = 3 |
(IntOpt) The number of attempts to mount nfs shares before raising an error. At least one attempt will be made to mount an nfs share, regardless of the value specified. |
nfs_mount_options = None |
(StrOpt) Mount options passed to the nfs client. See section of the nfs man page for details. |
nfs_mount_point_base = $state_path/mnt |
(StrOpt) Base dir containing mount points for nfs shares. |
nfs_oversub_ratio = 1.0 |
(FloatOpt) This will compare the allocated to available space on the volume destination. If the ratio exceeds this number, the destination will no longer be valid. Note that this option is deprecated in favor of "max_oversubscription_ratio" and will be removed in the Mitaka release. |
nfs_shares_config = /etc/cinder/nfs_shares |
(StrOpt) File with the list of available nfs shares |
nfs_sparsed_volumes = True |
(BoolOpt) Create volumes as sparsed files which take no space.If set to False volume is created as regular file.In such case volume creation takes a lot of time. |
nfs_used_ratio = 0.95 |
(FloatOpt) Percent of ACTUAL usage of the underlying volume before no new volumes can be allocated to the volume destination. Note that this option is deprecated in favor of "reserved_percentage" and will be removed in the Mitaka release. |
Note | |
---|---|
As of the Icehouse release, the NFS driver (and other
drivers based off it) will attempt to mount shares
using version 4.1 of the NFS protocol (including pNFS). If the
mount attempt is unsuccessful due to a lack of client or
server support, a subsequent mount attempt that requests the
default behavior of the mount.nfs command
will be performed. On most distributions, the default behavior
is to attempt mounting first with NFS v4.0, then silently fall
back to NFS v3.0 if necessary. If the
|