13.14 Cloud Storage Options

These options are for using cloud storage for single-file operations. See Section 4.3.1.3, “Backing Up to Cloud Storage”, and Section 5.1.5, “Restoring a Backup from Cloud Storage to a MySQL Server”, for more information and instructions on using cloud storage with MySQL Enterprise Backup.

  • --cloud-service=SERVICE

    Cloud service for data backup or restoration. Currently, there are two types of cloud storage services supported by mysqlbackup, represented by the following values for the options:

    • s3: Amazon Simple Storage Service (S3)

    • openstack: OpenStack Object Storage (Swift). MySQL Enterprise Backup 4.0 supports the Swift v1.0 API, and also the OpenStack Identity (Keystone) API v2.0 for authentication. Also supports authentication using Swift's TempAuth system.

  • --cloud-trace

    Print trace information for cloud operations. It works independently of --trace, which specifies the trace level for the non-cloud operations of mysqlbackup. Any non-zero value for the option enables the trace function.

    Default value is 0.

  • --cloud-proxy=proxy-url:port

    Proxy address and port number for overriding the environment's default proxy settings for accessing a cloud storage service.

    Note

    The list-image operation can be performed on a cloud backup only if the cloud proxy supports HTTP range headers.

  • Options used only for Amazon S3 (using them when the argument for --cloud-service is anything other than s3 will cause mysqlbackup to throw an error):

    • --cloud-bucket=S3_BUCKET

      The storage bucket on Amazon S3 for the backup image.

      In order to perform cloud backups and restores with the bucket, the user identified by the --cloud-access-key-id option must have at least the following permissions on the bucket:

      • s3:ListBucket: For listing information on items in the bucket.

      • s3:ListBucketMultipartUploads: For listing multipart uploads in progress to the bucket.

      • s3:GetObject: For retrieving objects from the bucket.

      • s3:PutObject: For adding objects to the bucket.

    • --cloud-object-key=S3_OBJECT_KEY

      The Amazon S3 object key for the backup image.

    • --cloud-access-key-id=S3_KEY-ID

      AWS access key ID for logging onto Amazon S3.

    • --cloud-secret-access-key=S3_ACCESS-KEY

      AWS secret access key for the AWS access key id specified with --cloud-access-key-id.

    • --cloud-aws-region=S3_REGION

      Region for Amazon Web Services that mysqlbackup accesses for S3.

  • Options used only for OpenStack Swift (using them when the argument for --cloud-service is anything other than openstack will cause mysqlbackup to throw an error):

    • --cloud-container=SWIFT_CONTAINER

      The Swift container for the backup image.

    • --cloud-object=SWIFT_OBJECT

      The Swift object for the backup image. Note that names of objects in a container have to be unique.

    • --cloud-user-id=SWIFT_OR_KEYSTONE_USER

      User ID for accessing Swift. The user credentials are authenticated using the Swift TempAuth identity system when the --cloud-tempauth-url option is used and by the OpenStack Keystone identity service when the --cloud-identity-url option is used.

    • --cloud-password=SWIFT_OR_KEYSTONE_PASSWORD

      Password for the user specified by --cloud-user-id. The user credentials are authenticated using the Swift TempAuth identity system when the --cloud-tempauth-url option is used and by the OpenStack Keystone identity service when the --cloud-identity-url option is used.

    • --cloud-tempauth-url=SWIFT_TEMPAUTH-URL

      The TempAuth URL for authenticating user credentials. Either this option or --cloud-identity-url (but not both) should be used when accessing a Swift service.

    • --cloud-identity-url=SWIFT_KEYSTONE-URL

      The URL of the Keystone identity service, when it is used for authenticating user credentials. Either this option or --cloud-tempauth-url (but not both) should be used when accessing a Swift service.

    • --cloud-tenant=SWIFT_KEYSTONE-TENANT

      The Keystone tenant for the user specified by --cloud-user-id, when the Keystone identity service is used for authenticating user credentials.

    • --cloud-region=SWIFT_KEYSTONE-REGION

      The Keystone region for the user specified by --cloud-user-id, when the Keystone identity service is used for authenticating user credentials.


User Comments
Sign Up Login You must be logged in to post a comment.