Chapter 3. Edit the Environment File

The environment file contains the back end settings you want to define. It also contains other settings relevant to the deployment of the Shared File System service. For more information about environment files, see Environment Files in the Advanced Overcloud Customization guide.

This release includes an integrated environment file for defining a CephFS back end. This file is located in the following path of the undercloud node:

/usr/share/openstack-tripleo-heat-templates/environments/manila-cephfsnative-config.yaml

This file provides default settings for deploying a Shared File System service.

Create an environment file which will contain the settings necessary for your environment — namely, ~/templates/manila-cephfsnative-config.yaml. The following snippet shows the default values used by the director when deploying the Shared File System service:

/home/stack/templates/manila-cephfsnative-config.yaml

parameter_defaults: # 1
  ManilaCephFSNativeBackendName: cephfsnative
  ManilaCephFSNativeDriverHandlesShareServers: false # 2
  ManilaCephFSNativeCephFSConfPath: '/etc/ceph/ceph.conf' # 3
  ManilaCephFSNativeCephFSAuthId: 'manila' # 4
  ManilaCephFSNativeCephFSClusterName: 'ceph'
  ManilaCephFSNativeCephFSEnableSnapshots: true

1
The parameter_defaults header signifies the start of your configuration. Specifically, it allows you to override default values set in resource_registry. This includes values set by OS::Tripleo::Services::ManilaBackendCephFs, which sets defaults for a CephFS back end.
2
With ManilaCephFSNativeDriverHandlesShareServers set to false, the driver will not handle the lifecycle of the share server.
3
ManilaCephFSNativeCephFSConfPath: sets the path to the configuration file of the Ceph cluster.
4
ManilaCephFSNativeCephFSAuthId: is the Ceph auth ID that the director will create for share access.