Chapter 19. Storage Configuration

1. Copy the file to the stack user’s template directory:

   $ cp /usr/share/openstack-tripleo-heat-templates/environments/storage-environment.yaml ~/templates/.

2. Modify the following parameters:

   CinderEnableIscsiBackend

   Enables the iSCSI backend. Set to false.

   CinderEnableRbdBackend

   Enables the Ceph Storage backend. Set to false.

   CinderEnableNfsBackend

   Enables the NFS backend. Set to true.

   NovaEnableRbdBackend

   Enables Ceph Storage for Nova ephemeral storage. Set to false.

   GlanceBackend

   Define the back end to use for glance. Set to file to use file-based storage for images. The overcloud saves these files in a mounted NFS share for glance.

   CinderNfsMountOptions

   The NFS mount options for the volume storage.

   CinderNfsServers

   The NFS share to mount for volume storage. For example, 192.168.122.1:/export/cinder.

   GlanceNfsEnabled

   When GlanceBackend is set to file, GlanceNfsEnabled enables images to be stored through NFS in a shared location so that all Controller nodes have access to the images. If disabled, the overcloud stores images in the file system of the Controller node. Set to true.

   GlanceNfsShare

   The NFS share to mount for image storage. For example, 192.168.122.1:/export/glance.

   GlanceNfsOptions

   The NFS mount options for the image storage.

   The environment file contains parameters that configure different storage options for the Red Hat OpenStack Platform Block Storage (cinder) and Image (glance) services. This example demonstrates how to configure the overcloud to use an NFS share.

   The options in the environment file should look similar to the following:

   parameter_defaults:
     CinderEnableIscsiBackend: false
     CinderEnableRbdBackend: false
     CinderEnableNfsBackend: true
     NovaEnableRbdBackend: false
     GlanceBackend: file
   
     CinderNfsMountOptions: rw,sync,context=system_u:object_r:cinder_var_lib_t:s0
     CinderNfsServers: 192.0.2.230:/cinder
   
     GlanceNfsEnabled: true
     GlanceNfsShare: 192.0.2.230:/glance
     GlanceNfsOptions: rw,sync,context=system_u:object_r:glance_var_lib_t:s0

   These parameters are integrated as part of the heat template collection. Setting them as shown in the example code creates two NFS mount points for the Block Storage and Image services to use.

   Important

   Include the context=system_u:object_r:glance_var_lib_t:s0 option in the GlanceNfsOptions parameter to allow the Image service to access the /var/lib directory. Without this SELinux content, the Image service cannot to write to the mount point.

3. Include the file when you deploy the overcloud.

1. Create a new file named swift-external-params.yaml with the following content:

   • Replace EXTERNAL.IP:PORT with the IP address and port of the external proxy and

   • Replace AUTHTOKEN with the authtoken password for the external proxy on the SwiftPassword line.

     parameter_defaults:
       ExternalPublicUrl: 'https://EXTERNAL.IP:PORT/v1/AUTH_%(tenant_id)s'
       ExternalInternalUrl: 'http://192.168.24.9:8080/v1/AUTH_%(tenant_id)s'
       ExternalAdminUrl: 'http://192.168.24.9:8080'
       ExternalSwiftUserTenant: 'service'
       SwiftPassword: AUTHTOKEN

2. Save this file as swift-external-params.yaml.

3. Deploy the overcloud using these additional environment files.

   openstack overcloud deploy --templates \
   -e [your environment files]
   -e /usr/share/openstack-tripleo-heat-templates/environments/swift-external.yaml
   -e swift-external-params.yaml

Procedure

1. To configure cinder as the Image service back end, add the following to the environment file:

   parameter_defaults:
     GlanceBackend: cinder

2. If the cinder back end is enabled, the following parameters and values are set by default:

   cinder_store_auth_address = http://172.17.1.19:5000/v3
   cinder_store_project_name = service
   cinder_store_user_name = glance
   cinder_store_password = ****secret****

3. To use a custom user name, or any custom value for the cinder_store_ parameters, add the ExtraConfig settings to parameter_defaults and pass the custom values:

   ExtraConfig:
       glance::config::api_config:
         glance_store/cinder_store_auth_address:
           value: "%{hiera('glance::api::authtoken::auth_url')}/v3"
         glance_store/cinder_store_user_name:
           value: <user-name>
         glance_store/cinder_store_password:
           value: "%{hiera('glance::api::authtoken::password')}"
         glance_store/cinder_store_project_name:
           value: "%{hiera('glance::api::authtoken::project_name')}"