Chapter 1. Backing up your Red Hat OpenStack Platform cluster by using the Snapshot and Revert tool

Procedure

1. Log in to the undercloud as the stack user.

2. Source the stackrc undercloud credentials file:

   [stack@undercloud ~]$ source stackrc
   (undercloud) [stack@undercloud ~]$

   Copy to Clipboard Toggle word wrap

3. If you have not done so before, extract the static Ansible inventory file from the location in which it was saved during installation:

   (undercloud) [stack@undercloud ~]$ cp ~/overcloud-deploy/<stack> /tripleo-ansible-inventory.yaml ~/tripleo-inventory.yaml

   Copy to Clipboard Toggle word wrap
   • Replace <stack> with the name of your stack. By default, the name of the stack is overcloud.

4. Take the snapshots:

   (undercloud) [stack@undercloud ~]$ openstack overcloud backup snapshot --inventory ~/tripleo-inventory.yaml

   Copy to Clipboard Toggle word wrap

5. If your upgrade or update was successful, remove the snapshots:

   (undercloud) [stack@undercloud ~]$ openstack overcloud backup snapshot --remove --inventory ~/tripleo-inventory.yaml

   Copy to Clipboard Toggle word wrap
   Important

   Removing snapshots is a critical action. Remove the snapshots if you do not intend to revert the nodes, for example, after an upgrade completes successfully. If you retain snapshots on the nodes for too long, they degrade disk I/O performance.

6. If your upgrade or update failed, revert the snapshots:

   (undercloud) [stack@undercloud ~]$ openstack overcloud backup snapshot --revert --inventory ~/tripleo-inventory.yaml

   Copy to Clipboard Toggle word wrap
   1. Reboot each node that you reverted so the changes are applied to the filesystem. The revert option automatically deletes the snapshots.