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>