The backup driver for the swift back end performs a volume backup to an object storage system.
To enable the swift backup driver, include the following option in the cinder.conf file:
backup_driver = cinder.backup.drivers.swift
The following configuration options are available for the Swift back-end backup driver.
Configuration option = Default value | Description |
---|---|
[DEFAULT] | |
backup_swift_auth = per_user | (String) Swift authentication mechanism |
backup_swift_auth_version = 1 | (String) Swift authentication version. Specify “1” for auth 1.0, or “2” for auth 2.0 |
backup_swift_block_size = 32768 | (Integer) The size in bytes that changes are tracked for incremental backups. backup_swift_object_size has to be multiple of backup_swift_block_size. |
backup_swift_ca_cert_file = None | (String) Location of the CA certificate file to use for swift client requests. |
backup_swift_container = volumebackups | (String) The default Swift container to use |
backup_swift_enable_progress_timer = True | (Boolean) Enable or Disable the timer to send the periodic progress notifications to Ceilometer when backing up the volume to the Swift backend storage. The default value is True to enable the timer. |
backup_swift_key = None | (String) Swift key for authentication |
backup_swift_object_size = 52428800 | (Integer) The size in bytes of Swift backup objects |
backup_swift_retry_attempts = 3 | (Integer) The number of retries to make for Swift operations |
backup_swift_retry_backoff = 2 | (Integer) The backoff time in seconds between Swift retries |
backup_swift_tenant = None | (String) Swift tenant/account name. Required when connecting to an auth 2.0 system |
backup_swift_url = None | (String) The URL of the Swift endpoint |
backup_swift_user = None | (String) Swift user name |
keystone_catalog_info = identity:Identity Service:publicURL | (String) Info to match when looking for keystone in the service catalog. Format is: separated values of the form: <service_type>:<service_name>:<endpoint_type> - Only used if backup_swift_auth_url is unset |
swift_catalog_info = object-store:swift:publicURL | (String) Info to match when looking for swift in the service catalog. Format is: separated values of the form: <service_type>:<service_name>:<endpoint_type> - Only used if backup_swift_url is unset |
To enable the swift backup driver for 1.0 or 2.0 authentication version, specify 1 or 2 correspondingly. For example:
backup_swift_auth_version = 2
In addition, the 2.0 authentication system requires the definition of the backup_swift_tenant setting:
backup_swift_tenant = <None>
This example shows the default options for the Swift back-end backup driver.
backup_swift_url = http://localhost:8080/v1/AUTH_
backup_swift_auth = per_user
backup_swift_auth_version = 1
backup_swift_user = <None>
backup_swift_key = <None>
backup_swift_container = volumebackups
backup_swift_object_size = 52428800
backup_swift_retry_attempts = 3
backup_swift_retry_backoff = 2
backup_compression_algorithm = zlib
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.