Chapter 13. Configuring NFS storage

Procedure

1. Create an environment file to configure your NFS storage, for example, nfs_storage.yaml.

2. Add the following parameters to your new environment file to configure NFS storage:

   parameter_defaults:
     CinderEnableIscsiBackend: false
     CinderEnableNfsBackend: true
     GlanceBackend: file
     CinderNfsServers: 192.0.2.230:/cinder
     GlanceNfsEnabled: true
     GlanceNfsShare: 192.0.2.230:/glance

   Note

   Do not configure the CinderNfsMountOptions and GlanceNfsOptions parameters, as their default values enable NFS mount options that are suitable for most Red Hat OpenStack Platform (RHOSP) environments. You can see the value of the GlanceNfsOptions parameter in the environments/storage/glance-nfs.yaml file. If you experience issues when you configure multiple services to share the same NFS server, contact Red Hat Support.

3. Add your NFS storage environment file to the stack with your other environment files and deploy the overcloud:

   (undercloud)$ openstack overcloud deploy --templates \
    -e [your environment files] \
    -e /home/stack/templates/nfs_storage.yaml

Procedure

1. Log in to the undercloud as the stack user and source the stackrc credentials file.

   $ source ~/stackrc

2. In a new or existing storage-related environment file, add information about the external NFS share.

   parameter_defaults:
     CinderImageConversionNfsShare: 192.168.10.1:/convert

   Note

   The default value of the CinderImageConversionNfsOptions parameter, that controls the NFS mount options, is sufficient for most environments.

3. Include the environment file that contains your new configuration in the openstack overcloud deploy command with any other environment files that are relevant to your environment.

   $ openstack overcloud deploy \
   --templates \
   …
   -e <existing_overcloud_environment_files> \
   -e <new_environment_file> \
   …

   • Replace <existing_overcloud_environment_files> with the list of environment files that are part of your existing deployment.
   • Replace <new_environment_file> with the new or edited environment file that contains your NFS share configuration.