Create a full volume backup

You can create one or more full backups of a volume.

Before you begin

  • Only volume owners and administrators can backup volumes.
  • The storage back end for backups must have the necessary space.
  • The backup quotas specified for your project have not been exceeded.

Procedure

  1. Access the remote shell for the OpenStackClient pod from your workstation: 
    $ oc rsh -n openstack openstackclient
  2. List the volumes to obtain the ID or name of the volume you want to back up: 
    $ openstack volume list
    Note
    Usually, you can only back up a volume that has an available status, but you can backup a volume with an in-use status if required. For more information, see Back up an in-use volume.
  3. Back up the volume: 
    $ openstack volume backup create [--name <backup_name>] <volume>
    • Replace <volume> with the ID or name of the volume you want to back up.
    • Optional: replace <backup_name> with the name of this backup.

      This command immediately provides the ID of this backup but the volume is backed up asynchronously, in the background. For example:

      $ openstack volume backup create --name vol1bu2 vol_1
+-------+--------------------------------------+
| Field | Value                                |
+-------+--------------------------------------+
| id    | 83dadc43-2aa9-4c0b-bc05-a12203a8f4cb |
| name  | vol1bu2                              |
+-------+--------------------------------------+

Results

  • List the backups: 
    $ openstack volume backup list

    The volume backup is created when this backup has an available status. For example:

    +--------------------------------------+---------+-------------+-----------+------+
| ID                                   | Name    | Description | Status    | Size |
+--------------------------------------+---------+-------------+-----------+------+
| 83dadc43-2aa9-4c0b-bc05-a12203a8f4cb | vol1bu2 | None        | available |    1 |
| b604a932-94a5-468e-bf6b-841ac16f69a8 | None    | None        | available |    1 |
+--------------------------------------+---------+-------------+-----------+------+
    1. Exit the openstackclient pod: 
      $ exit