Chapter 2. Block Storage backup service deployment

Procedure

1. Create a copy of the cinder-backup.yaml file, which is located in the /usr/share/openstack-tripleo-heat-templates/environments/ directory, and store it in the same location as your other custom templates.

   cp /usr/share/openstack-tripleo-heat-templates/environments/cinder-backup.yaml /home/stack/templates/cinder-backup-settings.yaml

   Copy to Clipboard Toggle word wrap

2. Your copy of the cinder-backup.yaml file contains default settings that configure an OpenStack Object Storage (swift) back end for the Block Storage backup service with Pacemaker. If this is the back end you are using for your backup then you do not need to make changes to this file. If you are using an alternative back end, configure parameter_defaults depending on the backup back end:

   • If you are using Red Hat Ceph Storage, configure parameter_defaults in the following way:

     • CinderBackupBackend: (Required) ceph
     • CinderBackupRbdPoolName: (Optional) Set to a custom RBD pool name. Default: backups

   • If you are using NFS, configure parameter_defaults in the following way:

     • CinderBackupBackend: (Required) nfs
     • CinderBackupNfsShare: (Required) Set to the NFS share that you want to mount. The default value is empty.
     • CinderBackupNfsOptions: (Optional) Set to your required mount option.
3. Save the changes to the file.

4. To enable the backup service and apply this configuration, add your backup settings environment file to the stack with your other environment files and deploy the overcloud:

   (undercloud) [stack@undercloud ~]$ openstack overcloud deploy --templates \
     -e [your environment files]
     -e /home/stack/templates/cinder-backup-settings.yaml

   Copy to Clipboard Toggle word wrap

Procedure

1. Log in as the stack user.

2. Deploy the configuration:

   $ openstack overcloud deploy --templates \
   -e /home/stack/templates/cinder-backup-settings.yaml

   Copy to Clipboard Toggle word wrap
   Important

   If you passed any extra environment files when you created the overcloud, pass them again here using the -e option to avoid making undesired changes to the overcloud.

3. Restart the cinder-backup service after the deployment finishes.