The cinder.backup.manager Module

Backup manager manages volume backups.

Volume Backups are full copies of persistent volumes stored in a backup store e.g. an object store or any other backup store if and when support is added. They are usable without the original object being available. A volume backup can be restored to the original volume it was created from or any other available volume with a minimum size of the original volume. Volume backups can be created, restored, deleted and listed.

Related Flags

backup_topic:What rpc topic to listen to (default: cinder-backup).
backup_manager:The module name of a class derived from manager.Manager (default: cinder.backup.manager.Manager).
class BackupManager(service_name=None, *args, **kwargs)

Bases: cinder.manager.SchedulerDependentManager

Manages backup of block storage devices.

RPC_API_VERSION = '2.0'
check_support_to_force_delete(context)

Check if the backup driver supports force delete operation.

Parameters:context – running context
create_backup(context, backup)

Create volume backups using configured backup service.

delete_backup(context, backup)

Delete volume backup from configured backup service.

driver_name

This function maps old backup services to backup drivers.

export_record(context, backup)

Export all volume backup metadata details to allow clean import.

Export backup metadata so it could be re-imported into the database without any prerequisite in the backup database.

Parameters:
  • context – running context
  • backup – backup object to export
Returns:

backup_record - a description of how to import the backup

Returns:

contains ‘backup_url’ - how to import the backup, and

Returns:

‘backup_service’ describing the needed driver.

Raises:

InvalidBackup

import_record(context, backup, backup_service, backup_url, backup_hosts)

Import all volume backup metadata details to the backup db.

Parameters:
  • context – running context
  • backup – The new backup object for the import
  • backup_service – The needed backup driver for import
  • backup_url – An identifier string to locate the backup
  • backup_hosts – Potential hosts to execute the import
Raises:

InvalidBackup

Raises:

ServiceNotFound

init_host()

Run initialization needed for a standalone service.

reset()
reset_status(context, backup, status)

Reset volume backup status.

Parameters:
  • context – running context
  • backup – The backup object for reset status operation
  • status – The status to be set
Raises:

InvalidBackup

Raises:

BackupVerifyUnsupportedDriver

Raises:

AttributeError

restore_backup(context, backup, volume_id)

Restore volume backups from configured backup service.

target = <Target version=2.0>

Previous topic

The cinder.backup.drivers.tsm Module

Next topic

The cinder.backup.rpcapi Module

Project Source

This Page