Enable the NFS driver and related options

Kilo - Kilo - Kilo - Kilo - Kilo - Kilo - Kilo - Kilo -

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.

Table 2.25. Description of NFS storage configuration options
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.
`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

	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 `nfs_mount_options` configuration option contains a request for a specific version of NFS to be used, or if specific options are specified in the shares configuration file specified by the `nfs_shares_config` configuration option, the mount will be attempted as requested with no subsequent attempts.

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 nfs_mount_options configuration option contains a request for a specific version of NFS to be used, or if specific options are specified in the shares configuration file specified by the nfs_shares_config configuration option, the mount will be attempted as requested with no subsequent attempts.

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page

Legal notices